Como configurar ligações profundas

Documento

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

Com um link profundo, se um utilizador clicar no anúncio e já tiver a sua aplicação instalada, não só a aplicação será aberta, como também mostrará o conteúdo específico da aplicação à sua escolha e não apenas o ecrã predefinido da aplicação.

deeplinking.png

Importante: Deve planear os seus deep links antes de integrar o SDK Singular na sua aplicação. 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?
  • Redireccionamento de recurso: se o utilizador não tiver a sua aplicação instalada, para onde deve ser redireccionado? (Normalmente, a página da loja da sua aplicação)
  • Trata-se de uma ligação direta diferida? Ou seja, a ligação deve mostrar conteúdo específico da aplicação mesmo para novos utilizadores que instalem a sua aplicação?

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? Redireccionamento de Fallback
Saldos da nova estação: moda de outono Mostrar roupas marcadas com "nova coleção de outono" < URL da aplicação na loja de aplicações>
Oferta especial: Registe-se na newsletter e receba um cupão de $5 Ecrã "Registar 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 aceda a Atribuição > Gerir ligações.
  2. Clique em Gerenciar domínios de link.

Pode criar um único domínio (por exemplo, o nome da sua empresa ou aplicação) 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 à equipa 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 programadores implementam o SDK, adicionam código que identifica se a aplicação foi aberta através de um deep link e direciona o utilizador para o ecrã ou conteúdo apropriado da aplicação (estão disponíveis guias passo-a-passo para programadores para Android, iOS, Unity, React).

Quando a sua equipa 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: Registe-se na newsletter e receba um cupão de $5 mylinkscheme://newsletteroffer
3

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

Dependendo da(s) plataforma(s) da sua aplicação e da tecnologia que a sua equipa de engenharia utilizou para implementar o deep linking, podem existir algumas informações que tem de introduzir na página Aplicações(Definições > Aplicações).

Estas informações devem ser fornecidas pela sua equipa 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 equipa.

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 hiperligação profunda às definições da sua aplicação na página Aplicações para facilitar o acesso. Desta forma, sempre que criar novas hiperligações 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 secção Definições do link e redireccionamentos, 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 a aplicação já estiver instalada, vá para:(deep link)"
    • "Após a instalação, vá diretamente para: (ligação direta 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 da aplicação ou o ID da equipa, é porque não configurou corretamente os esquemas de ligação direta na página Aplicações (consulte o passo 4 acima).
  • Se tiver configurado destinos de ligação direta na página Aplicações (consulte o passo 5 acima), estes estarão disponíveis para seleção aqui, para que não tenha de os colar novamente.
  • A ligação direta adiada é normalmente o mesmo URL que a ligação direta, embora possa torná-los diferentes se tiver um motivo especial para o fazer.
  • Se pretender redirecionar sempre para o destino "Se a aplicação não estiver instalada, vá para" e não tentar estabelecer uma ligação direta com o utilizador, mesmo que a aplicação esteja instalada, basta criar a ligação Singular sem o destino da ligação direta 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 aplicações.
  • Instale a aplicação e abra-a. A aplicação deve apresentar o ecrã ou o conteúdo pretendido.

Para testar a funcionalidade de ligação direta:

  • Instale a aplicação num dispositivo de teste.
  • Copie o URL da ligação de seguimento da página Gerir ligações e envie-o para o seu dispositivo de teste.
  • A partir do dispositivo, clique na hiperligação. A aplicação deve abrir e apresentar o ecrã 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 pela sua aplicação se um utilizador interagir com um dos anúncios e depois chegar à sua aplicação.

Isto é útil, por exemplo, se tiver uma aplicação de compras e apresentar banners dinâmicos para diferentes produtos. Quando os utilizadores clicam num anúncio, pretende que a aplicação 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.