Push API V2.0
Novedades de la Push API
-
La Push API V2.0 está alineada con la especificación de raw data de AppsFlyer V5.0.
- Campos adicionales: se agregaron más de 40 campos en comparación con la Push API V1.0.
- Selección de campos: selecciona qué campos se envían para reducir el tamaño de los mensajes de la Push API.
- No se envían campos vacíos: en el futuro, planeamos dejar de enviar campos nulos o vacíos y las claves asociadas.
- Filtrado de eventos in-app: selecciona los eventos in-app enviados para reducir el procesamiento.
- Guía de migración de la Push API V1.0 a Push API V2.0 para desarrolladores
Acerca de la Push API
La Push API envía mensajes de eventos de atribución en tiempo real a los puntos de conexión del lado del servidor. Esto te permite seguir las trayectorias de los usuarios a través de varios entornos y puntos de contacto.
El volumen de datos enviados a los puntos de conexión se puede reducir limitando lo siguiente:
- Los tipos de mensajes y eventos in-app seleccionados.
- Los campos seleccionados.
Estas son otras soluciones de entrega de datos de AppsFlyer que pueden interesarte:
- Si el flujo de tu aplicación depende de la disponibilidad de los datos de atribución en tiempo real en menos de cinco segundos, verifica si no es preferible utilizar los datos de conversión.
- Comparación de herramientas de entrega de datos de AppsFlyer
Tipos de mensajes de evento
Tipo de campaña |
Tipo de conversión |
valor de is_ retargeting |
valor de retargeting_ conversion_ type |
No orgánico | Orgánico | Retargeting |
---|---|---|---|---|---|---|
La adquisición de usuarios | Instalación(*) | False | ✓ | ✓ | - | |
Adquisición de usuarios | Instalar eventos in-app | False | ✓ | ✓ | - | |
Retargeting |
Re-engagement | True | re-engagement | - | - | ✓ |
Retargeting | Eventos in-app de recaptación | True | re-engagement | - | - | ✓ |
Retargeting | Reatribución | True | Reatribución | - | - | ✓ |
Retargeting | Eventos in-app de reatribución | True | Reatribución | - | - | ✓ |
* Algunas instalaciones se atribuyen a la fuente de medios restringida, estos eventos no se reportan a través de la Push API. |
Estructura del mensaje y campos exclusivos
El mensaje de la Push API depende del método HTTP:
- GET: los parámetros de datos se agregan a la secuencia de URL
- POST: los parámetros de datos se incluyen en el cuerpo del mensaje en formato JSON
- Los siguientes ejemplos contienen campos nulos o vacíos. En el futuro, planeamos dejar de enviar campos vacíos o nulos.
Campos disponibles
- Los mensajes de la Push API contienen los campos que se describen aquí.
- De vez en cuando se agregarán campos adicionales, a medida que estos se agreguen a la plataforma de AppsFlyer. Tus mecanismos de importación/análisis deberían tenerlo en cuenta.
Formato de los campos de marca de tiempo:
- Para campos de marca de tiempo en UTC: formato
aaaa-mm-dd hh:mm:ss.sss
. Por ejemplo, se muestra como2019-09-17 00:09:25.123
Un evento tuvo lugar a las 14:00 hora de Tokio. La hora del evento se convierte a UTC, que es a las 05:00. La hora registrada es la de UTC. - Para campos de marca de tiempo en la zona horaria seleccionada: formato
yyyy-mm-dd hh:mm:ss.sss±th:tm
. Por ejemplo2019-01-20 04:51:16.000+0000
. Un evento tuvo lugar a las 14:00 hora de Tokio. La hora del evento que se muestra se registra como 14:00+09:00. 09:00 es la zona horaria de Tokio.
Nombre para mostrar | Nombre V2.0 | Observaciones |
---|---|---|
La moneda seleccionada. | selected_currency | Esta es la configuración vigente a nivel aplicación en el momento en que se envía el mensaje API. |
Ingresos en la divisa seleccionada | revenue_in_selected_ currency |
|
Costo en la divisa seleccionada | cost_in_selected_ currency |
|
Zona horaria seleccionada para la hora de descarga del dispositivo | device_download_time_selected_ timezone |
|
Zona horaria seleccionada para hora de toque atribuido | attributed_touch_time_ selected_timezone |
|
Zona horaria seleccionada para hora de instalación | install_time_selected_ timezone |
|
Zona horaria seleccionada para hora del evento | event_time_selected_ timezone |
|
Zona horaria seleccionada | selected_timezone | Esta es la configuración vigente a nivel aplicación en el momento en que se envía el mensaje API. |
Campos disponibles de la Push API
Nombre de Push API V2.0 | Nombre visible de Push API | Comentarios |
---|---|---|
advertising_id | ID de publicidad | |
af_ad | ad | |
af_ad_id | ID de anuncio | |
af_ad_type | Tipo de anuncio | |
af_adset | Conjunto de anuncios | |
af_adset_id | ID de conjunto de anuncios | |
af_attribution_lookback | Ventana de atribución retrospectiva | |
af_c_id | ID de campaña | |
af_channel | Canal | |
af_cost_currency | Moneda de costo | |
af_cost_model | Modelo de costo | |
af_cost_value | Valor de costo | |
af_keywords | Palabras clave | |
af_prt | Partner | |
af_reengagement_window | Ventana de recaptación | |
af_siteid | ID de sitio | |
af_sub_siteid | ID de subsitio | |
af_sub1 | Subparámetro 1 | |
af_sub2 | Subparámetro 2 | |
af_sub3 | Subparámetro 3 | |
af_sub4 | Subparámetro 4 | |
af_sub5 | Subparámetro 5 | |
amazon_aid | ID de Amazon Fire. | |
android_id | ID de Android | |
api_version | Versión de API | |
app_id | ID de aplicación | |
app_name | Nombre de aplicación | |
app_version | Versión de aplicación | |
appsflyer_id | ID de AppsFlyer | |
attributed_touch_time | Hora del toque atribuido | |
attributed_touch_time_selected_timezone | Zona horaria seleccionada para hora de toque atribuido | Específico de Push API |
attributed_touch_type | Tipo de toque atribuido | |
bundle_id | ID de paquete | |
campaign | Campaña | |
carrier | Carrier | |
city | Ciudad | |
contributor_1_af_prt | Partner del colaborador 1 | |
contributor_1_campaign | Campaña del colaborador 1 | |
contributor_1_match_type | Tipo de coincidencia del colaborador 1 | |
contributor_1_media_source | Fuente de medios del colaborador 1 | |
contributor_1_touch_time | Hora de toque del colaborador 1 | |
contributor_1_touch_type | Tipo de toque del colaborador 1 | |
contributor_2_af_prt | Partner del colaborador 2 | |
contributor_2_campaign | Campaña del colaborador 2 | |
contributor_2_match_type | Tipo de coincidencia del colaborador 2 | |
contributor_2_media_source | Fuente de medios del colaborador 2 | |
contributor_2_touch_time | Hora de toque del colaborador 2 | |
contributor_2_touch_type | Tipo de toque del colaborador 2 | |
contributor_3_af_prt | Partner del colaborador 3 | |
contributor_3_campaign | Campaña del colaborador 3 | |
contributor_3_match_type | Tipo de coincidencia del colaborador 3 | |
contributor_3_media_source | Fuente de medios del colaborador 3 | |
contributor_3_touch_time | Hora de toque del colaborador 3 | |
contributor_3_touch_type | Tipo de toque del colaborador 3 | |
cost_in_selected_currency | Costo en la divisa seleccionada | Específico de Push API |
country_code | Código de país | |
custom_data | Datos personalizados | |
customer_user_id | ID de usuario de cliente | |
deeplink_url | URL de enlace profundo | Disponible desde el primer trimestre de 2020 |
device_category | Categoría de dispositivo | |
device_download_time |
Tiempo de descarga del dispositivo | Hasta el 3 de febrero de 2020, un campo adicional, download_time también está disponible. |
device_type | Tipo de dispositivo | |
dma | DMA | |
device_download_time_selected_timezone | Zona horaria seleccionada para la hora de descarga del dispositivo |
Específico de la Push API. Hasta el 3 de febrero de 2020, también está disponible un campo adicional, download_time_selected timezone. |
event_name | eventName | |
event_revenue | Ingresos del evento | |
event_revenue_currency | Divisa de ingresos del evento | |
event_revenue_usd | Ingresos del evento en USD | |
event_source | Fuente del evento | |
event_time | Hora del evento | |
event_time_selected_timezone | Zona horaria seleccionada para hora del evento | Específico de Push API |
event_value | Valor del evento | |
gp_broadcast_referrer | Referente de transmisión de GP | |
gp_click_time | Hora de clic de Google Play | |
gp_install_begin | Hora de inicio de la instalación de Google Play | |
gp_referrer | Google Play Referrer | |
http_referrer | Referente de HTTP | |
idfa | Identificador de anunciante (IDFA) | |
idfv | IDFV | |
imei | IMEI | |
install_app_store | Tienda de aplicaciones de la instalación | |
install_time | Hora de instalación | |
install_time_selected_timezone | Zona horaria seleccionada para hora de instalación | Específico de Push API |
ip | IP | |
is_LAT | Es LAT | Disponible a partir del cuarto trimestre de 2019 |
is_primary_attribution | Es atribución primaria | |
is_receipt_validated | Tiene validación de compras | |
is_retargeting | Es retargeting | |
keyword_id | ID de palabra clave | |
keyword_match_type | Tipo de coincidencia de palabras clave | |
language | language | |
match_type | Tipo de coincidencia | |
media_source | Fuente de medios | |
network_account_id | ID de cuenta de red | |
oaid | OAID | |
operator | Operator | |
original_url | URL original | |
os_version | Versión de SO | |
platform | Plataforma | |
postal_code | Código postal | |
region | Región | |
retargeting_conversion_type | Tipo de conversión de retargeting | |
revenue_in_selected_currency | Ingresos en la divisa seleccionada | Específico de Push API |
sdk_version | Versión del SDK | |
selected_currency | La moneda seleccionada. | Específico de Push API |
selected_timezone | Zona horaria seleccionada | Específico de Push API |
state | Estado | |
store_reinstall (False=Download, True=Redownload) | Reinstalación de tienda | |
user_agent | Agente de usuario | |
WIFI | WIFI |
Configuración de Push API
Precaución
No uses la Push API para enviar datos a terceros porque:
- Al hacerlo puedes estar infringiendo normas de privacidad, como la CCPA, si el usuario eligió no enviar sus datos a terceros.
- Algunas fuentes de medios restringen cómo se usan y cómo se comparten con terceros, o ambas, los datos de nivel de usuario que proporcionan. Asegúrate de cumplir con los términos de uso de la fuente de medios.
Por ejemplo, Facebook, Twitter, Snapchat, Pinterest.
Para configurar la Push API, completa la lista de acciones.
Acción n.º | Para configurar un punto de conexión nuevo |
---|---|
1 |
Completa la lista de verificación de requisitos del lado del servidor. |
2 | |
3 |
Requisitos del lado del servidor (tu servidor)
Asegúrate de que tu servidor cumpla con los requisitos que aquí se enumeran.
URL de punto de conexión |
|
Código de respuesta de punto de conexión | Al recibir un mensaje, el punto de conexión debe devolver un código de estado HTTP 200. |
Agregar los servidores de AppsFlyer a la lista de permitidos |
Agrega a la lista de permitidos las direcciones IP de los servidores de AppsFlyer para garantizar la comunicación con el punto de conexión. |
Versiones de TLS |
|
Puertos |
Puertos: 80, 443 |
Lista de verificación de planificación de Push API
- Utiliza la siguiente lista de verificación para planificar la configuración del punto de conexión. Los números en la figura coinciden con los números de fila en la lista de verificación.
Punto de conexión
No. |
Configuración |
Detalles | Tu configuración |
---|---|---|---|
1 |
Método |
POST o GET | |
2 |
URL de punto de conexión |
- | |
3 | Tipos de mensajes de evento |
|
|
4 |
Campos La lista de campos es común para todos los tipos de mensajes. |
Selecciona los campos requeridos.
|
|
5 |
Tipo de eventos in-app
|
Filtra por eventos in-app para reducir el tráfico enviado a tu punto de conexión. |
|
¿Deseas enviar datos de usuarios atribuidos a Facebook? |
|
|
Configurar y gestionar puntos de conexión
- Esta sección abarca los procedimientos para agregar, probar, modificar y eliminar puntos de conexión.
- Solo el administrador puede realizar cambios en la configuración de la API. Los miembros del equipo pueden visualizar la configuración de la Push API.

- Ve a Integración > Acceso a la API. Desplázate hacia abajo hasta la sección Push API.
Se muestra la sección Push API. - Haz clic en Agregar punto de conexión.
- Selecciona un método HTTP: POST o GET
- Ingresa la URL del punto de conexión. Si recibes el mensaje de que esta URL no es segura, comunícate con el soporte técnico de AppsFlyer.
- 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.
- Selecciona los campos para completar el mensaje de la Push API. Nota:
- Los campos obligatorios siempre se envían: ID de la aplicación, nombre del evento, hora del evento, identificador de anunciante (IDFA) para iOS o ID de publicidad para Android.
- Usa los controles representados en la figura a continuación para seleccionar campos opcionales.
- Se encuentran preseleccionados aquellos campos seleccionados con mayor frecuencia. Es posible eliminar toda la selección.
- Selecciona campos opcionales según sea necesario.
- Usa Borrar todo para desactivar todos los campos opcionales seleccionados.
- En el futuro, planeamos dejar de enviar campos nulos o vacíos y las claves asociadas. Ten esto en cuenta al planificar tus procedimientos de análisis/importación.
- 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.
- Haz clic en Guardar
La Push API está ahora activa
Los datos de conversión se envían al punto de conexión. - Prueba el punto de conexión utilizando el procedimiento que sigue.
- Si deseas recibir datos atribuidos a Facebook, debes primero haber aceptado los términos de servicio de Facebook.
Para probar el punto de conexión:
- 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 punto de conexión. - Comprueba que el punto de conexión recibió el mensaje de prueba.
A continuación se incluye una copia del mensaje enviado.
Prueba de los mensajes API POST y GET
El siguiente mensaje POST se envía como mensaje de prueba
{
"idfv": "123456789",
"device_category": "phone",
"af_sub1": "sub1-12345",
"customer_user_id": "Customer User ID",
"is_lat": null,
"contributor_2_af_prt": "attributionagency",
"bundle_id": "bundleIdentifier_test",
"gp_broadcastreferrer": "",
"contributor_2_touch_time": "2019-12-31 00:05:42.805",
"contributor_3_touch_type": "click",
"event_source": "SDK",
"af_cost_value": "10",
"contributor_1_match_type": "id_matching",
"app_version": "app_version",
"contributor_3_af_prt": "attributionagency",
"custom_data": null,
"contributor_2_touch_type": "click",
"gp_install_begin": "2019-12-31 00:07:14.000",
"city": "Redmond",
"amazon_aid": "9173fe74-0578-4658-a461-ebb0b4fce6d6",
"gp_referrer": "af_tranid=000712-31122019254604&pid=pdsagency_int&c=pushapi_v2",
"af_cost_model": "CPI",
"af_c_id": "cid12345",
"attributed_touch_time_selected_timezone": "2019-12-31 00:06:32.891+0000",
"selected_currency": "EUR",
"app_name": "com.pds.pushapi2.v2.transparent.com",
"install_time_selected_timezone": "2019-12-31 00:07:14.961+0000",
"postal_code": "98052",
"wifi": false,
"install_time": "2019-12-31 00:07:14.961",
"operator": "ORANGE",
"attributed_touch_type": "click",
"af_attribution_lookback": "25d",
"keyword_match_type": null,
"af_adset_id": "adset12345",
"device_download_time_selected_timezone": "2019-12-31 00:07:14.961+0000",
"contributor_2_media_source": "contrib2",
"contributor_2_match_type": "id_matching",
"api_version": "2.0",
"attributed_touch_time": "2019-12-31 00:06:32.891",
"revenue_in_selected_currency": null,
"is_retargeting": false,
"country_code": "US",
"gp_click_time": "2019-12-31 00:07:12.000",
"contributor_1_af_prt": "attributionagency",
"match_type": "id_matching",
"appsflyer_id": "e126a3b3-3406-4196-a964-563c9ae44ff8",
"dma": "819",
"http_referrer": "https://www.amazon.com/gp/bestsellers/gift-cards/ref=sv_gc_0",
"af_sub5": "sub5-12345",
"af_prt": "attributionagency",
"event_revenue_currency": null,
"store_reinstall": null,
"install_app_store": null,
"media_source": "pdsagency_int",
"deeplink_url": null,
"campaign": "pushapi_v2",
"af_keywords": "keywords12345",
"region": "NA",
"cost_in_selected_currency": "1000",
"event_value": null,
"ip": "20.168.174.166",
"oaid": null,
"event_time": "2019-12-31 00:07:14.961",
"is_receipt_validated": null,
"contributor_1_campaign": "camp1",
"af_sub4": "sub4-12345",
"imei": null,
"contributor_3_campaign": "camp3",
"event_revenue_usd": null,
"af_sub2": "sub2-12345",
"original_url": "https://app.appsflyer.com/com.pds.pushapi2.v2.transparent.com?c=pushapi_v2&pid=pdsagency_int&clickid=click12345&af_ref=000632-31122019&advertiserId=9173fe74-0578-4658-a461-ebb0b4fce6d6&android_id=3e06b4caebc19356&sha1_android_id=sha12345&af_siteid=136396&af_sub_siteid=sub_siteid12345&af_c_id=cid12345&af_adset=adset12345&af_adset_id=adset12345&af_ad=ad12345&af_ad_id=adid12345&af_ad_type=adtype12345&af_channel=channel12345&af_keywords=keywords12345&is_retargeting=False&af_dp=ebay%3A%2F%2Fshoppingcart&af_web_dp=www.dp.com&af_sub1=sub1-12345&af_sub2=sub2-12345&af_sub3=sub3-12345&af_sub4=sub4-12345&af_sub5=sub5-12345&af_cost_model=CPI&af_cost_value=10&af_cost_currency=EUR&sha1_advertising_id=sha12345&sha1_el=sha12345&af_installpostback=false&af_force_dp=true&af_chrome_lp=true&af_ec=1&af_click_lookback=25d&af_viewthrough_lookback=1h&af_reengagement_window=2d&af_prt=attributionagency",
"contributor_2_campaign": "camp2",
"android_id": "3e06b4caebc19356",
"contributor_3_media_source": "contrib3",
"af_adset": "adset12345",
"af_ad": "ad12345",
"state": "WA",
"network_account_id": null,
"device_type": "Samsung::SH-220",
"idfa": null,
"retargeting_conversion_type": null,
"af_channel": "channel12345",
"af_cost_currency": "EUR",
"contributor_1_media_source": "contrib1",
"keyword_id": null,
"device_download_time": "2019-12-31 00:07:14.961",
"contributor_1_touch_type": "click",
"af_reengagement_window": "2d",
"af_siteid": "136396",
"language": "English",
"app_id": "com.pds.pushapi2.v2.transparent.com",
"contributor_1_touch_time": "2019-12-31 00:06:07.847",
"event_revenue": null,
"af_ad_type": "adtype12345",
"carrier": "carrier",
"event_name": "install",
"af_sub_siteid": "sub_siteid12345",
"advertising_id": "9173fe74-0578-4658-a461-ebb0b4fce6d6",
"os_version": "6.0",
"platform": "android",
"af_sub3": "sub3-12345",
"contributor_3_match_type": "id_matching",
"selected_timezone": "UTC",
"af_ad_id": "adid12345",
"contributor_3_touch_time": "2019-12-31 00:05:17.757",
"user_agent": "Dalvik/1.6.0 (Linux; U; Android 6.0; Redmi Note 4 Build/KOT49I.F320S22g",
"is_primary_attribution": null,
"sdk_version": "v4.8.0",
"event_time_selected_timezone": "2019-12-31 00:07:14.961+0000"
}
Cambiar un punto de conexión
Para modificar la configuración de los puntos de conexión:
- Ve a Integración > Acceso a la API.
Desplázate hacia abajo hasta la sección Push API.
Se muestra la sección Push API. - Localiza el punto de conexión a modificar.
- Haz las modificaciones.
- Haga clic en Save (Guardar).
Eliminar un punto de conexión
Para eliminar un punto de conexión:
- Ve a Integración > Acceso a la API.
Desplázate hacia abajo hasta la sección de acceso a Push API. - Haz clic en Eliminar punto de conexión.
- Haz clic en Guardar.
Se elimina el punto de conexión.
Migrar un punto de conexión de V1.0 a V2.0
Para migrar un punto de conexión de V1.0 a V2.0:
- Ve a Integración > Acceso a la API. Desplázate hacia abajo hasta la sección Push API.
Se muestra la sección Push API. - Localiza el punto de conexión que deseas migrar.
- Selecciona los campos para completar el mensaje de la Push API.
- Los campos obligatorios siempre se envían: ID de la aplicación, nombre del evento, hora del evento, identificador de anunciante (IDFA) para iOS o ID de publicidad para Android.
- Usa los controles representados en la figura a continuación para seleccionar campos opcionales.
- Se encuentran preseleccionados aquellos campos seleccionados con mayor frecuencia. Es posible eliminar toda la selección.
- Selecciona campos opcionales según sea necesario.
- Usa Borrar todo para desactivar todos los campos opcionales seleccionados.
- En el futuro, planeamos dejar de enviar campos nulos o vacíos y las claves asociadas. Ten esto en cuenta al planificar tus procedimientos de análisis/importación.
- 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.
- Haga clic en Save (Guardar).
- La Push API se ha migrado.
- Los datos de conversión continúan enviándose al punto de conexión.
Mensajes de error del punto de conexión
Síntoma: El mensaje esta URL no es segura aparece cuando configuras la URL del punto de conexión.
Acción requerida: Comunícate con el soporte técnico de AppsFlyer; incluye el ID de aplicación, la URL del punto de conexión y una captura de pantalla del mensaje de error.
Resolución de problemas, limitaciones y características
Duplicar eventos in-app de retargeting
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:
- Instalar eventos in-app
- eventos in-app de retargeting
Los eventos in-app atribuidos a la fuente de medios de la UA (eventos in-app de instalación) como parte de una campaña de retargeting tienen el campo is_primary_attribtuion=false.
Ejemplo
- Un usuario instala example_app, que se atribuye a ua_network
- Más tarde, el usuario vuelve a involucrarse con la campaña de retargeting de example_app en retar_network y realiza una compra.
El evento de compra in-app se envía dos veces con los siguientes detalles:
Tipo de evento | Fuente de medios | is_retargeting | re_targeting conversion_type | is_primary_ attribution |
---|---|---|---|---|
Eventos in-app de instalación | ua_network | True | re-engagement o reatribución | False |
Eventos In-App de Retargeting | retar_network | True | re-engagement o reatribución | True |
¿Cómo identifico los eventos de retargeting duplicados?
El campo booleano is_primary_attribution identifica las fuentes de medios primarias y secundarias en las campañas de retargeting:
- Falso: identifica la fuente de medios de la UA original. Nota: Este es el único escenario en el que el valor es falso.
- Verdadero: identifica la fuente de medios de re-engagement
Esto se debe al motivo siguiente: si un usuario, como resultado de una campaña de retargeting, se involucra con la campaña, se abre una ventana de re-engagement. La fuente de medios de re-engagement se considera la fuente de medios primaria cuando la ventana de re-engagement está abierta y la fuente de la UA es secundaria. Una vez que la ventana se cierra, la fuente de medios de la UA original vuelve a ser primaria.
La selección de mensajes de eventos in-app está deshabilitada
- 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.
Datos faltantes de Facebook
Por defecto, Facebook no publica los raw data a nivel de usuario, salvo que aceptes los términos de servicio de Facebook.
Al hacerlo, los datos de nivel de usuario procedentes de Facebook y otras fuentes de raw data se envían a través de la Push API.
Faltan mensajes push y CloudFront
¿Estás utilizando Amazon CloudFront como punto de conexión? 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
Limitaciones y características
Característica | Observaciones |
---|---|
Redes de publicidad | No apto para el uso por parte de redes de publicidad. |
Agencias | No apto para el uso por parte de agencias. |
Zona horaria específica de la aplicación | Compatible |
Divisa específica de la aplicación | Compatible |
Limitaciones de tamaño | No correponde |
Orgánica | Sí |
No orgánico | Sí |
Actualización de los datos | Tiempo real |
Historial de datos | No se admite. Los datos del evento se envían después de configurar la Push API. Si necesitas raw data histórico, utiliza la Pull API. |
Acceso de miembros del equipo | Los miembros del equipo pueden ver la configuración de la Push API, pero no pueden realizar cambios. |
Migración de Push API V1.0 a Push API V2.0
Esta sección es para los ingenieros de Business Intelligence/TI del propietario de la aplicación, responsables de migrar la Push API V1.0 a la Push API 2.0.
Al planificar la migración de V1.0 a V2.0, debes tener en cuenta que el campo detallado en esta sección cambia.
Qué ha cambiado
Cambios a nivel de campo, detallados en las siguientes tablas:
- Campos eliminados: campos que son reemplazados por campos de raw data de AppsFlyer
- Campos renombrados: los nombres de los campos ahora están alineados con los nombres de raw data de AppsFlyer
- Campos adicionales (nuevos): campos que no estaban disponibles en V1.0. Puedes seleccionar qué campos se envían en los mensajes.
- Campos exclusivos para Push API: se encuentran solo en Push API.
Los puntos de conexión no cambian:
- El cambio a la API V2.0 se relaciona solo con campos, lo que significa que los parámetros de consulta/JSON de la API no se modifican.
- No hay cambios en el mecanismo o los puntos de conexión de la interfaz de la Push API.
Futuras adiciones de campos:
- Las adiciones de campos en Appsflyer estarán disponibles rápidamente en la Push API 2.0. La Push API V1.0 ahora está en desuso y se dará de baja el 31 de agosto de 2020.
- Esto no dará como resultado un cambio en el número de versión de API
- Asegúrate de que los mecanismos de análisis/importación puedan incorporar campos adicionales con facilidad
Configurar el punto de conexión de la Push API V2.0
- Puedes configurar puntos finales de la Push API adicionales para fines de desarrollo y prueba. Esto se puede hacer sin afectar la configuración actual de la Push API V1.0. Lo que significa que los mensajes de la Push API V1.0 se envían en paralelo a los mensajes enviados por la Push API V2.0. Cuando completes el ciclo de prueba y desarrollo, elimina/migra los puntos de conexión de la Push API V1.0.
Consulta las Novedades en AppsFlyer.
Tablas de campos de Push API
Campos eliminados de Push API V1.0
V1.0 Campo eliminado |
V2.0 Campo de reemplazo |
Descripción |
---|---|---|
fb_adgroup_name | af_ad | |
fb_adgroup_id | af_ad_id | |
fb_adset_name | af_adset | |
fb_adset_id | af_adset_id | |
fb_campaign_id | af_c_id | |
fb_campaign_name | campaign | |
event_type | event_name |
Puede ser uno de los siguientes: |
attribution_type | media_source |
En V1.0, el campo attribution_type tenía un valor orgánico o regular. Usa el campo media_source para derivar el tipo de atribución de la siguiente manera:
|
click_time | attributed_touch_time | |
cost_per_install | af_cost_value | |
device_brand (solo para Android) |
device_type |
Device_type contiene la marca y el modelo |
device_model (solo para Android) | device_type |
Device_type contiene la marca y el modelo |
Campos renombrados
Nombre V1.0 |
Nombre V2.0 |
---|---|
agency | af_prt |
af_click_lookback | af_attribution_lookback |
re_targeting_conversion_type | retargeting_conversion_type |
appsflyer_device_id | appsflyer_id |
currency | af_cost_currency |
click_time_selected_timezone | attributed_touch_time_selected_timezone |
click_url | original_url |
download_time | device_download_time |
Campos agregados a Push API V2.0
Nombre para mostrar | Nombre V2.0 | Descripción |
---|---|---|
ID de Amazon Fire. | amazon_aid | ID de publicidad de Amazon Fire TV |
Campaña del colaborador 1 | contributor_1_campaign | Campaña del colaborador |
Tipo de coincidencia del colaborador 1 | contributor_1_match_type | Los valores posibles incluyen: gp_referrer, id_matching, SRN, download_time |
Fuente de medios del colaborador 1 | contributor_1_media_source | Fuente de medios del colaborador |
Partner del colaborador 1 | contributor_1_af_prt | Agencia o PMD, siempre en minúscula |
Hora de toque del colaborador 1 | contributor_1_touch_time | La hora del toque |
Tipo de toque del colaborador 1 | contributor_1_touch_type | Tipo de toque clic, impresión, TV |
Campaña del colaborador 2 | contributor_2_campaign | Campaña del colaborador |
Tipo de coincidencia del colaborador 2 | contributor_2_match_type | Los valores posibles incluyen: gp_referrer/id_matching/srn |
Fuente de medios del colaborador 2 | contributor_2_media_source | Fuente de medios del colaborador |
Partner del colaborador 2 | contributor_2_af_prt | Agencia o PMD |
Hora de toque del colaborador 2 | contributor_2_touch_time | La hora del toque |
Tipo de toque del colaborador 2 | contributor_2_touch_type | Tipo de toque (podría ser clic/impresión/TV) |
Campaña del colaborador 3 | contributor_3_campaign | Campaña del colaborador |
Tipo de coincidencia del colaborador 3 | contributor_3_match_type | Los valores posibles incluyen: gp_referrer/id_matching/srn |
Fuente de medios del colaborador 3 | contributor_3_media_source | Fuente de medios del colaborador |
Partner del colaborador 3 | contributor_3_af_prt | Agencia o PMD |
Hora de toque del colaborador 3 | contributor_3_touch_time | La hora del toque |
Tipo de toque del colaborador 3 | contributor_3_touch_type | Tipo de toque (podría ser clic/impresión/TV) |
Datos personalizados | custom_data | Datos que se envían utilizando el SDK, consulte las guías de SDK para Android y iOS |
Categoría de dispositivo | device_category | Los valores posibles incluyen: teléfono, tableta, otros Compatible con SDK para Android V4.8.8 y posteriores |
DMA | dma | Área de mercado designada: las regiones son áreas geográficas en los EE. UU. donde la empresa Nielsen mide los telespectadores locales. |
Ingresos del evento en USD | event_revenue_usd | La cantidad de ingresos en USD o en la divisa preferida, configurable en Configuración de la aplicación. |
Ingresos del evento | event_revenue | Monto de ingresos utilizando la Divisa de ingresos del evento |
Divisa de ingresos del evento | event_revenue_currency | La divisa de ingresos del evento tal como se reporta al SDK. |
Fuente del evento | event_source | La fuente del evento, ya sea SDK o S2S |
Hora de clic de Google Play | gp_click_time | Hora de carga de la página de la aplicación en Google Play después del clic en un anuncio. Fuente de tiempo: Google API Disponible desde el SDK para Android versión 4.8.5 Ejemplo de caso de uso: al comparar install_time con gp_click time, puedes saber cuánto tardan los usuarios desde que comienzan a descargar la aplicación hasta que la abren. |
Hora de inicio de la instalación de Google Play | gp_install_begin | Hora a la que comienza la instalación Fuente de la hora: dispositivo del usuario. Significa la hora que aparece en el dispositivo. Nota: Disponible con el SDK de Android versión 4.8.5 |
Google Play Referrer | gp_referrer | La URL del referente del paquete instalado. Disponible con el SDK de Android versión 4.8.5 |
Referente de transmisión de GP | gp_broadcast_referrer | Referencia de retransmisión Google Play. |
Tienda de aplicaciones de la instalación | install_app_store | Identifica la tienda de Android desde la que se descarga la aplicación (detalles) |
Es atribución primaria | is_primary_attribution | En una ventana de recaptación, podemos atribuir a la fuente de medios original (antes de la recaptación) o a la fuente de medios de recaptación. Mientras el evento se encuentre dentro de la ventana de recaptación, la fuente de medios original no será la atribución principal. Fuera de la ventana de recaptación, será la atribución principal. |
Tiene validación de compras | is_receipt_validated | true/false/null cuando se implementa en el SDK; de lo contrario está vacío. |
Tipo de coincidencia de palabras clave | keyword_match_type | El tipo de concordancia de palabra clave devuelto por API de redes de búsqueda o enlaces de atribución deberán asignarse al reporte de raw data. Nota: Google AdWords y Apple Search Ads son las únicas redes que devuelven este parámetro para las campañas de búsqueda. |
Tipo de coincidencia | match_type | Tipo de método de atribución. Los valores posibles incluyen: gp_referrer (secuencia de referente de Google Play) id_matching fingerprinting srn (red de autoreporte) tv (atribución de TV) preinstalación |
ID de cuenta de red | network_account_id | ID de la cuenta del anunciante con el partner |
Código postal | postal_code | Basado en el IP del SDK |
Ventana de recaptación | af_reengagement_window | La ventana de atribución de re-engagement es el período de tiempo durante el cual un evento puede atribuirse a una campaña de retargeting. Limitación: el campo no se rellena en las campañas de retargeting. |
Región | region | Basado en el IP del SDK |
Estado | state | Basado en el IP proveniente del SDK |
ID de subsitio | af_sub_siteid | ID de subanunciante |
Agente de usuario | user_agent | El agente del usuario de la URL |
Campos exclusivos de Push API
Nombre para mostrar | Nombre V2.0 | Observaciones |
---|---|---|
La moneda seleccionada. | selected_currency | |
Ingresos en la divisa seleccionada | revenue_in_selected_ currency |
|
Costo en la divisa seleccionada | cost_in_selected_ currency |
|
Zona horaria seleccionada para la hora de descarga del dispositivo | device_download_time_selected_ timezone |
|
Zona horaria seleccionada para hora de toque atribuido | attributed_touch_time_ selected_timezone |
|
Zona horaria seleccionada para hora de instalación | install_time_selected_ timezone |
|
Zona horaria seleccionada para hora del evento | event_time_selected_ timezone |
|
Zona horaria seleccionada | selected_timezone |