OneLink: links de marca com seu próprio domínio

A configuração de um branded domain consiste em associar um conjunto de domínio completo no DNS a um subdomínio OneLink na AppsFlyer, conforme descrito na imagem a seguir. 

Branded domain que direciona para servidores da AppsFlyer

Antes de começar:

• Escolha um nome de domínio completo, por exemplo, app.abcdef.com, em que
  abcdef.com é a sua marca. O subdomínio, por exemplo, o app, também pode ser personalizado.
• Solicite que o administrador do DNS crie o domínio completo (também conhecido como host). 
• Solicite que o administrador do DNS defina um registro CNAME de forma que o domínio
  completo (branded domain) aponte para a URL especificada (também conhecido como AppsFlyer host).
  Isso está ilustrado na imagem branded domain apontando para os servidores da AppsFlyer (acima). 

Para mapear seu domínio completo para um subdomínio do OneLink:

1. Acesse Experiências e Deep Linking > Branded domains.
2. Clique + Novo branded domain.
3. No campo Branded domain, insira seu domínio completo conforme definido no DNS. Por exemplo, click.abcdef.com - Atenção: não coloque um ponto após o domínio. 
4. Selecione o subdomínio do OneLink na lista exibida.  Se não houver lista,
   você precisa criar um template do OneLink, que fornecerá um
   subdomínio padrão.
5. Clique em Próximo.
6. Defina um registro CNAME:
   • Se o seu domínio estiver apontado corretamente para o CNAME da AppsFlyer,
     "AppsFlyer CNAME foi encontrado" é exibido.
   • Se um CNAME não for encontrado, copie o destino CNAME da AppsFlyer, envie-o ao seu administrador DNS e peça a ele que se certifique de que seus pontos de domínio completos sejam mapeados no destino CNAME. O administrador de DNS deve mapear seu domínio completo para um destino CNAME da AppsFlyer. Caso contrário, o branded domain é criado, mas não funciona.

     Atenção:

     O registro CNAME deve ser mapeado dentro de um período de 7 dias, começando na data de criação do branded domain e terminando na data especificada na caixa de diálogo de confirmação.
     Se o registro CNAME não for mapeado na data especificada, você deverá
     renovar o período de 7 dias.

   • Se você estiver usando seu branded domain para ESPs, antes de copiar o destino CNAME, selecione Usar o domínio de marca para uma configuração ESP.
7. Clique em Concluído. Agora você pode criar novos links baseados no template do OneLink com seu branded domain.

   Atenção:

   • Se você já criou links com base em seu template do OneLink sem o branded domain, eles ainda funcionarão.
   • Podem ser necessários até 24 horas para que um novo branded domain comece a funcionar.

Renove o período de 7 dias para mapear o registro CNAME

O novo branded domain não funcionará se o registro CNAME do seu domínio completo não for mapeado para a AppsFlyer em até 7 dias após sua criação.

Para renovar o período de 7 dias:

1. Na AppsFlyer, no menu lateral, selecione Engajar > Branded domains.
2. Acesse o branded domain que ainda não foi mapeado para a AppsFlyer, indicado pelo ícone de aviso ().
3. Clique no ícone de atualização () para renovar o período de 7 dias.

• Use as seguintes versões do SDK:
   
  • Android versão 4.10.1 e posterior
  • iOS versão 4.10.1 e posterior
  • O referral de convite de usuário (convide um amigo) requer o SDK V5.2.0 e posterior para iOS e Android  

Considerações de implementação do Branded Domains SDK

• Quando o deep linking é feito usando branded domains, o SDK da AppsFlyer não consegue obter dados de conversão para instalações e deep linking.
• Para solucionar isso, o desenvolvedor usa as setOneLinkCustomDomain e oneLinkCustomDomains APIs do SDK para Android e iOS, respectivamente.
• Essas APIs consultam o branded link, obtendo o OneLink para o qual ele está mapeado e completando-o.

public class AFApplication extends Application {

    @Override
    public void onCreate() {
    super.onCreate();
      
      // Set branded link domain. Don't include https:// as part of the domain. 
      AppsFlyerLib.getInstance().setOneLinkCustomDomain("promotion.greatapp.com");
      AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionListener, this);
      AppsFlyerLib.getInstance().start(this, AF_DEV_KEY);

    }
}

AppsFlyerLib.getInstance().setOneLinkCustomDomain("promotion.greatapp.com", 
                                                        "click.greatapp.com", 
                                                        "deals.greatapp.com");

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    /** APPSFLYER INIT **/
    [AppsFlyerLib shared].appsFlyerDevKey = @"SED_DEV_KEY";
    [AppsFlyerLib shared].appleAppID = @"123456789";
    [AppsFlyerLib shared].oneLinkCustomDomains = @[@"promotion.greatapp.com"];
    //...
    //...
  }

[AppsFlyerLib shared].oneLinkCustomDomains = @[@"promotion.greatapp.com", @"click.greatapp.com"];

   func application(_ application: UIApplication, didFinishLaunchingWithOptions 
        launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
          AppsFlyerLib.shared().appsFlyerDevKey = "6CQi4Be6Zs9oNLsCusPbUL"
          AppsFlyerLib.shared().appleAppID = "340954504"
          AppsFlyerLib.shared().oneLinkCustomDomains = ["example.com"]
          //...
          //...
   }

AppsFlyerLib.shared().oneLinkCustomDomains = ["promotion.greatapp.com", "click.greatapp.com"]

Pré-requisitos:

Antes de usar e testar branded domains, complete as etapas no workflow de branded domains.  

Para criar e testar branded domains:

1. Crie um link do OneLink usando o template do OneLink mapeado para o branded domain.
2. Copie o link de atribuição personalizado para um editor de texto.
3. O link de atribuição personalizado é composto por um subdomínio do OneLink, OneLink ID e custom Link ID. Substitua o subdomínio do OneLink pelo domínio completo do branded domain. Exemplo:
    

   Link de atribuição personalizado	Branded Domain
   abcdef.onelink.me/A1bc/dc1234ef	clique.abcdef.com/A1bc/dc1234ef

4. Use o Branded Link para testar instalações e deep linking.
5. Se você usa relatórios de dados brutos como parte do teste, o campo URL Original será preenchido pelos branded links.  

Para editar um mapeamento do branded domain

Você pode alterar o mapeamento de um domínio completo existente para um subdomínio diferente do OneLink. Não há necessidade de configurar um CNAME. 

1.  
   1. Na AppsFlyer, no menu lateral, selecione Engajar > Branded domains.
   2. Vá para o branded domain que você deseja editar.
   3. Clique no ícone Editar ().
   4. Selecione o novo subdomínio no OneLink.
   5. Clique em Próximo. Não há necessidade de configurar um CNAME. 
   6. Clique em Concluído.

Verifique um mapeamento de branded domain

Depois de alterar o subdomínio do OneLink mapeado para o seu branded domain, verifique se ele está mapeado corretamente:

1. Na AppsFlyer, no menu lateral, selecione Engajar > Branded domains.
2. Vá para o branded domain que você deseja verificar.
3. Clique no ícone Verificar ().

Excluir um mapeamento de branded domain: 

Para excluir um branded domain, entre em contato com seu CSM da AppsFlyer ou envie um e-mail para hello@appsflyer.com.