Deep links para aplicativos móveis

Os deep links abrem aplicativos nativos diretamente a partir de uma URL curta. Quando o visitante tem seu app instalado, o link lança a tela correta dentro do aplicativo. Quando não tem, ele volta para a App Store (iOS) ou Play Store (Android) — ou qualquer outra URL que você configurar.

O que você precisa#

Para usar deep links, você precisa de:

• Um app iOS com Universal Links configurados, OU
• Um app Android com App Links configurados, OU
• Esquemas URI personalizados (myapp://) se você ainda não tem Universal/App Links.

Para Universal Links e App Links, você também precisará publicar arquivos de associação (apple-app-site-association para iOS, assetlinks.json para Android) no seu domínio personalizado. O Elido os serve para você automaticamente assim que você fizer o upload do arquivo em Settings → Domains → Deep linking.

Configurar deep links em um link#

1. Abra a página de detalhes do link → Targeting → Deep linking.
2. Ative o deep linking.
3. Adicione uma configuração iOS:
   • App ID — ex: K72L8M4N9P.com.acme.myapp (o Team ID + bundle identifier da sua conta Apple Developer).
   • In-app path — para onde o app deve rotear. O caminho é adicionado ao host do seu universal link; o SDK no app o lê a partir da URL de inicialização.
   • Fallback URL — para onde enviar visitantes que não têm o app. Geralmente a listagem do seu app na App Store.
4. Adicione uma configuração Android:
   • Package name — ex: com.acme.myapp.
   • In-app path — mesma ideia que iOS.
   • Fallback URL — geralmente uma URL da Play Store com seu nome de pacote.
5. Save. O link agora fará roteamento baseado em dispositivo em cada clique.

O que acontece no momento do clique#

O manipulador de redirecionamento retorna um HTML intersticial que executa cerca de 50 ms de JavaScript. O intersticial:

1. Detecta iOS vs Android vs desktop.
2. No iOS: tenta abrir via Universal Link. Se o SO abrir o app, pronto.
3. No Android: o mesmo com App Links.
4. Após 1,2 segundos sem app, a página redireciona para a URL de fallback.

Visitantes de desktop sempre acessam a URL de fallback diretamente — não há app para abrir.

Se um visitante estiver em uma plataforma que não reconhecemos (web view no WeChat, etc.), o link retorna ao destino de desktop. Você pode substituir isso com regras de smart-link.

Fallback de esquema URI#

Se você não tem Universal Links / App Links configurados, ainda pode usar um esquema URI personalizado:

• iOS scheme: myapp://
• Android scheme: myapp://

O intersticial tentará abrir o esquema e retornará para a App Store / Play Store após 1,2 segundos. A desvantagem é que o SO mostra uma confirmação "Abrir no My App?" no primeiro lançamento, que Universal Links evita.

Analytics#

Cada clique registra se o app foi aberto ou o fallback foi usado. A aba Analytics → Deep linking do link mostra a taxa de abertura por plataforma — útil para medir o desempenho dos seus arquivos de associação.

Limites#

• Uma configuração iOS e uma configuração Android por link.
• Deep links estão disponíveis no Pro e Business; o plano gratuito suporta apenas redirecionamentos simples.

Problemas comuns#

Universal Links funcionam em um dispositivo real mas não no simulador. Isso é esperado — o simulador da Apple não consegue buscar o arquivo AASA. Teste em um telefone real.

A URL de fallback abre antes que o app sequer tente. Alguns navegadores Android (Samsung Internet, em particular) interceptam o esquema antes que o SO o veja. Certifique-se de que sua configuração de App Links está completa: domínio verificado, nome do pacote correto, impressão digital SHA-256 corresponde.

iOS às vezes mostra um banner de tap em vez de abrir o app. É o "Open in Safari → Smart Banner" do iOS tratando a página como um site genérico. Reenviar o arquivo AASA com o App ID correto geralmente resolve.

O link abre o app, mas a tela errada. Seu roteamento interno no app não está correspondendo ao caminho que o Elido está passando. Registre a URL de inicialização dentro do seu app para confirmar o que realmente está recebendo, depois atualize a configuração do caminho para corresponder.