Visão geral: meça campanhas de notificação push tanto no iOS quanto no Android.
Visão geral
A AppsFlyer tem compatibilidade com a métrica de campanhas de notificação push de todos os fornecedores de push, além de campanhas implementadas diretamente sobre o Firebase Cloud Messaging ou Apple Push Notification Services (APNS).
Há 2 maneiras possíveis de implementar a integração:
- Usando templates do OneLink (recomendado).
- Enviando um objeto JSON com uma chave
af
no payload da notificação push (legado).
As conversões são exibidas no painel de visão geral, na visualização de retargeting ou unificada.
Como ela funciona?
Uma vez concluídas as etapas deste artigo, seu aplicativo funcionará da seguinte forma:
- Você aciona uma notificação push que contém um template do OneLink ou uma chave
af
em seu payload. - O usuário do aplicativo recebe a notificação push e clica nela.
- O aplicativo carrega e o SDK da AppsFlyer inicia.
- O SDK processa o payload da notificação push que abriu o aplicativo.
- O SDK extrai e envia os dados de atribuição para a AppsFlyer.
No cenário OneLink, se o OneLink for configurado para encaminhar o usuário para um local específico no aplicativo, o fluxo do deep link é acionado.
Pré-requisitos
Antes de continuar, certifique-se de que seu aplicativo tem o SDK da AppsFlyer integrado e pode receber notificações push.
Etapas
Para configurar a métrica de notificação por push, as seguintes etapas devem ser concluídas:
-
Criar uma notificação push que contenha uma chave de dados personalizada com o template OneLink ou uma chave
af
com um objeto JSON como seu valor. - Configurar o SDK para resolver a chave personalizada (feito pelo desenvolvedor do aplicativo).
- Testar a integração acionando uma notificação push.
- Veja o desempenho das campanhas de notificação push no painel.
1. Criando a notificação push
Primeiro, crie uma notificação push que contenha dados de atribuição usando um dos seguintes métodos.
Observação
Na demonstração a seguir, estamos usando Firebase como o fornecedor de push. As instruções devem ser aplicáveis a qualquer fornecedor de push, com pequenas diferenças (se houver). Consulte a documentação do respectivo fornecedor de push.
Usando OneLink (recomendado)
Este é o método recomendado para integrar a AppsFlyer com as notificações push.
- Crie um link do OneLink e configure-o para retargeting.
Observação: o OneLink é compatível tanto com URLs curtas como longas. - Na notificação push de dados personalizados, adicione o OneLink que contém os dados de atribuição que você deseja enviar à AppsFlyer.
Usando JSON (legado)
Observação
O seguinte documenta o método legado de integração da AppsFlyer com notificações push e está disponível para fins de compatibilidade com versões anteriores. Se você estiver criando um novo aplicativo, use a solução recomendada baseada no OneLink
Nos dados personalizados da notificação por push, adicione uma chave personalizada chamada af
que contenha os dados de atribuição que você deseja enviar para a AppsFlyer no formato JSON. Os seguintes parâmetros de atribuição são necessários:
pid
is_retargeting
C
2. Configurando o SDK
Esta tarefa exige alterações no código do app. Siga as instruções sobre como configurar o SDK:
- Ao implementar a solução recomendada baseada no OneLink:
- Informe ao desenvolvedor do aplicativo qual é o nome da chave personalizada que você adicionou à notificação. Neste exemplo, é
af_push_link
. - Envie estas instruções.
- Informe ao desenvolvedor do aplicativo qual é o nome da chave personalizada que você adicionou à notificação. Neste exemplo, é
- Ao implementar a solução legada baseada no JSON, envie estas instruções a seus desenvolvedores.
3. Testando a integração
Para testar se a métrica de notificação push está integrada corretamente, basta acionar uma notificação push na campanha que você montou na Etapa 1.
Se tudo estiver configurado corretamente, o SDK vai:
- Ouvir as notificações por impulso.
- Processar os dados de atribuição incorporados na notificação push e enviá-los para a AppsFlyer.
- Proceder com o fluxo regular de deep linking, se a métrica de notificação push for implementada usando o OneLink.
4. Visualizando as campanhas de notificação push no painel de instrumentos
Você pode ver os dados provenientes das notificações push no painel Retargeting.
Observação: AppsFlyer deduplica os dados de notificação push. Ou seja, se payloads idênticos são recebidos mais de uma vez, apenas um é contado.