Visão geral: Integre dados da AppsFlyer com uma conta do Salesforce Marketing Cloud (SFMC) para criar deep links de e-mails de forma integrada. O fluxo utiliza a compatibilidade do SFMC com links universais em um domínio de registro de cliques de marca.
Introdução
ESP (Email Service Providers ou provedores de serviços de e-mail) são excelentes fontes de tráfego segmentado de usuários. No entanto, alguns ESP, e este é um problema comum de ESP, não realizam atribuição e deep link corretos.
Os ESPs agrupam o URL do deep link com seu próprio domínio de gravação de cliques do ESP. Este procedimento frequentemente interrompe o processo de Links Universais do iOS. No entanto, há ESPs que são compatíveis com Links Universais no domínio de gravação de cliques, portanto é possível executar deep linking e gravação de cliques.
Integrando o Salesforce Marketing Cloud com a AppsFlyer
As etapas 1 a 4 descritas abaixo são necessárias para ser compatível com deep linking do iOS.
Pré-requisitos
AppsFlyer iOS SDK versão 4.9.0
Para iOS Universal Links, você deve executar o seguinte no seu ambiente SFMC:
- Adquirir e implementar o Pacote de Autenticação do Remetente (Sender Authentication Package ou SAP)
- Compre um Certificado SSL (também conhecido como Configuração SSL) e envie um Formulário de Solicitação SSL
* Para obter o Pacote de Autenticação de Remetente e o Certificado SSL, entre em contato com seu Representante de Conta do Salesforce ou envie um caso de suporte de entrega por meio da Ajuda do Salesforce.
AppsFlyer Android SDK versão 4.9.0
O SFMC não é compatível com o Android App Links e, portanto, o deep linking do URI Scheme ainda é compatível. Nenhuma ação especial é necessária para ter compatibilidade com deep links nos appd do Android do SFMC.
Etapa 1: Defina seu domínio de gravação de cliques no SFMC
Para definir um domínio de gravação de cliques, siga os guias oficiais do SFMC para:
Etapa 2: Carregue seu certificado SSL no SFMC
Para que os Links Universais do iOS funcionem corretamente, seu domínio de gravação de cliques deve incluir o certificado SSL do seu domínio, que deve ser instalado na sua conta SFMC. Instruções sobre como configurar seus certificados SSL podem ser encontradas no guia oficial do SFMC.
Etapa 3: Definir deep linking no SFMC
Para habilitar deep linking de e-mails no SFMC:
- Entre na sua conta SFMC e vá para a visualização Email Studio
- Clique na aba Admin
- No menu lateral, clique em deep linking. Nesta visualização, você pode configurar uma nova integração de deep link com seu aplicativo ou modificar as existentes.
- Para criar uma nova configuração, clique no botão Criar e insira seu AppID. O valor do AppID é uma combinação do ID da sua equipe de desenvolvedores da Apple e do ID do pacote. Ambos os valores podem ser recuperados da sua conta de desenvolvedor da Apple.
Exemplo
Dado o prefixo de ID da equipe 5UABCDFGH e o ID do pacote com.your.app, o seguinte valor deve ser inserido:
5UABCDFGH.com.your.app - A configuração de links universais e deep linking é concluída quando o SFMC configura o arquivo Apple App Site Association (AASA). Este processo pode levar algumas horas. Você pode ver o arquivo gerado usando o seguinte URL:
https://<click_recording_link_domain>/apple-app-site-association
Etapa 4: 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 gravação de cliques para ser compatível com Links Universais, conforme descrito anteriormente, você precisa configurar seu aplicativo para fazer deep link e resolver o Link Universal.
- Associe o domínio de gravação de cliques no Xcode:
- 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"]-
Importante! Se você estiver usando o Movable Ink (MI) em conjunto com o Salesforce, será necessário obter o CNAME do MI e os domínios internos do seu gerente de conta do MI e adicioná-los a
setResolveDeepLinkURLs, além do link de clique para o Salesforce. Por exemplo:AppsFlyerLib.shared().resolveDeepLinkURLs = ["salesforce-click.example.com", "mi.example.com", "example.micpn.com"]
-
Importante! Se você estiver usando o Movable Ink (MI) em conjunto com o Salesforce, será necessário obter o CNAME do MI e os domínios internos do seu gerente de conta do MI e adicioná-los a
- 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.
Enviar e-mails com OneLink através do SFMC
- Crie um link do OneLink manualmente ou na página de links do OneLink no dashboard da AppsFlyer.
- O URL codifica todos os valores de parâmetros ao criar um OneLink.
- Estes são parâmetros altamente recomendados:
pid canal de mídia Canal de mídia representativo c nome da campanha Campanha que será atribuída. af_dp URL de deep link Redirecionamento de deep link para usuários. af_web_dp redirecionamento de desktop Redirecionamento para usuários de desktop. af_ios_url Redirecionamento para usuários de dispositivos iOS que não têm o aplicativo instalado.
af_android_url Redirecionamento para usuários de dispositivos Android que não têm o aplicativo instalado.
- Copie o link para o e-mail criado no Salesforce Email Studio.
- Agora, o Salesforce Marketing Cloud envolve o link com o domínio de registro de cliques que foi definido anteriormente.
- Qualquer clique no domínio de gravação de clique redireciona para o link de atribuição do OneLink.
Exemplo
Para fins de legibilidade, os parâmetros de URL não são codificados em URL:
https://example.onelink.me/ABcd?pid=Email&c=Spring_Newsletter&
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/contentTeste seus links
Para testar seus links de atribuição:
- Crie o URL OneLink apropriado.
- Coloque-o em um e-mail.
- Envie o e-mail para você mesmo.
- Clique no link.
- Se você tiver o aplicativo instalado no seu dispositivo, ele deverá ser chamado.
- Se as APIs de deep linking relevantes do SDK da AppsFlyer forem implementadas, deve haver um deep link para o conteúdo relevante.
- Um clique deve aparecer tanto no painel da AppsFlyer, atribuído à fonte de mídia e campanha fornecidas.
- Um clique aparece nos dados do Salesforce.