Implementando Domínios de Marca

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

Domínio de Marca que direciona para servidores da AppsFlyer

Antes de começar:

• Escolha um nome de domínio completo, por exemplo, click.abcdef.com em que abcdef.com é a sua marca.
  • O subdomínio, por exemplo, click, também pode ser personalizado.
• Solicite que o administrador do DNS crie o domínio completo (também conhecido como host). 
• Peça para o administrador do DNS configurar um registro CNAME de forma que o domínio completo (domínio da marca) direcione para a URL especificada (também conhecida como host da AppsFlyer). Isso é representado na imagem de Branded Link que direciona para servidores da AppsFlyer (acima). 

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

1. Acesse Engajamento e Deep Linking > Domínios de Marca.
2. Clique em Adicionar Domínio de Marca.
3. No campo Domínio da marca, insira seu domínio completo conforme definido no DNS. Por exemplo, click.abcdef.com
   Não coloque um ponto após o domínio. 
4. Selecione o subdomínio do OneLink na lista exibida. 
5. Clique em Verificar.
   O status das configurações de DNS é exibido. Consulte a identificação e solução de problemas em caso de erro.
   

Para verificar se um Domínio de Marca está operacional: 

1. Acesse Engajamento e Deep Linking > Domínios de Marca.
2. Selecione o Domínio de Marca.
   A janela de edição é aberta.
3. Clique em Verificar.
   O status das configurações de DNS é exibido. Ambos devem ter uma marca de verificação verde para confirmar se estão corretamente configurados no DNS. Se algum deles tiver uma marca de verificação vermelha, entre em contato com o administrador do DNS.
   Observação: seus registros do DNS DEVEM habilitar o letsencrypt.org para criar um certificado para seu domínio (CAA). 

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

Considerações de implementação do SDK de Domínios de Marca

• Quando o deep linking ocorre usando Domínio de Marca, o SDK da AppsFlyer não consegue obter dados de conversão para instalações e deep linking.
• Para superar isso, o desenvolvedor usa a API do SDK setOneLinkCustomDomain e oneLinkCustomDomains para Android e iOS, respectivamente.
• Essa API consulta o branded link, obtém o OneLink para o qual ele está mapeado e, finalmente, consulta o OneLink para obter dados de conversão. Exemplo de configuração. 

public class AFApplication extends Application {

    @Override
    public void onCreate() {
    super.onCreate();

      AppsFlyerConversionListener conversionListener = new AppsFlyerConversionListener() {

        // implement AppsFlyerConversionListener callbacks 
        // see https://support.appsflyer.com/hc/en-us/articles/207032126#integration-32-initializing-the-sdk

      }
      
      // set branded link 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 Domínios de Marca, complete as etapas no fluxo de trabalho dos Domínios de Marca. 

Para criar e testar Domínios de Marca:

1. Crie um link de atribuição personalizado usando o template do OneLink mapeado para o Domínio de Marca.
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, ID do OneLink e ID de link personalizado. Substitua o subdomínio do OneLink pelo domínio completo do Domínio de Marca. Exemplo:

   Link de atribuição personalizado	Domínio de Marca
   abcdef.onelink.me/A1bc/dc1234ef	click.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. 

A edição permite que você altere o mapeamento de um domínio completo existente para um subdomínio do OneLink diferente. Não há necessidade de configurar um CNAME. 

Para editar um mapeamento do Domínio de Marca:

1. Acesse Experiências e Deep Linking > Domínio de Marca.
2. Clique no botão Ação.
3. Clique em Editar.

Para excluir um mapeamento de Domínio de Marca: 

• Acesse Experiências e Deep Linking > Domínio de Marca.
• Clique no botão Ação.
• Clique em Excluir.