Coloque sua marca no domínio do OneLink

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 (o aplicativo, por exemplo) 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 uma forma que o domínio
  completo (branded domain) aponte para a URL especificada (também conhecido como host da AppsFlyer).
  Isso está ilustrado na imagem de branded domain que aponta para os servidores da AppsFlyer (acima).

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

1. Na AppsFlyer, clique em Engajamento > Branded domains.
2. Clique + Novo branded domain.
3. No campo Branded domain, insira seu domínio completo conforme definido no DNS. Por exemplo, clique.abcdef.com. Observaçã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,
     a mensagem "CNAME da AppsFlyer encontrado" é exibida.

   • Se um CNAME não for encontrado, copie o destino CNAME da AppsFlyer e envie-o ao seu administrador do DNS para garantir que seus pontos de domínio completos sejam mapeados no destino. O administrador do DNS deve mapear seu domínio completo para um destino CNAME da AppsFlyer. Caso contrário, o branded domain é criado, mas não funciona.

     Observaçã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.

7. Clique em Concluído. Agora você pode criar novos links baseados no template do OneLink com seu branded domain.

   Observação

   • Se você já criou links com base no seu template OneLink sem o branded domain, eles ainda funcionam.
   • Pode levar 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 Engajamento > 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.

Certificado SSL personalizado (opcional)

O SSL gerenciado pela AppsFlyer é a opção padrão e recomendada para a maioria dos clientes e não requer nenhuma ação adicional, pois a AppsFlyer lida automaticamente com a emissão e renovação do certificado. Se houver requisitos específicos de segurança ou compliance, você pode usar sua própria autoridade certificadora (certificado SSL personalizado) em vez do SSL gerenciado pela AppsFlyer. Se você escolher essa opção, será responsável por emitir, fazer o upload, manter e renovar o certificado. Se o certificado expirar e não for renovado a tempo, o serviço poderá ser interrompido.

Para usar um certificado SSL personalizado:

1. Crie o branded domain. 

2. Na AppsFlyer, em Engajamento > Branded domains, passe o cursor sobre o domínio desejado e selecione o ícone "Certificado SSL personalizado". 
   

    

3. Preencha o formulário com as informações do certificado. 
   

    

4. Clique em Baixar CSR para fazer download de uma cópia do formulário que você acabou de preencher.
   
5. Forneça o arquivo CSR que você acabou de baixar para a autoridade certificadora de sua escolha. 
6. Assim que você receber seu novo certificado SSL, faça o upload novamente na AppsFlyer. 

• 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 dos branded domains do 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 Link ID personalizado. 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 de 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. Na AppsFlyer, no menu lateral, selecione Engajamento > 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 Engajamento > Branded domains.
2. Vá para o branded domain que você deseja verificar.
3. Clique no ícone Verificar ().

O registro CNAME do domínio não leva para a AppsFlyer

Mudar seu registro CNAME, de uma forma que ele deixe de direcionar para a AppsFlyer, resultará na exclusão do domínio personalizado na AppsFlyer.

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.