API de eventos de servidor a servidor para móviles (S2S móvil)

• Los parámetros de la carga útil consisten en uno o más identificadores de dispositivo (dependiendo del sistema operativo).
• ¿Qué sucede si no puedo enviar un identificador de dispositivo?
  • Es posible que no puedas enviar el identificador por una razón fuera de tu control, por ejemplo, porque el usuario tiene el rastreo de anuncios limitado (LAT) o porque utiliza el iOS 14 y no dio su consentimiento para ATT. Si el identificador de proveedor (IDFV) está disponible, envíalo. 
  • No enviar un ID de publicidad/identificador de dispositivo puede causar: 
    • Problemas de postback: La fuente de medios recibirá el postback pero sin un identificador de dispositivo; en consecuencia, la fuente de medios no puede asociarlo con un usuario. 
    • Segmentación de audiencias y fracaso de la regla. Los conjuntos de reglas de las audiencias requieren identificadores.Siempre es recomendable enviar un ID de dispositivo o ID de usuario de cliente de acuerdo con el tipo de ID que utiliza tu conjunto de reglas, para cada evento S2S. Sin embargo, si los identificadores de AppsFlyer se han enviado a través de otros medios (SDK o evento S2S anterior), los nuevos eventos in-app se emparejarán con los usuarios correctos, incluso si no se envían identificadores con los eventos.       

"custom_data" : {"key_group" : { 
"key_a1" : "value a1", 
"key_a2" : "value a2" 
},
"key_b" : "value b"
}

curl --location --request POST 'https://api2.appsflyer.com/inappevent/<app_id_placeholder>' \
--header 'authentication: <dev_key_placeholder>
' \
--header 'Content-Type: application/json' \
--data-raw '{
  "appsflyer_id": "9999999999999-9999999999999999999",
	"advertising_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
	"customer_user_id" : "example_customer_id_123",
	"ip": "199.0.2.1",
	"app_version_name" : "example_version_name",
	"eventTime" : "2020-02-25 12:00.000",
	"eventName": "af_purchase",
	"eventCurrency": "ZAR",
        "os" : "14.6",
        "att" : 3,
	"eventValue": 
	"{
		\"af_revenue\": \"1006\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }"
}
'

Ten en cuenta lo siguiente: 

• Para las pruebas, usa el ID de AppsFlyer de una instalación no orgánica para que el evento de prueba se atribuya en tiempo real. Los eventos orgánicos se atribuyen con un retraso de unas pocas horas.
• Algunos campos de eventos se rellenan con el evento de atribución de la instalación del usuario. Por ejemplo, la fecha y hora de instalación y la fuente de medios. 

Para atribuir el dispositivo de prueba como una instalación no orgánica:

1. Prepara un enlace de atribución personalizado para probar los mensajes S2S. Configura el parámetro de la fuente de medios en el enlace como s2s_test y configura el ID de publicidad (GAID, IDFA, etc.) en el enlace como se ilustra en los fragmentos de enlace de atribución de ejemplo. 
2. Registrar el dispositivo de prueba
3. Desinstala la aplicación del dispositivo de prueba.
4. Envía el enlace al dispositivo de prueba.
5. Haz clic en el enlace.
6. Instala y luego inicia la aplicación.
7. En el panel de control, comprueba que la instalación se haya atribuido.
8. Obtén el ID de AppsFlyer para usarlo en tu mensaje de S2S.

Para enviar el mensaje de prueba de S2S:

1. Prepara un mensaje de S2S usando el ID de AppsFlyer asignado. Consulta los siguientes ejemplos de código.
2. Envía el mensaje.
3. Haz una de las siguientes cosas para ver cómo se registra el mensaje en AppsFlyer:
   • Descarga el reporte de raw data de eventos in-app. Espera hasta 15 minutos luego de enviar el evento para que aparezca en el reporte de raw data. 
   • Push API (considera el uso de herramientas como Postman y el sitio Webhook.)
4. Comprueba lo siguiente:
   • Los valores enviados en el mensaje de S2S rellenan correctamente el reporte. Presta especial atención a los campos Fecha del evento, Divisa del evento, Ingresos del evento y Valor del evento.
   • AppsFlyer rellena la fuente de atribución y la fecha y hora de instalación.
   • Los valores proporcionados por el propio SDK, como la versión del SDK, no están rellenados.

Android

https://app.appsflyer.com/<app_id>?pid=s2s_test&c=test&advertising_id=<GAID>

iOS

https://app.appsflyer.com/<app_id>?pid=s2s_test&c=test&idfa=<IDFA>

• El ID de publicidad/identificador del dispositivo es obligatorio para asegurar los postbacks a las SRN como Facebook y Google Ads. Si no puedes enviar el ID, ten en cuenta que los postbacks no se pueden enviar.
• Si solo envías el ID de AppsFlyer, los eventos in-app se registrarán y atribuirán correctamente.

Cuando AppsFlyer procesa los eventos in-app de S2S, los campos de atribución se rellenan usando el ID de AppsFlyer para identificar el evento de instalación asociado que precedió a los eventos in-app.

Esto significa que algunos datos que AppsFlyer asocia con eventos in-app S2S no orgánicos no se asocian con eventos in-app S2S orgánicos.

Se requiere lógica de backend para obtener valores para rellenar el parámetro. A continuación, se describe cómo se puede obtener el ID de AppsFlyer:

• El ID de AppsFlyer es obligatorio y se usa para atribuir eventos.
• Se genera cuando un usuario instala por primera vez la aplicación móvil.
• Para que puedas asignar tu CUID al ID de AppsFlyer, debes configurar el CUID en la aplicación. 

Para que te sea más fácil saber qué usuario ejecutó qué evento, implementa el siguiente flujo:

• Configure el ID de usuario de cliente cuando el usuario instala la aplicación.
• Los reportes de raw data de AppsFlyer contienen el CUID y el ID de AppsFlyer. Usa una de las herramientas de entrega de datos para obtenerlo o la Push API de AppsFlyer. 
• Usa los reportes de raw data para hacer coincidir el CUID con el ID de AppsFlyer. 
• El ID de AppsFlyer está disponible en el SDK integrado en tu aplicación (Android/iOS).
• Asigna el ID de AppsFlyer al ID de usuario de cliente en tus sistemas internos (importante para uso futuro).

Una vez que asignas el ID de AppsFlyer con tu CUID, puedes hacer coincidir al usuario con los eventos realizados. Así, podrás obtener los demás valores (valor del evento, divisa del evento, fecha y hora del evento, etc.) y enviar el evento in-app de servidor a servidor. 

{
  "appsflyer_id": "1415211453000-6513894",
	"advertising_id": "38412345-8cf0-aa78-b23e-10b96e40000d",
	"eventName": "af_purchase",
	"eventValue": 
	"{
		\"af_revenue\": \"6\",
                \"af_currency\" \"USD"\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }",
	"eventCurrency": "USD",
	"ip": "1.2.3.4",
	"eventTime": "2014-05-15 12:17:00.000"
}

appsflyer_id es un parámetro obligatorio en los mensajes de eventos de servidor a servidor. AppsFlyer usa este parámetro para atribuir el evento al dispositivo original y a la fuente de medios atribuida. Puedes obtener el ID usando uno de los siguientes métodos:

• Desde el dispositivo móvil llamando a la API SDK de AppsFlyer: Android, iOS.
• Desde la plataforma de AppsFlyer, usando uno de los siguientes: Pull API, Push API, Exportar raw data de instalación.

Se pueden enviar los eventos que tienen un valor de ingresos negativo. Por ejemplo, si una compra se canceló. El parámetro af_revenue puede tener valores negativos para registrar esto. 

Si rellenas af_quantity, es posible que quieras rellenarlo con un valor negativo dependiendo de la lógica de tu sistema. AppsFlyer no hace uso de af_quantity.

Ejemplo con ingresos negativos

{
	"eventName": "cancel_purchase",
	"eventValue": 
	"{
		\"af_revenue\": \"-6\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }",
	"eventCurrency": "USD",
	
}

• Punto de conexión: verifica que el punto de conexión utilizado sea el correcto.
• Verifica que la carga útil contiene los parámetros obligatorios. Ver aquí.
• Asegúrate de que el ID de AppsFlyer que estás usando para disparar el evento sea un appsflyer_id real que esté realmente instalado en la aplicación específica, y no un ID de prueba proporcionado en la documentación. Ver aquí.
• Los eventos S2S no admiten múltiples eventos en una solicitud de S2S. Cada evento debe ser enviado como un evento separado.
  • Los eventos se pueden enviar con un método asíncrono para facilitar el tiempo de respuesta.
• En el panel de control de información general, el intervalo de fechas se refiere a la fecha de instalación de la aplicación (LTV) y no a la fecha del evento.
  • Asegúrate de seleccionar el intervalo de fechas correcto.
  • Asegúrate de que el intervalo de fechas del panel de control corresponda a la fecha de instalación del dispositivo (appsflyer_id) y no a la fecha del evento.
• Reportes de raw data de eventos: el intervalo de fechas se refiere a la fecha del evento y no a la fecha de instalación. 

Si envías eventos de S2S cuyos ingresos no se registran, asegúrate de que el JSON que envíes esté en formato de secuencia. Lo más importante es el parámetro de valor del evento en el JSON. Debe estar en formato de secuencia, como se muestra en el ejemplo que sigue.

"{\"af_revenue\":\"6\" ,\"af_content_type\":\"wallets\"}"

Si no tiene formato de secuencia, el valor del evento no se procesará correctamente y no se podrán registrar los ingresos.

Los valores de los ingresos no deben ser formateados de ninguna manera. Pueden contener un punto decimal. No incluyas signos o códigos de divisa ni delimitadores ,. Los ingresos pueden tener un prefijo -

• Ejemplos de valores válidos: 123, -123.45, 123.456
• Ejemplos de valores inválidos: 1,234.56, 1,234

Los campos de raw data se rellenan con el valor enviado en la llamada de S2S y algunos campos se rellenan con el evento de instalación.  Se observa un comportamiento similar pero no idéntico para los eventos in-app reportados usando el SDK de AppsFlyer. Hay algunas diferencias; específicamente, los siguientes campos no se rellenan para los eventos de S2S:

• WIFI
• Operator
• language
• Tipo de dispositivo
• Categoría de dispositivo
• Versión de la aplicación: Puedes usar app_version_name
• Nombre de aplicación