Boas práticas com IA

Estas são as regras da casa para quem usa Claude ou outro agente para criar, nomear e acompanhar campanhas. Elas existem porque a conciliação da owiew só diz qual campanha vendeu se o rastreamento chegar com identificadores corretos.

Nomenclatura

• Dê às campanhas nomes que uma pessoa entenda, com objetivo, público e período. O nome é para leitura.
• Escreva os valores de UTM no formato do Padrão de UTM: minúsculas, sem acento, hífen no lugar de espaço, só a-z, 0-9, - e _, até 100 caracteres.
• Use sempre o mesmo valor de utm_source por rede (meta, google, tiktok).

Identificador em vez de nome

Nunca use o nome da campanha para casar nada. Em utm_campaign, use o identificador que a plataforma substitui sozinha no clique. Nome muda e se repete; o identificador não. A API de leitura segue a mesma regra: campaign_id é a única chave estável de uma campanha.

Conciliação

A conciliação compara o que a plataforma reportou com o que a loja confirmou. Duas consequências para quem automatiza:

• Uma campanha sem identificador na URL aparece como venda sem atribuição de campanha. O agente deve conferir isso depois da publicação.
• Os números da plataforma e os reais divergem de propósito: a plataforma conta o clique e inclui pedido cancelado, e o real conta o dinheiro que liquidou. Peça sempre os dois e cite qual usou.

O que conferir antes de publicar

Peça ao agente que entregue esta lista preenchida antes de qualquer publicação:

1. O modelo de rastreamento está no campo de rastreamento da conta, não no link do anúncio.
2. O modelo é o da plataforma certa (duas chaves na Meta, uma no Google, sublinhados no TikTok).
3. utm_campaign leva o identificador, não o nome.
4. Nenhum parâmetro utm_* está duplicado no destino.
5. Todos os valores escritos à mão seguem o formato do padrão.
6. A URL de destino abre, e quem aprova viu os links finais.

O inspetor de URL confere duplicidade, conflito e maiúsculas.

O que a IA nunca deve fazer

• Inventar identificadores. Campanha, conjunto, anúncio e conta só entram com valores devolvidos pela plataforma ou pela API. Se faltar, o agente pergunta.
• Trocar o modelo de uma plataforma pelo de outra. Cada rede tem sua sintaxe de substituição.
• Escrever chave ou token em código, arquivo de configuração versionado, prompt ou log. Veja Segurança com agentes.
• Somar ou tirar média de métricas derivadas. CPA, CPC, CTR e ROAS saem dos totais somados.
• Tratar _micros como centavos. O valor está em micros: divida por 1.000.000.
• Publicar sem aprovação de uma pessoa quando a ação gasta verba.

Próximos passos

• Padrão de UTM
• Agentes lendo a API de leitura
• Segurança com agentes