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 | Sí | ID de dispositivo que el usuario puede restablecer, también conocido como ID de publicidad de Google (GAID). También disponible como: (sha1-advertiserId) | Sí | |
app_name | SDK | Sí | Nombre de la aplicación configurado por el anunciante | Sí | |
appsflyer_id | SDK | Sí | Identificador único de AppsFlyer registrado tras la conversión | Sí | |
attributed_touch_type | SDK | No | Valores posibles: clic, impresión, TV, preinstalación | Sí | |
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 | Sí | 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. | Sí | |
country_code | AF | Sí | Código de país con ISO 3166 (alpha-2) Ejemplo: US, CN. | Sí | |
event_name | SDK | Sí | Nombre asignado a un evento | No | In-app |
event_revenue_USD | AF | Sí | Valor del evento en USD | 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 _currency |
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_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í | |
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_lat | SDK | Sí | 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). | Sí | |
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, usualmente es una alternativa al ID de publicidad de Google (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 | |
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í | |
app_id | SDK | Sí | El ID de la aplicación tal como lo reporta la aplicación | Sí | |
att-0-1 | SDK | Sí |
Valores posibles:
|
Sí | |
att-status | SDK | Sí |
El estado de la ATT informado por iOS. Como authorized, not_determined. En algunos casos no hay ningún valor y se devuelve "". |
Sí | |
af_ad | Link | No |
Nombre de anuncio (ver más): provisto por el anunciante/publisher. |
Sí | Sí |
af_ad_id | Link | No |
Proporcionado por el anunciante/publisher. |
Sí | Sí |
af_adset | Enlace | No |
|
Sí | Sí |
af_adset_id | Enlace | No | Proporcionado por el anunciante/publisher. | Sí | 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 panel de control como "c_name_exceeded_max_length". | Sí | Sí |
af_c_id | Enlace | No | Proporcionado por el anunciante/publisher. | Sí | Sí |
af_siteid | Enlace | No |
|
Sí | Sí |
af_subsite_id | Enlace | No |
|
Sí | Sí |
af_ad_type | Enlace | No |
Usa la siguiente convención de nomenclatura:
|
Sí | Sí |
imei | SDK | Sí |
Un número único utilizado para identificar teléfonos móviles. |
Sí |
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
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)
http://YourCompanyDomain.com?&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install_unix_ts)
Ejemplos de postbacks de eventos in-app generales
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)¤cy=(currency)&
json=(event_value)
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&idfa=(idfa)&install_time=(install_unix_ts)
&event_name=(event_name)¤cy=(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