Como configurar deeplinks

Seguir
Avatar
Ghani Yusuf
Updated
Documento
Singular Links
Criar links profundos
Leve os usuários para o seu aplicativo

Ao criar um link de rastreamento para seu aplicativo, você pode configurá-lo para ser um deep link.

Com um link profundo, se um usuário clicar no anúncio e já tiver o seu aplicativo instalado, não só o aplicativo será aberta, como também mostrará o conteúdo específico do aplicativo à sua escolha e não apenas a tela padrão do aplicativo.

deeplinking.png

Importante: Deve planear os seus deep links antes de integrar o SDK Singular no seu aplicativo. Seus engenheiros implementarão os deep links como parte do processo de integração do SDK.

Antes de começar: Planejar seus deep links

Para começar, faça uma lista de todos os deep links que você deseja implementar em suas campanhas de anúncios para o aplicativo.

Para cada deep link, decida o seguinte:

  • Conteúdo do aplicativo de destino: qual tela do seu aplicativo o usuário deve ver?
  • Redirecionamento de recurso: se o usuário não tiver o seu aplicativo instalado, para onde deve ser redirecionado? (Normalmente, a página da loja do seu aplicativo)
  • Trata-se de um link direto diferida? Ou seja, o link deve mostrar conteúdo específico do aplicativo mesmo para novos usuários que instalem o seu aplicativo?

Exemplo: Se o seu aplicativo for uma loja de roupas, convém configurar os seguintes links diretos.

Deep Link Conteúdo a ser exibido Ativar diferido? Redirecionamento de Fallback
Saldos da nova estação: moda de outono Mostrar roupas marcadas com "nova coleção de outono" ✅ < URL do aplicativo na loja de aplicativos>
Oferta especial: Registre-se na newsletter e receba um cupão de $5 Tela "Registrar para receber a newsletter" ✅ < URL do aplicativo na loja de aplicativos>

Como criar um link profundo

1

Criar um domínio de link

Os Links Singulares têm a seguinte estrutura, onde [SUBDOMAIN] é escolhido por si:

https://[SUBDOMAIN].sng.link/[PARAMETERS]

Se ainda não tem nenhum domínio configurado, tem de criar pelo menos um para começar a criar Singular Links. Para o fazer:

  1. Inicie sessão na sua conta Singular e acesse a Atribuição > Gerenciar Links.
  2. Clique em Gerenciar domínios de link.

Pode criar um único domínio (por exemplo, o nome da sua empresa ou aplicativo) e utilizá-lo para todos os seus links, ou pode criar vários para utilizar para diferentes fins.
2

Comunicar o plano do Deep Link à equipe de engenharia

Seus desenvolvedores precisam conhecer os destinos dos links diretos antes de integrar o Singular SDK/S2S em seu aplicativo (ou antes de lançar uma atualização para seu aplicativo).

À medida que os desenvolvedores implementam o SDK, adicionam código que identifica se o aplicativo foi aberto através de um deep link e direciona o usuário para a tela ou conteúdo apropriado do aplicativo (estão disponíveis guias passo-a-passo para desenvolvedores para Android, iOS, Unity, React).

Quando a sua equipe de engenheiros tiver terminado, pode fornecer-lhe:

  1. O esquema de deep link que você usará para este aplicativo (por plataforma). Você precisa inserir essas informações na página Aplicativos na próxima etapa.

  2. Uma lista de destinos de deep link (URLs) para usar ao configurar seus Singular Links. Por exemplo:

    Link profundo Destino (URL)
    Saldos da nova estação: moda de outono mylinkscheme://automnfashion
    Oferta especial: Registre-se na newsletter e receba um cupão de $5 mylinkscheme://newsletteroffer
3

Introduzir informações do esquema de links na página de aplicativos

Dependendo da(s) plataforma(s) do seu aplicativo e da tecnologia que a sua equipe de engenharia utilizou para implementar o deep linking, podem existir algumas informações que tem de introduzir na página Aplicativos(Configurações > Aplicativos).

Estas informações devem ser fornecidas pela sua equipe de engenharia.

  1. Faça login na sua conta do Singular e vá para Configurações > Aplicativos.
  2. Encontre seu aplicativo na lista e expanda os detalhes.
  • Para Android: insira o Esquema do aplicativo Android.
  • Para iOS: introduza o ID da equipe.

Se o seu aplicativo tiver mais de um site de aplicativo (o que significa que ele está disponível para mais de uma plataforma), insira as informações necessárias em cada um deles.
4

(Opcional) Adicionar destinos de deep link na página de aplicativos

Pode adicionar os destinos de link profunda às configurações do seu aplicativo na página Aplicativos para facilitar o acesso. Desta forma, sempre que criar novos links de seguimento, estes destinos aparecerão nos menus pendentes para que possa escolher.

Este passo é opcional, uma vez que pode sempre digitar qualquer destino quando cria um link singular.

Para adicionar destinos de links diretos à página Aplicativos:

  1. Faça login na sua conta do Singular e vá para a página Aplicativos.
  2. Encontre seu aplicativo na lista e expanda os detalhes.

  3. Em Destinos, adicione os URLs de deep link, cada um em uma linha separada, e clique em Salvar.
5

Criar o link

Para criar o link de rastreamento real (com o deep linking incluído):

  1. Na sua conta Singular, vá para Atribuição > Gerenciar links e clique em Criar link.
  2. Insira os detalhes do link. Para obter ajuda, consulte as Perguntas frequentes sobre links do Singular.
  3. Na seção Configurações do link e redirecionamentos, depois de ativar o link para iOS, Android ou ambos, preencha os seguintes campos:
    • "Se o aplicativo não estiver instalado, vá para" (este é o redirecionamento de fallback)
    • "Se o aplicativo já estiver instalado, vá para:(deep link)"
    • "Após a instalação, vá diretamente para: (link direto diferida)"

  4. Termine de criar o link e copie o URL do link de rastreamento para poder configurá-lo no painel da rede de anúncios.

Notas:

  • Se receber uma mensagem a indicar que precisa de configurar o esquema do aplicativo ou o ID da equipe, é porque não configurou corretamente os esquemas de link direto na página Aplicativos (consulte o passo 4 acima).
  • Se tiver configurado destinos de link direto na página Aplicativos (consulte o passo 5 acima), estes estarão disponíveis para seleção aqui, para que não tenha de os colar novamente.
  • O link direto adiada é normalmente o mesmo URL que o link direto, embora possa torná-los diferentes se tiver um motivo especial para o fazer.
  • Se pretender redirecionar sempre para o destino "Se o aplicativo não estiver instalado, vá para" e não tentar estabelecer um link direto com o usuário, mesmo que o aplicativo esteja instalado, basta criar a Singular Link sem o destino do link direto configurado
6

Testar o link

Agora que você criou o link direto, pode testá-lo facilmente para ver como ele funciona.

Para testar a funcionalidade do link direto adiado:

  • Copie o URL do link de rastreamento da página Gerenciar links e envie-o para um dispositivo de teste que não tenha o aplicativo instalado.
  • No dispositivo, clique no link. Deverá ser direcionado para a loja de aplicativos.
  • Instale o aplicativo e abra-a. O aplicativo deve apresentar a tela ou o conteúdo pretendido.

Para testar a funcionalidade de link direto:

  • Instale o aplicativo num dispositivo de teste.
  • Copie o URL do link de rastreamento da página Gerenciar Links e envie-o para o seu dispositivo de teste.
  • A partir do dispositivo, clique no link. O aplicativo deve abrir e apresentar a tela ou conteúdo pretendido.

Para testar como o Link único funciona para determinar a atribuição, consulte Como testar um link de rastreamento.

Avançado: Adicionar conteúdo dinâmico ao link

É possível fazer com que um Singular Link trabalhe ainda mais, adicionando dados a ele dinamicamente à medida que você exibe seus anúncios. Estes dados podem então ser lidos e utilizados pelo seu aplicativo se um usuário interagir com um dos anúncios e depois chegar ao seu aplicativo.

Isto é útil, por exemplo, se tiver um aplicativo de compras e apresentar banners dinâmicos para diferentes produtos. Quando os usuários clicam num anúncio, pretende que o aplicativo abra e apresente a página do produto específico em que clicaram. Para tal, pretende adicionar dinamicamente o ID do produto ao Singular Link.

Para implementar links diretos com conteúdo dinâmico, siga as mesmas etapas descritas acima, começando pelo planejamento do link e fornecendo todas as informações à sua equipe de engenharia.

Nota para desenvolvedores: Usando o parâmetro _p

Para adicionar dados dinâmicos a um Singular Link à medida que você veicula o anúncio, anexe o parâmetro _p e qualquer valor ao final do URL do Singular Link. _p significa "passthrough" e o valor pode ser um valor JSON codificado por URL ou um valor de cadeia de caracteres não estruturado.

Por exemplo, se o Singular Link for: https://myshoppingapp.sng.link/A59c0/nha7

Ao exibir o anúncio, é possível anexar a ID do produto ao Singular Link da seguinte forma: https://myshoppingapp.sng.link/A59c0/nha7?_p=Shoes123

Os valores dos parâmetros de passagem são disponibilizados para o aplicativo quando você lê a URL do link direto. Para obter detalhes, consulte o guia de suporte de links diretos para o SDK escolhido: Android, iOS, Unity, React.