Perguntas frequentes sobre deep links
Vários fatores podem afetar o comportamento dos seus deep links. Se você estiver tendo resultados inesperados com deep links, seja na testagem ou na produção, consulte este artigo para encontrar uma solução. Se o problema persistir, contate support@adjust.com.
Problemas gerais
Minha sintaxe de URL e codificação estão corretas?
Se seu deep link não está direcionando para o destino especificado ou está retornando um erro HTTP 404, primeiro confira a sintaxe da URL e a codificação.
As URLs usam, em geral, a seguinte sintaxe: scheme://host:port/path?query-string#fragment-id
Cada parte de uma URL tem uma função diferente e usa caracteres específicos para identificar e separar valores. O esquema e o host não diferenciam letras maiúsculas e minúsculas, mas o caminho (path) e a string de consulta (query) diferenciam. Um erro na composição da sua URL impedirá que ela seja aberta como deveria.
Ao configurar seu deep link, preste atenção a estas condições:
- Se você adicionar um parâmetro da Adjust a uma string de consulta de URL que já contém parâmetros de consulta, use um
&. Do contrário, informações após o segundo?na URL são ignoradas.- Exemplo correto:
https://abcd.adj.st/my?path=location&client=name&adjust_t=klm012 - Exemplo incorreto:
https://z9pm.adj.st/my?path=location&client=name?adjust_t=klm012
- Exemplo correto:
- Se uma string de consulta está codificada, comece com um
/ou assegure que ela seja parte de um parâmetrodeeplink.
Se seu aplicativo ainda não estiver instalado e essas condições não foram atendidas, o parâmetro adjust_t é ignorado pelo navegador. A Adjust precisa desse parâmetro para localizar a fonte ou origem do clique; sem isso, nós retornaremos um erro HTTP 404 URL not found.
Exemplos
Dependendo de como a URL está configurada, seu deep link pode ter os seguintes comportamentos:
| Configuração do deep link | Exemplo de URL do link | Comportamento |
|---|---|---|
URL do link + parâmetro deep_link | https://app.adjust.com/r40ncx7?deep_link=adjust%3A%2F%2F%3Fpath | Abre o app em uma página in-app específica |
| Universal link | https://abcd.adj.st/%3Fpath?adjust_t=r40ncx7 | Abre o app em uma página in-app específica |
| Universal link | https://abcd.adj.st/?path&adjust_t=r40ncx7 | Abre o app se já estiver instalado, mas não consegue acessar a página in-app especificada. |
| Universal link | https://abcd.adj.st%3Fpath?adjust_t=r40ncx7 | É inválido e retorna um erro |
Por que não posso ver meus dados de atribuição e/ou níveis de campanha?
Se os dados de atribuição ou níveis de campanha da sua URL do link de deep link não estiverem disponíveis, isso provavelmente é devido a um problema na configuração. Confira se os parâmetros do ID do dispositivo e parâmetros de campanha (conforme aplicável) não estão sendo afetados por causa de erros de codificação em fallbacks ou callbacks. Por exemplo, se não há espaços na URL ou caracteres inválidos.
Por que eu sou levado(a) para a loja mesmo tendo o aplicativo instalado?
Tipicamente isso significa que seu deep link não conseguiu abrir o aplicativo e nós redirecionamos para a loja como fallback. Para testar, siga estes passos:
Siga nossas instruções para testes como usuário existente com universal links e links com o parâmetro deep_link.
Se seu teste for bem-sucedido e o aplicativo abrir, considere em que ambiente o deep link foi clicado quando ocorreu o erro. Depois, verifique se são necessários parâmetros adicionais para esse caso.
- Por exemplo: se um universal link JSR é clicado a partir do Slack, a flag
adjust_deeplink_js=1deve estar presente. Isso ajuda a carregar o esquema antes de redirecionar para a loja. Se seu link não funcionar mesmo com a flagadjust_deeplink_jspresente, então seu App Scheme pode estar incorreto no Campaign Lab.
- Por exemplo: se um universal link JSR é clicado a partir do Slack, a flag
Certifique-se de que não há erros de codificação nos seus fallbacks ou callbacks na URL do link que podem quebrá-la. Isso pode fazer com que os parâmetros sejam descartados. Parâmetros descartados resultarão no mau funcionamento do link por completo.
Por que meu deep link não abre no lugar correto no aplicativo?
Se o link não abrir no lugar correto, mas abrir o aplicativo mesmo assim, verifique se a configuração do link ou do aplicativo está causando o problema.
- Hospede o domínio do universal link (
https://abcd.adj.st/) ou esquema (myapp://) em um ambiente web e clique nele a partir daí. - Contate seu desenvolvedor para assegurar que os caminhos dentro do aplicativo estão configurados corretamente.
A Adjust recebe dados de cliques de entrada para deep links com um link da Adjust ou parâmetros da Adjust anexados. Um deep link direto com apenas um domínio que é específico ao seu aplicativo não retornará dados para a Adjust.
Envia dados de cliques:
myapp://welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1https://z9pm.adj.st/welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1Não envia dados de cliques:
myapp://welcomePara receber dados de cliques para aplicativos que já estão instalados e para a reatribuição com deep link, implemente o clique do SDK no SDK da Adjust iOS; Android.
Deep links que acionam um clique do SDK são registrados como cliques no Datascape. Eles também podem ser visualizados nos dados brutos usando o callback click. Para uma visualização granular sobre quais cliques resultam de um clique do SDK no deep link, inclua o parâmetro {is_deeplink_click}.
Solução de problemas para deep links com links + parâmetro deep_link
Por que meu deep link não está funcionando em uma publicação no Facebook?
Campanhas executadas em publicações no Facebook precisam usar a URL do link da Adjust com o parâmetro deeplink anexado. Além disso, o parâmetro deeplink precisa ter um caminho anexado a ele ou o usuário será levado para a loja (mesmo se o aplicativo estiver instalado). O caminho fornecido não precisa ser válido.
Exemplo de parâmetro com o caminho anexado: https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path
Solução de problemas para deferred deep links ou deep links diferidos
Por que meu deferred deep link não abre o aplicativo no lugar correto após a instalação?
Quando seu deferred deep link não leva ao caminho correto dentro do aplicativo após a instalação, primeiro verifique se esse caminho de fato existe. Hospede o esquema (myapp://) no ambiente web e clique nele para testar se é seu link ou uma configuração do aplicativo causando o problema. Contate seu desenvolvedor para assegurar que os caminhos dentro do aplicativo estão configurados corretamente.
Se você for levado ao caminho correto como usuário existente, mas não como novo usuário, inspecione seu dispositivo via Console de teste e certifique-se de que você foi atribuído ao clique. Do contrário, esqueça o dispositivo via Console de teste e tente novamente.
Se você for atribuído ao clique, inspecione seu dispositivo para verificar se ele inclui um parâmetro deeplink. Se não, certifique-se de que não há problemas na codificação ou caracteres especiais que estão suspendendo a URL antes do parâmetro deeplink.
Por fim, se um parâmetro deeplink está incluído, certifique-se de que o caminho (path) está presente. Se o caminho não estiver presente, ele foi cortado por algum motivo. Entre em contato pelo e-mail support@adjust.com para receber suporte.
Por que meu deferred deep link não funciona após esquecer o dispositivo?
Às vezes, durante o teste, o deferred deep link persiste por certo tempo após o clique - mesmo após esquecer o dispositivo via Console de teste.
Se isso ocorrer, seu teste pode ficar assim:
- Você clicou no deep link, instalou o aplicativo e o abriu.
- Você desinstalou o aplicativo.
- Você esqueceu o dispositivo por meio do Console de teste.
- Você faz outro teste (clique, instalação, abertura) e o deferred deep link não funciona.
Nesse caso, desinstale o aplicativo novamente, esqueça seu dispositivo por meio do Console de teste e, então, execute o teste de novo. Após isso, o deferred deep link deve funcionar conforme o esperado.