Visão geral

Use este guia se houver eventos ausentes, falhas nas requisiçõ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, e escolha abaixo a pergunta que se aplica 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 coleta esses eventos em uma fonte de dados. A atribuição determina qual anúncio recebe o crédito pela ação. Uma janela de atribuição define por quanto tempo após uma interação com um anúncio uma ação pode se qualificar.

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 dessas opções. 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: Mensuraçã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 requisições e as chaves da CAPI no seu servidor.

Se um parceiro gerencia sua integração, use o guia de configuração de parceiros de mensuração ou o guia de configuração de parceiros de mensuração móvel. Para uma conexão com o HubSpot, consulte: Configurar o ChatGPT Anúncios no HubSpot.

Para uma configuração existente, verifique cada etapa:

• A ação enviou uma requisição de evento?

• A requisiçã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 de 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 envia o evento. Uma visualização de página não é uma compra concluída.

• Confirme que o Pixel é inicializado antes de enviar o evento, inclusive quando um gerenciador de tags o carrega.

• Verifique o console do navegador e a requisição de rede. A mensagem "disparada" 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 requisiçã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 outros locais.

Se nenhuma requisiçã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, a mensagem exata do erro, o horário da requisiçã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 requisições de eventos da CAPI usam uma chave da API de Conversões da mesma conta de anúncios. As requisições de configuração, gerenciamento e relatórios usam uma chave separada, a da API de Anunciantes. Não envie chaves de API ao Suporte.

Nos lotes da CAPI, um único evento inválido pode causar a falha de todo o lote.

A CAPI exige o horário original da ação em milissegundos Unix. O evento deve estar no intervalo entre os últimos 7 dias e, no máximo, 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 um erro de servidor pode deixar dúvidas sobre o recebimento do evento. Verifique a requisição original e os registros de recebimento disponíveis. Se tentar reenviar a mesma ação, mantenha o ID do evento e o carimbo de data/hora originais. Um novo ID pode fazer com que ela pareça outra ação.

Investigue prontamente qualquer rejeição ou falha persistente nas requisições. A estimativa de 24 a 48 horas para os relatórios não se aplica a esses erros. Para conhecer os requisitos das requisições, consulte: API de Conversões.

4. Vejo que o evento foi aceito. Por que ele não aparece 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 requisiçã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. Essa visualização 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 exemplo. Informe quais verificações você concluiu; não é preciso descobrir a causa primeiro.

Se o recebimento estiver confirmado, vá 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 todos os eventos aceitos aparecerão nem confirma que foram recebidos. 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 exibido 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 que se qualifica de acordo com as configurações de atribuição?

• Você está visualizando a campanha, a coluna de eventos, as datas e a referência temporal dos relatórios corretas?

As informações de correspondência ajudam a vincular 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.

O objetivo selecionado de uma campanha otimizada para conversões não pode ser alterado após a criação. Para usar um objetivo diferente, crie uma nova campanha. Eventos personalizados não podem ser objetivos de otimização. Consulte: Campanhas otimizadas para conversões.

Depois de corrigir uma divergência na configuração, verifique novas atividades elegíveis. Não presuma que a alteração corrige os relatórios anteriores. Para conhecer as regras de correspondência, consulte: Mensuração de conversões.

6. Por que há divergências entre a Plataforma de Anúncios, nossa ferramenta de análise e nosso CRM?

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, a métrica conta 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 as classificações da 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 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 de todas as origens de tráfego da propriedade selecionada. Esses totais não representam 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 os objetivos 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 alterações. Consulte Medir resultados para conhecer as visualizações da Plataforma de Anúncios e Relatórios para as opções da API.

7. Usar o Pixel e a CAPI fará com que uma compra seja contada 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 enviadas pelo navegador e pelo 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 reenviar uma ação; 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 talvez já enviem o evento.

Não reenvie uma duplicata para alterar o valor ou as informações de correspondência do evento original. Confira 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 verifique quais eventos o app envia para sua loja.

Se você também usa tags personalizadas, código no 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 a normalização e a aplicação de hash exigidas. Não remova os controles de consentimento para aumentar as conversões nos relatórios ou melhorar uma pontuação.

O consentimento para mensuração e opt_out têm finalidades diferentes. A opção opt_out diz respeito à personalização; ela não interrompe todas as requisições de mensuração. Peça ao seu desenvolvedor para verificar como o consentimento é tratado 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 se qualifica 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, 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 dos eventos baixa ou indisponível significa que o rastreamento não está funcionando?

Não por si só. A qualidade dos eventos 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 as ações reais recentes são capturadas corretamente e, em seguida, investigue o aviso. Não envie eventos extras nem identificadores inventados para aumentar a pontuação. Para saber mais sobre as verificações e os prazos de atualização, consulte: Entender e melhorar a qualidade dos eventos.

11. O que devo incluir ao entrar em contato com o Suporte?

Conte o que você esperava, o que aconteceu, quando começou e o que você verificou. Inclua as informações 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 exemplos de IDs de eventos existentes e carimbos de data/hora das ações, com o fuso horário.

• Para falhas nas requisições ou dúvidas sobre o recebimento: código de resposta, mensagem exata do erro, horário da requisição, qualquer ID de requisição ou CF-Ray retornado e um payload ou trecho de log com os dados sensíveis ocultados.

• Para diferenças nos relatórios: intervalo de datas, referência 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 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. Informe prontamente qualquer erro ou integração que funcionava e parou de repente. Não espere o prazo de atualização dos relatórios terminar.