# Integração com AppsFlyer ESP 2.0
O [AppsFlyer](https://www.appsflyer.com/) é uma plataforma de atribuição móvel e análise de marketing. O [AppsFlyer ESP 2.0](https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide) é 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.
Esta integração também envia dados de cliques em links para o AppsFlyer, dando a você 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](/pt/product/first-steps/start-with-your-project/configure-platforms/email-verification/)
* Conta AppsFlyer com a [integração AppsFlyer ESP 2.0](https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide). Este é um recurso premium. Entre em contato com seu CSM da AppsFlyer ou com o suporte da AppsFlyer para obter acesso.
### Entidades sincronizadas
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 de 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:///json/1.3/emailRedirect
Host:
```
3. O Pushwoosh recebe a solicitação e registra o clique para suas próprias estatísticas.
## Configurando a integração
### Passo 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.
1. Decida qual subdomínio você usará como seu CTD (por exemplo, `clickpush.esp-integrations1.com`).
2. No Pushwoosh, abra **Settings**, depois selecione **Configure Platforms**.
3. Na página **Email channel configuration**, role até **Custom tracking domain** e selecione **Enable**.
4. Insira seu CTD no campo **Domain** e selecione **Next**.
5. Fora do Pushwoosh, abra o serviço onde você gerencia o DNS público para o domínio do seu CTD (normalmente 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`.
6. No Pushwoosh, selecione **Verify**.
7. Quando a verificação for bem-sucedida, selecione **Save**.
8. Se precisar alterar o **Domain** ou o registro DNS, selecione **Back** e ajuste as etapas anteriores.
9. Depois de clicar em **Save**, seu CTD aparece na lista **Custom tracking domain** em **Email channel configuration**.
Para desativá-lo mais tarde, selecione `...` ao lado do seu CTD e, em seguida, selecione **Disable custom tracking domain**.
### Passo 2. Inicie a integração no AppsFlyer
Na [plataforma AppsFlyer](https://hq1.appsflyer.com/), inicie a integração ESP 2.0. Siga o [guia da AppsFlyer para configurar sua integração ESP](https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer).
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.
### Passo 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)
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:
4. Insira seu CTD no campo **Domain** e selecione **Next**.
5. Fora do Pushwoosh, abra o serviço onde você gerencia o DNS público para o domínio do seu CTD (normalmente 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`.
6. No Pushwoosh, selecione **Verify**.
7. Quando a verificação for bem-sucedida, selecione **Save**.
8. Se precisar alterar o **Domain** ou o registro DNS, selecione **Back** e ajuste as etapas anteriores.
9. Depois de clicar em **Save**, seu CTD aparece na lista **Custom tracking domain** em **Email channel configuration**.
Para desativá-lo mais tarde, selecione `...` ao lado do seu CTD e, em seguida, selecione **Disable custom tracking domain**.
### Passo 2. Inicie a integração no AppsFlyer
Na [plataforma AppsFlyer](https://hq1.appsflyer.com/), inicie a integração ESP 2.0. Siga o [guia da AppsFlyer para configurar sua integração ESP](https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer).
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.
### Passo 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)
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: