Macros na URL de destino da oferta
Como levar dados do clique até a página de destino — keyword, criativo, sub-IDs, país — usando macros na URL da oferta, com exemplos e as regras de expansão.
A URL de destino da oferta aceita macros entre chaves. No momento do redirecionamento, cada macro é substituída pelo valor do clique. Isso permite personalizar a página (mostrar a keyword no título), alimentar um formulário ou passar dados para um sistema de terceiro.
Exemplo
Oferta com URL:
https://loja.com.br/oferta?kw={keyword}&criativo={aid}&origem={rt_source}&pais={country}Clique vindo do Google com keyword=tenis+corrida, creative=999888777, utm_source=google, IP do Brasil. O visitante pousa em:
https://loja.com.br/oferta?kw=tenis%20corrida&criativo=999888777&origem=google&pais=BR&clickid=034U7aNU58sxhCH1BD7gomO clickid no fim é o parâmetro do click da oferta — acrescentado sempre, independentemente das macros.
Macros disponíveis
| Macro | Valor |
|---|---|
{click_id} | ID do clique gerado pelo Affilitrack |
{ref_id} | gclid / fbclid / ttclid capturado do anúncio |
{campaign_id} | ID interno da campanha |
{campaign_slug} | Slug do link de tracking |
{campaign_name} | Nome da campanha |
{source_id} / {source_name} | ID / nome da fonte de tráfego |
{offer_id} / {offer_name} | ID / nome da oferta |
{rt_source} | utm_source / fonte mapeada |
{rt_campaign} | utm_campaign / campanha da plataforma |
{cid} | ID da campanha na plataforma de anúncios |
{gid} | ID do grupo de anúncios |
{aid} | ID do anúncio / criativo |
{keyword} | Palavra-chave |
{placement} | Placement |
{country} | País do clique (ISO-2, ex. BR) |
{device} | desktop, mobile ou tablet |
{ip} | IP do visitante |
{user_agent} | User agent do visitante |
{referrer} / {referrer_domain} | Referrer completo / só o domínio |
{timestamp} | Epoch em segundos do clique |
{sub1} … {sub10} | Sub-IDs capturados na URL do anúncio |
A mesma lista está disponível pela API em GET /api/offer-macros.
Regras de expansão
- Os valores são codificados para URL (espaço vira
%20,&vira%26). Você não precisa codificar nada. - Macro sem valor vira string vazia:
kw={keyword}sem keyword produzkw=. Se preferir omitir o parâmetro quando vazio, trate isso na página. - Macro desconhecida é mantida como texto literal — sinal de erro de digitação. Confira o nome na tabela.
- Não há expansão dentro de
redirection_url. Quando o Google Ads declara o destino pelo parâmetroredirection_url, a URL declarada é obedecida literalmente, sem macros — a plataforma já preencheu tudo o que precisava no{lpurl}. Veja redirection_url.
Usos práticos
- Personalizar a landing por keyword ou criativo:
?h={keyword}e o site lêhpara trocar o título. - Passar o
click_idcom outro nome para um sistema que só aceita um parâmetro específico:?sck={click_id}(a Hotmart, por exemplo, propagasckaté o postback). - Segmentar por país sem geolocalização própria:
?pais={country}. - Levar o sub-ID de afiliado até o checkout:
?afiliado={sub1}.
Cuidados
- Não coloque na URL de destino dados que a página não vai usar: parâmetros a mais só poluem o Analytics.
- Se o destino é um checkout de terceiro, confira quais parâmetros ele propaga até o postback.
sck(Hotmart/Kiwify),src(Braip),[SRC](Monetizze) são os que sobrevivem ao checkout — oclick_idprecisa viajar num deles. Veja a integração da sua plataforma em Integrações.