Macros de postbacks para ad networks

Para:
Marketers Redes de publicidad
Última actualización:

En resumen: Como una ad network, puedes definir el contenido y los puntos de conexión de los postbacks que se te envían como parte de tu integración con AppsFlyer. Los postbacks se relacionan con el engagement del usuario de la aplicación, como instalaciones, eventos in-app, re-engagements, etc.

Guías relacionadas de postback de partners integrados:

Postbacks para ad networks

  • Configuración de postback: Para solicitar cambios en tu configuración de postbacks, usa el widget del asistente para partners o contacta con tu gerente de desarrollo de partners de AppsFlyer. 
  • Tipos de postback: Los postbacks están disponibles para los eventos in-app e instalaciones y los eventos in-app e instalaciones bloqueadas debido al fraude identificado por Protect360 o a la violación de las reglas de validación de segmentación.

Fuentes de datos de postbacks

Fuente Descripción
Parámetros del enlace de atribución

Los parámetros proporcionados por el partner en las URL de impresiones o clics

Ejemplo: parámetro de ID de clic en el enlace de atribución "&click_id=CLICK_ID".
ID de partner en AppsFlyer

IDs únicos proporcionados al anunciante por parte del partner

Ejemplos: ID de aplicación, ID de cuenta, ID de usuario, ID de red.
Información derivada del SDK

Información extraída del dispositivo por el SDK de AppsFlyer.

Ejemplo: los IDs de dispositivos iOS pueden extraerse utilizando "&IDFA=(idfa)" en el postback.
Derivado de la plataforma de AppsFlyer Información derivada de la plataforma de AppsFlyer.  
Protect360 y reglas de validación Información sobre instalaciones identificadas como fraude e instalaciones que violan las reglas de segmentación de la campaña y sus eventos in-app asociados.

Macros de postbacks

Cuando se incluyen en un postback, las macros se sustituyen por datos relevantes para el usuario. Por ejemplo, para obtener la dirección IP del usuario que instala la aplicación, incluye country_code=(ip) en la estructura del postback.  Las macros admitidas se enumeran en la siguiente tabla:

Las columnas de la tabla a continuación tienen el siguiente significado:

  • Fuente: De dónde proceden los datos.
    • Enlace: Enlaces de atribución
    • SDK: El SDK de AppsFlyer incorporado en la aplicación o la API de servidor a servidor
    • AF: Tras el procesamiento por parte de AppsFlyer.
  • Enviar todo:  En caso afirmativo, puedes recibir los datos sobre instalaciones y eventos atribuidos a otras redes u orgánicos (es decir, los no atribuidos a ti).
  • [Base] Macros para todos los postbacks Macros relevantes para la instalación, eventos in-app y postbacks de eventos rechazados
  • [Opcional] para eventos in-app y eventos rechazados como se indica en la columna (rechazado, in-app).

Macros: instalaciones, eventos in-app y eventos rechazados

Macro de postback (nombre) Fuente Enviar todo Descripción [Base] Macros para todos los postbacks [Opcional] Eventos rechazados in-app
advertising_id SDK Sí ID del dispositivo que puede ser restablecido por el usuario, también conocido como GAID. También disponible como: (sha1-advertiserId) Sí  
af_ad ENLACE No Nombre del anuncio (ver más) proporcionado por el anunciante/publisher Sí Sí
af_ad_id ENLACE No Proporcionado por el anunciante/publisher Sí Sí
af_ad_type Enlace No Usa la siguiente convención de nomenclatura:
  • text: una unidad de anuncio que contiene solo texto, por ejemplo, un resultado de búsqueda.
  • banner: un formato básico que aparece en la parte superior o inferior de la pantalla del dispositivo.
  • interstitial: un anuncio de página completa que aparece durante los descansos en la experiencia actual.
  • video: un video estándar, es decir, no recompensado.
  • rewarded_video: una unidad de anuncio que ofrece recompensas in-app a cambio de ver un video.
  • playable: una unidad de anuncio que contiene una vista previa interactiva de la experiencia de la aplicación.
  • sponsored_content: un enlace incluido en una pieza de contenido patrocinado, como un artículo publicitario
  • audio: un anuncio de audio.
 Sí Sí
af_adset Enlace No
  • Proporcionado por el anunciante/publisher.
  • El conjunto de anuncios es un nivel intermedio en la jerarquía entre Campaña y Anuncio. Ver más
Sí Sí
af_adset_id Enlace No Proporcionado por el anunciante/publisher Sí Sí
af_c_id Enlace No Proporcionado por el anunciante/publisher Sí Sí
af_siteid Enlace No
  • ID único que identifica al publisher que muestra el anuncio. Saber más
Sí Sí
af_subsite_id Enlace No
  • ID de subred publicitaria/ID del publisher.
  • Si, además del editor principal (ID del sitio), hay un subeditor o deseas incluir información adicional, como tipo de anuncio/ubicación dentro de la aplicación, como banner, intersticial, vídeo, etc., utiliza af_sub_siteid. Por ejemplo: af_sub_siteid =ABCD_4567
 Sí Sí
af_validated AF Sí Indica si la compra fue validada con éxito. Valores posibles: verdadero o falso. Sí  
af_validation_type AF Sí Indica el tipo de validación realizada. Valores posibles: roi360_purchase, roi360_subscription o Básico. Sí  
app_id SDK Sí El ID de la aplicación tal como lo reporta la aplicación   Sí  
app_name SDK Sí Nombre de la aplicación configurado por el anunciante Sí  
app_version SDK Sí Nombre de versión de la aplicación configurado por el desarrollador en el código de la aplicación Sí  
appsflyer_id SDK Sí Identificador único de AppsFlyer registrado tras la conversión Sí  
att-0-1 SDK Sí Posibles valores:
  • 1: El estado de la ATT es authorized o af_authorized.
  • 0: Cualquier otro estado de la ATT.  
 Sí  
att-status SDK Sí

El estado de la ATT reportado por iOS. Como authorized, not_determined.  

En algunos casos no hay ningún valor y se devuelve "".  

 Sí  
attributed_touch_type SDK No Valores posibles: click, impression, TV, pre-install Sí  
blocked_reason AF No Motivo de las reglas de validación/fraude No Rejected
blocked_reason_value AF No Valor del motivo de las reglas de validación/fraude (como ID de sitio) No Rejected
blocked_sub_reason AF No Submotivo de las reglas de validación/fraude No Rejected
bundle_id SDK Sí iOS: Identificación para hacer coincidir una sola aplicación o un grupo de aplicaciones en iOS (consulta el ID del paquete del desarrollador de Apple) Android: Nombre de la aplicación Sí  
c Enlace No Proporcionado por el anunciante/publisher. Los nombres de campaña que superan los 100 caracteres de longitud se muestran en el dashboard como “c_name_exceeded_max_length” Sí Sí
country_code AF Sí Código de país con ISO 3166 (alfa-2) Ejemplo: US, CN. Sí  
event_name SDK Sí Nombre asignado a un evento No In-app
event_revenue SDK Sí Valor de evento reportado por SDK usando event_revenue_currency o la divisa que has seleccionado. No In-app
event_revenue
_moneda		 SDK Sí El código de divisa del ingreso del evento reportado en el evento o la divisa que has seleccionado. No In-app
event_revenue_USD AF Sí Valor del evento en USD No In-app
event_time SDK Sí Hora del evento No In-app
event_value SDK Sí El evento in-app incluye atributos con valores, que se pueden enviar por completo en el postback en formato JSON. URL codificada mediante la macro (encode). No In-app
idfa SDK Sí ID de publicidad que el usuario puede restablecer y que se encuentra en dispositivos iOS. También disponible como: (sha1-idfa) Sí  
idfv SDK Sí Identificador único por usuario y por proveedor en los dispositivos iOS Sí  
imei SDK Sí Un número único utilizado para identificar teléfonos móviles Sí  
install_time SDK Sí Marca de tiempo de instalación Sí  
install_unix_ts SDK Sí Marca de tiempo de instalación en formato unix Sí  
is_attributed AF Sí Indicador que marca si la instalación o el evento se atribuye a esta fuente de medios Sí  
is_contrib AF Sí Indica si la ad network estuvo entre los 3 principales contribuyentes a una instalación.
  • Si la ad network no ganó la atribución pero está entre los 3 principales contribuyentes, is_contrib=1.
  • Si la ad network ganó la atribución, is_contrib=0.
  • Si la ad network no está entre los 3 principales contribuyentes, is_contrib=0.
 Sí  
is_lat SDK Sí Limit ad tracking (LAT): iOS: Desde iOS 14, Apple retiró LAT. Determina el estado de privacidad del usuario usando ATT. En este caso, ignora is_lat. Antes de iOS 14, si es verdadero, el IDFA no está disponible y se establece en 0. Android: Cuando es verdadero, el usuario ha optado por no participar en anuncios basados en intereses. Esto no impide que se recopile el ID de publicidad de Google (GAID). Sí  
is_organic AF Sí

Si se envía un postback de instalación para todas las fuentes de medios, incluyendo orgánico, entonces la ad network recibirá una indicación de si una instalación fue orgánica o no orgánica.

 

 Se instala el  
is_primary_attribution AF Sí Cuando es falso, consulta is_retargeting. No In-app
is_retargeting Enlace No

Se debe usar conjuntamente con is_primary_attribution. Obtén más información sobre la doble atribución de los eventos de retargeting.

Si es verdadero (1), el evento se reporta como parte de una campaña de retargeting y la fuente de medios es la fuente de medios de retargeting.

Si es falso (0) y is_primary_attribution es falso, el evento es parte de una campaña de retargeting, pero la fuente de medios a la que se hace referencia es la fuente de medios de atribución del usuario.

 

 No  
language SDK Sí Idioma (configuración regional) reportado por el dispositivo y establecido por el sistema operativo del dispositivo. Sí  
oaid SDK Sí ID que el usuario puede restablecer en algunos dispositivos Android, generalmente como alternativa a GAID Sí  
partner_event_id AF Sí Nombre/ID del evento correspondiente en la plataforma del partner No In-app
platform SDK Sí Plataforma del dispositivo: iOS, Android o Windows Mobile Sí  
retargeting_conversion_type AF No Un indicador que marca si se trata de una reatribución o un re-engagement Solo retargeting  

Macros solo para eventos in-app

Los ejemplos a continuación se relacionan con los postbacks de eventos in-app disponibles para los partners.

Ejemplo

La plantilla de postback de evento "&event=(event)&json=(encode)" se tradujo al siguiente postback para un evento af_purchase específico:

&event=af_purchase&json=%7B%22af_quantity%22%3A1%2C%22
af_revenue%22%3A%2212000%22%2C%22af_currency%22%3A%
22USD%22%2C%22af_content_id%22%3A%221107%22%2C%22
af_content_type%22%3A%22default_type%22%7D%0A

El valor JSON decodificado de este postback es

{"af_quantity":1,"af_revenue":"12000","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}


Valores codificados

Es posible que los postbacks incluyan caracteres irregulares no alfanuméricos. Para transferir estos valores correctamente a través de postbacks, la URL de AppsFlyer codifica valores no alfanuméricos.

Para decodificar o codificar un postback usa un servicio web de codificación. 

Postbacks de muestra

Ejemplos de postbacks de instalación generales

Android iOS 
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)

Ejemplos de postbacks de eventos in-app generales

Android iOS 
http://YourCompanyDomain.com?site_id=(publisher_id)&
device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android_id)&
install_time=(install_unix_ts)&event_name=(event_name)&currency=(currency)&
json=(event_value)

 Ejemplo de postbacks de eventos in-app

Parámetros de evento:

  • Nombre del evento: af_revenue
  • Ingresos por evento: 120.00
  • Moneda del evento: USD
  • Valor del evento: {"af_quantity":1,"af_revenue":"120","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

Postback:

http://YourCompanyDomain.com?clickid=8594845&site_id=click123&device_ip=
38.166.144.142&advertising_id=121sxxxx-xxxx-xxxx-xxxx-52454bd7500b&
android_id=9aaeecc4455xxxxx&;install_time=1451923560&event_name=af_purchase&
currency=USD&revenue=120.00&json=%7B%22af_quantity%22%3A1%2C%22 />af_revenue
%22%3A%22120.10%22%2C%22af_currency%22%3A%22USD%22%2C%22af_content_id
%22%3A%221107%22%2C%22af_content_type%22%3A%22default_type%22%7D%0A