A conexão com o ChatGPT Ads (a plataforma de anúncios da OpenAI) é feita por uma API key emitida no próprio Ads Manager. Nenhuma senha de usuário é usada.

Antes de começar

• Tenha acesso ao Ads Manager da conta de anúncios que você quer acompanhar.
• Emita a chave na aba Settings do Ads Manager.
• Atenção: a chave já vem amarrada a uma conta de anúncios — nenhuma consulta pede o id da conta depois. Se você anuncia com mais de uma conta, use a chave da conta que quer acompanhar na Toca; conectar a chave de outra conta não dá erro, apenas devolve os números da outra conta.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card ChatGPT Ads e clique no botão de conexão.
3. Preencha o único campo:
   • api_key — a API key emitida em Settings, no Ads Manager. O campo mostra a chave enquanto você digita, para conferir que é a da conta certa.
4. Salve. O card fica marcado como conectado e a Toca já consegue consultar a conta.

O que a Toca acessa

Com a conexão ativa, a Toca lê os anúncios veiculados dentro do ChatGPT: campanhas, grupos de anúncios e criativos, com investimento, impressões, cliques, CTR, CPC, CPM e conversões — e a quebra por produto do feed, país e dispositivo. A integração é somente de leitura: a Toca não cria, pausa nem edita campanhas no ChatGPT Ads.

Manutenção da conexão

A API key é estática e não expira sozinha: a conexão permanece ativa até você revogar a chave no Ads Manager ou desconectar a integração na Toca. Se a chave for revogada, o card em Configurações → Integrações passa a indicar que a conexão precisa ser refeita.

Problemas comuns

• Relatórios vêm vazios — a causa mais comum é a conta ainda não aprovada na revisão de marca da OpenAI: enquanto a revisão não é aprovada, a conta não veicula anúncios e não há investimento, impressão nem clique para reportar. Verifique o status da revisão no Ads Manager.
• Os números não batem com o que você esperava — confira se a chave conectada é da conta certa: a chave carrega a conta, e a de outra conta responde normalmente, com os dados dela. Emita e conecte a chave da conta que você quer acompanhar.
• Erro de autenticação nas consultas — a chave pode ter sido revogada ou colada com espaços extras. Emita uma chave nova em Settings, no Ads Manager, e atualize a conexão.