Visão geral
Use este guia se houver eventos ausentes, falhas nas solicitações ou divergências entre a Plataforma de Anúncios e os registros da sua empresa. Comece com uma compra concluída, um lead enviado ou outra ação. Anote o que aconteceu e quando, depois escolha a pergunta abaixo que corresponde ao caso.
Um evento registra uma ação, como uma compra. O Pixel envia eventos do navegador de um visitante; a API de Conversões (CAPI) os envia do seu servidor. A Plataforma de Anúncios reúne esses eventos em uma fonte de dados. A atribuição determina a qual anúncio a ação será creditada. Uma janela de atribuição define por quanto tempo após uma interação com um anúncio uma ação pode ser considerada elegível.
Perguntas frequentes
1. Por onde devo começar?
Identifique a ação que você quer medir, o que a envia e a conta de anúncios e o ID do Pixel usados. Sua configuração pode usar o Pixel, a CAPI, uma integração de parceiro ou uma combinação deles. A CAPI precisa de um ID do Pixel mesmo que você não tenha instalado o Pixel no navegador.
Para a configuração inicial, consulte: Medição de conversões e Rastreamento de conversões. Seu desenvolvedor pode usar os guias do Pixel, da CAPI e de Eventos compatíveis. Mantenha as solicitações e chaves da CAPI no seu servidor.
Se um parceiro gerencia sua integração, use o guia de configuração de parceiros de medição ou o guia de configuração de parceiros de medição móvel. Para uma conexão com o HubSpot, consulte: Como configurar o ChatGPT Anúncios no HubSpot.
Para uma configuração existente, verifique cada etapa:
A ação enviou uma solicitação de evento?
A solicitação retornou um erro ou foi aceita?
Você consegue confirmar que a fonte de dados correta recebeu o evento?
O evento foi atribuído a um anúncio no relatório da campanha?
2. Meu Pixel está instalado. Por que não vejo compras ou leads?
O Pixel pode carregar sem enviar o evento de compra ou lead de que você precisa. Peça ao seu desenvolvedor para verificar uma ação concluída:
Verifique o nome do evento, o ID do Pixel e a página ou o callback que o envia. Uma visualização de página não é uma compra concluída.
Confirme que o Pixel é inicializado antes de enviar o evento, inclusive quando é carregado por um gerenciador de tags.
Verifique o console do navegador e a solicitação de rede. A mensagem "disparado" de um gerenciador de tags, por si só, não confirma que o evento foi enviado. O modo de depuração do Pixel pode ajudar.
Verifique se as escolhas de consentimento, o bloqueio do navegador ou a política de segurança do seu site impediram a solicitação.
Verifique páginas que exigem login, checkout, sites de reservas, redirecionamentos e formulários incorporados. Um Pixel funcionando na página de destino não confirma o rastreamento em outras páginas.
Se nenhuma solicitação foi enviada, corrija essa etapa primeiro. Esperar pelos relatórios não vai ajudar. Use o guia de solução de problemas do Pixel antes de adicionar outra integração.
3. O que devo fazer se um evento for rejeitado, exceder o tempo limite ou retornar um erro de servidor?
Salve o código de resposta, o erro exato, o horário da solicitação e o ID do evento. Peça ao seu desenvolvedor para verificar o formato do evento, o ID do Pixel e a chave. As solicitações de eventos da CAPI usam uma chave da API de Conversões da mesma conta de anúncios. As solicitações de configuração, gerenciamento e relatórios usam uma chave separada, da API de Anunciantes. Não envie chaves de API ao Suporte.
Nos lotes da CAPI, um evento inválido pode causar a falha do lote inteiro.
A CAPI exige o horário original da ação em milissegundos Unix. O evento deve estar dentro dos últimos 7 dias e não mais de 10 minutos no futuro. Esse limite de envio é independente da janela de atribuição. Não altere o horário de um evento antigo para que ele seja aceito.
Um tempo limite excedido ou erro de servidor pode deixar dúvidas sobre a chegada do evento. Verifique a solicitação original e os registros de recebimento disponíveis. Se você tentar enviar a mesma ação novamente, mantenha o ID do evento e o carimbo de data/hora originais. Um novo ID pode fazer com que ela pareça ser outra ação.
Investigue prontamente uma rejeição ou falha persistente nas solicitações. A estimativa de 24 a 48 horas para os relatórios não se aplica a esses erros. Para os requisitos das solicitações, consulte: API de Conversões.
4. Vejo que o evento foi aceito. Por que ele não está no relatório?
A aceitação não significa que um evento foi atribuído a um anúncio. Verifique o que a resposta confirma e se a solicitação usou a fonte de dados correta. Na CAPI, validate_only definido como true verifica os eventos sem salvá-los.
Para um novo evento, seu desenvolvedor pode verificar os eventos recentes, quando disponíveis. Isso mostra uma amostra recente, não um histórico completo nem um resultado de atribuição.
Se não conseguir verificar o recebimento, entre em contato com o Suporte e envie a resposta original e um evento de amostra. Informe quais verificações você realizou; não é preciso descobrir a causa primeiro.
Se o recebimento for confirmado, prossiga para a pergunta 5. Não reenvie o evento com novos IDs só porque o relatório da campanha não mudou.
As conversões atribuídas podem levar aproximadamente de 24 a 48 horas para aparecer, e os totais recentes podem mudar durante o processamento. Isso não garante que todo evento aceito aparecerá nem confirma que ele foi recebido. Consulte: Medir resultados.
5. Os eventos estão sendo recebidos. Por que a campanha ainda mostra zero conversões?
Antes de alterar a integração, verifique:
A fonte de dados desejada está conectada à conta correta?
O evento que você envia corresponde à configuração de conversão da campanha? Para eventos personalizados, verifique o tipo personalizado e o nome exato do evento. Não basta que o rótulo de exibição seja igual.
A conversão correta foi vinculada à campanha antes da atividade que você está verificando?
A ação ocorreu após um clique ou uma visualização de anúncio elegível segundo as configurações de atribuição?
Você está visualizando a campanha, a coluna de eventos, as datas e a base temporal dos relatórios corretas?
As informações de correspondência ajudam a conectar um evento a um anúncio, mas não garantem a atribuição. Preserve a referência real de clique da OpenAI, oppref, durante toda a visita e inclua-a nos eventos do servidor quando estiver disponível. Nunca invente uma referência nem use a de outro visitante.
Verifique os eventos do navegador e do servidor separadamente. Uma referência ou um campo de cliente disponível para o Pixel pode estar ausente no evento do servidor.
A meta selecionada para uma campanha otimizada para conversões não pode ser alterada após a criação. Para usar uma meta diferente, crie uma nova campanha. Eventos personalizados não podem ser metas de otimização. Consulte: Campanhas otimizadas para conversões.
Após corrigir uma divergência na configuração, verifique novas atividades elegíveis. Não presuma que a alteração corrige relatórios anteriores. Para as regras de correspondência, consulte: Medição de conversões.
6. Por que a Plataforma de Anúncios, nossa ferramenta de análise e nosso CRM apresentam divergências?
Compare as mesmas ações e regras de relatórios. Seu CRM pode contar todas as compras; um relatório de anúncios conta as compras atribuídas àquela plataforma. Plataformas diferentes podem atribuir a mesma compra de maneiras diferentes.
Na Plataforma de Anúncios, Conversões combina conversões pós-clique e conversões pós-visualização elegíveis quando a janela de relatórios pós-visualização é de 1 dia. Com uma janela de visualização de 0 dias, são contadas apenas as conversões pós-clique. Use a mesma configuração ao comparar relatórios.
Por exemplo, alguém clica em um anúncio, volta diretamente ao site mais tarde e faz uma compra. Uma ferramenta pode classificar a visita como "Direta", enquanto outra atribui a compra ao anúncio anterior. Essa diferença, por si só, não significa que a compra foi contada duas vezes.
Se os rótulos de origem do tráfego forem diferentes, verifique a URL de destino e os parâmetros de rastreamento usados naquela visita. As configurações atuais da campanha podem ser diferentes das usadas anteriormente.
Compare:
Conta, campanha, tipo de evento, filtros e nível dos relatórios.
Intervalo de datas, fuso horário e se as datas se referem à interação com o anúncio ou à conversão em si.
Configurações pós-clique e pós-visualização e a métrica ou coluna exata selecionada.
Atrasos recentes no processamento, tratamento de duplicatas, consentimento e informações de correspondência disponíveis.
Conversões modeladas, quando disponíveis, que podem diferir das transações registradas diretamente.
Para valores, a moeda, as unidades e se a comparação usa o pedido inteiro ou itens individuais.
Para a receita, compare impostos, frete, descontos e taxas. Verifique se as cópias do navegador e do servidor enviam o mesmo valor do pedido. Vendas de pedidos criados e ROAS de pedidos criados contam apenas eventos order_created atribuídos.
A atividade importada do GA4 inclui eventos das diferentes origens de tráfego da propriedade selecionada. Esses totais não são conversões atribuídas à campanha. Consulte: Conectar o Google Analytics 4 à Plataforma de Anúncios da OpenAI.
Para comparações via API, registre o endpoint e defina explicitamente as opções de relatórios. Uma configuração omitida pode não corresponder à da Plataforma de Anúncios. Os relatórios também podem incluir eventos diferentes: alguns abrangem as metas da campanha, mas não outras ações rastreadas. A ausência de um evento em um relatório não prova que ele nunca foi recebido.
Use as mesmas configurações para uma comparação em CSV e guarde as exportações sem edição. Consulte Medir resultados para as visualizações da Plataforma de Anúncios e Relatórios para as opções da API.
7. Usar o Pixel e a CAPI vai contar uma compra duas vezes?
Para evitar contar a mesma ação duas vezes, use o mesmo ID do Pixel, nome do evento e ID do evento nas cópias do navegador e do servidor. O campo de ID do evento é id na CAPI e event_id no Pixel. Use também o mesmo nome de evento personalizado nos dois lados.
Mantenha o mesmo ID ao tentar enviar uma ação novamente; use um novo ID para cada ação diferente. Verifique se há tags duplicadas, carregamentos de página ou callbacks repetidos e integrações de parceiros que já possam enviar o evento.
Não reenvie uma duplicata para alterar o valor ou as informações de correspondência do evento original. Verifique o comportamento documentado antes de tentar fazer uma correção. Consulte: deduplicação de eventos do navegador e do servidor.
8. Usamos a Shopify. Precisamos de outra integração?
Verifique sua conexão com a Shopify antes de adicionar outra integração. Confirme a conta de anúncios e o Pixel conectados e depois verifique quais eventos o app envia para sua loja.
Se você também usa tags personalizadas, código de checkout ou um mecanismo de envio pelo servidor, verifique se eles enviam os mesmos eventos. As configurações da Shopify podem usar diferentes combinações de rastreamento pelo navegador e pelo servidor. Consulte: Configurar o ChatGPT Anúncios para a Shopify.
9. Como devemos lidar com o consentimento e os testes?
Envie apenas dados que você tem permissão para compartilhar e respeite as escolhas de consentimento dos visitantes. Seu desenvolvedor deve seguir as orientações da integração sobre consentimento e dados de correspondência compatíveis, incluindo qualquer normalização e aplicação de hash exigidas. Não remova controles de consentimento para aumentar as conversões nos relatórios ou melhorar uma pontuação.
O consentimento para medição e opt_out têm finalidades diferentes. A opção opt_out diz respeito à personalização; ela não interrompe todas as solicitações de medição. Peça ao seu desenvolvedor para verificar o tratamento do consentimento nas integrações do navegador e do servidor.
Registre o horário, o nome e o ID de uma ação de teste. Verifique se ela foi enviada, validada e recebida. Um teste de implementação bem-sucedido não mostra que um anúncio está qualificado para receber a atribuição.
A opção validate_only da CAPI verifica os eventos sem salvá-los. O modo de depuração do Pixel registra a atividade em logs, mas não exclui os eventos de teste dos relatórios. Identifique os testes nos seus registros e não invente compras nem altere os horários dos eventos para forçar um resultado.
10. Uma pontuação de qualidade do evento baixa ou indisponível significa que o rastreamento está com problemas?
Não por si só. A qualidade do evento avalia as informações recebidas de uma fonte de dados. Ela não informa quantas conversões foram atribuídas a anúncios. Uma pontuação baixa ou indisponível, por si só, não permite determinar se o rastreamento funciona.
Verifique se ações reais recentes são capturadas corretamente e depois investigue o aviso. Não envie eventos extras nem identificadores inventados para aumentar a pontuação. Para saber mais sobre verificações e prazos de atualização, consulte: Entender e melhorar a qualidade dos eventos.
11. O que devo incluir ao entrar em contato com o Suporte?
Informe o que você esperava, o que aconteceu, quando começou e o que você verificou. Inclua os itens desta lista que você tiver:
ID da conta de anúncios, ID do Pixel ou fonte de dados e identificadores das campanhas e dos anúncios afetados.
Tipo de integração e nome exato do evento, incluindo qualquer nome de evento personalizado.
Um ou dois IDs de eventos existentes como amostra e os carimbos de data/hora das ações, com o fuso horário.
Para falhas nas solicitações ou dúvidas sobre o recebimento: código de resposta, erro exato, horário da solicitação, qualquer ID de solicitação ou CF-Ray retornado e um payload ou trecho de log com dados sensíveis ocultados.
Para divergências nos relatórios: intervalo de datas, base temporal dos relatórios, configurações de atribuição, colunas selecionadas, exportação em CSV e uma comparação com o mesmo escopo.
Capturas de tela relevantes e quaisquer alterações recentes na configuração, incluindo um checkout separado ou uma integração de parceiro.
Informe se você confirmou que o evento foi enviado, aceito ou recebido, ou se apenas verificou o relatório. Você pode pedir ajuda mesmo que não consiga concluir essas verificações.
Remova dos anexos as chaves de API, os cabeçalhos de autorização, as senhas, os cookies e as informações desnecessárias de clientes. Comunique prontamente erros ou uma integração que funcionava e parou de repente. Não espere a janela de relatórios terminar.