Macros de postbacks para ad networks

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). (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_anuncio	ENLACE	No	Nombre del anuncio (ver más) proporcionado por el anunciante/publisher	Sí	Sí
id_del_anuncio_af	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_conjunto de anuncios	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í
id_aplicación	SDK	Sí	El ID de la aplicación tal como lo reporta la aplicación	Sí
nombre_aplicación	SDK	Sí	Nombre de la aplicación configurado por el anunciante	Sí
version_app	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í
tipo_táctil_atribuido	SDK	No	Valores posibles: click, impression, TV, pre-install	Sí
razón_bloqueo	AF	No	Motivo de las reglas de validación/fraude	No	Rechazado
valor_del_motivo_bloqueado	AF	No	Valor del motivo de las reglas de validación/fraude (como ID de sitio)	No	Rechazado
submotivo_bloqueado	AF	No	Submotivo de las reglas de validación/fraude	No	Rechazado
id_paquete	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í
código_de_país	AF	Sí	Código de país con ISO 3166 (alfa-2) Ejemplo: US, CN.	Sí
nombre_del_evento	SDK	Sí	Nombre asignado a un evento	No	Dentro de la aplicación
ingresos_evento	SDK	Sí	Valor de evento reportado por SDK usando event_revenue_currency o la divisa que has seleccionado.	No	Dentro de la aplicación
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	Dentro de la aplicación
event_revenue_USD	AF	Sí	Valor del evento en USD	No	Dentro de la aplicación
event_time	SDK	Sí	Hora del evento	No	Dentro de la aplicación
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	Dentro de la aplicación
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í
hora_de_instalación	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í
es_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í
es_orgánico	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.	Solo instalaciones
es_atribución_primaria	AF	Sí	Cuando es falso, consulta is_retargeting.	No	Dentro de la aplicación
es_reinstalación	AF	Se instala el	Si es verdadero, el evento se reporta como una reinstalación.
es_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
Indicador de atribución AF	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	Dentro de la aplicación
Identificador de origen	SDK	Sí	Plataforma del dispositivo: iOS, Android o Windows Mobile	Sí
tipo_conversion_retargeting	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

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)&currency=(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)&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

This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.

How can we help?

Búsqueda