Transmissão de dados brutos pela Push API

Esta seção descreve as mensagens (tipos de relatório) disponíveis para a SKAdNetwork e como identificar as mensagens. Leia esta seção e, em seguida, Configure o endpoint de atribuição da SKAdNetwork.

Leitura relacionada: Campos de dados brutos da SKAdNetwork. As mensagens da Push API têm estrutura e campos equivalentes. 

Determine o tipo de mensagem de atribuição da SKAdNetwork

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

• Use essa checklist para planejar suas configurações de endpoint de atribuição na AppsFlyer. Os números na figura correspondem aos números na linha da checklist.
• Esta seção não é relevante para a atribuição na SKAdNetwork. Consulte Configurar atribuição da SKAdNetwork. 

Ponto final 

• 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 atribuição da AppsFlyer:

1. Acesse Integração > Acesso à API.Role para baixo até a seção da Push API.
2. Clique em Adicionar Ponto Final 
3. Selecione um método HTTP: POSTou GET
4. Insira a URL de 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. Observaçã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 mais comuns são pré-selecionados por padrão. Você pode cancelar as seleções.
     • 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.  (Obrigatório para atribuição da AppsFlyer, mas não para atribuição da SKAdNetwork.)

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 endpoint. Se o teste falhar, certifique-se de que você incluiu os endereços de IP da AppsFlyer na lista de permissões.Atenção! Um mecanismo de tempo limite, com duração de 3 segundos, é usado. Se a AppsFlyer não receber uma mensagem de OK durante esse período, isso será considerado uma falha no envio da mensagem. 
2. Verifique se o endpoint recebeu a mensagem de teste.
   Veja uma cópia da mensagem enviada. 

Observação: somente o administrador pode fazer alterações nas configurações da API. Os membros da equipe podem visualizar as definições da Push API.

Para adicionar um endpoint da Push API da SKAdNetwork SKAdNetwork:

1. Acesse Integração > Acesso à API.Role para baixo até a seção da Push API.
2. Selecione SKAdNetwork como a entidade atribuidora. 
3. Clique em Adicionar endpoint. 
   Observação: você pode definir um endpoint da SKAdNetwork por aplicativo. 
4. Selecione um método HTTP: POSTou GET
5. Insira a URL do endpoint. Se você receber a mensagem esta URL não é segura, entre em contato com o suporte da AppsFlyer.
6. Não enviamos campos vazios/nulos e a chave associada. Leve isso em conta ao planejar seus processos de importação/análise.
7. Clique em Salvar.
   A Push API agora está ativa. Os dados são enviados para o ponto final. 

Observação: somente o administrador pode fazer alterações nas configurações da API. Os membros da equipe podem visualizar as definições da Push API.

 Para modificar as definições do ponto final: 

1. Acesse Integração > Acesso à API.Role para baixo até a seção da Push API.
2. Localize o ponto final a ser modificado.
3. Faça as modificações.
4. Clique em Salvar.

Observação: somente o administrador pode fazer alterações nas configurações da API. Os membros da equipe podem visualizar as definições da Push API.

Para excluir um endpoint:

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

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á eventos duplicados se ambos estiverem ativos:

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

Identificar e desduplicar eventos in-app

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

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 o ID do aplicativo, a URL do endpoint e uma captura de tela da mensagem de erro.