Guia de links diretos do OneLink™

Esquemas de URI são URLs que direcionam o usuário para as atividades dos aplicativos móveis. No Android, os esquemas de URI também podem ser usados para vincular usuários com links diretos a atividades específicas.

Se os usuários de um aplicativo digitarem um esquema de URI na barra de endereços de um navegador, o aplicativo inicia e os usuários são vinculados diretamente. A mesma coisa acontece quando os usuários clicam em links com esquemas de URI por trás deles.

A AppsFlyer oferece suporte à funcionalidade de links diretos do esquema de URI por meio de URLs do OneLink, usando o parâmetro af_dp.

Configuração de Esquemas do URI

A configuração do OneLink para o esquema de URI deve ser feita em colaboração entre o profissional de marketing e o desenvolvedor.

A configuração do esquema de URI ocorre em dois locais:

1. No modelo de página do OneLink
2. No aplicativo

O esquema de URI nas instruções abaixo é greatapp://.

Papel do profissional de marketing

Papel do desenvolvedor

<activity android:name="com.appsflyer.sample.Activity">    
      <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="greatapp" />
      </intent-filter>
</activity>

<activity android:name="com.appsflyer.sample.Activity1">    
      <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="greatapp" />
        <data android:host="activity1" />
      </intent-filter>
</activity>

<activity android:name="com.appsflyer.sample.Activity2">    
      <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="greatapp" />
        <data android:host="activity2" />
      </intent-filter>
</activity>

Testar Esquemas do URI 

Para testar o esquema de URI, crie um link de atribuição personalizado.

1. Gere um link de atribuição personalizado a partir do OneLink que você criou
2. Instale o aplicativo em seu dispositivo
3. Envie o link de atribuição para o dispositivo
4. Clique no link

Se o link não abrir o aplicativo, adicione o parâmetro af_force_deeplink=true ao link de atribuição personalizado. Por exemplo:

https://demo.onelink.me/1aBC/123ab45c?af_force_deeplink=true 

Limitações

A Apple e o Google não aplicam nomenclatura exclusiva para esquemas de aplicativos. Escolha um nome de esquema exclusivo para sua marca para evitar esquemas conflitantes nos diferentes aplicativos. Uma sugestão de nome de esquema seria a ID do pacote de seu aplicativo, ou seja, com.company.app.

Quando um OneLink com af_force_deeplink=true é aberto no iOS 12.3.1, a seguinte lógica se aplica:

• Uma caixa de diálogo é exibida perguntando ao usuário se o aplicativo foi instalado:
  • Se o usuário escolher OK (o aplicativo está instalado), a AppsFlyer tentará abrir o aplicativo usando o esquema de URI
  • Se o usuário escolher Cancelar (o aplicativo não está instalado), a AppsFlyer o redirecionará para a loja de aplicativos
  • Se o usuário escolher OK, mas o aplicativo não estiver instalado, uma mensagem de erro será exibida:
    

    

Para habilitar o OneLink para servir tanto para o iOS como para o Android, é importante que o mesmo esquema seja definido para ambas as plataformas. Veja aqui estão instruções para iOS e Android.

Atualmente, dispositivos da Amazon não oferecem suporte a links diretos por meio de esquemas de URI.

O método de links universais vincula o aplicativo móvel iOS a um website/domínio associado. Este guia mostra como criar e usar links universais com o OneLink.

Configurar links universais com o OneLink é um processo de duas etapas:

1. Configurar o OneLink
2. Configurar os aplicativos móveis para registrar os domínios aprovados

Configurar o OneLink

A configuração do OneLink para links universais deve ser feita em colaboração entre o profissional de marketing e o desenvolvedor.

Papel do desenvolvedor

 func onConversionDataReceived(_ installData: [AnyHashable: Any]) {
  //Handle Conversion Data (Deferred Deep Link)
  }
  
  func onConversionDataRequestFailure(_ error: Error?) {
    //    print("\(error)")
  }
  
  func onAppOpenAttribution(_ attributionData: [AnyHashable: Any]) {
    //Handle Deep Link Data
    
  }
  
  func onAppOpenAttributionFailure(_ error: Error?) {
  }
// Reports app open from a Universal Link for iOS 9 or later
  func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([Any]?) -> Void) -> Bool {
    AppsFlyerTracker.shared().continue(userActivity, restorationHandler: restorationHandler)
    return true
  }

  // Reports app open from deep link from apps which do not support Universal Links (Twitter) and for iOS8 and below
  func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
    AppsFlyerTracker.shared().handleOpen(url, sourceApplication: sourceApplication, withAnnotation: annotation)
    return true
  }

  // Reports app open from deep link for iOS 10 or later
  func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
    AppsFlyerTracker.shared().handleOpen(url, options: options)
    return true
  }
  

func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
	AppsFlyerTracker.shared().continue(userActivity, restorationHandler: nil)
	return true
}

-(void)onConversionDataReceived:(NSDictionary*) installData {
  //Handle Conversion Data (Deferred Deep Link)
  
}

-(void)onConversionDataRequestFailure:(NSError *) error {
  
  NSLog(@"%@",error);
}


- (void) onAppOpenAttribution:(NSDictionary*) attributionData {
  
  //Handle Deep Link
}

- (void) onAppOpenAttributionFailure:(NSError *)error {
  NSLog(@"%@",error);
}

// Reports app open from a Universal Link for iOS 9 or above
- (BOOL) application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> *restorableObjects))restorationHandler {
    [[AppsFlyerTracker sharedTracker] continueUserActivity:userActivity restorationHandler:restorationHandler];
    return YES;
  }

  // Reports app open from deep link from apps which do not support Universal Links (Twitter) and for iOS8 and below
  - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString*)sourceApplication annotation:(id)annotation {
    [[AppsFlyerTracker sharedTracker] handleOpenURL:url sourceApplication:sourceApplication withAnnotation:annotation];
    return YES;
  }
  // Reports app open from deep link for iOS 10
  - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
  options:(NSDictionary *) options {
    [[AppsFlyerTracker sharedTracker] handleOpenUrl:url options:options];
    return YES;
  }

Papel do profissional de marketing

Depois de completar as etapas acima, toda vez que os usuários clicarem em um URL de domínio autorizado (quando o aplicativo já estiver instalado no dispositivo), o iOS inicia o aplicativo associado como sua atividade padrão.

Manter o esquema de URI

Mesmo no iOS9+, ainda é importante implementar um esquema de URI. Alguns navegadores ou aplicativos não oferecem suporte a links universais e recorrem ao método de esquema de URI. Consulte o nosso guia sobre configuração de esquema de URI para links diretos.

Limitações dos links universais

Os links universais têm algumas limitações que você deve considerar.

Este método, que foi introduzido com o Android 6.0, é a versão da Google dos links universais e possui efeitos semelhantes. Para saber mais, consulte o nosso artigo sobre Links de aplicativos.

Configuração de links de aplicativos Android

A configuração do OneLink para links de aplicativos Android deve ser feita em colaboração entre o profissional de marketing e o desenvolvedor.

Papel do desenvolvedor

AppsFlyerLib.getInstance().sendDeepLinkData(this); 

Papel do profissional de marketing

Links diretos a atividades específicas

Links de aplicativo Android permitem que você vincule os usuários por links diretos a atividades específicas.

<activity android:name="com.king.candycrushsaga.DeepLink">
    <intent-filter>
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <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="demo.onelink.me"
            android:pathPrefix="/ST6c/c0aae4f" />
    </intent-filter>
</activity>

<activity android:name="com.appsflyersmaple.guide.DeepLink2">
    <intent-filter>
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <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="demo.onelink.me"
            android:pathPrefix="/ST6c/6f0b5993" />
    </intent-filter>
</activity>

<activity android:name="com.king.candycrushsaga.DeepLink3">
    <intent-filter>
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <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="demo.onelink.me"
            android:pathPrefix="/ST6c/b40bder4" />
    </intent-filter>
</activity>
      

Manter o esquema de URI

Ainda é importante implementar um esquema de URI, pois dispositivos Android ainda não oferecem suporte a links de aplicativo e recorrem ao método do esquema de URI. Consulte o nosso guia sobre configuração de esquema de URI para links diretos.

Limitações dos links de aplicativos

Os links de aplicativos possuem algumas limitações que você deve levar em conta.

Não são necessárias ações especiais

Para que o novo OneLink funcione, é preciso atualizar o arquivo AASA do aplicativo. Depois de criar o novo modelo do OneLink, envie uma nova versão para a loja. Somente os usuários do iOS que atualizaram para a nova versão poderão ativar um URL do OneLink criado no novo modelo.

1. Depois de criar o novo modelo do OneLink, copie a nova ID do OneLink gerada.
2. Copie o trecho XML na parte inferior da seção Link do aplicativo e adicione-o ao seu arquivo AndroidManifest.xml dentro do intent ao qual deseja vincular por links diretos, além dos intents anteriores.
3. Lance a nova versão na loja. Somente os usuários do Android que atualizaram para a nova versão poderão ativar um URL do OneLink criado no novo modelo.

1. Instale e inicie o aplicativo no seu dispositivo (ou simulador de iPhone no iOS).
   [Se o aplicativo acabou de ser instalado, coloque o aplicativo na tela de fundo e depois volte para o primeiro plano duas ou mais vezes.]
2. Prepare um URL do OneLink para o aplicativo, o qual tem o parâmetro af_dp com um caminho de esquema válido (por exemplo, "aplicativo://cars").
3. No dispositivo testado, cole o link no e-mail, anotações, SMS, gerador de código QR etc.
4. Clique no link.

Resultado esperado: o aplicativo deve abrir na atividade solicitada, apontada por af_dp.

1. Saia do aplicativo.
2. Exclua o aplicativo.
3. Prepare um URL do OneLink para o aplicativo, o qual tem o parâmetro af_dp(ou outro) com um caminho de esquema válido (por exemplo, "aplicativo://cars").
4. No dispositivo testado, cole o link no e-mail, anotações, SMS, gerador de código QR etc.
5. Clique no link.
6. Instale e inicie o aplicativo no seu dispositivo (ou simulador de iPhone no iOS).

Resultado esperado: o link (dados de conversão) é fornecido pelo aplicativo na primeira inicialização. O parâmetro af_dp é extraído e o usuário é redirecionado dentro do aplicativo de acordo com o valor af_dp.

1. Instale e inicie o aplicativo no seu dispositivo (ou simulador de iPhone no iOS).
   [Se o aplicativo acabou de ser instalado, coloque o aplicativo na tela de fundo e depois volte para o primeiro plano duas ou mais vezes.]
2. Prepare um URL do OneLink para o aplicativo, o qual tem o parâmetro af_dp(ou outro) com um caminho de esquema válido (por exemplo, "aplicativo://cars").
3. iOS – cole o link nas Anotações, iMessage or em um e-mail usando o Apple Mail Client.
   Android – cole o link no e-mail, Chrome, SMS, gerador de código QR etc. Não use Slack, Facebook ou qualquer outro aplicativo social para clicar no link!
4. Clique no link.

Resultado esperado: o aplicativo abre imediatamente, sem redirecionamento através do navegador. O parâmetro af_dp é extraído e o usuário é redirecionado dentro do aplicativo de acordo com o valor af_dp.

Sim, mas apenas parcialmente. Embora o OneLink seja uma ferramenta integral para links diretos, os URLs regulares específicos do aplicativo também podem realizar a vinculação de usuários por links diretos, que usam esquema do URI. Efetivamente, isso significa que você pode usar links diretos em aplicativos Android, simplesmente adicionando o parâmetro af_dp a um link de atribuição regular da AppsFlyer.
Links universais, que é o método de vinculação profunda disponível para mais de 98% dos usuários iOS, só podem ser ativados pelo OneLink e não por links de atribuição regulares de plataformas únicas.

Infelizmente, sim.
Os aplicativos de redes sociais tratam links diretos a partir de posts virais de maneiras diferentes, o que muitas vezes interrompe a experiência do usuário. A alternativa recomendada pela AppsFlyer para diagnosticar e redirecionar dispositivos pelo OneLink é usar páginas de destino, conforme explicado no guia Redirecionamentos do OneLink.

Para fins de links direto existe outra solução alternativa, que pode ser usada quando o link universal ou o link do aplicativo estiver quebrado por causa do aplicativo host, por exemplo, stories do Instagram com o OneLink. A solução é forçar o uso de um esquema de URI para links diretos.

1. Adicione o parâmetro af_dp ao OneLink e especifique o caminho para a atividade vinculada profundamente (mais detalhes)

2. Adicione &af_force_deeplink=true ao link de atribuição para forçar o uso de af_dp

Essa alternativa funciona bem para usuários ativos, ou seja, os usuários que possuem o aplicativo instalado em seus dispositivos. No entanto, no iOS, os usuários do Safari que não possuem o aplicativo instalado recebem uma mensagem de erro do sistema e depois são redirecionados para o fallback definido.

Você não pode excluir um modelo do OneLink. Não recomendamos excluir modelos do OneLink, pois isso pode afetar as campanhas ativas. Em vez disso, veja se você consegue alterar a configuração do modelo. Se você ainda desejar excluir o modelo do OneLink, entre em contato com o gerente de atendimento ao cliente ou envie um e-mail para hello@appsflyer.com.

Sim, mas alterar o subdomínio do OneLink pode fazer com que links diretos e links personalizados parem de funcionar. É sempre melhor criar uma nova configuração do OneLink e links personalizados e retirar de uso gradativamente o OneLink antigo e os links personalizados que dependem dele.

Alterar o subdomínio do OneLink

1. Altere o subdomínio do OneLink — você pode fazer isso na configuração do modelo do OneLink.
2. Atualize os links personalizados que dependem da configuração do OneLink:
   1. Vá para Gerenciamento de links personalizados.
   2. Clique no link que você deseja atualizar.
   3. Não faça alterações — basta clicar em Update Link (Atualizar link) na parte inferior da página.
3. Atualize sua configuração do Android — consulte a configuração de links de aplicativos Android, especificamente a seção sobre como adicionar filtro de intenção às atividades no AndroidManifest.xml.
4. Atualize sua configuração do iOS — consulte a configuração de links universais, especificamente a seção sobre a configuração de domínios aprovados no XCode.
5. Publique os dois aplicativos nas lojas de aplicativos.

Os links diretos não funcionam para usuários com versões mais antigas do aplicativo, antes das alterações no subdomínio do OneLink. É por isso que você precisa publicar os aplicativos nas lojas de aplicativos depois de alterar o subdomínio do OneLink.

Sim. E não.
O af_dp pode conter um valor de URI e quaisquer parâmetros podem ser transferidos como parte do caminho de URI, por exemplo, af_dp=greatapp%3A%2F%2Fparam1%2Fparam2 (greatapp://param1/param2).

Mais fácil ainda, você pode adicionar quaisquer parâmetros ao link de atribuição após o caractere "?".

Contudo, concatenar parâmetros ao valor de af_dp após "?" NÃO é recomendado. Os parâmetros podem ser descartados e não estar disponíveis por meio de dados de conversão ou por meio de outras APIs. Exemplo ruim: af_dp=greatapp%3A%2F%2F%3Fparam1%3Da%26param2%3Db (greatapp://?param1=a&param2=b).

Isso significa que a integração do SDK para vinculação profunda não foi totalmente concluída. O método continueUserActivity no AppDelegate está faltando e deve ser chamado.

Isso geralmente acontece como resultado do código no aplicativo que realiza um redirecionamento para um navegador, quando um link https inicia o aplicativo.

No iOS 9 e 10 (removido do iOS 11), há uma opção para ignorar links diretos. Quando um aplicativo é aberto pelos Links universais, o iOS mostra um link para ignorar links diretos no canto superior direito, que define aquele link a ser aberto sem links diretos.

Essa é uma configuração por aplicativo salva em cada dispositivo exclusivo. A configuração é preservada mesmo se você excluir o aplicativo e reinstalá-lo. A única maneira de reverter isso é reativar o comportamento do link universal para esse aplicativo no seu dispositivo. Há algumas maneiras de fazer isso:

Para redefinir essa configuração, cole o OneLink no Notes ou iMessage (ou em algum outro aplicativo com suporte a links universais), pressione e segure. Você verá a opção "Open in [aplicativo]". Selecione-a e todos os Links universais para esse aplicativo funcionarão novamente.

Selecione Open in your app (por exemplo, abrir no LoginBox).
Os links diretos agora estão restaurados.

Apliquei um toque longo, mas não vejo a opção "Abrir no seu aplicativo"!

• Os aplicativos iOS são desenvolvidos com um arquivo de provisionamento (semelhante a uma licença). Este arquivo é gerado no console do desenvolvedor da Apple e deve ser habilitado para Links Universais.
• No Xcode – certifique-se de que Associar domínios está habilitado na aba Recursos e inclui o domínio do OneLink para o aplicativo.
• Certifique-se de que a ID de Equipe do aplicativo corresponde àquela digitada na página de configuração do OneLink.

Excluir o aplicativo, reinstalar e executar novamente. Se o problema persistir, tente adicionar outra linha em Associar domínios (para que este mude). Em seguida, exclua o aplicativo e repita o processo. Também certifique-se de que o seu OneLink tem o mesmo domínio configurado no aplicativo.

Ei, nós te ouvimos. Se tudo o que foi descrito acima não resolveu o problema, tente gerar os arquivos de provisionamento novamente para seu aplicativo. Faça download desses arquivos mais uma vez e clique duas vezes para instalá-los no Xcode.
Você também pode tentar excluir o aplicativo e reinstalá-lo com uma versão avançada do aplicativo.

O iOS 11.2, e todos os seus patches subsequentes, apresentam um bug que por vezes impede os links diretos por meio de links universais.

Aparentemente, o arquivo apple-app-site-association, usado para abrir aplicativos com links universais e automaticamente baixado ao instalar qualquer aplicativo iOS, por vezes não consegue ser baixado ao instalar aplicativos em dispositivos que possuem iOS 11.2 e superior. Sem esse arquivo no dispositivo iOS é impossível que os links universais abram os aplicativos diretamente.

Se você se deparou com este problema ao testar links diretos, desinstale o aplicativo, reinicie seu dispositivo iOS (incluído na lista branca) e reinstale o aplicativo. O problema persiste? Tente novamente.

Ainda desconhecemos a proporção que este problema esporádico tomou, embora o problema tenha se apresentado em vários dispositivos iPhone que rodam o iOS 11.2. Esperamos que a Apple resolva logo esse bug que pode afetar os links direto para mais de 2/3 dos usuários iOS.

Observação: Ao clicar no botão Seguir na parte superior da tela você pode ser notificado quando o problema for resolvido ou quando este artigo for atualizado.

A exclusão de usuários prejudica a atribuição e a coleta de dados. Aqui está o motivo pelo qual eles impedem o funcionamento correto do mecanismo de links diretos e como isso pode ser corrigido.

Com relação a links de aplicativos ou links universais, há uma diferença na resposta de onAppOpenAttribution dependendo do tipo de OneLink usado.

Para iOS e Android, ao usar a versão curta do OneLink, os dados de conversão são um mapa estruturado de todos os parâmetros no link:

Exemplo:

{
  af_dp: "superapp://Deeplink",
  pid: "media_source_name"
  c: "campaign_name",
  link: "https://abcd.onelink.me/12ab/12ab34c"
  is_retargeting: true
}

Por outro lado, a versão longa do OneLink produz um mapa com um par de chave-valor único que contém todo o OneLink

{
  "link": "https://abcd.onelink.me/12ab?pid=media_source&c=campaign_name&is_retargeting=true&af_dp=superapp%3A%2F%2FDeepLink"
}

A resposta para o OneLink curto é bem estruturada e mais fácil de analisar. Portanto, recomendamos usar a versão curta do OneLink.