Configuración de postback de eventos in-app

Para:

Marketers Marketers Desarrolladores

Última actualización: 19 de septiembre de 2025 08:21

En resumen: Mide el engagement en la app y la calidad de tus usuarios, optimizando las campañas con datos de eventos internos.

Vista general

Los eventos in-app permiten a los marketers evaluar el engagement en la app y la calidad de usuarios de diversas fuentes y desarrollar estrategias de adquisición efectivas. Las ad networks aprovechan la información de eventos in-app para optimizar y realizar campañas de costo por acción/evento. Las ad networks reciben datos de eventos in-app mediante postbacks enviados en tiempo real. Descubre más sobre eventos enriquecidos in-app.

Selección de eventos in-app para postbacks

Los marketers pueden elegir qué eventos in-app quieren enviar como postbacks a las ad networks usando las configuraciones descritas en este artículo.

Nota

Entre los eventos in-app se incluyen eventos rechazados, como aquellos bloqueados por Protect360 o que no cumplen con las normas de validación de objetivos.
Si la sección Postbacks de eventos in-app no está en la pestaña Integración, significa que el partner no ha configurado el registro de eventos con AppsFlyer. El partner puede contactar con AppsFlyer a través del widget del asistente de partner para completar la integración.

Ventana de postback de eventos in-app

La ventana de postback de eventos in-app permite a los marketers que trabajan con redes en un modelo CPA (costo por acción) configurar periodos post-conversión tras los cuales no se envían más postbacks.

Por ejemplo, si los eventos dentro de 15 días de una instalación implican un costo, configura la ventana de esta manera:

Los postbacks después de este periodo no se envían ni se notifica a la red, pero los eventos todavía se registran en AppsFlyer y se atribuyen a la red.

Los postbacks se envían siempre según la configuración actual de la ventana. Consulta el siguiente ejemplo:

1 de enero	La ventana es de 15 días. Un usuario instala una app.
2 de enero	La ventana se cambia a 10 días.
14 de enero	El usuario realiza una compra. El postback no se envía a la ad network porque el evento cae fuera de la ventana actual (10 días).
15 de enero	La ventana se cambia a 20 días.
18 de enero	El usuario realiza otra compra. Esta vez se envía el postback, ya que el evento ocurre dentro de la ventana actual (20 días).

Ventana de postback predeterminada

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

Nota

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

¿Quién puede configurar ventanas de postback?

Marketers
Agencias, si se les concede el permiso Permitir configurar postbacks de eventos in-app.
Nota: Un marketers y una agencia que trabajan con la misma ad network pueden configurar las ventanas de postback por separado, según su contrato con la red.
Partners, si se les concede el permiso Permitir configurar postbacks de eventos in-app.

Mapeo de eventos

Cada marketer puede asignar un nombre diferente a un evento del mismo tipo. Estos nombres de eventos pueden diferir también de los nombres que usan los partners.

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

Para asegurarse de que los eventos del marketer coincidan con los mismos eventos de los partners, los nombres de los eventos deben mapearse.

Nota

Los eventos mapeados en la pestaña de Integración para un partner específico son aplicables tanto para postbacks estándar como para SKAN.

Métodos de mapeo

Cada postback decide cuál de los siguientes métodos se usará para mapear sus eventos in-app:

Nota

No todos los métodos de mapeo aparecen para todos los partners.
Puedes darle permiso al partner para que realice el mapeo él mismo.

Introducir el ID del evento del partner

Evento de AppsFlyer: De la lista de eventos in-app, 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 los eventos distinguen entre mayúsculas y minúsculas. Para evitar discrepancias, asegúrate de utilizar el nombre de evento correcto para todas las fuentes de medios y versiones de la aplicación.
Al escribir el nombre de un evento, puedes emplear guiones bajos antes o después del nombre del evento. Asegúrate de usar guiones bajos solo cuando el nombre del evento enviado desde AppsFlyer tenga exactamente los mismos guiones.

Selecciona un ID de evento de la lista

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

Enviar eventos tal y como están (sin mapear)

Algunos partners prefieren recibir postbacks de eventos in-app sin mapear, lo que significa que los nombres se envían tal cual aparecen en la app. No importa si el evento se llama compra, adquisición o evento5.

Puedes elegir qué eventos no mapeados 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 desinstalaciones, sesiones (inicios de aplicación) ni el evento af_app_opened.

Nota

Para evitar que los anunciantes compartan más información de la debida con plataformas de análisis 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 análisis configuradas antes de esta fecha aún mantienen esta opción.

Para agregar eventos manualmente:

Haz clic en Agregar evento.
Elige las opciones de postback:
- Evento de AppsFlyer: De la lista de eventos de tu aplicación, selecciona un evento.
- para usuarios de: Elige 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).
Elige las opciones de postback:
- para 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 el mapeo de eventos, consulta postbacks de eventos in-app.

Opciones para enviar postbacks

Para cada evento, puedes elegir en qué casos 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, cuando el usuario que lo realizó provenga de este partner.
Todas las fuentes de medios, incluidas las orgánicas: Envía postbacks a todas las fuentes de medios para eventos atribuidos a cualquier partner y para eventos orgánicos, es decir, cuando el usuario que lo realizó provenga de cualquier fuente de medios. Nota: Cuando se seleccionan todas las fuentes de medios, incluidas las orgánicas, los postbacks de otros partners no contienen datos de atribución.

Datos a incluir en los postbacks

Puedes elegir qué tipo de datos de eventos 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 ningún parámetro (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, incluyendo el valor de los ingresos (si existe en el evento).

Se recomienda compartir los ingresos si deseas que las ad networks optimicen tus campañas y mejoren tus resultados. Sin embargo, compartir los ingresos no es obligatorio. Asegúrate de habilitar la distribución de ingresos solo para eventos que tengan af_revenue o af_projected_revenue definidos en su valor de evento. De lo contrario, las ad networks recibirán eventos sin valor de ingresos.

Compartir ingresos

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

Nota: Al elegir las opciones con Sin valores y sin ingresos o Con 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 valor del evento:
{"af_currency":"USD","af_content_id":"1234567", "af_revenue":50.87,"af_content_type":"category_a"}

La tabla a continuación muestra cómo se envían los parámetros:

Nombre del campo	event_value	monetario	moneda
Sin valores y sin ingresos	N/A	N/A	N/A
Con 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	N/A
Con valores y con ingresos	`{"af_currency":"USD","af_content_id":"1234567", "af_revenue":50.87,"af_content_type":"category_a"} &monetary=1.856918&content_id=1234567`	50,87	USD

Postbacks condicionales de eventos in-app

Filtra los postbacks de eventos in-app utilizando múltiples condiciones que pueden asignarse a diferentes eventos. Solo se envían a los partners, incluidos SRNs y partners de análisis, aquellos eventos que cumplen con las condiciones del filtro. Utiliza esta función para:

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

Ejemplo

Un marketer con una app de juegos quiere optimizar las campañas que se ejecutan a través de una ad network, pero solo para los usuarios que superen el nivel 10 o el nivel 50, o para aquellos que gasten $3 dólares en compras in-app.

Así se establecen las condiciones para este evento:

Cuando nivel es igual a 10, se asigna a fb_mobile_level_acheived.
De lo contrario (O),
Cuando el nivel es igual a 50, se asigna a fb_mobile_level_acheived.
De lo contrario (O),
Cuando el costo es igual a 3, se asigna a fb_mobile_purchase.

Para establecer condiciones para un evento:

En la página de integración con el partner, define y asigna los eventos in-app necesarios para enviar al partner.
Haz clic en el icono Agregar condición del evento requerido.
Introduce los campos de condición, tal como aparecen en el valor del evento:
- Nombre de la propiedad
- Valor
- Evento asociado para asignar la condición (utilizando cualquiera de estas opciones de mapeo)
Puedes añadir más condiciones, pero asegúrate de haber introducido 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 cumplan 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, solo se pueden establecer condiciones como “iguales”.
No se admiten estructuras complejas como matrices.

Múltiples condiciones para un evento

El número máximo de condiciones por evento es 5.
Se debe cumplir al menos una condición para que se envíe el postback, pero solo se ejecuta una.
Cada condición se verifica en orden de aparición: la primera que se cumple se ejecuta.
Cada condición se asigna por separado. El nombre del evento del partner se cambia a Según condiciones.
Más de una condición puede tener la misma propiedad o el mismo valor, pero no pueden compartir ambos.
Se puede asignar más de una condición al mismo evento.

Nota

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

Editar múltiples eventos

Al mapear eventos, los valores en los campos para usuarios de e incluido se pueden editar para múltiples eventos en una única acción.

Para editar varios eventos:

Selecciona los eventos a actualizar.
Haz clic en Acciones masivas.
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 (elige 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 informados por el SDK o desde eventos enviados de servidor a servidor hacia AppsFlyer. Si el evento que deseas asignar no aparece en la lista desplegable, esto puede deberse a las siguientes razones:

Aún no hay ningún usuario que haya realizado el evento
La última vez que ocurrió el evento fue hace más de dos semanas.
Tienes una gran cantidad de eventos activos

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

En la lista desplegable, haz clic en + Añadir elemento.
En el cuadro de texto, introduce el nombre del evento que deseas añadir.
Haz clic en el símbolo V para confirmar. El evento que has añadido ahora aparece en la lista y puedes seleccionarlo.
Asocia el evento con el identificador del partner.
Haz clic en Guardar integración para asegurarte de que se registre el mapeo.

Nota

Agregar eventos personalizados en la página de postback no los extrae automáticamente de tu aplicación. Los eventos deben configurarse en el SDK o S2S para que funcionen correctamente. Consulta cómo enviar eventos a AppsFlyer.
Cuando se añade un evento personalizado bajo un partner determinado, se incluye en la lista de eventos de todos los partners. Es decir, este evento es visible en cualquier lista desplegable de eventos de un partner.
Consulta los consejos y las limitaciones para definir nombres y parámetros de eventos.

Agencias y ad networks:

No pueden añadir eventos personalizados
Solo pueden ver y/o mapear eventos después de que el marketer haya añadido el evento y otorgado los permisos necesarios.

Mapeo de eventos por ad networks

Los marketers pueden permitir que las ad networks mapeen los eventos y deshabiliten los postbacks por sí mismos. Para ello, el marketer debe otorgar los permisos pertinentes a la ad network:

En la página Integraciones activas, busca al partner al que deseas otorgar permiso.
En la pestaña de Permisos, cambia el interruptor Permitir configurar postbacks de eventos in-app a ACTIVADO.

Una vez que la ad network ha recibido los permisos, puede mapear los eventos siguiendo las instrucciones en Escribe el ID del evento en el campo de texto.

Mapeo de eventos por agencias

Los marketers pueden permitir que las agencias configuren postbacks de eventos in-app.

Nota

Si tanto el anunciante como la agencia habilitan el mismo postback de evento in-app a la misma ad network, AppsFlyer envía el postback solo una vez. Esto evita la duplicación de reportes del evento.

Para otorgar a la agencia permiso 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 ad network específica.
Selecciona si la agencia puede enviar ingresos por eventos.
Selecciona los eventos específicos que la agencia puede compartir.

Consulta también