API InCost para redes de publicidad

Para:
Redes de publicidad
Última actualización:

En resumen: La API InCost, que forma parte de AppsFlyer ROI360, permite a las redes de publicidad enviar datos de costos publicitarios de manera programática a AppsFlyer. Al hacerlo, los anunciantes obtienen datos de costos agregados y comprenden el verdadero impacto de tu red.

Acerca de la API InCost

La API InCost es la solución óptima para que las redes de publicidad envíen datos de costos a AppsFlyer. Los partners de la red de publicidad envían datos detallados de los costos publicitarios a AppsFlyer mediante la API. AppsFlyer ingiere y procesa los datos, y los pone a disposición de los anunciantes y partners a través de paneles de control y reportes.

Ventajas

  • Ayuda a tus clientes a comprender el verdadero impacto de tu red con reportes de costos sin fricciones. Sin datos de costos, a tus clientes les falta una pieza crucial del rompecabezas de la medición y no pueden medir con precisión el ROAS. En consecuencia, pueden invertir erróneamente en otras fuentes de medios, lo que afectaría negativamente tus resultados.
  • Demuestra tu ROI con una solución que garantiza una medición de costos precisa, completa y en tiempo real.
  • La API InCost es rápida y sencilla de implementar, y el impacto es casi inmediato. También obtienes un control completo sobre cómo y cuándo envías los datos, incluida la capacidad de enviar datos de costos de hasta 90 días atrás.
  • La API InCost es compatible con todos los modelos de precios de campaña, no solo el CPI (que es el único modelo disponible cuando se envía el costo por clic).
  • Destácate en el Partner Marketplace de AppsFlyer con una insignia de "Costo" que indica que esta es una función que admites.

Implementación de la API InCost

Requisitos previos: Para cumplir los requisitos de la API InCost, tu red de publicidad requiere lo siguiente:

  • Que el 90 % de las campañas incluyan el ID de campaña en la atribución.
  • La capacidad de enviar datos al menos 6 veces al día para aumentar la actualización de los datos. Los horarios específicos dependen de la red de publicidad.
  • [Si la red de publicidad actualiza los datos con carácter retroactivo] La capacidad de enviar datos de los últimos 7 días cada vez, para una mayor exhaustividad de los datos.

Para implementar la API InCost y comenzar a enviar datos de costos a AppsFlyer:

  • Sigue los pasos de la tabla siguiente.
N.º de paso Acción 
1

Solicitar InCost:

  1. En AppsFlyer, en el menú superior, selecciona Ayuda > Contactar con nuestro equipo.
    Se abre el widget del asistente para partners.
  2. Selecciona Habilitación de la medición de costos y envía tu información.
    Una vez enviada, se abre un ticket y un ingeniero de soluciones para partners de AppsFlyer se pondrá en contacto contigo.
2 Asegúrate de que las jerarquías de campaña (ID de campaña y, opcionalmente, ID de conjunto de anuncios e ID de anuncio) se incluyan en los enlaces de atribución para más del 90 % de tu tráfico.
3

Obtén el token de API de AppsFlyer desde el panel de control de AppsFlyer.
4

Entrega el token de API a tu desarrollador para que lo use en el encabezado de autorización de API y pídele que siga sus instrucciones para implementar los 3 métodos de API:

  1. Obtener la lista de aplicaciones.
  2. Carga de InCost: dile al desarrollador qué campos del JSON debe rellenar:
    • Los campos obligatorios deben rellenarse. Es decir, no deben enviarse vacíos. 
    • La fuente de medios está restringida a las fuentes de medios asociadas a (registradas en) tu cuenta de red de publicidad. Obtén la lista de tu gerente de desarrollo de partners.
    • Ten en cuenta la zona horaria de la aplicación (reportada a través de la API Obtener lista de permisos de la aplicación) para alinear las fechas de los datos de costos con las de la aplicación.
    • Si hay campos que no forman parte de la jerarquía de reporte de costos de la campaña, no los incluyas. Por ejemplo, ID de conjunto de anuncios, nombre del recurso, ID de anuncio, nombre del anuncio.
  3. Obtener el estado del trabajo.
6

En el hilo del ticket (del paso 1), notifica a AppsFlyer que se completó la implementación de la API y espera a que confirmen que tu integración está operativa.
7

Asegúrate de que tus anunciantes habiliten la obtención de datos de costos en la pestaña de costos de su página de partner integrado de AppsFlyer. Luego comenzarán a recibir datos de costos.

Campos del JSON de carga de InCost

Campo

Obligatorio

Observaciones

date

Sí
  • Fecha del gasto
  • Formato: YYYY-MM-DD
  • Ejemplo:2019-12-30
app_id

Sí
  • El ID de la aplicación tal y como aparece en la plataforma de AppsFlyer.
  • Formato: cadena de hasta 250 caracteres.
  • Ejemplo: Android:com.app.name, iOS: id123456789

media_source

Sí
  • Nombre de la red (ID) que muestra el anuncio asociado con tu cuenta de partner de la red de publicidad en AppsFlyer.
  • Formato: cadena de 50 caracteres.
  • Ejemplo: network_int

af_prt

No*
  • Obligatorio para la atribución de agencia y los datos de costos.
  • Nombre de la agencia tal como se muestra en el enlace de atribución y está asociado con la cuenta de la agencia en AppsFlyer.
  • Formato: cadena de 50 caracteres.
  • Ejemplo: agencya

campaign_id

Sí
  • Debe ser idéntico al parámetro af_c_id enviado en el enlace de atribución.
  • No se permite una cadena vacía.
  • Formato: cadena de 24 caracteres.
  • Ejemplo: 123abc

campaign_name

Sí
  • Formato: cadena de 100 caracteres.
  • Ejemplo: my_campaign123

adset_id

 No*
  • Obligatorio si envías adset_name.
  • Debe ser idéntico al parámetro af_adset_id enviado en el enlace de atribución.
  • Si tus reportes de costos no admiten adset_id, no lo envíes.
  • Formato: cadena de 24 caracteres.
  • Ejemplo: 123A

adset_name

No
  • Si envías este campo, también debes enviar adset_id.
  • Formato: cadena de 100 caracteres.
  • Ejemplo:my_adset_name

ad_id

No*
  • Obligatorio si envías ad_name.
  • Este campo debe ser idéntico al parámetro af_ad_id enviado en el enlace de atribución.
  • Si tus reportes de costos no admiten adset_id, no lo envíes.
  • Formato: cadena de 24 caracteres.
  • Ejemplo: 123AB

site_id

No
  • ID único que identifica al publisher que muestra el anuncio.
  • Formato: cadena de 24 caracteres.

ad_name

No
  • Si envías este campo, también debes enviar ad_id.
  • Formato: cadena de 100 caracteres.
  • Ejemplo: Ad-name

geo

No
  • El país que registraste como asociado con el costo.
  • Siempre que sea posible, debe representar el país en el que se mostró el anuncio.
  • Formato: código de país ISO 3166 de 2 caracteres
  • Ejemplo:US, CN, ZA
currency

Sí
  • Tipo de divisa del gasto.
  • Formato: código de divisa ISO 4217 de 3 caracteres.
  • Ejemplo: USD, EUR, ZAR
spend Sí
  • Monto de gasto con la divisa especificada. 
  • Se permiten cinco dígitos después del punto decimal.
  • Se permite el valor 0 (cero).
  • NO se permiten valores negativos.
  • No envíes delimitadores ,.
  • No envíes valores entre comillas. 
  • Formato: número decimal
  • Valores de ejemplo: 1 1.2 1234.20
channel No
  • Debe ser idéntico al parámetro af_channel enviado en el enlace de atribución.
  • Formato: cadena de 20 caracteres.
  • Ejemplo: my_channel
keywords No
  • Formato: cadena de 100 caracteres.
  • Ejemplo: abc app

* Consulta la columna de observaciones, ya que en algunos casos debes enviar este campo.