Importar datos de costo

Premium

En resumen: Cost Import, parte de AppsFlyer ROI360, permite a los anunciantes obtener una cobertura completa y precisa de su costo de marketing al importar archivos CSV a través de uplaod o correo electrónico.

General

Utiliza Cost Import para:

  • Obtener los costos de campaña de cualquier actividad de marketing (campañas móviles, campañas de influencers, CTV y más) a AppsFlyer. Esto es particularmente importante para las fuentes de medios que no informan el costo a través de API o en el enlace de atribución.
  • Sobrescribir y corregir retroactivamente los datos de costo existentes.

El costo se reporta a través de archivos CSV o enviados por correo electrónico a AppsFlyer. Una vez que AppsFlyer recibe el archivo, los datos se procesan y están disponibles en dashboards en unas pocas horas. Esto te da una imagen completa de los costos de tu campaña y del ROI.

Nota:

  • Las ad networks pueden importar archivos de costo para sus clientes si se proporcionan los permisos relevantes.
  • Las agencias pueden preparar archivos, pero los anunciantes deben subirlos.

Procedimientos

Para utilizar Cost Import y enviar datos de costo a AppsFlyer, necesitas:

  1. Preparar el archivo CSV con los datos de costo para enviar.
  2. Envía el archivo a AppsFlyer a través de:
    • La interfaz de usuario de AppsFlyer.
    • Correo electrónico. Nota: Para aplicaciones en plataformas de CTV, PC y consola, utiliza solo este método.

Consulta las secciones que siguen para obtener instrucciones detalladas.

Prepara el archivo CSV con datos de costo

Los anunciantes, las ad networks y agencias pueden preparar el archivo CSV de Cost Import. Ver archivo de muestra

Para preparar el archivo CSV:

  • Sigue el esquema del archivo, formato y reglas detalladas en las siguientes tablas.
    Nota: Si utilizas Excel o Google Sheets para crear el archivo, sigue las instrucciones de formato de Excel y Google Sheets.

Esquema CSV

Nombre de columna 

(distingue entre mayúsculas y minúsculas)

Formato/observaciones

Ejemplo

Obligatorio

date

  • La fecha en que ocurrió el costo
  • Formato: Cadena
    (Mejores prácticas):
    • AAAA-MM-DD
    • AAAA/MM/DD
    • MM-DD-YYYY
    • MM/DD/YYYY 
  • No se permiten fechas futuras.
  • Prácticas recomendadas: Usa la misma zona horaria que la definida para tu aplicación en AppsFlyer.
  • Nota: ¿Estás utilizando Excel/Google Sheets para preparar el archivo? Lee esto
  • 2019-05-30
  • 2019/05/30
  • 5-30-2019
  • 5/30/2019
  • 05-30-2019
  • 05/30/2019

 

app-id

  • Formato: Cadena
  • ID de la aplicación tal como aparece en AppsFlyer
  • Se permiten múltiples aplicaciones en un solo archivo.
  • Todos los IDs de la aplicación deben pertenecer a la misma cuenta de anunciante.
  • com.app.name 
  • id12356789

media-source

    • Formato: Cadena
    • Nombre de la fuente de medios exactamente como aparece en AppsFlyer. Nota: Incluye el sufijo _int si es necesario.
    • Solo se permite una fuente de medios por archivo. Se permiten múltiples aplicaciones para la misma fuente de medios.

network_x_int

campaign

  • Formato: String
  • Nombre de la campaña. Si el nombre de la campaña aparece en la ad network, el nombre en este archivo debe coincidir (sensible a mayúsculas y minúsculas).
  • No utilices el mismo nombre de campaña para varias aplicaciones.

campaign_a

Nota: Si los datos de atribución existen con nombre e ID, el CSV debe contener ambos para que coincidan.

spend

  • Costo monetario
  • Se permiten cinco dígitos después del punto decimal
  • Se permite el valor 0 (cero).
  • Nota:
    • No se permiten separadores de coma en 1000, por ejemplo: "2,874.12".
    • ¿Estás utilizando Excel/Google Sheets para preparar el archivo? Lee esto.

2874.12345

 

 

geo

  • Formato: Cadena
  • Código de país de dos letras que cumple con la norma ISO 3166. Nota: Asegúrate de enviar dos caracteres sin espacios en blanco.
  • Para el Reino Unido, utiliza UK, no GB.

US, CN, AU

 

No

currency

  • Formato: Cadena
  • Código de moneda de tres letras que cumple con la norma ISO 4217Nota: Asegúrate de enviar tres caracteres sin espacios en blanco iniciales o finales.
  • Se permite un código de moneda por aplicación en el archivo. Diferentesaplicaciones pueden tener diferentes códigos de moneda.

USD, GBP, EUR, JPY

No.

El valor predeterminado será USD si se deja vacío.

campaign-id

Formato: Cadena

abc1234def

No.

Nota: Si los datos de atribución existen con nombre e ID, el CSV debe contener ambos para que coincidan.

adset

Formato: Cadena  my_adset_1

adset-id

Formato: Cadena id5678ghi

ad

Formato: Cadena  my_ad_name

ad-id

Formato: Cadena  id91011jkl

site-id

  • Formato: Cadena 
  • ID único que identifica al publisher que muestra el anuncio. Saber más
id1213mno No

channel

Formato: Cadena   video No

keywords

Formato: Cadena

  • better
  • better you app
  • better you online
No

agency

  • Formato: Cadena
  • El nombre de la agencia. (El valor en el parámetro af_prt)
  • Solo se puede incluir una agencia en un archivo. Y solo se pueden incluir en el archivo las campañas gestionadas por esa agencia.
  • El nombre de la agencia es obligatorio por fila. No se permiten celdas en blanco en la columna de la agencia.
  • La agencia debe tener permiso para todas las aplicaciones incluidas en el archivo.
  • Solo los anunciantes pueden subir el archivo. Las agencias no pueden subir datos. Pueden preparar sus archivos y enviarlos al anunciante para que los suban.
AgencyName No

Nota: Los nombres que tengan caracteres que no estén en inglés deben codificarse con UTF-8.

Formato y reglas CSV

Regla Requisito

Caracteres prohibidos

Los campos en formato de cadena no pueden tener =, +, -o @ como primer carácter. Por ejemplo, @example_campign o =123 están prohibidos.

Propietario de la aplicación 

Se permite un anunciante (propietario de la aplicación) por archivo. Se permiten múltiples aplicaciones de la misma cuenta de anunciante. 

Extensión del nombre de archivo

Ejemplo CSV: abc123.csv

Estructura de archivos

  • Formato: Los archivos tienen un formato CSV, lo que significa que cada columna está separada por una coma.
  • Fila de encabezado: La primera fila es una fila de encabezado que coincide con el esquema.
  • Filas de datos: Contiene las columnas obligatorias. Nota: Asegúrate de que no haya espacios en blanco al final de los datos. Por ejemplo, [USD] (con un espacio en blanco después de la D) debe cambiarse a [USD].
  • Filas en blanco: No permitido
  • Filas duplicadas que tienen la misma clave: No está permitido. La clave se deriva del uso de los campos obligatorios.
  • Celdas en blanco: No se permiten valores vacíos en el archivo. Si no quieres subir ciertos campos, no deben estar en el archivo.

Jerarquía publicitaria 

El costo debe registrarse a nivel de campaña, siendo opcionales otras dimensiones en la jerarquía publicitaria.

Cualquier dato parcial que se suba en una jerarquía inferior anulará todos los datos del nivel de campaña hacia abajo.

Por ejemplo: Si importas un archivo con el costo de la campaña para el adset 1 e importas por separado otro archivo para el adset 2 de la misma campaña, se reemplazará el costo total de la campaña y solo se mostrarán los datos del adset 2. Para el costo total de la campaña, el archivo que importes debe incluir el adset 1 y el adset 2. 

Upload archivo

Los anunciantes y las ad networks pueden cargar archivos CSV de Cost Import.

Requisitos previos: Las ad networks requieren permiso de Cost Import del anunciante.

Para cargar el archivo CSV a través de la interfaz de usuario de AppsFlyer:

  1. En AppsFlyer, en el menú lateral, selecciona Configuración > Cost Import.
    Aparece la página de Cost Import. 
  2. Haz clic en + Importar archivo de costos
    Se abre la ventana de importación de costos.
  3. Arrastra el archivo CSV a la ventana de Importación de costos.
    Se muestra el mensaje procesando archivo.
  4. Si aparece un mensaje de error durante el upload, corrígelo y repite los pasos correspondientes. 
  5. Se abre la ventana Cost Import: resumen de archivos.
  6. Realiza una de las siguientes acciones:
    • Anula el upload, haz clic en Cancelar importación
    • Completa el proceso de importación, haz clic en importar archivo.
      Se muestra el mensaje “¡Todo listo!”
    • Si se muestra un mensaje de error, sigue las instrucciones del mensaje de error.
  7. Haz clic en importar otro archivo o en Listo

Archivo de correo electrónico

Los anunciantes y las ad networks pueden enviar por correo electrónico archivos CSV de Cost Import.

Requisitos previos:

  • Anunciantes:
    • El correo electrónico del remitente debe ser de un usuario registrado de AppsFlyer.
  • Ad networks:

Para enviar el archivo CSV por correo electrónico:

  1. Obtén el token para la importación por correo electrónico.
    1. En AppsFlyer, en el menú lateral, selecciona Configuración > Cost Import.
    2. En la parte superior derecha de la página, haga clic en Token para la importación de correos electrónicos.
    3. Copia y guarda el token.
  2. Redacta el correo electrónico con los siguientes campos: 
    • Para:adspend-upload@appsflyer.com
    • CC: Usuarios que deben recibir una copia de los comentarios automáticos
    • Asunto: Pega el token para la importación de correos electrónicos en el campo del asunto.
    • Archivo adjunto: CSV con los datos.
  3. Envía el correo electrónico.
    • Una vez que se reciba y procese el archivo, un correo electrónico de estado resume los detalles, problemas o errores encontrados durante el procesamiento. El correo electrónico se envía a todas las partes del correo electrónico de envío y al administrador del anunciante. Donde se identifiquen errores, sigue las instrucciones del mensaje del error.
    • Puedes ver el estado de los archivos enviados en el dashboard de Cost Import

Dashboard

El dashboard de Cost Import es donde puedes cargar archivos y ver detalles de archivos previamente cargados.

Dashboard de Cost Import

Para ver el dashboard de Cost Import, en AppsFlyer, desde el menú lateral, selecciona Configuración > Cost Import.

Los detalles sobre la información disponible para archivos importados previamente se describen en la siguiente tabla.

Nombre de columna Descripción
Nombre de archivo CSV El nombre de los archivos de costos importados a AppsFlyer.
Fecha de upload Fecha en que se importó el archivo.
Fuente de medios Fuente de medios incluida en el archivo.
Rango de fechas Fechas de inicio y fin en el archivo en las que se produjo el gasto publicitario.
Filas con coincidencias (%) El porcentaje de filas en el archivo donde el costo se asignó a la atribución. Saber más.
Estado El estado del archivo importado:
  • Éxito: Acción completada con éxito.  El costo se registra y está disponible en los dashboards y reportes de AppsFlyer.
  • Error de validación: Problema del sistema de AppsFlyer. Espera 10 minutos e inténtalo de nuevo. Si vuelve a fallar, comunícate con el soporte de AppsFlyer.
  • Sin permisos: El token no está aprobado para esta aplicación.
    • Anunciantes: Asegúrate de que el ID de la aplicación sea correcto.
    • Ad networks: Confirma con el anunciante que le han dado permiso para Cost Import. 
  • Revertido: Acción completada con éxito.  El archivo fue sobrescrito/reemplazado por otros datos.
Acción
  • A nivel de archivo: Si tienes permisos de aplicación para todas las aplicaciones contenidas en el archivo, puedes:
    • Descargar el archivo CSV: Esta es una copia del archivo CSV importado.
    • Descargar el reporte sin coincidencias para todas las aplicaciones en el archivo. Consulta la sección de filas coincidentes de esta tabla para más información.
  • A nivel de aplicación: Si haces clic en un archivo específico, se muestra información sobre todas las importaciones de costos para la aplicación, desde ese archivo específico, así como otros archivos. Si tienes permiso de aplicación para la aplicación, puedes:
    • Descargar los datos de la aplicación.
    • Descargar el reporte sin coincidencias para la aplicación.
    • Revertir(cancelar) el Cost Import de la aplicación seleccionada.

Filas con coincidencias

La coincidencia de filas es el proceso donde el costo reportado por la importación se empareja con los datos de atribución registrados en AppsFlyer. Esto se hace utilizando todos los nombres de dimensiones (no IDs) disponibles, como fuente de medios, campaña, conjunto de anuncios, anuncio, etc. Si todas coinciden, las filas se designan como is-matching=TRUE. 

El costo se registra y está disponible en los dashboards y reportes de AppsFlyer, independientemente del estado de coincidencia.

El porcentaje de filas coincidentes se muestra en el dashboard de Cost Import. Si las filas no coincidentes son inesperadas o el número de filas coincidentes (%) es mayor de lo esperado:

  • Descarga el reporte de no coincidentes para investigar la causa. El reporte sin coincidencias contiene una columna, is-matched, que puede tener un valor de filas TRUE (con coincidencias) o FALSE (sin coincidencias).
  • Si es necesario, cancela la importación revirtiéndola.
  • Consulta la sección de Acción de esta tabla para más detalles.

Información adicional

Utilizando Excel o Google Sheets para preparar el archivo CSV

Al utilizar Excel/Google Sheets para crear un archivo CSV, las columnas de fecha y gasto deben tener el formato correcto antes de guardar el archivo como un archivo CSV. Después de guardar el archivo CSV, comprueba que el contenido tenga el formato correcto. Utiliza las siguientes pautas para:

  • Formatear las celdas de fecha.
  • Formatear las celdas de gasto.
  • Verificar el formato del contenido.

Formatear celdas de fecha

Para formatear celdas de fecha en Excel con el formato AAAA-MM-DD:

  1. Selecciona las celdas que se van a formatear.
  2. Haz clic derecho y luego selecciona Formato de celdas.
    Se abre la ventana de formato de celda.
    Formatdate..png
  3. Selecciona Personalizado.
  4. En el campo Tipo, ingresa AAAA-MM-DD
  5. Haz clic en Aceptar.
    Se aplica el formato a la fecha.

Formato de celdas de gasto

Excel suele dar formato a las celdas de valor con una coma para separar los miles, como se muestra en la figura. Este formato no es adecuado para archivos de Cost Import. 

mceclip1.png

Para formatear celdas de gasto sin un separador de coma de 1000: 

  1. Selecciona las celdas que se van a formatear.
  2. Haz clic derecho y luego selecciona Formato de celdas.
    Se abre la ventana de formato de celda.
  3. Selecciona Número.
    Formatnumbers.png
  4. Borra Usar separador de 1000 (,). 
  5. (Opcional) Establece el número de decimales. El valor predeterminado es 2. El máximo permitido es 5. 
  6. Haz clic en Aceptar.
    Las celdas se formatean correctamente.

Verificar el formato del contenido

Para verificar el formato del contenido:

  1. Utiliza un editor para ver el archivo. 
    • Windows: Notepad, Notepad++
    • macOS TextEdit
  2. Presta especial atención a lo siguiente:
    • Espacios en blanco: Asegúrate de que no haya espacios en blanco al principio o al final antes o después de las comas que separan los campos. En Excel, usa el comando @trim para eliminar los espacios en blanco.  
    • Fecha: Asegúrate de que las celdas de fecha tengan el formato AAAA-MM-DD. 
    • Gasto: Asegúrate de que no haya comas en las celdas de gasto.
    • Delimitadores: Deben ser comas. Si son punto y coma:
      • Esto puede ocurrir cuando la configuración regional de tu computadora está configurada en un idioma/región que no es inglés, especialmente alemán.
      • La solución difiere según el sistema operativo de tu ordenador (macOS o Windows).
      • Para resolver este problema, busca la guía más reciente de Microsoft u otros foros para encontrar una solución. Utiliza los siguientes términos de búsqueda: Sistema operativo (macOS o Windows) delimitador de cambios de Excel para archivos CSV.

A continuación se incluye una captura de pantalla del archivo CSV de ejemplo mostrado en un editor. 

mceclip1.png

Token para importación de correo electrónico

El token para la importación de correo electrónico se utiliza para verificar que el remitente del correo electrónico está autorizado para enviar el archivo de Cost Import.

Los tokens del anunciante y de la ad network son diferentes.

  • Token del anunciante:
    • El mismo token es válido para todas las aplicaciones de la cuenta.
    • Cualquier usuario de la cuenta puede obtener el token.
  • Token de ad network:
    • Se utiliza el mismo token para todos los anunciantes.

¡Los anunciantes y las ad networks no deben compartir sus tokens entre sí!

Permisos de Cost Import para ad networks

Las ad networks requieren permiso del anunciante por aplicación para acceder al Cost Import.

Para conceder a la ad network el permiso de Cost Import:

  1. En AppsFlyer, el anunciante debe ir al menú lateral y seleccionar Colaborar > Integraciones activas.
    Aparece la página de Partner Integrado.
  2. Selecciona el partner integrado.
  3. Ve a la pestaña Permisos
  4. Habilita los Permisos para ad networks si no lo están.
  5. (Opcional) Agrega usuarios de la cuenta.
  6. Habilita Usar Cost Import.
  7. Haz clic en Guardar permisos.

Solución de problemas, rasgos y limitaciones

Mensajes de error y soluciones

En la tabla siguiente se enumeran todos los posibles mensajes de error de importación de costos y las soluciones correspondientes. 

Mensaje de error Descripción Solución
Ninguno de los IDs de aplicación proporcionados en el archivo existe en AppsFlyer. Verifica la exactitud de los IDs de aplicación. El ID de aplicación no existe en la cuenta. Cambia el ID de aplicación y vuelve a enviarlo.
La línea [line name] tiene un número incorrecto de columnas. Se esperaban [number] columnas, se recibieron [number] columnas. Todas las columnas del archivo deben tener un valor. Cambia los valores rellenados en el archivo en función de los encabezados que hayas definido.
Falta 'media-source' en el encabezado del archivo.
  • Al encabezado del archivo le falta la fuente de medios.
  • El nombre de la columna debe ser exactamente como está en el esquema.
Agrega media-source como nombre de encabezado.
El archivo solo puede contener una fuente de medios. Múltiples fuentes de medios encontradas en el archivo: [number of media sources].  No se puede subir un archivo con más de una fuente de medios. Divide la subida en un archivo por cada fuente de medios.
El valor proporcionado [value] para [field] no es un valor válido para esta columna. El formato de los datos en la columna es incorrecto. Por ejemplo, la fecha es dd-mm-aa en lugar de aaaa-mm-dd. Corrige el formato y vuelve a enviarlo.  
Varias divisas identificadas para la aplicación. Por favor, utiliza una única divisa para cada aplicación en el archivo. Divisas encontradas: %number of currencies%. Solo se puede usar una divisa para cada aplicación. Utiliza una sola divisa en el upload y vuelve a enviarlo.
No se admiten las siguientes columnas en el encabezado del archivo: [file headers] El encabezado del archivo no coincide con el esquema. Es decir, el nombre de la columna debe ser exactamente como está en el esquema. Elimina las columnas no compatibles y vuelve a enviarlo.
Faltan columnas requeridas en el encabezado del archivo: [file headers] Al encabezado del archivo le falta una columna obligatoria. Agrega la columna que falta y sus valores y vuelve a enviarlo.
La aplicación contiene una fecha futura: [date] No se permiten fechas futuras. Corrige la fecha a la fecha actual o anterior, y vuelve a enviarlo.
El archivo está vacío. No hay datos que procesar. El archivo está vacío. Rellena los datos en el archivo y vuelve a enviarlo.
Las siguientes dos filas entran en conflicto debido a dimensiones idénticas. Proporciona una sola fila de gasto por conjunto de dimensiones. [conflicting rows] Hay más de una fila con los mismos campos clave (obligatorios). Elimina las filas duplicadas y vuelve e enviarlo.
El archivo solo puede contener datos de una sola cuenta de anunciante. Se encontraron diferentes anunciantes en el archivo: [advertiser names] Para los partners, una subida no puede ser para más de un anunciante. Divide la subida en un archivo por cada anunciante.
La aplicación [app ID] no existe en la cuenta. Verifica el ID de la aplicación. El ID de aplicación no existe. Corrige el ID de aplicación y vuelve a enviarlo.
No se encontró el código de geolocalización (país) para la aplicación [app ID]. Usa un código ISO 3166 de 2 letras La geolocalización no existe. Corrige la geolocalización y vuelve a enviarlo.
No se encontró el código de divisa de la aplicación [app ID]. Utiliza un código ISO 4217 de 3 letras. La divisa no existe. Cambia la divisa por una que sea válida y vuelve a enviarlo.
Hubo errores de validación para una o más aplicaciones en el archivo. Revisa la información del archivo para obtener más detalles. Hay más de un error en el archivo. Descarga el archivo y revisa los errores.
Hubo un error interno al procesar el archivo, intenta subirlo nuevamente.
  • Problema de backend al procesar el archivo.
  • Normalmente se trata de un problema temporal.
Espera 1 hora y vuelve a subirlo.

Rasgos y limitaciones

Característica Observaciones 
Ad networks

Compatible.

Excepciones:

  • Meta Ads
  • X Ads
  • ASA
Agencias
  • Las agencias no pueden subir datos. Pueden preparar sus archivos y enviarlos al anunciante para que los suban.
  • Para ello, los archivos CSV deben contener una columna Agencia con el nombre de la agencia (el nombre de la agencia es el valor del parámetro af_prt). Consulta el esquema CSV
Transparencia de agencia No es compatible
Zona horaria específica de la aplicación Compatible
Moneda específica de la aplicación  Compatible. Los costos de campaña se convierten a la divisa específica de la aplicación.
Nombre de la campaña El mismo nombre de campaña no se puede usar para varias aplicaciones, o el costo de una aplicación se aplicará a ambas.
Nombres de campo

Si los nombres de campo en la jerarquía de la campaña no coinciden con los nombres de campo tal como aparecen en los datos de atribución, se contabilizarán por separado. 

Por ejemplo, si los nombres de las campañas no coinciden, entonces aunque los IDs de campaña sean los mismos, se contabilizarán como campañas diferentes.

Tamaño del archivo Al cargar un archivo de importación de costos CSV, el límite de tamaño es:
  • A través del dashboard de AppsFlyer: 2 MB
  • Por correo electrónico: 5 MB por archivo
Datos orgánicos Compatible
Datos no orgánicos Compatible
Actualización de los datos Gasto publicitario
Datos históricos Compatible. Los costos reportados pueden revertirse y los datos corregidos enviarse en un plazo de hasta 90 días.
Retargeting No es compatible.
Acceso de usuario a la cuenta No está disponible para usuarios con restricciones de geolocalización o fuente de medios.