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:

Depois de criados, os links curtos permanecem ativos por 30 dias.
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/indicação ou de influenciadores.

Criação de links curtos dinâmicos

Criar um link único

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

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ário de 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

(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

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

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"}`