Links universais e App Links

Este artigo descreve como configurar links universais da Apple e Android App Links.

Os links universais da Apple e os Android App Links são mecanismos criados para proporcionar uma transição fluida entre conteúdo web e apps móveis. Enquanto os links universais são específicos do iOS, os Android App Links servem ao mesmo propósito para aplicativos Android.

Como os links universais e App Links funcionam

Os links universais (iOS) e App Links (Android) são links web padrão (http://mydomain.com) que apontam tanto para uma página web quanto para um conteúdo dentro de um app.

Quando um link universal ou App Link é aberto, o sistema operacional verifica se algum app instalado está registrado para aquele domínio. Se um app for encontrado, ele é aberto imediatamente sem carregar a página web. Se nenhum app for encontrado, a URL web é carregada no navegador padrão do usuário, que também pode ser configurado para redirecionar para a App Store ou Google Play Store, respectivamente.

Em termos simples, os links universais permitem que um site associe suas páginas web a telas específicas do app. Assim, quando um usuário clica em um link para uma página web que corresponde a uma tela do app, o app pode ser aberto diretamente (se estiver instalado).

Esta tabela descreve as principais diferenças entre links universais e deep links tradicionais:

Casos de uso

Os links universais e App Links são mais comumente usados em Campaigns de e-mail, já que os e-mails podem ser abertos e clicados tanto em dispositivos desktop quanto móveis.

Alguns canais não funcionam bem com esses links. Por exemplo, notificações por push, mensagens no app e Content Cards devem usar deep links baseados em esquema (mydomain://).

Pré-requisitos

Para usar links universais e App Links:

• Seu site deve ser acessível via HTTPS
• Seu app deve estar disponível na App Store (iOS) ou Google Play Store (Android)

Configurando links universais e App Links

Para que os apps suportem links universais ou App Links, tanto o iOS quanto o Android exigem que um arquivo especial de permissões seja hospedado no domínio do link. Esse arquivo contém definições de quais apps podem abrir links daquele domínio e, no caso do iOS, quais caminhos esses apps podem abrir:

• iOS: Arquivo Apple App Site Association (AASA)
• Android: Arquivo Digital Asset Links

Além desse arquivo de permissões, existem definições codificadas de quais domínios de link o app pode abrir, configuradas dentro do próprio app:

• iOS: Definido como “Associated Domains” no Xcode
• Android: Definido no arquivo AndroidManifest.xml do app

Essa associação bidirecional entre domínio e app é necessária para que um link universal ou App Link funcione e impede que qualquer app sequestre links de um domínio específico ou que qualquer domínio abra um app específico.

• ios
• android

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "JHGFJHHYX.com.facebook.ios",
        "paths": [
          "*"
        ]
      }
    ]
  }
}

Links universais, App Links e rastreamento de cliques

Nossos parceiros de envio de e-mail, SendGrid e SparkPost, usam domínios de rastreamento de cliques para encapsular todos os links e incluir parâmetros de URL para rastreamento de cliques nos e-mails da Braze.

Por exemplo, um link como https://www.example.com se torna algo como https://links.email.example.com/uni/wf/click?upn=abcdef123456….

Para permitir que links de e-mail com rastreamento de cliques funcionem como links universais ou App Links, você precisará realizar algumas configurações adicionais. Certifique-se de adicionar o domínio de rastreamento de cliques (links.email.example.com) como um domínio que o app pode abrir. Além disso, o domínio de rastreamento de cliques deve servir os arquivos AASA (iOS) ou Digital Asset Links (Android). Isso ajudará a garantir que os links de e-mail com rastreamento de cliques funcionem perfeitamente.

Se você não quiser que todos os links de rastreamento de cliques sejam links universais ou App Links, pode especificar quais links devem ser links universais com base no parceiro de envio de e-mail. Consulte as seções a seguir para mais detalhes.

SendGrid

Para tratar um link de rastreamento de cliques do SendGrid como um link universal:

1. Configure os valores de pathPrefix do AASA ou AndroidManifest para tratar apenas links com /uni/ no caminho da URL como links universais.
2. Adicione o atributo universal="true" à tag âncora (<a>) do seu link. Isso altera o caminho da URL do link encapsulado para incluir /uni/.

Por exemplo:

1
<a href=”https://www.example.com” universal="true">

3. Certifique-se de que seu app está configurado para tratar os links encapsulados corretamente. Consulte o artigo do SendGrid sobre Resolving SendGrid Click Tracking Links e siga as etapas para o seu sistema operacional. Este artigo contém código de exemplo para iOS e Android.

Com essa configuração, links com /uni/ no caminho da URL funcionarão como links universais, enquanto todos os outros links funcionarão como links web.

SparkPost

Para tratar um link de rastreamento de cliques do SparkPost como um link universal, adicione o seguinte atributo à seção de atributos do editor de arrastar e soltar para e-mail, ou edite manualmente o HTML do link para incluir o seguinte atributo na tag âncora do seu link: data-msys-sublink="custom_path".

Esse caminho personalizado permite que você trate seletivamente URLs com esse valor como um link universal.

Por exemplo:

1
<a href=”https://www.example.com” data-msys-sublink="open-in-app">

Em seguida, certifique-se de que seu app está configurado para tratar o caminho personalizado corretamente. Consulte o artigo do SparkPost sobre Using SparkPost click tracking on deep links. Este artigo contém código de exemplo para iOS e Android.

Desativando o rastreamento de cliques link a link

Você pode desativar o rastreamento de cliques para links específicos adicionando código HTML à sua mensagem de e-mail no editor de HTML ou a um bloco HTML no editor de arrastar e soltar.

SendGrid

Se o seu prestador de serviço de e-mail for o SendGrid, use o código HTML clicktracking=off assim:

<a clicktracking=off href="[INSERT https LINK HERE]">click here</a>

SparkPost

Se o seu prestador de serviço de e-mail for o SparkPost, use o código HTML data-msys-clicktrack="0" assim:

<a data-msys-clicktrack="0" href="[INSERT https LINK HERE]">click here</a>

Amazon SES

Se o seu prestador de serviço de e-mail for o Amazon SES, use o código HTML ses:no-track assim:

<a ses:no-track href="[INSERT https LINK HERE]">click here</a>

Editor de arrastar e soltar

Ao usar o editor de arrastar e soltar para e-mail, insira seu código HTML como um atributo personalizado se o link estiver vinculado a um texto, botão ou imagem.

Atributo personalizado para um link de texto

SendGrid

Selecione o seguinte para o atributo personalizado:

• Name: clicktracking
• Value: off

SparkPost

Selecione o seguinte para o atributo personalizado:

• Name: data-msys-clicktrack
• Value: 0

Atributo personalizado para um botão ou imagem

SendGrid

Selecione o seguinte para o atributo personalizado:

• Name: clicktracking
• Value: off
• Type: Link

SparkPost

Selecione o seguinte para o atributo personalizado:

• Name: data-msys-clicktrack
• Value: 0
• Type: Link

Solução de problemas de links universais com rastreamento de cliques

Se seus links universais não estiverem funcionando como esperado nos seus e-mails, como navegar o destinatário do app de e-mail para o navegador web antes de finalmente redirecionar para o app, consulte estas dicas para solucionar problemas na configuração do seu link universal.

Verifique a localização do arquivo de link

Certifique-se de que o arquivo AASA (iOS) ou Digital Asset Links (Android) está localizado no lugar correto:

• iOS: https://click.tracking.domain/.well-known/apple-app-site-association
• Android: https://click.tracking.domain/.well-known/assetlinks.json

É importante garantir que esses arquivos estejam sempre acessíveis publicamente. Se você não conseguir acessá-los, pode ter pulado uma etapa na configuração dos links universais para e-mail.

Verifique as definições de domínio

Certifique-se de que você tem as definições corretas para os domínios que seu app pode abrir.

• iOS: Revise os Associated Domains configurados no Xcode para o seu app (etapa 1c). Verifique se o domínio de rastreamento de cliques está incluído nessa lista.
• Android: Abra a página de informações do app (pressione e segure o ícone do app e clique em ⓘ). No menu de informações do app, localize Abrir por padrão e toque nessa opção. Isso deve mostrar uma tela com todos os links verificados que o app pode abrir. Verifique se o domínio de rastreamento de cliques está incluído nessa lista.