Onde encontro os meus dados do OpenAI Ads?
O OpenAI Ads precisa de um Pixel ID e de uma chave da Conversions API. O cPixel envia a compra a partir do servidor e, com o app embed do tema ativo, também os eventos de navegação da loja a partir de uma tag no navegador.
- Pixel ID 22 letras e dígitos, por exemplo CxHP7ickCLR1SJhZKZ61Hg
- Chave da Conversions API começa por sk-svcacct-…
As capturas de ecrã são de uma conta real. Os nomes de conta, IDs, tokens e endereços de e-mail aparecem ocultos — na sua, esses campos vão mostrar valores reais.
-
Abra Tools → Conversions
Expanda Tools no painel esquerdo e escolha Conversions. Tudo o que se segue está nessa única página.
Tools → Conversions no painel do Ads Manager. -
Copie o Pixel ID no separador Data Source
O separador Data Source lista as suas fontes de dados com o ID impresso a cinzento por baixo de cada nome. Essa cadeia a cinzento é o Pixel ID que o cPixel quer — não o id da conta de anúncios da barra de endereço.
O Pixel ID fica por baixo do nome da fonte de dados. -
Abra Conversion keys
Clique no ícone de chave no cabeçalho da página, ao lado de Warnings. O painel lista as chaves existentes, cada uma mostrada mascarada — o OpenAI não volta a revelar uma chave antiga, por isso, se não guardou uma, precisa de gerar outra.
As chaves existentes aparecem mascaradas, exceto os primeiros e últimos caracteres. -
Crie uma chave e copie-a de imediato
Create new key, dê-lhe um nome, e copie o valor a partir da caixa de diálogo. É mostrado uma única vez. Cole-o, junto com o Pixel ID, no cPixel.
Copie isto agora — a caixa de diálogo não volta a aparecer.
«Ads cannot serve until you finish account setup» não o está a impedir
Uma conta nova do OpenAI Ads mostra esse aviso até a faturação e um logótipo estarem configurados. Isso condiciona a veiculação de anúncios, não a Conversions API — pode criar a chave e ligar o cPixel enquanto esse aviso aparece.
Bom saber
- Os checkouts e as compras vêm sempre da Conversions API, nunca da tag do navegador: um tema não consegue correr na página de checkout ou de agradecimento do Shopify, por isso esses dois eventos, de outra forma, nunca chegariam ao OpenAI. Ativar o app embed do cPixel no tema acrescenta visualizações de página, visualizações de produto e adições ao carrinho a partir da loja, que o lado do servidor nunca envia — por isso os dois nunca reportam o mesmo evento duas vezes.
- Se o navegador de um visitante não conseguir mesmo carregar a tag do OpenAI — um bloqueador de anúncios, uma rede filtrada — o cPixel envia essa visualização de página ou adição ao carrinho a partir dos nossos servidores. Só nesse caso: um evento que a tag já enviou nunca é reenviado, por isso nada é contado duas vezes. O cPixel não consegue saber quando é o próprio OpenAI a recusar um evento, porque as tags do navegador enviam sem ler uma resposta.
- O OpenAI não publica nenhuma pontuação de qualidade de correspondência — não há um equivalente ao Events Manager, nem uma página de diagnóstico, nem um número para obter, nem para o cPixel nem para qualquer outra aplicação. Em vez disso, a página Qualidade dos eventos do cPixel mede isso localmente: para cada evento, mostra que identificadores de correspondência foram realmente enviados e quais estavam em falta, para que possa ver com que dados o OpenAI teve de fazer a correspondência.
- O OpenAI associa uma venda a um anúncio principalmente pela referência de clique que coloca no URL da sua página de destino — as próprias orientações do OpenAI dão-lhe prioridade sobre o e-mail com hash. Com o app embed do tema ativo, a tag do OpenAI guarda essa referência num cookie first-party no seu domínio, e o cPixel lê-a tanto daí como do URL, por isso sobrevive a um visitante limpar o armazenamento ou passar de www para o domínio sem www.
- Os carimbos temporais dos eventos têm de estar dentro dos últimos 7 dias, o que fica bem dentro da janela de repetição do cPixel.
- Eliminar uma chave neste painel revoga-a de imediato, por isso, para a substituir, crie primeiro a nova chave.
Token de API do lado do servidor Usado pelo cPixel hoje
Já a tem — a chave da Conversions API do passo 4 é a credencial do lado do servidor, e é ela que transporta a compra. A tag do navegador não precisa de nenhuma credencial: basta o Pixel ID, e só dispara na loja, e só enquanto o app embed do cPixel estiver ativo no seu tema. A chave também transporta os eventos da loja que o cPixel reenvia quando o navegador de um visitante não consegue carregar a tag, por isso, sem ela, esses eventos também se perdem.
Confirmar que funcionou
Inicie uma sessão em direto no cPixel e faça uma encomenda de teste. O envio ao OpenAI mostra a sua resposta, e o separador Event Stream no Ads Manager lista o que chegou. As visualizações de página da loja também chegam lá assim que o app embed estiver ativo — mas só a partir da loja, por isso não aparecem para páginas de checkout.
A documentação oficial do OpenAI Ads
O que é o cPixel
O cPixel é uma aplicação Shopify que regista os eventos da sua loja e reporta-os às suas plataformas de anúncios — a partir do navegador do visitante e a partir dos nossos servidores, através da Conversions API de cada plataforma. O rastreio no navegador é gratuito e sem limites em todos os planos; o envio do lado do servidor é o que os planos pagos acrescentam, e é o que mantém as conversões a chegar quando um navegador bloqueia o pixel, descarta a tag ou nunca chega a executá-la.
- Um único ID de evento nos dois lados. Cada compra é enviada com o mesmo id determinístico a partir do navegador e do servidor, para que a plataforma mantenha uma única conversão em vez de a contar duas vezes.
- Uma vista em direto de cada envio do servidor. Abra uma sessão de depuração e veja cada evento a sair: o payload, a resposta da plataforma, se foi desduplicado, e exatamente que parâmetros de correspondência estavam presentes. Também está no plano Free — pode ver o que o cPixel envia antes de pagar seja o que for.
- Todas as plataformas em todos os planos. Os planos diferem apenas num aspeto: quantas encomendas por mês estão incluídas. Nenhuma funcionalidade, plataforma ou limite de contas depende do preço, e até 10 contas por plataforma estão disponíveis em todos eles.
- Nada para instalar no seu tema. O rastreio usa as próprias superfícies do Shopify — o web pixel e o app embed —, sem tags de script, sem edições a ficheiros do tema, e com uma desinstalação limpa.
O preço depende só das encomendas mensais, mais nada — nem o tráfego, nem o seu plano Shopify, nem o número de plataformas que liga. As instalações no Free têm 7 dias sem qualquer limite, e nos planos pagos o envio do lado do servidor nunca é desligado por ultrapassar a quota.