Integração do Oracle Responsys com a AppsFlyer

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 dos ESPs é realizar atribuição correta e deep linking. Os ESPs agrupam o URL do deep link com seu próprio domínio de gravação de cliques do ESP.Esse procedimento geralmente interrompe a funcionalidade dos links universais do iOS e dos links de aplicativos do Android. 

No entanto, deep linking e gravação de cliques ainda são possíveis com ESPs que suportam links universais e links de aplicativos além de seu domínio de gravação de cliques. Além disso, você pode configurar seu próprio domínio de cliques para atuar como domínio de gravação de cliques.

Pré-requisitos

• Configure seu aplicativo para que haja compatibilidade do deep link com o OneLink.
• Verifique sua versão do SDK (Android e iOS)

Configurando o domínio de clique do Oracle Responsys

Siga esta seção para configurar seu domínio de clique (domínio de gravação de clique) no Oracle Responsys.

Etapa 1: configure um domínio de clique no Oracle Responsys

Para configurar um domínio de clique, siga o guia oficial do Oracle Responsys sobre como criar domínios de clique. O Oracle Responsys usa tabelas de links para ajudar a registrar cliques para uma campanha específica

Observe que, nas tabelas de links, você pode definir o URL do link do IOS como igual ao URL do link:

Depois de definir domínios de clique em tabelas de links, o Responsys usa esses domínios para agrupar OneLinks que você inclui em campanhas de e-mail. Dessa forma, o Responsys pode registrar cliques em seu sistema enquanto preserva a funcionalidade do OneLink e do deep link.

Etapa 2: forneça ao Responsys um AASA (iOS) e um arquivo Asset Links (Android)

Configurando seu aplicativo

<activity android:name=".DeepLinkActivity">
    <intent-filter  android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
           <category android:name="android.intent.category.DEFAULT" />
           <category android:name="android.intent.category.BROWSABLE" />
           <data android:scheme="https"
               android:host="click.example.com"
               android:pathPrefix="/campaign" />
     </intent-filter>
</activity>

Etapa 2: configurar o aplicativo para resolver domínios de cliques

O SDK precisa resolver o OneLink por trás do domínio de clique para obter os detalhes da campanha. Os detalhes são retornados no método onAppOpenAttribution.

Para resolver domínios de clique:

1. Certifique-se de que sua versão do SDK seja pelo menos 4.9.0.
2. Liste os domínios de clique na propriedade do SDK resolveDeepLinkURLs. Esta propriedade precisa ser definida antes da inicialização do SDK. Para obter mais informações, consulte a documentação do SDK aqui.
   
   Objective-C Swift

   [AppsFlyerTracker sharedTracker].resolveDeepLinkURLs = @[@"example.com",@"click.example.com"];

   AppsFlyerTracker.shared().resolveDeepLinkURLs = ["example.com", "click.example.com"]
   

   • Importante! Se você estiver usando o Movable Ink (MI) em conjunto com a Oracle, 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 Oracle. Exemplos de domínio:
     • Domínio Oracle: oracle-click.exemplo.com
     • Domínio MI CNAME: mi.exemplo.com
     • Domínio interno MI: exemplo.micpn.com
3. Adicione o seguinte código para que o SDK possa resolver o domínio de gravação de cliques:
   
   Objective-C Swift

   Adicione este código em AppDelegate.m

   - (NSDictionary *)allHTTPHeaderFieldsForResolveDeepLinkURL:(NSURL *)URL {
       if ([URL.host  isEqual: @"click.example.com"]) {
           return [NSDictionary dictionary];
       }
       else {
           return nil;
       }
   }

   Adicione este código em AppDelgate.swift

   func allHTTPHeaderFields(forResolveDeepLinkURL URL: URL!) -> [String : String]! {
       if (URL.host == "click.example.com") {
           /// Change User-Agent
           return [:]
       } else {
           return nil;
       }
   }
   

Enviando seu primeiro e-mail

1. Crie uma URL do OneLink na página Gerenciamento de links (ou manualmente).
2. Ao criar o URL do OneLink, certifique-se de codificar o URL de todos os valores dos parâmetros.
3. Os seguintes parâmetros são altamente recomendados para uso:
   • pid (fonte de mídia) - Use uma fonte de mídia que signifique esse uso, como E-mail.
   • c (campanha) – O nome da campanha que você deseja medir.
   • af_dp - O esquema de URI de deep link ao qual você deseja vincular seus usuários.
   • af_web_dp - Para onde redirecionar os usuários que clicam no link em um 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.
4. Coloque o URL do OneLink no e-mail que você cria no Responsys. Exemplo:

   <a href="greatapp.onelink.me/abcd/1234567">Download my great app!</a>

   Nesse estágio, a Responsys agrupa o link acima com o domínio de clique definido nas etapas anteriores. Qualquer clique no domínio de clique redireciona para o link de atribuição do OneLink. Se o aplicativo estiver instalado no dispositivo do usuário, há um deep link entre o domínio do clique e o aplicativo.

https://greatapp.onelink.me/abcd?pid=Email&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

Testando seus links

Depois de seguir todas as etapas necessárias mencionadas acima, criar o URL OneLink apropriado e colocá-lo em um e-mail, envie um e-mail de teste para si mesmo.

O que você deve esperar?

Se você tiver o aplicativo instalado, 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.
Além disso, um clique deve aparecer tanto no painel da AppsFlyer, atribuído à fonte de mídia e campanha fornecidas, quanto nos dados do Responsys.