Guía de importación de costos

El formato de archivo CSV de gastos publicitarios, el esquema y las reglas de validación se detallan aquí. Si usas Excel o Google Sheets para crear el archivo, lee las instrucciones sobre el formato de Excel. 

Ver archivo de muestra

Antes de seguir leyendo, tome nota de los errores más comunes que se cometen al preparar el archivo CSV, como se muestra en la siguiente captura de pantalla. 

El formato de archivo CSV de gastos publicitarios, el esquema y las reglas de validación se detallan en las siguientes secciones. Si usas Excel o Google Sheets para crear el archivo, lee las instrucciones sobre el formato de Excel.

Reglas de contenido y esquema de los archivos CSV de gastos publicitarios

Esquema CSV de gastos publicitarios

El token de gasto publicitario se utiliza para verificar que el remitente del correo electrónico está autorizado para enviar el archivo de importación de costos. Los tokens del anunciante y de la red publicitaria son diferentes.

• Token del anunciante:
  • El mismo token es válido para todas las aplicaciones de la cuenta.
  • Cualquier usuario de la cuenta puede recuperar el token de gastos publicitarios
• Token de red de publicidad:
  • El mismo token se usa para todos los anunciantes.
  • Además, el anunciante debe conceder permiso a la red publicitaria para enviar archivos de importación. 

Para recuperar el token de gastos publicitarios:

1. En AppsFlyer, en el menú lateral, selecciona Configuración > Importación de costos.
2. En la parte superior derecha de la página, haz clic en Ver token de gastos publicitarios.
   Se mostrará el token de gastos publicitarios.  
3. Copia y guarda el token.

Para conceder a la red publicitaria el permiso de importación de costes:

1. En AppsFlyer, el anunciante debe ir al menú lateral y seleccionar Colaborar > Integraciones activas. 
   Aparece la página Partner Integrado.
2. Selecciona un partner integrado.
3. Ve a la pestaña Permisos. 
   
4. Habilita los Permisos para redes de publicidad si no lo están.
5. (Opcional) Agrega usuarios de la cuenta.
6. Habilita Permitir importación de gastos.
   

Requisitos previos del correo electrónico:

• Anunciantes:
  • Se requiere un token de inversión publicitaria.
  • El correo electrónico del remitente debe ser de un usuario registrado de AppsFlyer.
• Redes publicitarias:
  
  • Se requiere un token de inversión publicitaria.
  • El correo electrónico del remitente debe ser de un usuario registrado de AppsFlyer.
  • El anunciante debe conceder al partner (red publicitaria) el permiso de importación de costos. 

Para enviar el archivo de gastos publicitarios por correo electrónico:

1. Completa los campos del correo electrónico:  
   • Para:adspend-upload@appsflyer.com
   • CC: Usuarios que deben recibir una copia de los comentarios automáticos
   • Asunto: Pega el token de gasto publicitario en el campo «asunto». 
   • Archivo adjunto: CSV con los datos.
2. Envía el correo electrónico.
   • Al finalizar el procesamiento, se envía un correo electrónico de estado que resume el upload y detalla los 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. Cuando se identifiquen errores, se deben tomar medidas correctivas. Nota: Si no has recibido el correo de estado, consulta aquí.
   • Puedes ver el estado de los archivos enviados en la página de Importación de Costo

Para subir el archivo de gasto publicitario:

1. En AppsFlyer, en el menú lateral, selecciona Configuración > Importar costos.
   Aparece la página de Importación de costos. 
2. Haz clic en + importar archivo de gasto publicitario
   Se abre la ventana Importar gasto publicitario.
   
3. Arrastra el archivo CSV a la ventana de importación del archivo.
   Se muestra el mensaje Procesando archivo.
4. Si aparece un mensaje de error durante la carga: Corrígelo y repite los pasos correspondientes. 
5. Se abre la ventana Importación de costos: 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!
7. Haz clic en importar otro archivo o en Listo.

Para ver el estado de importación a nivel de archivo:

• En AppsFlyer, en el menú lateral, selecciona Configuración > Importación de costos.
  La página Importación de Costos muestra la lista de archivos cargados.
• Si tienes permisos de aplicación para todas las aplicaciones contenidas en el archivo, usa el comando Acción para:
  
  • Descargar archivo CSV: Esta es una copia del archivo CSV que se cargó.
  • Descargar reporte sin coincidencias para todas las aplicaciones en el archivo.

Para ver el estado de importación en el nivel de aplicación:

• Selecciona el archivo.
  Se muestra la página de nivel de aplicación. Se muestra la lista de aplicaciones en el archivo de gastos publicitarios.

  

• Realice acciones a nivel de archivo o a nivel de aplicación como se describe aquí.
• Nivel de archivo: Si tienes permisos de aplicación para todas las aplicaciones contenidas en el archivo, puedes usar los controles en la parte superior derecha de la página para: 
  • Revertir (cancelar) la importación de costos de todas las aplicaciones del archivo. 
  • Descargar una copia del archivo CSV que se envió. 
• Nivel de aplicación: Si tienes permiso de aplicación para una aplicación específica, puedes hacerlo mediante el comando Acción:
  • Descargar datos de la aplicación.
  • Descargar informe sin coincidencias para la aplicación.
  • Revertir(cancelar) la importación de costo de la aplicación seleccionada. 

La coincidencia de filas es el proceso en el que el mecanismo de importación hace coincidir las filas de gasto publicitario notificadas por la importación con los datos de atribución registrados en el dashboard. Esto se hace usando todas las dimensiones disponibles en el esquema del archivo, como fuente de medios, campaña, conjunto de anuncios, anuncio, etc. Si todas coinciden, las filas se designan como is-matching=TRUE. 

Nombres vs ID

La importación de costos identifica una dimensión, como una campaña, un conjunto de anuncios o un anuncio por su nombre, sin el ID. Actualmente, la importación de costos no admite reportes de gastos utilizando solo identificadores.

Nota: Independientemente de la coincidencia del estado, se registra el gasto.

El porcentaje de filas coincidentes se muestra en la página de importación.

Si las filas no coincidentes son inesperadas, descarga el informe sin coincidencias para investigar la causa. Si es necesario, cancela la importación revirtiéndola.

El reporte sin coincidencias contiene una columna, is-matched, que puede tener un valor de filas TRUE (con coincidencias) o FALSE (sin coincidencias).

Página Importación de Costos que muestra el porcentaje de filas coincidentes

La inversión publicitaria importada anteriormente se puede sobrescribir mediante archivos CSV que contienen datos con la misma clave de datos importados anteriormente.

La clave se forma a partir de los campos de fecha, fuente de medios y campaña. Si las claves coinciden, los datos importados por última vez sobrescriben los datos importados anteriormente.

Los siguientes ejemplos ilustran la sobrescritura del gasto publicitario.

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

Síntoma 1: Los datos de costos no se muestran después de una importación correcta

1. En el panel de control, comprueba si el nombre de la campaña se muestra más de una vez.
2. Si es así, busca la fila en la que el ID de campaña está en blanco.
   La fila con el ID de campaña en blanco contiene el costo. 

Síntoma 2: El costo importado se muestra en una (fila adicional) separada sin datos de rendimiento (instalaciones) . El ID de campaña de la fila está en blanco.

Causa: Cuando tanto el ID de la campaña como el nombre de la campaña existen en los datos de atribución, el CSV debe contener ambos para que AppsFlyer coincida correctamente con los datos de costos y evite líneas de pedido separadas.

Al usar 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. Utiliza los siguientes procedimientos para dar formato correctamente a los campos de fecha y gasto. 

Después de guardar el archivo CSV, comprueba que el contenido tenga el formato correcto. Nota: No utilices Excel para hacer la verificación, utiliza un editor. 

Formatear celdas de fecha en Excel

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 con el botón derecho y selecciona Formato de celda.
   Se abre la ventana de formato de celda.
   

   

3. Selecciona Personalizado.
4. En el campo Tipo, ingresa AAAA-MM-DD
5. Haz clic en Aceptar.
   Se aplica el formato a la fecha.

Formatear celdas de gastos en Excel

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 los archivos de importación de gasto publicitario. 

Puedes corregir esto formateando las celdas en Excel. 

Para formatear los montos de gasto sin un separador de 1000:  

1. Selecciona las celdas que se van a formatear.
2. Haz clic con el botón derecho y selecciona Formato de celda.
   Se abre la ventana de formato de celda.
3. Selecciona Número.
   

   

1. Borra Usar separador de 1000 (,). 
2. (Opcional) Establece el número de decimales. El valor predeterminado es 2. El máximo permitido es 5. 
3. Haz clic en Aceptar.
   Las celdas se formatean correctamente.

Para examinar el contenido del archivo CSV, usa un editor.  

• Windows: Notepad, Notepad++
• macOS: TextEdit

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

Vista del editor

Usando un editor, examina el archivo CSV. 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 el campo fecha tenga el formato YYYY-MM-DD. 
• Gasto: Asegúrate de que no haya ninguna coma en el campo gasto.
  

   

Si Excel crea un archivo CSV con un punto y coma ";" u otro carácter como delimitador, pero no una coma:

• Esto ocurre cuando la configuración regional de tu computadora se establece en un idioma/región que no es el inglés.
• Este tema es particularmente frecuente cuando se selecciona alemán en la configuración regional.
• La solución difiere según el sistema operativo de tu computadora (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.

Probablemente significa que el archivo de gastos publicitarios no fue procesado. Puede suceder por una variedad de razones:

Tipo de contenido incorrecto

AppsFlyer solo procesa los mensajes con el multipart/mixed tipo de contenido. Otros tipos no se procesan y en consecuencia no se genera ni se envía ningún correo electrónico de estado. En un caso normal, los correos electrónicos con archivos adjuntos son configurados automáticamente por multipart/mixed por el cliente de correo.

Para asegurarte de que el tipo de contenido del mensaje del correo electrónico es multipart/mixed, consulta el tipo de contenido en el encabezado del correo.

• Para ver el encabezado del mensaje de correo electrónico en Gmail sigue la documentación de Gmail.
• Para ver el encabezado del mensaje de correo electrónico en Outlook, sigue la documentación de Outlook.

El mensaje de correo electrónico HTML no está correctamente formateado

Los errores HTML pueden impedir el correcto procesamiento del correo electrónico. Por ejemplo, la etiqueta está vacía o falta. Revisa tu script para ver si hay errores HTML.

Los anunciantes y las agencias pueden preparar archivos CSV para cargar e importar datos de costos. 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

Ten en cuenta lo siguiente:

• 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.