Configuración de postbacks de eventos in-app

Para:

Marketers Desarrolladores

Última actualización: 16 de enero de 2024 11:41

De un vistazo: Mide el engagement en la aplicación y la calidad de tus usuarios, y optimiza las campañas utilizando datos de eventos in-app.

Resumen general

Los eventos in-app permiten a los marketers medir el engagement en la aplicación y la calidad del usuario desde diferentes fuentes y desarrollar una estrategia de adquisición de usuarios adecuada. Las redes de publicidad utilizan la información de los eventos in-app para optimizar las campañas y ejecutar campañas de costo por acción/eventos. Las redes de publicidad reciben datos sobre eventos in-app a través de postbacks, que se envían en tiempo real. Aprender más sobre los eventos in-app enriquecidos.

Selección de eventos in-app de postback

Los marketers pueden seleccionar para qué eventos in-app quieren enviar postbacks a las redes de publicidad, utilizando la configuración descrita en este artículo.

Nota

Los eventos in-app incluyen los eventos rechazados, es decir, los eventos in-app bloqueados por Protect360 o eventos que no cumplen con las reglas de validación de destino.
Si la sección Postbacks de eventos in-app no existe en la pestaña Integración, significa que el partner aún no ha configurado el registro de eventos in-app con AppsFlyer en su configuración preliminar. El partner puede comunicarse con AppsFlyer usando el widget del asistente para partners para finalizar la integración.

Ventana de postbacks de eventos in-app

La ventana de postback de eventos in-app permite a los marketers que trabajan con redes según el CPA (costo por acción) configurar ventanas posteriores a la conversión, después de las cuales ya no se envían los postbacks de eventos.

Por ejemplo, si se cobra por los eventos que ocurren dentro de los 15 días siguientes a la instalación de un usuario, establece la ventana de la siguiente manera:

Los postbacks después de este período no se envían y no se notifica a la red, pero los eventos aún se registran en AppsFlyer y se atribuyen a la red.

Los postbacks siempre se envían en función de la configuración de la ventana actual. Mira el siguiente ejemplo:

1 de enero	La ventana es de 15 días. Un usuario instala una aplicación.
2 de enero	La ventana cambia a 10 días.
14 de enero	El usuario realiza una compra. El postback no se envía a la red de publicidad porque el evento no se encuentra dentro de la ventana actual (10 días).
15 de enero	La ventana cambia a 20 días.
18 de enero	El usuario realiza otra compra. Esta vez se envía el postback, ya que el evento se encuentra dentro de la ventana actual (20 días).

Ventana de postback por defecto

Al empezar a configurar postbacks de eventos in-app, la ventana predeterminada se establece automáticamente en seis meses.

Nota

Si comenzaste a usar postbacks de eventos in-app con un partner específico antes del 30 de julio de 2019, la configuración predeterminada para la ventana es Tiempo de vida. Esto significa que siempre se envían los postbacks de eventos in-app.

Quién puede configurar ventanas de postback

Marketers
Agencias, si se les otorga el permiso Permitir configurar postbacks de eventos in-app.
Nota: Un marketer y una agencia que trabajen con la misma red de publicidad pueden configurar las ventanas de postback por separado entre sí, según su contrato con la red.
Si se les da el permiso Permitir configurar postbacks de eventos in-app.

Asignación de eventos

Cada marketer puede dar un nombre diferente a un evento del mismo tipo. Dichos nombres de eventos también pueden diferir de los nombres de los partners.

Por ejemplo, cuando un usuario compra algo a través de una aplicación, un marketer puede llamarlo purchase o un ID menos informativo, como event5, y un partner puede llamarlo purchase_event.

Para asegurarte de que los eventos del anunciante coincidan con los mismos eventos que los partners, se deben asignar los nombres de los eventos.

Nota

Los eventos asignados en la pestaña Integración para un partner específico se aplican tanto para postbacks estándar como SKAN.

Métodos de asignación

Cada partner decide cuál de los siguientes métodos se utilizará para asignar sus eventos in-app:

Nota

No todos los métodos de asignación aparecen para todos los partners.
Puedes dar permiso al partner para que haga la asignación por sí mismo.

Introducir el ID del evento del partner

Evento de AppsFlyer: en la lista de eventos de tu aplicación, selecciona un evento.
Asignado al evento del partner: en el campo de texto, introduce el ID del evento recibido del partner, que corresponde al evento de tu aplicación (evento de AppsFlyer).

Nota

Los nombres de eventos distinguen entre mayúsculas y minúsculas. Para evitar discrepancias, asegúrate de usar los nombres de eventos correctos para todas las fuentes de medios y versiones de aplicaciones.
Al escribir el nombre de un evento, puedes usar espacios subrayados (guiones bajos) antes o después del nombre del evento. Asegúrate de utilizar los espacios subrayados solo cuando el nombre del evento que se envía desde AppsFlyer tenga exactamente los mismos espacios subrayados.

Seleccionar un ID de evento de la lista

Evento de AppsFlyer: en la lista de eventos de tu aplicación, selecciona un evento.
Asignado al evento del partner: en la lista de eventos predefinidos del partner, selecciona el evento que corresponde al evento de tu aplicación (evento de AppsFlyer).

Enviar eventos tal como están (sin asignar)

Algunos partners prefieren recibir postbacks de eventos in-app no asignados, es decir, los nombres de los eventos se envían tal y como se nombran en tu aplicación. No importa si el evento se llama purchase, acquisition o event5.

Puedes elegir qué eventos no asignados enviar al partner:

Agregar manualmente: selecciona eventos específicos.
Enviar todos los eventos (excluye desinstalaciones y sesiones): envía todos tus eventos. Esto no incluye las desinstalaciones, las sesiones (inicios de aplicaciones) y el evento af_app_opened.

Nota

Para evitar que los anunciantes compartan involuntariamente demasiada información con plataformas de analíticas de terceros, eliminamos la opción Enviar todos los eventos (excluye desinstalaciones y sesiones) para estas plataformas, a partir de marzo de 2019. Las plataformas de analíticas configuradas antes de esto aún conservan esta opción de configuración.

Para agregar eventos manualmente:

Haz clic en Agregar evento.
Selecciona las opciones de postback:
- Evento de AppsFlyer: en la lista de eventos de tu aplicación, selecciona un evento.
- para los usuarios de: selecciona la opción de envío para el evento.
- incluyendo: selecciona qué datos incluir en el postback.
Repite este procedimiento para más eventos.

Para enviar todos los eventos:

Selecciona Enviar todos los eventos (excluye desinstalaciones y sesiones).
Selecciona las opciones de postback:
- para los usuarios de: selecciona la opción de envío para todos los eventos.
- incluyendo: selecciona qué datos incluir para todos los eventos en el postback.

Para más información sobre la asignación de eventos, consulta postbacks de eventos in-app.

Opciones para enviar postbacks

Para cada evento, puedes elegir en qué caso enviar los postbacks (dentro de la ventana de postback):

Solo este partner: envía postbacks solo cuando el evento se atribuya a este partner, es decir, el usuario que lo realizó provino de este partner.
Todas las fuentes de medios, incluidas las orgánicas: envía postbacks a todas las fuentes de medios para los eventos atribuidos a cualquier partner y para los eventos orgánicos, es decir, cuando el usuario que los ha realizado procede de cualquier fuente de medios.

Datos que se incluirán en los postbacks

Puedes elegir qué tipo de datos de eventos puedes compartir con el partner en el postback. Selecciona una de las siguientes opciones:

Sin valores y sin ingresos: envía solo el evento en sí sin parámetros (valores o ingresos).
Valores y sin ingresos: envía todos los parámetros excluyendo el valor de los ingresos.
Valores e ingresos: envía todos los parámetros del evento, incluido el valor de ingresos (si existe en el evento).

Se recomienda compartir los ingresos si quieres que las redes de publicidad optimicen tus campañas y mejoren los resultados de las mismas. Sin embargo, no es obligatorio compartir los ingresos. Asegúrate de activar el reparto de ingresos solo para los eventos que tienen af_revenue definido en su valor de evento. De lo contrario, las redes de publicidad reciben eventos con un valor de ingresos vacío.

En los postbacks, af_revenue y af_currency se escriben fuera del JSON event_value como monetary y currency y se pueden enviar por separado. Ejemplo de estructura de postback: https://appsflyer.com/push?event_value=(event-value)&monetary=(monetary)&content_id=(af_content_id)

Nota: Al elegir las opciones Sin valores y sin ingresos o Valores y sin ingresos, los parámetros respectivos se enmascaran con N/A.

Ejemplo

Un marketer envía un evento de compra con el siguiente event_value:
{af_revenue: 50.87, af_currency: USD, af_level=2, af_receipt_id=57601333}

La siguiente tabla muestra cómo se envían los parámetros:

Nombre de campo event_value monetary currency

Sin valores y sin ingresos N/A N/A N/A

Valores y sin ingresos

{"af_currency":"N/A","af_content_id":"1234567",

"af_revenue":"N/A","af_content_type":"category_a"}

&monetary=N/A&content_id=1234567

N/A

Valores e ingresos

"af_currency":"USD","af_content_id":"1234567",

"af_revenue":200,"af_content_type":"category_a"}

&monetary=1.856918&content_id=1234567

50,87

USD

Postbacks de eventos in-app condicionales

Filtra los postbacks de eventos in-app utilizando múltiples condiciones que se pueden asignar a diferentes eventos. Solo los eventos que cumplan con las condiciones de filtro se envían a los partners, incluidos las SRN y los partners de Analytics. Usa esta función para:

Optimizar la segmentación, personalización y retención de usuarios
Minimizar los datos
Proteger la privacidad de los usuarios

Ejemplo

Un marketer con una aplicación de gaming quiere optimizar las campañas que se ejecutan a través de una red de publicidad, pero solo para los usuarios que superan el nivel 10 o el nivel 50, o para los usuarios que gastan 3 USD en compras en la aplicación.

Así se establecen las condiciones para este evento:

Cuando el nivel sea igual a 10, asigna a fb_mobile_level_acheived
De lo contrario (OR),
Cuando el nivel sea igual a 50, asigna a fb_mobile_level_acheived
De lo contrario (OR),
Cuando el costo sea igual a 3, asigna a fb_mobile_purchase

Para configurar las condiciones de un evento:

En la página de integración del partner, define y asigna los eventos in-app necesarios para enviarlos al partner.
Haz clic en el ícono Agregar condición del evento requerido.
Introduce los campos de condición tal y como aparecen en el valor del evento:
- Nombre de la propiedad
- value
- Evento de partner al que asignar la condición (usa cualquiera de estas opciones de asignación)
Puedes agregar más condiciones, solo asegúrate de introducir primero todos los campos de la condición existente.
Haz clic en Guardar integración.

consideraciones

Al configurar las condiciones, asegúrate de que se cumplen las siguientes consideraciones para que el evento se envíe al partner:

Estructura de la condición

Tanto la propiedad como el valor de la condición deben coincidir con los datos del evento.
Actualmente, las condiciones solo pueden establecerse como "iguales".
Las estructuras complejas como matrices no son compatibles.

Varias condiciones para un evento

El número máximo de condiciones por evento es 5.
Debe cumplirse al menos una condición para que se envíe el postback, pero solo se ejecuta una condición.
Cada condición se comprueba por orden de aparición. La primera condición que se cumple es ejecutada.
Cada condición se asigna por separado. El nombre del evento del partner se cambia a Basado en las condiciones.
Más de una condición puede tener la misma propiedad o el mismo valor, pero dos condiciones no pueden tener tanto la misma propiedad como el mismo valor.
Se puede asignar más de una condición al mismo evento.

Nota

Se recomienda probar esta función con una aplicación de prueba o con eventos menores para comprender su impacto en la optimización de la campaña.
Para ver el contenido del postback, puedes descargar el reporte de postback de raw data.

Editar varios eventos

Durante la asignación de eventos, los valores de los campos para usuarios de e incluyendo se pueden editar para múltiples eventos en una sola acción.

Para editar varios eventos:

Selecciona los eventos para actualizar.
Haz clic en Acciones en lote.
Selecciona la nueva configuración que se aplicará a todos los eventos seleccionados:
- para usuarios de (elige solo una opción)
  - Solo este partner
  - Todas las fuentes de medios, incluidas las orgánicas
- incluyendo (elija solo una opción)
  - Sin datos (predeterminado)
  - Valores sin ingresos
  - Valores e ingresos

Eventos personalizados

La lista de eventos disponibles para asignar muestra solo los eventos ya reportados por el SDK o desde eventos de servidor a servidor a AppsFlyer. Si el evento que deseas asignar no aparece en la lista desplegable, esto puede suceder por las siguientes razones:

Ningún usuario ha realizado el evento todavía
La última vez que ocurrió el evento fue hace más de dos semanas
Tienes una gran lista de eventos activos

En cualquiera de estos casos, para asignar el evento al ID del partner:

Escribe el nombre del evento.
Haz clic en Crear personalizado.
Asigna el evento al identificador de partner.
Haz clic en Guardar integración para asegurarte de que se registre la asignación.

Nota

Cuando se agrega un evento personalizado en un determinado partner, el evento se agrega a la lista de eventos para todos los partners. Es decir, puedes ver este evento en cualquier lista desplegable de eventos de partners.
Consulta los consejos y limitaciones para definir nombres y parámetros de eventos.

Agencias y redes de publicidad:

No pueden agregar eventos personalizados
Solo pueden ver y/o asignar eventos después de que el marketer haya agregado el evento y otorgado los permisos necesarios

Asignación de eventos por redes de publicidad

Los marketers pueden permitir que las redes de publicidad asignen los eventos y deshabiliten los postbacks por su cuenta. Para ello, un marketer debe otorgar los permisos relevantes a la red de publicidad:

En la página Integraciones activas encuentra el partner al que quieres dar permiso.
En la pestaña Permisos, cambia la opción Permitir configurar postbacks de eventos in-app a ACTIVADO.

Una vez que la red de publicidad ha recibido los permisos, puede asignar los eventos siguiendo las instrucciones en Escribir el ID de evento en el campo de texto.

Asignación de eventos por agencias

Los marketers pueden permitir a las agencias configurar postbacks de eventos in-app.

Para otorgar permiso a la agencia para configurar postbacks in-app:

Encuentra la agencia en la página Integraciones activas.
Selecciona si la agencia puede compartir todos los eventos o solo aquellos atribuidos a la red de publicidad específica.
Selecciona si la agencia puede enviar ingresos por eventos.
Selecciona los eventos específicos que la agencia puede compartir.

Consulta también