Transmissão de dados brutos da Push API

Características da mensagem

Tipos de mensagens disponíveis

Campos exclusivos

Essa seção descreve as mensagens (tipos de relatório) disponíveis para SKAN e como identificá-las. Leia o conteúdo e, em seguida, configure o endpoint de atribuição da SKAN.

Leitura adicional: campos de dados brutos da SKAN. As mensagens da Push API têm estrutura e campos equivalentes. 

Características da mensagem:

Tipos de mensagens para atribuição da SKAN

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

Requisitos do lado do servidor

Atenção! Um mecanismo de tempo limite, com duração de 4 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. 

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

Endpoint 

Tabela de planejamento do endpoint

Não.	Configuração	Detalhes	Use essa coluna para registrar suas configurações planejadas
1	Método	POST ou GET
2	URL do endpoint	-
3	Tipos de mensagem de evento	Selecione pelo menos um tipo de mensagem de evento. Para selecionar mensagens de eventos in-app, é necessário gravar um evento no aplicativo. Até você fazer isso, não poderá selecionar mensagens de evento in-app.
4	Campos  A lista de campos é comum a todos os tipos de mensagens	Aviso Se você marcar Selecionar tudo, os arquivos recém-adicionados também serão selecionados automaticamente. Certifique-se de que você pode oferecer suporte a todos os novos campos adicionados automaticamente ao esquema para evitar problemas. Selecione os campos obrigatórios. Os campos mais comuns são pré-selecionados por padrão. Não enviamos campos vazios/nulos
5	Tipo de evento in-app	Filtre por evento in-app para reduzir o tráfego enviado ao seu endpoint. Selecione um ou mais eventos ou todos os eventos in-app. Atenção! Se o evento não for exibido na lista, procure por ele.  Se você selecionar tudo, novos eventos in-app serão adicionados automaticamente.  Você só pode selecionar um evento in-app após ele ter sido gravado pelo menos uma vez. Se necessário, use o S2S para acionar o evento.

Atenção: Somente o proprietário da conta da AppsFlyer pode fazer alterações nas configurações da Push API. Outros usuários da conta podem visualizar as configurações.

Adicione um endpoint de atribuição da AppsFlyer

1. Acesse relatórios > acesso à API. Vá até a seção da Push API.
2. Clique em Adicionar Endpoint.
    
3. Selecione um método HTTP: POST ou GET
4. Insira a URL do Endpoint/strong>.  Se você receber a mensagem "essa 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. Atenção:
    
   • campos obrigatórios sempre enviados: App ID, nome do evento, horário do evento, IDFA (iOS) ou Advertising ID (Android)
   • Use os controles representados na figura a seguir para selecionar campos opcionais.
     • 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 endpoint usando o procedimento a seguir.

Para testar o endpoint:

1. Clique 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 2 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.  

Atenção: Somente o proprietário da conta da AppsFlyer pode fazer alterações nas configurações da Push API. Outros usuários da conta podem visualizar as configurações.

Para adicionar um endpoint da Push API da SKAdNetwork:

1. Acesse relatórios > acesso à API. Vá até a seção da Push API.
2. Selecione SKAdNetwork como a entidade de atribuição.  
3. Clique em Adicionar endpoint.
   Atenção: Você pode definir de 1 a 3 endpoints da SKAdNetwork por aplicativo. 
4. Selecione um método HTTP: POST ou GET
5. Insira a URL doEndpoint.   Se você receber a mensagem "essa 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 endpoint. 

Usando o token de autenticação da Push API, os clientes podem integrar e proteger suas mensagens da Push-API de forma contínua, adicionando um header de autorização personalizável com um token solicitado.
Você pode personalizar um header de autorização que será enviado com suas mensagens da Push-API, definindo o nome do token e o valor associado a cada app ID. Isso garante que suas mensagens não sejam apenas seguras, mas também adaptadas às suas necessidades específicas.

Atenção: somente o proprietário da conta da AppsFlyer pode fazer alterações nas configurações da Push API. Outros usuários da conta podem visualizar as configurações.

Para modificar as configurações do endpoint: 

1. Vá para Relatório > Acesso à API. Vá até a seção da Push API.
2. Localize o endpoint a ser modificado.
3. Faça as alterações.
4. Clique em Salvar.

Atenção: somente o proprietário da conta da AppsFlyer pode fazer alterações nas configurações da Push API. Outros usuários da conta podem visualizar as configurações.

Para excluir um endpoint:

1. acesse relatórios > acesso à API. Vá até a seção da Push API.
2. Clique em excluir endpoint.
3. Clique em salvar.
   O endpoint é 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:

• Eventos in-app à instalação
• Eventos in-app relacionados ao 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.  

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

Sintoma: a mensagem essa URL não é segura  é exibida quando você configura a URL do endpoint.

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

Não. A Push API é compatível com o uso do header Authorization apenas para tokens de autenticação. Headers personalizados adicionais — como consumer-key — não são compatíveis.

Se você precisar enviar parâmetros extras, inclua-os na URL. Por exemplo:

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