How can we help?

Integração do EmailLabs com AppsFlyer

  • Atualizado

Visão geral: o EmailLabs, uma plataforma de entrega e plataforma de analytics de e-mail, incorpora o OneLink da AppsFlyer em e-mails. Quando os destinatários de e-mails clicam no link, eles são direcionados por deep link para o seu Aplicativo.

emaillabs-af-logo.png

Introdução

ESPs (Email Service Providers ou provedores de serviços de e-mail) podem ser excelentes fontes de tráfego segmentado de usuários.

Um dos desafios ao usar ESPs é registrar cliques e, ao mesmo tempo, preservar a funcionalidade de Deep linking. Os ESPs encapsulam a URL de Deep linking com seu próprio domínio de registro de cliques. Essa ação muitas vezes interrompe os Links Universais do iOS.

No entanto, com ESPs que oferecem suporte a Links Universais além do seu domínio de registro de cliques, ainda é possível realizar o Deep linking e o registro de cliques com sucesso.

Pré-requisitos de versão do SDK

iOSAndroid
  • AppsFlyer iOS SDK versão 6.0.4

Etapa 1: Configuração da integração no EmailLabs

Para configurar a integração no EmailLabs:

  1. Configure seu domínio de acordo com este artigo
  2. Configure seu domínio de registro de cliques de acordo com este artigo e a captura de tela abaixo.

    whitelabel-section-2.png

  3. Ative o rastreamento de links de acordo com este artigo e a captura de tela abaixo.

    link-tracking-section-3.png

  4. Entre em contato com o suporte do EmailLabs em bok@emaillabs.pl e solicite a ativação do SSL.
  5. No EmailLabs, acesse Panel > SMTP Accounts > Settings > Deep Links e marque a caixa "Activated". Para aplicativos iOS, insira o ID do aplicativo da Apple no respectivo campo.

    deeplinking-section-5.png

Etapa 2: Configure seu SDK AppsFlyer

 Observação

Caso ainda não tenha feito isso, certifique-se de configurar seu aplicativo para que ele seja compatível com deep linking com o OneLink.

Depois de configurar seu domínio de registro de cliques para oferecer suporte a Links Universais conforme descrito anteriormente, você precisa configurar seu Aplicativo para fazer deep link e resolver esse link universal.

  1. Associe o domínio de registro de cliques no Xcode:

    configure-xcode-deeplinking-domain.png

  2. Forneça o domínio de gravação de cliques para a API do SDK setResolveDeepLinkURLs. Esta API precisa ser chamada antes da inicialização do SDK. Para obter mais informações, consulte a documentação do SDK aqui.
    [[AppsFlyerLib shared] resolveDeepLinkURLs = @[@"example.com",@"click.example.com"];
  3. Quando o aplicativo é invocado devido a um clique no Universal Link, o AppsFlyer SDK resolve o deep link e extrai o OneLink subjacente. Todos os parâmetros de deep link são então propagados para a API onAppOpenAttribution para execução da lógica de deep link.

Etapa 3: Envie e-mails com OneLink através do EmailLabs

  1. Crie uma URL do OneLink na página de gerenciamento de links (ou manualmente). Você deve codificar em URL os valores dos parâmetros.
  2. [Melhores práticas] Use os seguintes parâmetros:
    • pid (canal de mídia): Use um canal de mídia que indique esse uso, como EmailLabs.
    • c (campanha): Nome da campanha
    • af_dp: O esquema de URI de deep link para o qual você deseja direcionar seus usuários.
    • af_web_dp: Para onde redirecionar os usuários que clicam no link no desktop.
    • af_ios_url: Para onde redirecionar usuários que não têm o aplicativo e que clicam no link em um dispositivo iOS.
    • af_android_url: Para onde redirecionar usuários que não têm o aplicativo e que clicam no link em um dispositivo Android.
  3. Insira a URL do OneLink no e-mail.
    Exemplo:
    <a href="links.example.com" data-msys-sublink="appsflyer">Link para seu Aplicativo!</a>
  4. Se o e-mail fizer parte de uma campanha de retargeting, adicione o parâmetro is_retargeting=true.
    Isso indica que o link de atribuição é de uma campanha de retargeting. Saiba mais sobre retargeting.
  5. O EmailLabs encapsula o link com o domínio de clique definido para que um clique no domínio de clique redirecione para o link de atribuição do OneLink.

 Exemplo

Os parâmetros de URL no exemplo a seguir não estão codificados para facilitar a leitura. 

https://example.onelink.me/abcd?pid=emaillabs&c=Spring_Newsletter&is_retargeting=true&
af_dp=testapp://path/to/content&af_web_dp=https://www.example.com/path/to/content&
af_ios_url=https://www.example.com/path/to/content&af_android_url=https://www.example.com/path/to/content

Etapa 4: Teste seus links

Para testar a integração:

  1. Configure o EmailLabs.
  2. Crie uma URL do OneLink.
  3. Insira a URL em um e-mail.
  4. Envie um e-mail de teste para você mesmo. 

Resultado esperado:

  • Se você tiver o aplicativo instalado, ele deverá ser aberto e você será direcionado por deep link para a página definida no aplicativo.
  • Um clique se reflete em:
    • O dashboard da AppsFlyer, atribuído ao canal de mídia e à campanha.
    • Dados da EmailLabs.

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: