Como criar Deep Links

 

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

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

deeplinking.png

Importante: você deve planejar seus deep links antes de integrar o SDK da Singular em seu aplicativo. Seus engenheiros implementarão os deep links como parte do processo de integração do SDK.

Antes de começar: Planeje seus deep links

Para começar, faça uma lista de todos os deep links que deseja implementar em suas campanhas publicitárias 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 fallback: se o usuário não tiver seu aplicativo instalado, para onde ele deve ser redirecionado? (Normalmente, a página da loja do seu aplicativo)
  • Esse é um deep link diferido? Ou seja, o link deve mostrar conteúdo específico do aplicativo mesmo para novos usuários que estejam instalando o seu aplicativo?

Exemplo: Se o seu aplicativo for uma loja de roupas, talvez você queira configurar os seguintes deep links.

Deep Link Conteúdo a ser exibido Ativar Deferred? Redirecionamento de fallback
Liquidação da nova temporada: moda de outono Exibir roupas marcadas com "nova coleção de outono" <URL do aplicativo na loja de aplicativos>
Oferta especial: Registre-se para receber o boletim informativo e ganhe um cupom de US$ 5 Tela "Registrar-se para receber o boletim informativo" <URL do aplicativo na loja de aplicativos>

Como criar um Deep Link

1

Criar um domínio de link

Os links Singular têm a seguinte estrutura, em que [SUBDOMAIN] é escolhido por você:

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

Se você ainda não tem nenhum domínio configurado, é necessário criar pelo menos um para começar a criar Singular Links. Para isso:

  1. Faça login em sua conta do Singular e vá para Attribution > Manage Links (Atribuição > Gerenciar links).
  2. Clique em Manage Link Domains (Gerenciar domínios de links).

Você pode criar um único domínio (por exemplo, o nome de sua empresa ou aplicativo) e usá-lo para todos os seus links, ou pode criar vários para usar para diferentes finalidades.

2

Comunique o plano de deep links à equipe de engenharia

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

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

Quando sua equipe de engenharia terminar, ela poderá lhe fornecer:

  1. O esquema de deep link que você usará para esse 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 quando você configurar seus Singular Links. Por exemplo:

    Deep Link Destino (URL)
    Promoção de nova temporada: moda de outono mylinkscheme://automnfashion
    Oferta especial: Registre-se para receber o boletim informativo e ganhe um cupom de US$ 5 mylinkscheme://newsletteroffer
3

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

Dependendo da(s) plataforma(s) do seu aplicativo e da tecnologia que sua equipe de engenharia usou para implementar o deep linking, pode haver algumas informações que você precisa inserir na página Aplicativos (Configurações > Aplicativos).

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

  1. Faça login em sua conta da Singular e acesse Settings > Apps (Configurações > Aplicativos).
  2. Localize seu aplicativo na lista e expanda os detalhes.
  • Para Android: digite o Esquema do aplicativo Android.
  • Para iOS: digite 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

Você pode adicionar os destinos de Deep Links às configurações do seu aplicativo na página Aplicativos para facilitar o acesso. Dessa forma, sempre que você criar novos links de rastreamento, esses destinos aparecerão nos menus suspensos para você escolher.

Essa etapa é opcional, pois você sempre pode digitar qualquer destino ao criar um Singular Link.

Para adicionar destinos de deep link à página Apps:

  1. Faça login em sua conta da Singular e vá para a página Apps.
  2. Localize 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 deep linking incluído):

  1. Em sua conta Singular, vá para Attribution > Manage Links (Atribuição > Gerenciar links ) e clique em Create Link (Criar link).
  2. Insira os detalhes do link. Para obter ajuda, consulte as Perguntas frequentes sobre Singular Links.
  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" (esse é o redirecionamento de fallback)
    • "Se o aplicativo já estiver instalado, vá para:(deep link)"
    • "Após a instalação, vá diretamente para: (deferred deep link)"

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

Observações:

  • Se você receber uma mensagem dizendo que precisa configurar o esquema do aplicativo ou o ID da equipe, é porque não configurou corretamente os esquemas de Deep Link na página Aplicativos (consulte a etapa 4 acima).
  • Se você tiver configurado destinos de Deep Link na página Aplicativos (consulte a etapa 5 acima), eles estarão disponíveis para seleção aqui para que você não precise colá-los novamente.
  • O deep link diferido é normalmente o mesmo URL do deep link, embora você possa torná-los diferentes se tiver um motivo especial para isso.
6

Teste o link

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

Para testar a funcionalidade do deep link diferido:

  • Copie o URL do link de rastreamento da página Manage Links e envie-o para um dispositivo de teste que não tenha o aplicativo instalado.
  • No dispositivo, clique no link. Você deverá ser direcionado para a loja de aplicativos.
  • Instale o aplicativo e abra-o. O aplicativo deve exibir a tela ou o conteúdo desejado.

Para testar a funcionalidade do deep link:

  • Instale o aplicativo em um dispositivo de teste.
  • Copie o URL do link de rastreamento da página Gerenciar links e envie-o para seu dispositivo de teste.
  • No dispositivo, clique no link. O aplicativo deve abrir e exibir a tela ou o conteúdo desejado.

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

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

Você pode fazer com que um Singular Link trabalhe ainda mais, adicionando dados a ele dinamicamente à medida que exibe seus anúncios. Esses dados podem ser lidos e usados pelo seu aplicativo se um usuário se envolver com um dos anúncios e, em seguida, chegar ao seu aplicativo.

Isso é útil, por exemplo, se você tiver um aplicativo de compras e exibir anúncios de banner dinâmicos para diferentes produtos. Quando os usuários clicam em um anúncio, você deseja que o aplicativo abra e exiba a página do produto específico em que eles clicaram. Para isso, você deseja adicionar dinamicamente o ID do produto ao Singular Link.

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

Observação para desenvolvedores: Uso do parâmetro _p

Para adicionar dados dinâmicos a um Singular Link à medida que você veicula o anúncio, acrescente o parâmetro _p e qualquer valor ao final do URL do Singular Link. _p significa "passthrough" (passagem) 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, você pode 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ê o URL do deep link. Para obter detalhes, consulte o guia de suporte de deep linking do SDK escolhido: Android, iOS, Unity, React.