Integração com AppsFlyer ESP 2.0

Necessária a assistência de um desenvolvedor

Você precisará da ajuda da sua equipe de desenvolvimento para configurar a integração. Compartilhe este guia com eles.

O AppsFlyer é uma plataforma de atribuição móvel e análise de marketing. O AppsFlyer ESP 2.0 é a integração da AppsFlyer para provedores de serviços de e-mail (ESPs). Conecte o Pushwoosh com o ESP 2.0 para habilitar o rastreamento de links em campanhas de e-mail. Nesta integração, o Pushwoosh encapsula os URLs, e a solução ESP 2.0 mantém o deep linking funcionando para Universal Links do iOS e App Links do Android quando os links são encapsulados para rastreamento.

Essa integração também envia dados de cliques em links para o AppsFlyer, oferecendo visibilidade total do desempenho do e-mail juntamente com seus outros canais de marketing e permitindo que você meça o impacto real do e-mail na aquisição e no engajamento de usuários.

Visão geral da integração

Pré-requisitos

• Aplicativo Pushwoosh com envio de e-mail configurado
• Conta AppsFlyer com a integração AppsFlyer ESP 2.0. Este é um recurso premium. Entre em contato com seu CSM da AppsFlyer ou com o suporte da AppsFlyer para obter acesso.

Entidades sincronizadas

Os cliques em links de e-mail através do seu Domínio de Rastreamento de Cliques são registrados como estatísticas de cliques no Pushwoosh e como eventos de clique com dados de atribuição no AppsFlyer.

Casos de uso

• Rastreamento de cliques de e-mail: Meça os cliques em links de e-mail através do AppsFlyer.
• Deep linking a partir do e-mail: Mantenha os Universal Links (iOS) e App Links (Android) funcionando quando os links nos e-mails são encapsulados.

Como a integração funciona

Assim que a integração estiver ativa, cada clique passa por três etapas:

1. O Pushwoosh substitui os links em seus e-mails por URLs de rastreamento em seu CTD, por exemplo: https://clickpush.yourdomain.com/json/1.3/emailRedirect?d=...

2. Quando um usuário toca no link, a solicitação vai para o AppsFlyer através do CNAME configurado. O AppsFlyer registra a atribuição, lida com o deep linking e redireciona o usuário para o URL final ou para dentro do aplicativo via Universal Link / App Link. Ele também envia uma solicitação GET para o Pushwoosh, passando seu CTD no cabeçalho Host, para que o Pushwoosh possa registrar o clique:

   GET https://<Pushwoosh CNAME target>/json/1.3/emailRedirect
   Host: <your CTD>

3. O Pushwoosh recebe a solicitação e registra o clique para suas próprias estatísticas.

Configurando a integração

Pushwoosh vs. AppsFlyer

O Pushwoosh está envolvido apenas na configuração inicial do CTD. O restante da integração é concluído do lado do AppsFlyer.

Etapa 1. Crie e ative um domínio de rastreamento de cliques

O Domínio de Rastreamento de Cliques (CTD) é a parte do domínio de um URL de link rastreado exibido em uma mensagem de e-mail. Ele combina um subdomínio com seu domínio principal, por exemplo, clickpush.esp-integrations1.com. O subdomínio é criado nas configurações de DNS do seu domínio com seu provedor de domínio, geralmente adicionando um registro CNAME.

Novo CTD necessário

A criação de um novo CTD é obrigatória para a integração com o AppsFlyer ESP 2.0, mesmo que você já esteja usando um domínio de rastreamento de cliques existente. Usar um novo evita impactar o tráfego de suas campanhas de e-mail atuais.

Para mais detalhes, consulte o guia da AppsFlyer: Configure sua integração ESP com a AppsFlyer.

1. Decida qual subdomínio você usará como seu CTD (por exemplo, clickpush.esp-integrations1.com).
2. No Pushwoosh, abra Configurações e selecione Configurar Plataformas.
3. Na página de Configuração do canal de e-mail, role até Domínio de rastreamento personalizado e selecione Habilitar.

Nota

A seção Domínio de rastreamento personalizado é exibida somente após a configuração do canal de e-mail para seu aplicativo. Se você não a vir, conclua primeiro a configuração de e-mail.

4. Insira seu CTD no campo Domínio e selecione Avançar.

5. Fora do Pushwoosh, abra o serviço onde você gerencia o DNS público para o domínio do seu CTD (geralmente seu registrador de domínio, um host DNS ou sua conta de hospedagem). Em seu editor de DNS ou de zona para esse domínio, adicione o CNAME que o Pushwoosh mostra nesta etapa para que seu CTD aponte para api.pushwoosh.com.

Propagação de DNS

As alterações de DNS geralmente entram em vigor em minutos, mas podem levar até 48 horas.

6. No Pushwoosh, selecione Verificar.

7. Quando a verificação for bem-sucedida, selecione Salvar.

8. Se precisar alterar o Domínio ou o registro DNS, selecione Voltar e ajuste as etapas anteriores.

9. Depois de clicar em Salvar, seu CTD aparece na lista de Domínio de rastreamento personalizado em Configuração do canal de e-mail.

Para desabilitá-lo mais tarde, selecione ... ao lado do seu CTD e, em seguida, selecione Desabilitar domínio de rastreamento personalizado.

Dica

Antes de continuar, envie um e-mail de teste e confirme que o link usa seu CTD.

Exemplo de link rastreado

https://clickpush.example.com/json/1.3/emailRedirect?d=...

Etapa 2. Inicie a integração no AppsFlyer

Na plataforma AppsFlyer, inicie a integração ESP 2.0. Siga o guia da AppsFlyer para configurar sua integração ESP.

O AppsFlyer solicitará os seguintes detalhes:

• Domínio de rastreamento de cliques: seu CTD (por exemplo, clickpush.example.com)
• Endpoint do ESP: api.pushwoosh.com (o destino do CNAME exibido no Pushwoosh quando você habilita o domínio de rastreamento personalizado)

O AppsFlyer validará a configuração. Mantenha o CNAME do CTD apontando para api.pushwoosh.com até que a validação seja concluída.

Etapa 3. Atualize o CNAME para o AppsFlyer

Depois que o AppsFlyer validar a configuração, ele fornecerá um domínio de roteamento (por exemplo, jyvls.espclicks.appsflyer.com).

Atualize seu CNAME para que o CTD aponte para o AppsFlyer em vez do Pushwoosh:

Antes:

clickpush.example.com → api.pushwoosh.com

Depois:

clickpush.example.com → jyvls.espclicks.appsflyer.com (use o domínio fornecido pelo AppsFlyer)

Tempo de propagação

Depois de atualizar o CNAME, a integração pode levar até 24 horas para começar a funcionar.

Após trocar o CNAME, envie um e-mail de teste e verifique se os links abrem corretamente e se os cliques aparecem no AppsFlyer.

O que acontece a seguir

Assim que a alteração entrar em vigor, o tráfego de cliques passará pela infraestrutura do AppsFlyer. O AppsFlyer fornece a camada de roteamento, SSL, AASA (Apple App Site Association) e Android App Links.

O Pushwoosh continua a encapsular links e registrar estatísticas de cliques. Nenhuma configuração adicional é necessária no Pushwoosh.

Para saber mais sobre a configuração e os testes do lado do AppsFlyer, consulte:

Configure sua integração ESP com o AppsFlyer

Guia de integração de provedor de serviços de e-mail