Links universais e links de aplicativos

Os links universais da Apple e os links de aplicativos Android são mecanismos criados para fornecer uma transição perfeita entre o conteúdo da Web e os aplicativos móveis. Embora os links universais sejam específicos para iOS, os links de app Android servem ao mesmo propósito para 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 app.

Quando um link universal ou App Link é aberto, o sistema operacional verifica se algum app instalado está registrado para esse domínio. Se um app for encontrado, ele será iniciado imediatamente, sem precisar carregar a página da Web. Se nenhum app 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 tradicionais deep linkings:

Casos de uso

Os links universais e os App Links são mais comumente usados em 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 por push, mensagens no app e cartões de conteúdo devem usar deep linkings baseados em esquemas (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 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 apps podem abrir links desse domínio e, no caso do iOS, quais jornadas esses apps podem abrir:

• iOS: Arquivo da Apple App Site Association (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 app tem permissão para abrir, que são configuradas dentro do app:

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

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 apps 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 app 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 saber mais.

SendGrid

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

1. Configure seus valores pathPrefix do AASA ou do AndroidManifest para tratar apenas links com /uni/ na jornada do URL como links universais.
2. Adicione a atribuição universal="true" à tag âncora de seu link (<a>). Isso altera a jornada 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 app 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/ na jornada 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 âncora do seu link: data-msys-sublink="custom_path".

Essa jornada personalizada 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, confira se seu app está configurado para lidar corretamente com a jornada personalizada. 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.

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

Se os links universais não estiverem funcionando como esperado em seus e-mails, por exemplo, navegando o destinatário do aplicativo de e-mail para o navegador da Web antes de finalmente ser redirecionado para o app, 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 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 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

Certifique-se de ter as definições corretas para os domínios que seu app tem permissão para abrir.

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