Transmissão de dados brutos pela Push API (V2)

A mensagem da Push API depende do método HTTP:

• GET: parâmetros de dados são anexados à string da URL
• POST: parâmetros de dados estão contidos no corpo da mensagem no formato JSON
• Os exemplos a seguir contêm campos nulos/vazios. No futuro, planejamos parar de enviar campos vazios/nulos. 
  
  • Android_Push_API_ V2.0.json
  • iOS_Push_API_V2.json

Campos disponíveis

• As mensagens da Push API contêm os campos descritos aqui.
• Campos adicionais serão adicionados periodicamente, à medida que são adicionados à plataforma da AppsFlyer. Seus mecanismos de importação/análise devem levar isso em consideração. 

Formato dos campos de carimbo de data/hora:

• Para campos do carimbo de data/hora em UTC: formato  aaaa-mm-dd hh:mm:ss.sss. Por exemplo, um evento que ocorreu às 14:00, horário de Tóquio, é exibido como 2019-09-17 00: 09: 25.123. A hora do evento é convertida em UTC, que é 05:00. A hora registrada é a hora em UTC. 
• Para campos de carimbo de data/hora em fuso horário selecionado: formato aaaa-mm-dd hh:mm:ss.±th:tm. Por exemplo,  2019-01-20 04:51:16.000+0000. Um evento ocorreu às 14:00, horário de Tóquio. O horário do evento mostrado é registrado como 14:00+09:00. 09:00 é o fuso horário de Tóquio. 

• Campos de dados brutos disponíveis via Push API
• Descrição detalhada de todos os campos de dados brutos na AppsFlyer, independentemente do método de entrega

Verifique se o seu servidor cumpre com os requisitos listados aqui. 

• Use a lista de verificação a seguir para planejar as configurações do ponto final. Os números na figura correspondem aos números de linha na lista de verificação.

Ponto final 

• Esta seção contém procedimentos para adicionar, testar, modificar e excluir pontos finais. 
• Somente o administrador pode fazer alterações nas definições da API. Os membros da equipe podem visualizar as definições da Push API.

Para adicionar um endpoint de Push API:

1. Acesse Integração > Acesso à API.
   Role para baixo até a seção da Push API.
   A seção da Push API será exibida.
2. Clique em Adicionar Ponto Final 
3. Selecione um método HTTP: POSTou GET
4. Insira a URL do Endpoint. Se você receber a mensagem 'esta URL não é segura', entre em contato com o suporte da AppsFlyer.
5. Selecione um ou mais tipos de evento. Atenção! Se as mensagens de evento in-app estiverem desativadas, isso significa que nenhum evento in-app foi gravado até o momento. 
6. Selecione os campos para preencher a mensagem da Push API. Observação:
   
   • Campos obrigatórios sempre enviados: ID do aplicativo, Nome do evento, IDFA (iOS) ou ID de publicidade (Android)
   • Use os controles representados na figura a seguir para selecionar os campos adicionais. 

     

     • Os campos selecionados com mais frequência são pré-selecionados. Você pode limpar a seleção.
     • Selecione os campos opcionais conforme necessário.
     • Use Limpar tudo para limpar todos os campos opcionais.
     • Não enviamos campos vazios/nulos e a chave associada. Leve isso em conta ao planejar seus processos de importação/análise.
7. Selecione um ou mais (até 52 eventos) ou  Todos os eventos in-app.
   
   • A lista é preenchida por tipos de eventos que já foram gravados. Se estiver faltando um evento, envie um evento desse tipo usando um dispositivo de teste. 
8. Clique em Salvar
   A Push API agora está ativa
   Os dados de conversão são enviados para o endpoint.
9. Teste o ponto final usando o procedimento a seguir.
10. Se você quiser receber eventos atribuídos ao Facebook, primeiro deve aceitar os Termos de serviço do Facebook. 

Para testar o ponto final:

1. Clique em Enviar teste. 
   Uma mensagem de resultado do teste é exibida abaixo do botão Enviar teste . 
   Uma mensagem de teste é enviada para o ponto final. Se o teste falhar, certifique-se de que os endereços IP da AppsFlyer listados estão na lista de permissões. 
2. Verifique se o endpoint recebeu a mensagem de teste.
   Uma cópia da mensagem enviada vem em seguida.

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

Excluindo um ponto final

Para excluir um endpoint:

1. Acesse Integração > Acesso à API.
   Role para baixo até a seção de acesso à Push API. 
2. Clique em Excluir ponto final.
3. Clique em Salvar.
   O ponto final é removido. 

Migrando um ponto final da V1.0 para V2.0

Para migrar um ponto final da V1.0 para V2.0:

1. Acesse Integração > Acesso à API.
   Role para baixo até a seção da Push API.
   A seção da Push API será exibida.
2. Localize o ponto final a ser migrado.
3. Selecione os campos para preencher a mensagem da Push API.
   
   • Campos obrigatórios sempre enviados: ID do aplicativo, Nome do evento, IDFA (iOS) ou ID de publicidade (Android)
   • Use os controles representados na figura a seguir para selecionar os campos adicionais. 

     

     • Os campos selecionados com mais frequência são pré-selecionados. Você pode limpar a seleção.
     • Selecione os campos opcionais conforme necessário.
     • Use Limpar tudo para limpar todos os campos opcionais.
     • Em um futuro próximo, vamos parar de enviar campos nulos/vazios e a chave associada. Leve isso em conta ao planejar seus processos de importação/análise.
4. Selecione um ou mais (até 52 eventos) ou  Todos os eventos in-app.
   
   • A lista é preenchida por tipos de eventos que já foram gravados. Se estiver faltando um evento, envie um evento desse tipo usando um dispositivo de teste. 
5. Clique em Salvar
   • A Push API foi migrada. 
   • Os dados de conversão continuam sendo enviados para o ponto final.

Sintoma: a mensagem esta URL não é segura  é exibida quando você configura a URL do ponto final.

Ação necessária: entre em contato com o suporte da AppsFlyer, inclua a ID do aplicativo, a URL do endpoint e uma captura de tela da mensagem de erro.  

Se você não receber a mensagem de teste e restringir o acesso aos seus servidores por endereço IP: certifique-se de que você incluiu todos os endereços IP da AppsFlyer na lista de permissões. 

Os eventos de retargeting in-app são duplicados quando um evento de compra ocorre como parte da campanha de retargeting durante uma janela de reengajamento de UA. Isso é feito para atribuir receita à fonte de mídia de UA e à fonte de mídia de retargeting. 

Você só receberá um evento duplicado se tiver ativado os dois:

• Instalar eventos in-app
• eventos de retargeting in-app 

Eventos in-app atribuídos à fonte de mídia de UA (instalar eventos in-app) como parte de uma campanha de retargeting têm o campo is_primary_attribtuion=false. 

Como identificar eventos de retargeting duplicados?

O campo booleanois_primary_attribution identifica as fontes de mídia primárias e secundárias nas campanhas de retargeting:

• Falso: identifica a fonte de mídia original de UA. Observação: esse é o único cenário em que o valor é falso. 
• Verdadeiro: identifica a fonte de mídia de reengajamento 

O motivo disso é o seguinte: se um usuário, como resultado de uma campanha de retargeting, se envolver com a campanha, uma janela de reengajamento será aberta. A fonte de mídia de reengajamento é considerada a fonte de mídia primária quando a janela de reengajamento é aberta e a fonte de UA é secundária. Depois que a janela é fechada, a fonte de mídia original de UA volta a ser primária. 

• Mensagens de eventos in-app só podem ser selecionadas após a gravação de um evento in-app.
• Use um dispositivo de teste para gerar um evento in-app ou use a API S2S para fazer isso manualmente. 

Por padrão, o Facebook não libera dados brutos a nível do usuário até que você aceite os Termos de Serviço do Facebook. 
Depois de aceitar os termos, dados a nível do usuário vindos do Facebook e de outras fontes de dados brutos serão enviados pela Push API.

Você está usando Amazon CloudFront como seu endpoint? Nesse caso, verifique se o CloudFront está rejeitando a mensagem com o código de rejeição 421. Se sim, consulte Escolhendo como o CloudFront atende a solicitações de HTTPS