Reportes de eventos de atribución en tiempo real de la Push API V2.0

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: data parameters are contained in the message body in JSON format 
• The examples that follow contain null/empty fields. Starting from June 15, 2020 we plan to stop sending empty fields. 
  
  • Android_Push_API_ V2.0.json
  • iOS_Push_API_V2.0_json

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 como 2019-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 ejemplo 2019-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. 

Asegúrate de que tu servidor cumpla con los requisitos que aquí se enumeran. 

• 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 

• Esta sección abarca los procedimientos para agregar, probar, modificar y eliminar puntos de conexión. 
• Only the admin can make changes to API settings. Team members can view Push API settings.

1. 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.
2. Haz clic en Agregar punto de conexión. 
3. Selecciona un método HTTP: POST o GET
4. Ingresa la URL del punto de conexión. 
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: 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.
     • Use Clear all to clear all optional fields.
7. Selecciona hasta 52 eventos in-app o elige Seleccionar todo.
   • Precaución Si no eliges Seleccionar todo, deberás agregar manualmente los eventos in-app nuevos. 
   • 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 está ahora activa
   Los datos de conversión se envían al punto de conexión.
9. Prueba el punto de conexión utilizando el procedimiento que sigue.
10. 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:

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 punto de conexión.
2. Comprueba que el punto de conexión recibió el mensaje de prueba.
   A continuación se incluye una copia del mensaje enviado.

{                  
  "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"
}

Eliminar un punto de conexión

🔑 To delete an endpoint:

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

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. 

¿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. 

• 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. 

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.

¿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