Macros de postbacks para redes de publicidad

De un vistazo: Como una red de publicidad, 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 socios integrados:

Postbacks para redes de publicidad

  • Configuración de postbacks: Para solicitar cambios en tu configuración de postbacks, usa el widget del asistente para partners o comunícate con tu gerente de desarrollo de partners de AppsFlyer. 
  • Tipos de postbacks: 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 targeting.

Fuentes de datos de postbacks

Fuente Descripción
Parámetros de enlaces de atribución

Los parámetros proporcionados por el socio 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 socio

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 targeting 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: Después de ser procesado por 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 instalar, 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).

Macro: 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 ID de dispositivo que el usuario puede restablecer, también conocido como ID de publicidad de Google (GAID). También disponible como: (sha1-advertiserId)  
app_name SDK Nombre de la aplicación configurado por el anunciante  
appsflyer_id SDK Identificador único de AppsFlyer registrado tras la conversión  
attributed_touch_type SDK No Valores posibles: clic, impresión, TV, preinstalación  
blocked_reason AF No Motivo de las reglas de validación/fraude No Rechazado
blocked_reason_value AF No Valor del motivo de las reglas de validación/fraude (como ID de sitio) No Rechazado
blocked_sub_reason AF No Submotivo de las reglas de validación/fraude No Rechazado
bundle_id SDK iOS: Identificación para coincidir con una sola aplicación o un grupo de aplicaciones en iOS (consultar el ID de paquete del desarrollador de Apple). Android: El nombre de la aplicación.  
country_code AF Código de país con ISO 3166 (alpha-2) Ejemplo: US, CN.  
event_name SDK Nombre asignado a un evento No In-app
event_revenue_USD AF Valor del evento en USD No In-app
event_revenue SDK Valor de evento reportado por SDK usando event_revenue_currency o la divisa que has seleccionado. No In-app
event_revenue
_currency
SDK El código de divisa del ingreso del evento reportado en el evento o la divisa que has seleccionado. No In-app
event_time SDK Hora del evento No In-app
event_value SDK 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 ID de publicidad que el usuario puede restablecer y que se encuentra en dispositivos iOS. También disponible como: (sha1-idfa)  
idfv SDK Identificador único por usuario y por proveedor en los dispositivos iOS  
install_time SDK Marca de tiempo de instalación  
install_unix_ts SDK Marca de tiempo de instalación en formato unix  
is_attributed AF Indicador que marca si la instalación o el evento se atribuye a esta fuente de medios  
is_lat SDK Rastreo de anuncios limitado (LAT): iOS: A partir del iOS 14, Apple ha dejado de utilizar LAT. Determinar el estado de privacidad del usuario mediante ATT. En este caso, ignorar is_lat. Antes de iOS 14, si es verdadero, el IDFA no está disponible y está configurado en 0. Android: si es verdadero, el usuario eligió la exclusión opcional para los anuncios basados en intereses. Esto no impide que se recopile el ID de publicidad de Google (GAID).  
is_primary_attribution AF

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 Idioma (configuración regional) reportado por el dispositivo y establecido por el sistema operativo del dispositivo.  
oaid SDK ID que el usuario puede restablecer en algunos dispositivos Android, usualmente es una alternativa al ID de publicidad de Google (GAID)  
partner_event_id AF Nombre/ID del evento correspondiente en la plataforma del partner No In-app
platform SDK Plataforma del dispositivo: iOS, Android o Windows Mobile  
retargeting_
conversion_type
AF No Un indicador que marca si se trata de una reatribución o un re-engagement Solo retargeting  
app_version SDK Nombre de versión de la aplicación configurado por el desarrollador en el código de la aplicación  
app_id SDK El ID de la aplicación tal como lo reporta la aplicación   
att-0-1 SDK

Valores posibles:

  • 1: El estado de la ATT es authorized o af_authorized.
  • 0: Cualquier otro estado de la ATT. 
 
att-status SDK

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

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

 
af_ad Link No

Nombre de anuncio (ver más): provisto por el anunciante/publisher.

af_ad_id Link No

Proporcionado por el anunciante/publisher.

af_adset Enlace No
  • Proporcionado por el anunciante/publisher.
  • El conjunto de anuncios representa un nivel intermedio en la jerarquía entre campaña y anuncio. Ver más
af_adset_id Enlace No Proporcionado por el anunciante/publisher.
C Enlace No Proporcionado por el anunciante/publisher. Los nombres de campaña que superan los 100–caracteres de longitud se muestran en el panel de control como "c_name_exceeded_max_length".
af_c_id Enlace No Proporcionado por el anunciante/publisher.
af_siteid Enlace No
af_subsite_id Enlace No
  • ID de anunciante/subred de publicidad. 
  • Si además del publisher principal (ID de sitio), hay un subpublisher o deseas incluir información adicional, como el tipo/ubicación de anuncio dentro de la aplicación, como banner, intersticial, video, etc., usa af_sub_siteid. Por ejemplo: af_sub_siteid =ABCD_4567
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
imei SDK

Un número único utilizado para identificar teléfonos móviles.

 

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 del evento: 120,00
  • Divisa 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