Links curtos dinâmicos e rastreamento de referências

Muitos proprietários de aplicativos e sites permitem que os clientes convidem seus amigos para o produto, na esperança de obter um aumento orgânico. As equipes de crescimento querem rastrear esses convites e medir seu impacto no crescimento geral, além de responder a perguntas como:

  • Quais usuários geram o maior número de convites?
  • Como podemos adquirir mais usuários como eles?
  • Para quem deve ir o crédito pelo convite (quando relevante)?

Com a infraestrutura da Singular, convidar alguém para o aplicativo é tão simples quanto enviar um link. Mas queremos anexar alguns dados a esse link (por exemplo, o ID do usuário que o indicou) e também encurtá-lo para que as informações permaneçam privadas, seguras e inalteradas. O encurtamento também evita que o link se torne muito longo e desagradável para os usuários.

A API Dynamic Short Links permite que você transforme Singular Links longos e cheios de parâmetros em links mais curtos, seguros e atraentes:

Antes:
https://my.sng.link/Dappid/linkid?referring_user_id=123&referring_user_name=john&channel=sms
Depois:
https://my.sng.link/Dappid/linkid/r_hiuxchas8h

Observação:

  1. Depois de criados, os links curtos permanecem ativos por 30 dias.
  2. A API Dynamic Short Links funciona para links de rastreamento personalizados e integrados a parceiros. No entanto, ela é usada principalmente para o tipo de links personalizados para rastreamento de campanhas de referência ou de influenciadores.

Criação de links curtos dinâmicos

1

Criar um link único

Vá para Attribution > Manage Links (Atribuição > Gerenciar links) e crie um novo link. Consulte as Perguntas frequentes sobre links singularespara obter ajuda.

2

Adicionar parâmetros ao link

Depois que você tiver o URL do link, recomendamos anexar os seguintes parâmetros. Os dados adicionados serão disponibilizados para você em relatórios ou exportações.

Parâmetro do URL Descrição Incluído em relatórios? Incluído em destinos de dados (ETL)?
pcn Campaign Name Sim Sim
referring_user_id Seu ID de usuário para o usuário de referência Não Sim
referring_user_name Seu nome para o usuáriode referência Não Sim

O resultado pode ser o seguinte:

https://my.sng.link/Dappid/linkid?referring_user_id=123&referring_user_name=john&pcn=mycampaign
3

(Opcional) Adicionar informações de passagem personalizadas ao link

Você pode passar informações adicionais para o seu aplicativo por meio do link de rastreamento usando o parâmetro "_p". Esse parâmetro pode aceitar uma string ou um objeto JSON (desde que seja codificado por URL).

Por exemplo, digamos que você queira passar as seguintes informações dinâmicas para o seu aplicativo por meio do link de rastreamento:

{
“productid”:”Shoes123”,
“qty”:1
}

Você pode codificá-las por URL e anexá-las ao parâmetro _p em seu link de rastreamento:

https://myshoppingapp.sng.link/A59c0/nha7?_p=%7B%22productid%22%3A%22Shoes123%22%2C%22qty%22%3A1%7D
4

Recuperar sua chave de SDK singular

Recupere sua Singular SDK Key acessando "Developer Tools > SDK Integration > SDK Keys" e copiando o valor ao lado de "SDK Key".

Screen_Shot_2022-10-11_at_15.30.07.png

5

Criar um ou mais links curtos

Use o ponto de extremidade da API Dynamic Short Links para criar um link curto.

Observação:

  • O ponto de extremidade é https://s2s.singular.net/api/v1/s2s/shorten_link?a=<SDK KEY>, em que <SDK KEY> é a chave que você recuperou na etapa anterior.
  • Nos parâmetros JSON, passe o URL que você deseja encurtar.
  • Depois de criados, os links curtos permanecem ativos por 30 dias.
Ponto final https://s2s.singular.net/api/v1/s2s/shorten_link?a=<SDK KEY>
Método POST
JSON Body
{"long_link": "<LONG LINK>"}

Por exemplo:

{"long_link": "https://my.sng.link/Dappid/linkid?referring_user_id=123&referring_user_name=john&channel=sms"}
Resposta

A resposta (no formato JSON) contém um link encurtado:

{"short_link": "https://my.sng.link/Dapp/linkid/r_ninja123"}