Transmisión de raw data de la Push API

Características del mensaje

Tipos de mensajes disponibles

Campos exclusivos

Esta sección describe los mensajes (tipos de reportes) disponibles para SKAN y cómo identificar los mensajes. Lee esta sección y, a continuación, Configura el endpoint de atribución de SKAN.

Lectura relacionada: Campos de raw data de SKAN. Los mensajes de la Push API tienen la estructura y los campos equivalentes.  

Características del mensaje:

Tipos de mensajes para la atribución de SKAN

Asegúrate de que tu servidor cumpla con los siguientes requisitos:  

Requisitos del lado del servidor

¡Importante! Se utiliza un mecanismo de tiempo de espera que tiene una duración de 4 segundos. Si AppsFlyer no recibe un mensaje de OK durante este tiempo, AppsFlyer lo considera como un error en el envío del mensaje. 

• Usa esa lista de verificación para planificar la configuración de tus endpoints de atribución de AppsFlyer. Los números en la figura coinciden con los números de fila en la lista de verificación.
• Esta sección no es relevante para la atribución de SKAdNetwork. Consulta Configurar la atribución de SKAdNetwork. 

Endpoint 

Tabla de planificación de los endpoints

Número	Configuración	Detalles	Usa esta columna para registrar la configuración planificada
1	Método	POST o GET
2	URL de endpoint	-
3	Tipos de mensajes de evento	Selecciona al menos un tipo de mensaje de evento. Para seleccionar mensajes de eventos in-app, debes atribuir un evento in-app. Si no lo haces, no podrás seleccionar mensajes de eventos in-app.
4	Campos   La lista de campos es común para todos los tipos de mensajes.	Advertencia Si marcas Seleccionar todo, los campos recién agregados también se seleccionarán automáticamente. Por favor, asegúrate de que puedes admitir todos los campos nuevos agregados automáticamente al esquema para evitar problemas. Selecciona los campos requeridos. Los campos más comunes ya están seleccionados de forma predeterminada. No enviamos campos vacíos o nulos
5	Tipo de eventos in-app	Filtra por eventos in-app para reducir el tráfico enviado a tu endpoint. Selecciona uno o más, o todos los eventos in-app. ¡Nota! Si el evento no aparece en la lista, búscalo.   Si seleccionas todo, los eventos in-app nuevos se agregan automáticamente.   Solo puedes seleccionar un evento in-app después de que se haya atribuido al menos una vez.  Si es necesario, usa S2S para disparar el evento.

Nota: Solo el propietario de la cuenta de AppsFlyer puede realizar cambios en la configuración de la Push API. Los demás usuarios de la cuenta pueden ver la configuración.

Para agregar un endpoint de atribución de AppsFlyer:

1. Ve a Reporte > Acceso a la API Desplázate hacia abajo hasta la sección Push API.
2. Haz clic en Agregar endpoint. 
    
3. Selecciona un método HTTP: POST o GET
4. Ingresa la URL del endpoint. Si recibes el mensaje de que esta URL no es segura, contacta con el soporte técnico de AppsFlyer.
5. Selecciona uno o más tipos de eventos. Nota: Si los mensajes de eventos in-app están deshabilitados, significa que no se han atribuido eventos in-app hasta el momento. 
6. Selecciona los campos para completar el mensaje de la Push API. Nota:
    
   • Los campos obligatorios siempre se envían: Estos son: ID de la aplicación, nombre del evento, hora del evento, IDFA para iOS o ID de publicidad para Android.
   • Usa los controles representados en la figura a continuación para seleccionar campos opcionales.
     • Los campos más comunes ya están seleccionados de forma predeterminada. Puedes cancelar las selecciones.
     • Selecciona campos opcionales según sea necesario.
     • Usa Borrar todo para desactivar todos los campos opcionales seleccionados.
     • No enviamos campos nulos o vacíos y la clave asociada. Ten esto en cuenta al planificar tus procedimientos de análisis/importación.
7. Selecciona uno o más (hasta 52 eventos) o Todos los eventos in-app.
    
   • La lista se completa por tipos de eventos que ya se han atribuido. Si falta un evento, envía un evento que contenga este tipo utilizando un dispositivo de prueba.  
8. Haz clic en Guardar.
   La Push API ahora está activa. Los datos de conversión continúan enviándose al endpoint.
9. Prueba el endpoint utilizando el procedimiento que sigue.

Para probar el endpoint:

1. Haz clic en Enviar prueba.
   Aparece un mensaje de resultado de la prueba debajo del botón Enviar prueba. 
   Se envía un mensaje de prueba al endpoint. Si la prueba falla, asegúrate de que las direcciones IP de AppsFlyer estén en la lista de permitidos.  
   ¡Importante! Se utiliza un mecanismo de tiempo de espera que tiene una duración de 2 segundos. Si AppsFlyer no recibe un mensaje de OK durante este tiempo, AppsFlyer lo considera como un error en el envío del mensaje. 
2. Comprueba que tu endpoint recibió el mensaje de prueba.
   Ver una copia del mensaje enviado. 

Nota: Solo el propietario de la cuenta de AppsFlyer puede realizar cambios en la configuración de la Push API. Los demás usuarios de la cuenta pueden ver la configuración.

Para agregar un endpoint de la Push API de SKAdNetwork:

1. Ve a Reporte > Acceso a la API Desplázate hacia abajo hasta la sección Push API.
2. Selecciona SKAdNetwork como entidad atribuidora. 
3. Haz clic en Agregar endpoint. 
   Nota: Puedes definir de 1 a 3 endpoint de SKAdNetwork por aplicación. 
4. Selecciona un método HTTP: POST o GET
5. Ingresa la URL del endpoint. Si recibes el mensaje de que esta URL no es segura, contacta con el soporte técnico de AppsFlyer.
6. No enviamos campos nulos o vacíos y la clave asociada. Ten esto en cuenta al planificar tus procedimientos de análisis/importación.
7. Haz clic en Guardar.
   La Push API ahora está activa. Los datos se envían al endpoint. 

Con el token de autenticación de la Push API, los clientes pueden integrar y proteger sin problemas sus mensajes de la Push API agregando un encabezado de autorización personalizable con un token solicitado.
Puedes personalizar un encabezado de autorización que se enviará con tus mensajes de la Push API, definiendo el nombre del token y el valor asociados con cada ID de aplicación. Esto garantiza que tus mensajes no solo sean seguros, sino que también se adapten a tus requisitos específicos.

Nota: Solo el propietario de la cuenta de AppsFlyer puede realizar cambios en la configuración de la Push API. Los demás usuarios de la cuenta pueden ver la configuración.

Para modificar la configuración del endpoint: 

1. Ve a Reporte > Acceso a la API. Desplázate hacia abajo hasta la sección Push API.
2. Localiza el endpoint a modificar.
3. Haz las modificaciones.
4. Haz clic en Guardar.

Nota: Solo el propietario de la cuenta de AppsFlyer puede realizar cambios en la configuración de la Push API. Los demás usuarios de la cuenta pueden ver la configuración.

Para eliminar un endpoint:

1. Ve a Reporte > Acceso a la API Desplázate hacia abajo hasta la sección Acceso a la Push API.
2. Haz clic en Eliminar endpoint.
3. Haz clic en Guardar.
   Se elimina el endpoint.  

Si no recibes el mensaje de prueba y restringes el acceso a tus servidores por dirección IP: asegúrate de que todas las direcciones IP de AppsFlyer estén en la lista de permitidos.  

Los eventos in-app de retargeting se duplican cuando se lleva a cabo un evento de compra como parte de una campaña de retargeting durante la ventana de re-engagement de la UA. Esto se hace para atribuir ingresos tanto a la fuente de medios de la UA como a la fuente de medios de retargeting. 

Solo obtendrás un evento duplicado si has habilitado ambos:

• Instalación de eventos in-app
• Eventos de retargeting en la aplicación 

Identificar y deduplicar eventos in-app

• Los mensajes de eventos in-app solo se pueden seleccionar después de que se haya atribuido un evento in-app.
• Usa un dispositivo de prueba para generar un evento in-app o usa la API S2S para hacerlo manualmente. 

¿Estás utilizando Amazon CloudFront como endpoint? Si es así, verifica si CloudFront está rechazando el mensaje con el código de rechazo 421. Si este es el caso, consulta Elegir cómo CloudFront atiende las solicitudes HTTPS

Síntoma: El mensaje esta URL no es segura aparece cuando configuras la URL del endpoint.

Acción requerida: Contacta con el soporte técnico de AppsFlyer; incluye el ID de aplicación, la URL del endpoint y una captura de pantalla del mensaje de error.  

No. La Push API admite el uso del encabezado Authorization solo para tokens de autenticación. No se admiten encabezados personalizados adicionales, como consumer-key.

Si necesitas pasar parámetros adicionales, inclúyelos en la URL. Por ejemplo:

https://your.server.com?consumer_key=abc456