Links universais e links de aplicativos

Os links universais da Apple e os links de aplicativos do Android são mecanismos criados para proporcionar uma transição perfeita entre o conteúdo da Web e os aplicativos móveis. Embora os links universais sejam específicos do iOS, os Android App Links têm a mesma finalidade para os aplicativos Android.

Como funcionam os links universais e os App Links

Os links universais (iOS) e os links de aplicativos (Android) são links padrão da Web (http://mydomain.com) que apontam para uma página da Web e para um conteúdo dentro de um aplicativo.

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

De forma simples, os links universais permitem que um site associe suas páginas da Web a telas de aplicativos específicos, de modo que, quando um usuário clica em um link para uma página da Web que corresponde a uma tela de aplicativo, o aplicativo pode ser aberto diretamente (se o aplicativo estiver instalado no momento).

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

Casos de uso

Os links universais e os links de aplicativos são mais comumente usados para campanhas de e-mail, pois os e-mails podem ser abertos e clicados tanto no desktop quanto em dispositivos móveis.

Alguns canais não funcionam bem com esses links. Por exemplo, notificações push, mensagens no aplicativo e cartões de conteúdo devem usar deep links baseados em esquemas (mydomain://).

Pré-requisitos

Para usar links universais e App Links:

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

Configuração de links universais e App Links

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

• iOS: Arquivo da Associação de Sites de Aplicativos da Apple (AASA)
• Android: Arquivo de links de ativos digitais

Além desse arquivo de permissões, há definições codificadas de quais domínios de links o aplicativo tem permissão para abrir, que são configuradas no aplicativo:

• iOS: Definir como “Domínios associados” no Xcode
• Android: Definido no arquivo AndroidManifest.xml do aplicativo

Essa associação domínio-app de duas partes é necessária para que um link universal ou App Link funcione e evita que qualquer aplicativo sequestre links de um domínio específico ou que qualquer domínio abra um aplicativo 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, links de aplicativos e rastreamento de cliques

Nossos parceiros de envio de e-mail, SendGrid e SparkPost, usam domínios de rastreamento de cliques para envolver todos os links e incluir parâmetros de URL para rastreamento de cliques nos e-mails do 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 os 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 aplicativo tem permissão para 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 não quiser que cada link de rastreamento de cliques seja um link universal ou um App Link, você poderá especificar quais links devem ser links universais com base no parceiro de envio de e-mail. Consulte as seções a seguir para obter detalhes.

SendGrid

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

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

Por exemplo:

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

3. Certifique-se de que seu aplicativo esteja configurado para lidar corretamente com os links agrupados. Consulte o artigo da SendGrid sobre Resolução de links de rastreamento de cliques da SendGrid e siga as etapas para seu sistema operacional. Este artigo contém um código de exemplo para iOS e Android.

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

SparkPost

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

Esse caminho personalizado permite que você trate seletivamente os 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 aplicativo esteja configurado para lidar corretamente com o caminho personalizado. Consulte o artigo do SparkPost sobre como usar o rastreamento de cliques do SparkPost em deep links. Este artigo contém um código de exemplo para iOS e Android.

Desativar o rastreamento de cliques em uma base de link a link

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

SendGrid

Se o seu provedor de serviços de e-mail for o SendGrid, use o código HTML clicktracking=off da seguinte forma:

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

SparkPost

Se o seu provedor de serviços de e-mail for o SparkPost, use o código HTML data-msys-clicktrack="0" da seguinte forma:

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

Amazon SES

Se o seu provedor de serviços de e-mail for o Amazon SES, use o código HTML ses:no-track da seguinte forma:

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

Editor de arrastar e soltar

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

Atributo personalizado para um link de texto

SendGrid

Selecione o seguinte para o atributo personalizado:

• Nome: clicktracking
• Valor: off

SparkPost

Selecione o seguinte para o atributo personalizado:

• Nome: data-msys-clicktrack
• Valor: 0

!Um atributo personalizado para um link de texto.

Atributo personalizado para um botão ou imagem

SendGrid

Selecione o seguinte para o atributo personalizado:

• Nome: clicktracking
• Valor: off
• Tipo: Link

SparkPost

Selecione o seguinte para o atributo personalizado:

• Nome: data-msys-clicktrack
• Valor: 0
• Tipo: Link

!Um atributo personalizado para um botão.

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

Se os seus links universais não estiverem funcionando como esperado em seus e-mails, como navegar o destinatário do aplicativo de e-mail para o navegador da Web antes de finalmente redirecionar para o aplicativo, consulte estas dicas para solucionar problemas de configuração do link universal.

Verificar o local do arquivo de link

Certifique-se de que o arquivo AASA (iOS) ou o arquivo Digital Asset Links (Android) esteja localizado no local 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 ao público. Se não conseguir acessá-los, talvez tenha perdido uma etapa na configuração de links universais para e-mail.

Verificar definições de domínio

Verifique se você tem as definições corretas para os domínios que seu aplicativo pode abrir.

• iOS: Revise os domínios associados configurados no Xcode para seu aplicativo(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 aplicativo (mantenha pressionado o ícone do aplicativo e clique em ⓘ). No menu de informações do aplicativo, localize Abrir por padrão e toque nele. Isso deve mostrar uma tela com todos os links verificados que o aplicativo tem permissão para abrir. Verifique se o domínio de rastreamento de cliques está incluído nessa lista.