Tracking links e atribuição

Quando você roda anúncios no Meta, TikTok ou qualquer outra plataforma, precisa saber quais campanhas estão gerando installs e quais estão trazendo receita de verdade. Tracking links resolvem isso. Você cria um link no Paywallo, usa esse link no anúncio, e a partir daí o Paywallo conecta cada install à campanha que trouxe o usuário.

Você só precisa dar um nome pro link e escolher a plataforma (Meta, TikTok ou orgânico). O Paywallo gera a URL completa com os parâmetros que a plataforma precisa. Quando o usuário clica, o Paywallo detecta se é iOS ou Android e redireciona pra loja correta do seu app.

Existem três tipos de tracking link, cada um pra uma finalidade:

Orgânico: Pra qualquer fonte que não é mídia paga, como bio do Instagram, parcerias e influenciadores. O Paywallo rastreia installs e compras de cada link separadamente.

Meta Ads: Pra campanhas no Facebook e Instagram. O Paywallo preenche os UTMs automaticamente para associar o install à campanha certa e enviar os eventos de conversão.

TikTok Ads: Pra campanhas no TikTok. O Paywallo rastreia automaticamente e envia os eventos pro TikTok.

Links orgânicos marcados como TikTok mostram uma página intermediária automática antes do redirecionamento. Isso é necessário porque o navegador interno do TikTok bloqueia o redirecionamento direto pra loja. A página orienta o usuário a abrir no Safari ou Chrome, e você pode personalizá-la com uma imagem ou animação Lottie na criação do link ou nos detalhes dele no Growth Hub.

Ao criar um link pra Meta, o Paywallo gera a URL já com as macros do Facebook (campaign_id, adset_id, ad_id, etc.). O Meta substitui essas macros automaticamente na hora do clique, então o Paywallo sabe exatamente de qual campanha, conjunto e anúncio veio cada install.

No Meta Ads Manager, no nível do anúncio, cole o link no campo "Website URL". Não edite os parâmetros da URL: eles precisam ficar exatamente como o Paywallo gerou. O objetivo da campanha e o local de conversão estão descritos na página Meta Ads.

Mesma lógica do Meta. Cole o tracking link no campo de URL de destino.

Com a integração configurada, o Paywallo envia eventos de conversão automaticamente pras plataformas. Veja os detalhes em Meta Ads e TikTok Ads.

Por padrão, um tracking link redireciona o usuário pra App Store ou Google Play. Você também pode apontar pra qualquer URL: uma landing page, um formulário, um site externo, mantendo toda a captura de clique do Paywallo. Em um link orgânico, escolha a URL externa no passo Destino já na criação. Em um link do Meta Ads ou do TikTok Ads, esse passo não existe na criação: crie o link e depois edite ele para trocar o destino pra URL externa. Na API, o campo correspondente é destinationMode com o valor EXTERNAL.

O Paywallo mescla automaticamente os UTMs e os click-ids da plataforma (fbclid, ttclid, gclid) na URL de destino, e adiciona pwclid=<trackingId> pra rastrear o clique internamente. Isso depende da opção Anexar UTMs e click-ids ao destino, ligada por padrão: com ela desligada, a URL de destino vai sem nenhum parâmetro adicional. Se a validação da URL falhar em tempo de execução, o usuário é encaminhado pra bridge page normalmente.

Segurança: só URLs com esquema https:// são aceitas. O Paywallo valida contra uma blocklist estática (phishing comum, domínios próprios do Paywallo) e bloqueia IPs privados, loopback e link-local para evitar SSRF. Links desabilitados pela validação exibem um banner de erro e param de redirecionar. Limite máximo de 2048 caracteres.

Todo tracking link tem um objetivo, no campo Destino do anúncio: App para campanhas de instalação de aplicativo, e Web para fluxos web como landing pages e formulários. Ao criar um link do Meta Ads ou do TikTok Ads, você escolhe o objetivo nesse passo. Em um link orgânico, o campo não aparece na criação: o padrão é App, e dá pra mudar editando o link depois. O objetivo é independente do destino do redirect (seção acima): escolher Web não muda pra onde o link aponta, só como o Paywallo categoriza os cliques e atribuições no dashboard. Na API, é o campo linkObjective (APP ou WEB).