Mapa de parâmetros e papéis (cid, gid, aid, keyword, sub1…sub10)
Como a fonte traduz os parâmetros da URL do anúncio em campos do clique, os papéis disponíveis, os templates de cada plataforma e como montar um mapa para fontes personalizadas.
Para que serve
A plataforma de anúncios manda na URL o ID da campanha, do grupo, do criativo, a keyword, o placement. Mas cada uma usa nomes diferentes (campaignid no Google, campaignid={{campaign.id}} na Meta, __CAMPAIGN_ID__ no TikTok). O mapa de parâmetros da fonte diz ao Affilitrack qual parâmetro cumpre qual papel, para que os relatórios possam agrupar por criativo ou keyword independente da plataforma.
Abra em Canais de tráfego › mapa de parâmetros na fonte. A tabela tem quatro colunas:
| Coluna | Significado |
|---|---|
| Parâmetro | O nome do parâmetro como ele chega na URL (campaignid). |
| Macro / token | O que você deve colocar na URL do anúncio para a plataforma preencher ({campaignid}). Serve para montar a URL de rastreio no anúncio. |
| Descrição | Texto livre. |
| Papel | O campo do clique que recebe o valor. |
Os papéis
| Papel | Campo do clique | Uso |
|---|---|---|
cid | ID da campanha na plataforma | Relatório por campanha da plataforma; reconciliação de custo. |
gid | ID do grupo de anúncios / conjunto | Relatório por grupo. |
aid | ID do anúncio / criativo | Relatório por Criativo — o mais valioso para otimizar. |
keyword | Palavra-chave | Relatório por Keyword (busca). |
placement | Placement / posicionamento | Relatório por Placement. |
rt_source | Fonte "lógica" (google, facebook) | Preenche a macro {rt_source}; útil na URL de destino. |
rt_campaign | Nome/ID da campanha em texto | Preenche {rt_campaign}; costuma receber utm_campaign. |
sub1 … sub10 | Dez campos livres | Tudo o que não tem papel próprio: tipo de correspondência, dispositivo, rede, público, país da campanha… |
| (vazio) | Nenhum | O parâmetro é ignorado no mapeamento (continua no payload do clique). |
A lista completa de papéis que a API aceita é rt_source, rt_campaign, cid, gid, aid, keyword, placement, sub1…sub10.
Os templates prontos
Ao criar uma fonte com Tipo google, meta, tiktok ou kwai, o mapa vem preenchido:
Google Ads — Click Ref ID {gclid}
| Parâmetro | Macro | Papel |
|---|---|---|
| campaignid | {campaignid} | cid |
| adgroupid | {adgroupid} | gid |
| creative | {creative} | aid |
| keyword | {keyword} | keyword |
| placement | {placement} | placement |
| matchtype | {matchtype} | sub1 |
| device | {device} | sub2 |
| network | {network} | sub3 |
| utm_source | google (fixo) | rt_source |
Meta Ads — Click Ref ID {fbclid} (confira; veja Click Ref ID)
| Parâmetro | Macro | Papel |
|---|---|---|
| utm_campaign | {{campaign.name}} | rt_campaign |
| campaignid | {{campaign.id}} | cid |
| adsetid | {{adset.id}} | gid |
| adid | {{ad.id}} | aid |
| placement | {{placement}} | placement |
| utm_source | facebook (fixo) | rt_source |
TikTok Ads — Click Ref ID __CLICKID__
| Parâmetro | Macro | Papel |
|---|---|---|
| utm_campaign | __CAMPAIGN_NAME__ | rt_campaign |
| campaignid | __CAMPAIGN_ID__ | cid |
| adgroupid | __AID__ | gid |
| adid | __CID__ | aid |
| utm_source | tiktok (fixo) | rt_source |
Kwai Ads — Click Ref ID __CALLBACK_PARAM__
| Parâmetro | Macro | Papel |
|---|---|---|
| utm_campaign | __CAMPAIGN_NAME__ | rt_campaign |
| campaignid | __CAMPAIGN_ID__ | cid |
| adid | __CREATIVE_ID__ | aid |
| utm_source | kwai (fixo) | rt_source |
Os mesmos templates estão em Templates de fonte com a URL de anúncio pronta de cada um.
Precedência em fontes Google
Em fontes do tipo google, os parâmetros ValueTrack campaignid, adgroupid e creative têm precedência sobre o mapa: mesmo que o mapa esteja diferente, o redirecionamento grava cid, gid e aid a partir deles quando presentes. Isso garante que fontes criadas com mapas antigos passem a gravar o ID real sem precisar de reconfiguração. Fontes de outros tipos não são afetadas.
Montar um mapa para fonte personalizada
Para uma rede, um e-mail marketing ou um influenciador, crie a fonte com Tipo custom e monte o mapa à mão:
- Decida os parâmetros que a origem vai mandar e os nomes (
campanha,criativo,parceiro). - Adicione uma linha por parâmetro. Em Macro / token, coloque a macro da origem se ela tiver (
{{ad_name}}), ou o valor fixo. - Atribua os papéis: use
cid/gid/aid/keyword/placementquando o significado bate; o resto emsub1…sub10. - Salve e teste com o link:
…/r/SLUG?campanha=teste&criativo=v1. Em Logs › Cliques › ver, os campos devem estar preenchidos.
O mapa também pode ser definido por API: PUT /api/traffic-sources/{id}/params com a lista params de objetos {param, macro, hint, role, position}.
O que o mapa não faz
- Não altera a URL de destino. Para repassar um valor para a página, use a macro correspondente na oferta (
{cid},{keyword},{sub1}). - Não filtra parâmetros. Todos os que chegarem ficam no payload do clique, mapeados ou não.