Dúvidas Deeplink

Perguntas frequentes sobre Deeplink

🔵 O que é preciso para ativar o Deeplink no app

Se o app for VTEX, é necessário enviar as chaves appKey e appToken com permissão para chamadas públicas.

Essas chaves podem ser geradas seguindo as instruções da documentação oficial da VTEX.Recomendamos que sejam configuradas como chaves permanentes.

Também é necessário conceder acesso com perfil Owner (Admin Super), com liberação para todos os recursos.
Se o app for Shopify ou outra plataforma Cloud Commerce, é necessário entrar em contato com nosso suporte através do portal para que os arquivos assetlinks.json e apple-app-site-association sejam enviados, além das demais orientações necessárias.

A integração com Deeplink exige a publicação de uma nova versão do app. Assim, o ajuste segue o fluxo completo de revisão de código, testes de QAs e processo regressivo, além do prazo de aprovação das lojas (Apple e Google).

🔵 Deeplink não está redirecinando para o app

O primeiro passo é verificar se o direcionamento desejado está disponível atualmente no app. Os destinos suportados são: Home, PDP, PLP(categorias), Carrinho, Favoritos e Perfil.
Também é importante conferir se o formato da URL utilizado é compatível com o Deeplink.
Exemplos de URLs aceitas:

Destino	Exemplo de URL
Página de Produto (PDP):	`https://www.merx.com.br/camiseta-kobe-longo-0000000000/p?idsku=00000` Ou `https://www.merx.com.br/camiseta-kobe-longo-0000000000/p` O sufixo `/p` é obrigatório para URLs de Página de Produto (PDP). URLs sem o `/p` não são reconhecidas pelo Deeplink. Formato correto: https://www.sualoja.com.br/nome-do-produto/p https://www.sualoja.com.br/nome-do-produto/p?idsku=00000
Categoria / PLP:	`https://www.merx.com.br/masculino-camiseta` Ou `https://www.merx.com.br/categoria/masculino-camiseta`
Home:	`https://www.merx.com.br/`
Login / Perfil:	`https://www.merx.com.br/login`
Favoritos:	`https://www.merx.com.br/wishlist`
Carrinho:	`https://www.merx.com.br/checkout#/cart`

Atualmente, o Deeplink nativo do app não possui suporte para direcionamento de coleções. Por isso, URLs de coleção não irão abrir diretamente no aplicativo.

🔵 Quero excluir um link do direcionamento de Deeplink do app

Quando o Deeplink nativo do app está ativo, qualquer link que contenha o domínio da loja https://www.sualoja.com.br será interpretado pelo dispositivo para abrir diretamente no app, caso ele esteja instalado.
Caso deseje excluir uma URL específica do direcionamento para o app, ou seja, fazer com que esse link sempre abra no navegador, é necessário informar a URL completa que deverá ser removida do Deeplink. Por exemplo: https://www.sualoja.com.br/nps-clientes
Se o app for VTEX, também será necessário enviar as chaves appKey e appToken com permissão para chamadas públicas, seguindo as orientações da documentação .

Esse ajuste exige a publicação de uma nova versão do app. Portanto, seguirá o fluxo completo de: revisão de código, testes de QAs e processo regressivo, além do prazo de aprovação das lojas (Apple e Google).

🔵 Deeplink X Navegador

Nos navegadores como Chrome e Safari, o Deeplink segue o comportamento esperado, abrindo diretamente o app quando ele está instalado no dispositivo.

No navegador específico Samsung Internet, quando busca é realizada, ele trata o acesso como uma navegação vinda de outro domínio, geralmente google.com. Com isso, a URL passa por um redirecionamento intermediário, por exemplo:https://www.google.com/url?q=https://www.sualoja.com.br/

Devido a esse redirecionamento, o deeplink não reconhece a URL original e, por isso, não é acionado.

Em dispositivos Android, quando o usuário acessa pela primeira vez um link do domínio da loja https://www.sualoja.com.br, o sistema pode perguntar se deseja abrir o conteúdo no app ou no navegador. Caso o usuário selecione a opção de abrir sempre no navegador, os próximos acessos aos links desse domínio podem deixar de abrir o app automaticamente.

Recomendamos sempre verificar nas configurações do app nos dispositivo se a opção de abrir links compatíveis está ativada.

🔵 Deeplink da AppsFlyer

Além do Deeplink nativo, o app também permite integração com o Deeplink da AppsFlyer. Essa integração já é suportada nativamente pelo aplicativo e não gera custos adicionais.
Você pode conferir os tipos de direcionamentos do Deeplink da AppsFlyer na documentação: Redirecionamento Deeplink Via AppsFlyer
O principal formato de Deeplink utilizado nessa integração é o OneLink. Assim, para iniciar a configuração, é necessário primeiro criar o domínio no painel do OneLink. Após a criação do domínio, entre em contato com nosso suporte através do portal para que possamos realizar a liberação de acesso para o e-mail de um dos nossos desenvolvedores, que seguirá com a integração.
Essa integração está disponível para clientes dos planos Pro e Enterprise.
A integração com a AppsFlyer exige publicação de uma nova versão do app. Portanto, seguirá o fluxo completo de: revisão de código, testes de QAs e processo regressivo, além do prazo de aprovação das lojas (Apple e Google).