Perguntas frequentes sobre deep links
Diversos fatores podem afetar o comportamento dos links profundos durante os testes ou em produção. Use este artigo para solucionar problemas comuns com links diretos do Adjust, links universais e links diretos diferidos. Se o problema persistir, contate support@adjust.com.
Problemas gerais com links diretos
Se o seu link direto não abrir o destino esperado ou retornar um erro HTTP 404 URL não encontrada, 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 da URL tem uma função específica. 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 link direto:
- 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
&. Não adicione um segundo?, porque as informações após o segundo?podem ser descartadas. - Se uma string de consulta está codificada, comece com um
/ou assegure que ela seja parte de um parâmetrodeeplink. - Certifique-se de que não haja espaços ou caracteres inválidos em fallbacks, callbacks, parâmetros de ID do dispositivo ou parâmetros de campanha. Problemas de codificação podem causar o corte de parâmetros.
Exemplo correto:
https://example.go.link/my?path=location&client=name&adjust_t=klm012
Exemplo incorreto:
https://example.go.link/my?path=location&client=name?adjust_t=klm012
Se o aplicativo não estiver instalado e o URL estiver estruturado incorretamente, o navegador poderá remover o parâmetro adjust_t. O parâmetro Adjust precisa ser usado para identificar a fonte do clique. Sem ele, Adjust retorna 404 URL not found.
Normalmente, isso significa que o link direto não conseguiu abrir o aplicativo, então o usuário foi redirecionado para a loja como Fallback.
Resolução de problemas:
- Teste o link como um usuário existente.
- Se o aplicativo abrir durante o teste, verifique o ambiente onde o link falhou originalmente.
- Verifique se a configuração de seus links universais/Android App links/esquema de aplicativo personalizado está correta, pois esses são os padrões de vinculação necessários para abrir o aplicativo.
- Certifique-se de que não haja erros de codificação em Fallback ou callbacks, pois isso pode fazer com que parâmetros sejam descartados e a conexão seja interrompida.
Se o link abrir o aplicativo, mas não exibir a tela correta dentro do aplicativo, verifique se o problema está na configuração do link ou na configuração do aplicativo.
Hospede seu link direto em um ambiente web e abra-o a partir do seu dispositivo de teste. Se você estiver usando um domínio com marca, teste o link com marca diretamente. Se você estiver usando o link Adjust adj.st legado, você pode testar o domínio do link universal, por exemplo https://abcd.adj.st/, ou o esquema do aplicativo, por exemplo myapp://.
Se o aplicativo abrir, mas o caminho estiver incorreto, peça ao seu desenvolvedor para confirmar se os caminhos dentro do aplicativo estão configurados corretamente.
Nota: Os links universais adj.st são a abordagem legada. Recomendamos o uso de domínios com marca para novas implementações.
Atribuição e relatórios
Não. O Adjust recebe dados de cliques de links diretos que usam um link do Adjust ou que possuem parâmetros do Adjust anexados. Um deep link direto que utiliza apenas o domínio ou esquema específico do seu aplicativo não envia dados de cliques para a Adjust.
Envia dados de cliques:
myapp://welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1
https://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 de aplicativos instalados e reatribuição de links diretos, implemente o SDK de cliques no SDK da Adjust para iOS ou Android. Os links diretos que acionam um clique do SDK são relatados como cliques no Datascape e ficam visíveis nos dados brutos por meio do callback do clique.
Para identificar cliques que vieram de um clique do SDK de link profundo, inclua o placeholder {is_deeplink_click}.
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.
Problemas com o link universal
Por que meu parceiro não está recebendo callbacks atribuídos apesar de as instalações estarem sendo atribuídas corretamente?
Se as instalações estiverem sendo atribuídas corretamente, mas seu parceiro não estiver recebendo os retornos de chamada atribuídos, verifique a configuração do link universal.
Certifique-se de que:
Verifique se você adicionou o parâmetro click ID ao universal link. Certifique-se de que não há erros de codificação nos seus fallbacks ou callbacks. Verifique se o parâmetro click ID está com o prefixo adj_ ou adjust_.
Se o ID do clique estiver ausente, formatado incorretamente ou cortado por um problema de codificação, o Adjust poderá atribuir a instalação, mas não conseguirá transmitir os dados de callback do parceiro esperados.
Primeiro, verifique se os links universais estão configurados corretamente.
Em seguida, verifique de onde a Apple está abrindo o link. A Apple não permite redirecionamentos para raw universal link fora do Safari, portanto, você precisa hospedar o raw universal link ou o esquema em um ambiente web e clique nele a partir daí.
Se o seu aplicativo ainda não abrir:
- Abra sua página HTML de teste no Safari e selecione o ícone Compartilhar. Se você vir a opção "Abrir em... (Open in...)" com seu aplicativo listado, a configuração de Domínios Associados está correta e o arquivo de Associação do Site da Apple foi baixado.
- Se você não encontrar o aplicativo na lista, desinstale-o e reinstale-o.
- Verifique se o bundle ID é o mesmo nos ambientes de teste e de produção.
- Certifique-se de que o iOS bundle ID e o prefixo do aplicativo estejam corretos no AppView.
- Se o aplicativo ainda não abrir, peça ao seu desenvolvedor para investigar o link universal ou a associação do aplicativo ao esquema.
Verifique também se o seu link inclui target="_blank". Isso pode funcionar em testes, mas falhar em produção. Remova o atributo do link.
Por que meu universal link não está funcionando a partir de uma publicação no Facebook ou Instagram?
Certifique-se de que o link universal inclua um caminho. Se nenhum caminho for adicionado, o usuário poderá ser redirecionado para a loja mesmo que o aplicativo esteja instalado. O caminho não precisa ser válido.
Na maioria das vezes, o iOS não permite redirecionar universal links para fora do Safari. Isso significa que ambientes usando o SFSafariViewController são afetados.
Como os links de e-mail podem ser abertos em diversos ambientes, incluindo navegadores e aplicativos de e-mail que não oferecem suporte a links universais, a Adjust recomenda o uso de links JSR ou a integraçāo com um ESP da Adjust.
Links diretos com o parâmetro deeplink
Campanhas executadas em publicações no Facebook precisam usar a URL do link da Adjust com o parâmetro deeplink anexado. O parâmetro deeplink também deve incluir um caminho. Se não estiver, o usuário será levado para loja mesmo se o aplicativo estiver instalado. O caminho não precisa ser válido.
Exemplo: https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path
Deeplinks atrasados
Um link direto diferido é usado quando um usuário clica em um link direto antes de ter o aplicativo instalado. Após instalar, o aplicativo deverá abrir no local indicado dentro do próprio aplicativo.
Se o link direto adiado não abrir a localização correta:
- Verifique se o caminho existe no aplicativo.
- Hospede o esquema do aplicativo, por exemplo
myapp://, em um ambiente web e clique nele a partir daí. - Se o caminho não funcionar para um usuário existente, peça ao seu desenvolvedor para confirmar se os caminhos de aplicativos estão configurados corretamente.
- Se o caminho funcionar para um usuário existente, mas não para um novo usuário, inspecione o dispositivo no Console de Teste e verifique se ele foi atribuído ao clique.
- Se o dispositivo não foi atribuído, esqueça-o no Console de Teste e teste novamente.
- Se o dispositivo foi atribuído, verifique se o dispositivo inclui um parâmetro
deeplink. - Se o parâmetro
deeplinkestiver ausente, verifique se há problemas de codificação ou caracteres especiais que possam estar cortando o URL. - Se o parâmetro
deeplinkestiver presente, mas o caminho estiver faltando, entre em contato com o Suporte da Adjust.
Durante os testes, um link direto adiado pode, por vezes, persistir por um curto período após o clique, mesmo depois de o dispositivo ser removido da Console de testes.
Isso pode ocorrer se:
- Você clicou no deep link, instalou o aplicativo e o abriu.
- Desinstale o aplicativo.
- Esqueça o dispositivo no Console de Teste.
- Execute outro teste e o link direto adiado não funcionará.
Para resolver isso, desinstale o aplicativo novamente, esqueça o dispositivo no Console de Teste e execute o teste novamente.