Visão geral
Utilize este guia se faltarem eventos, se os pedidos falharem ou se os dados do Gestor de Anúncios não coincidirem com os registos da sua empresa. Comece por uma compra concluída, um contacto de potencial cliente enviado ou outra ação. Anote o que aconteceu e quando, e depois escolha abaixo a pergunta que se aplica.
Um evento regista uma ação, como uma compra. O Pixel envia eventos a partir do navegador de um visitante; a API de Conversões (CAPI) envia-os a partir do seu servidor. O Gestor de Anúncios reúne estes eventos numa fonte de dados. A atribuição determina a que anúncio é atribuída a ação. Uma janela de atribuição define durante quanto tempo, após uma interação com um anúncio, uma ação pode ser elegível.
Perguntas frequentes
1. Por onde devo começar?
Identifique a ação que pretende medir, o mecanismo que a envia, a conta de anúncios e o ID do Pixel utilizados. A sua configuração pode utilizar o Pixel, a CAPI, uma integração de parceiro ou uma combinação destes elementos. A CAPI precisa de um ID do Pixel, mesmo que não tenha instalado o Pixel no navegador.
Para a configuração inicial, consulte: Medição de conversões e Rastreio de conversões. O seu programador pode utilizar os guias do Pixel, da CAPI e dos Eventos suportados. Mantenha os pedidos e as chaves da CAPI no seu servidor.
Se um parceiro gerir a sua integração, utilize 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 ligação ao HubSpot, consulte: Configurar o ChatGPT Ads no HubSpot.
Se já tiver uma configuração, verifique cada passo:
A ação enviou um pedido de evento?
O pedido devolveu um erro ou foi aceite?
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. O meu Pixel está instalado. Porque não vejo compras ou potenciais clientes?
O Pixel pode carregar sem enviar o evento de compra ou de potencial cliente de que precisa. Peça ao seu programador 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, incluindo quando é carregado por um gestor de etiquetas.
Verifique a consola do navegador e o pedido de rede. A mensagem «acionada» de um gestor de etiquetas, por si só, não confirma que o evento tenha sido enviado. O modo de depuração do Pixel pode ajudar.
Verifique se as opções de consentimento, o bloqueio pelo navegador ou a política de segurança do seu site impediram o pedido.
Verifique as páginas que exigem início de sessão, a finalização de compra, os sites de reservas, os redirecionamentos e os formulários incorporados. Um Pixel a funcionar na página de destino não confirma que o rastreio funcione noutros locais.
Se não tiver sido enviado nenhum pedido, corrija primeiro esse passo. Esperar que os dados apareçam nos relatórios não vai ajudar. Utilize o guia de resoluçã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 devolver um erro de servidor?
Guarde o código de resposta, o erro exato, a hora do pedido e o ID do evento. Peça ao seu programador para verificar o formato do evento, o ID do Pixel e a chave. Os pedidos de eventos da CAPI utilizam uma chave da API de Conversões da mesma conta de anúncios. Os pedidos de configuração, gestão e relatórios utilizam uma chave distinta, a da API do Anunciante. Não envie chaves de API à equipa de apoio.
Nos lotes da CAPI, um único evento inválido pode fazer com que todo o lote falhe.
A CAPI exige a hora original da ação em milissegundos Unix. A data e hora do evento não podem recuar mais de 7 dias nem avançar mais de 10 minutos em relação ao momento atual. Este limite de envio é independente da janela de atribuição. Não altere a hora de um evento antigo para que seja aceite.
Um tempo limite excedido ou um erro de servidor pode deixar dúvidas sobre se o evento chegou. Verifique o pedido original e quaisquer registos de receção. Se voltar a tentar a mesma ação, mantenha o ID do evento e o carimbo de data/hora originais. Um novo ID pode fazer com que pareça tratar-se de outra ação.
Investigue sem demora uma rejeição ou uma falha persistente nos pedidos. A estimativa de 24–48 horas para os dados aparecerem nos relatórios não se aplica a estes erros. Para conhecer os requisitos dos pedidos, consulte: API de Conversões.
4. Vejo que o evento foi aceite. Porque não aparece no relatório?
A aceitação não significa que um evento tenha sido atribuído a um anúncio. Verifique o que a resposta confirma e se o pedido utilizou a fonte de dados correta. Na CAPI, validate_only definido como true verifica os eventos sem os guardar.
No caso de um novo evento, o seu programador pode consultar os eventos recentes, quando disponíveis. Esta vista mostra uma amostra recente, não um histórico completo nem um resultado de atribuição.
Se não conseguir verificar a receção, contacte a equipa de apoio e forneça a resposta original e um evento de exemplo. Diga-nos que verificações concluiu; não precisa de identificar a causa primeiro.
Se a receção estiver confirmada, avance 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 demorar aproximadamente 24–48 horas a aparecer, e os totais recentes podem mudar durante o processamento. Isto não garante que todos os eventos aceites apareçam nem confirma que tenham sido recebidos. Consulte: Medir resultados.
5. Os eventos estão a ser recebidos. Porque é que a campanha continua a mostrar zero conversões?
Antes de alterar a integração, verifique:
A fonte de dados pretendida está ligada à conta correta?
O evento que envia corresponde à definição de conversão da campanha? No caso de eventos personalizados, verifique o tipo personalizado e o nome exato do evento. Não basta que o nome apresentado corresponda.
A conversão correta foi associada à campanha antes da atividade que está a verificar?
A ação ocorreu após um clique ou uma visualização de anúncio elegível segundo as definições de atribuição?
Está a consultar a campanha, a coluna de eventos, as datas e a referência temporal do relatório corretas?
As informações de correspondência ajudam a associar um evento a um anúncio, mas não garantem a atribuição. Preserve a referência real de clique da OpenAI, oppref, ao longo da visita e inclua-a nos eventos do servidor quando estiver disponível. Nunca invente uma referência nem utilize a de outro visitante.
Verifique separadamente os eventos do navegador e do servidor. Uma referência ou um campo de cliente disponível para o Pixel pode não estar presente 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 utilizar um objetivo diferente, crie uma nova campanha. Os eventos personalizados não podem ser objetivos de otimização. Consulte: Campanhas otimizadas para conversões.
Depois de corrigir uma incompatibilidade na configuração, verifique a nova atividade elegível. Não presuma que a alteração corrige os relatórios anteriores. Para conhecer as regras de correspondência, consulte: Medição de conversões.
6. Porque é que o Gestor de Anúncios, a nossa ferramenta de análise e o nosso CRM apresentam dados diferentes?
Compare as mesmas ações e regras de relatório. O seu CRM pode contar todas as compras; um relatório de anúncios conta as compras atribuídas à respetiva plataforma. Diferentes plataformas podem atribuir a mesma compra de formas diferentes.
No Gestor de Anúncios, Conversões combina as conversões após clique e as conversões elegíveis após visualização quando a janela de relatório após visualização é de 1 dia. Com uma janela após visualização de 0 dias, conta apenas as conversões após clique. Utilize a mesma definição ao comparar relatórios.
Por exemplo, alguém clica num anúncio, regressa diretamente 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 tenha sido contada duas vezes.
Se as classificações da origem do tráfego forem diferentes, verifique o URL de destino e os parâmetros de rastreio utilizados nessa visita. As definições atuais da campanha podem diferir das utilizadas anteriormente.
Compare:
Conta, campanha, tipo de evento, filtros e nível do relatório.
Intervalo de datas, fuso horário e se as datas se referem à interação com o anúncio ou à própria conversão.
Definições após clique e após visualização e a métrica ou coluna exata selecionada.
Atrasos recentes no processamento, tratamento de duplicados, consentimento e informações de correspondência disponíveis.
Conversões modeladas, quando disponíveis, que podem diferir das transações registadas diretamente.
No caso dos valores, a moeda, as unidades e se a comparação utiliza a encomenda completa ou artigos individuais.
No caso da receita, compare impostos, portes de envio, descontos e taxas. Verifique se as cópias do navegador e do servidor enviam o mesmo valor da encomenda. Vendas de encomendas criadas e ROAS de encomendas criadas contam apenas os 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 são conversões atribuídas a campanhas. Consulte: Ligar o Google Analytics 4 ao Gestor de Anúncios da OpenAI.
Para comparações através da API, registe o endpoint e defina explicitamente as opções de relatório. Uma definição omitida pode não corresponder à do Gestor 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 num relatório não prova que nunca tenha sido recebido.
Utilize as mesmas definições para uma comparação em CSV e guarde as exportações sem alterações. Consulte Medir resultados para conhecer as vistas do Gestor de Anúncios e Relatórios para conhecer as opções da API.
7. Utilizar o Pixel e a CAPI fará com que uma compra seja contada duas vezes?
Para evitar contar a mesma ação duas vezes, utilize 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. Utilize também o mesmo nome de evento personalizado em ambos os lados.
Mantenha o mesmo ID ao repetir uma tentativa de uma ação; utilize um novo ID para cada ação diferente. Verifique se existem etiquetas duplicadas, carregamentos de página ou callbacks repetidos e integrações de parceiros que já possam estar a enviar o evento.
Não reenvie um duplicado para alterar o valor ou as informações de correspondência do evento original. Consulte o comportamento documentado antes de tentar uma correção. Consulte: deduplicação de eventos do navegador e do servidor.
8. Utilizamos o Shopify. Precisamos de outra integração?
Verifique a sua ligação ao Shopify antes de adicionar outra integração. Confirme a conta de anúncios e o Pixel ligados e, em seguida, verifique que eventos a aplicação envia para a sua loja.
Se também utilizar etiquetas personalizadas, código de finalização de compra ou um mecanismo de envio no servidor, verifique se enviam os mesmos eventos. As configurações do Shopify podem utilizar diferentes combinações de rastreio no navegador e no servidor. Consulte: Configurar o ChatGPT Ads para o Shopify.
9. Como devemos gerir o consentimento e os testes?
Envie apenas dados que tem permissão para partilhar e respeite as opções de consentimento dos visitantes. O seu programador deve seguir as orientações da integração sobre consentimento e dados de correspondência suportados, incluindo qualquer normalização e aplicação de funções de hash exigidas. Não remova os controlos de consentimento para aumentar as conversões nos relatórios ou melhorar uma pontuação.
O consentimento para medição e a opção opt_out têm finalidades diferentes. A opção opt_out diz respeito à personalização; não impede todos os pedidos de medição. Peça ao seu programador para verificar a gestão do consentimento nas integrações do navegador e do servidor.
Registe a hora, o nome e o ID de uma ação de teste. Verifique se foi enviada, validada e recebida. Um teste de implementação bem-sucedido não demonstra que um anúncio seja elegível para atribuição.
A opção validate_only da CAPI verifica os eventos sem os guardar. O modo de depuração do Pixel regista a atividade, mas não exclui os eventos de teste dos relatórios. Identifique os testes nos seus registos e não invente compras nem altere as horas dos eventos para forçar um resultado.
10. Uma Pontuação de qualidade dos eventos baixa ou indisponível significa que o rastreio não funciona?
Por si só, não. A qualidade dos eventos avalia as informações recebidas de uma fonte de dados. Não indica 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 rastreio funciona.
Verifique se as ações reais recentes são registadas corretamente e, em seguida, investigue o aviso. Não envie eventos adicionais nem identificadores inventados para aumentar a pontuação. Para saber que verificações fazer e quais os prazos de atualização, consulte: Compreender e melhorar a qualidade dos eventos.
11. O que devo incluir ao contactar a equipa de apoio?
Diga-nos o que esperava, o que aconteceu, quando começou e o que verificou. Inclua os elementos desta lista de que dispõe:
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 exemplo e os carimbos de data/hora das ações, com o fuso horário.
Para falhas nos pedidos ou dúvidas sobre a receção: código de resposta, erro exato, hora do pedido, qualquer ID de pedido ou CF-Ray devolvido e um payload ou excerto de registo com os dados sensíveis ocultados.
Para diferenças nos relatórios: intervalo de datas, referência temporal do relatório, definições de atribuição, colunas selecionadas, exportação CSV e uma comparação com o mesmo âmbito.
Capturas de ecrã relevantes e quaisquer alterações recentes à configuração, incluindo um processo de finalização de compra separado ou uma integração de parceiro.
Diga-nos se confirmou que o evento foi enviado, aceite ou recebido, ou se apenas consultou o relatório. Pode pedir ajuda mesmo que não consiga concluir estas verificações.
Remova dos anexos as chaves de API, os cabeçalhos de autorização, as palavras-passe, os cookies e as informações desnecessárias sobre clientes. Comunique sem demora quaisquer erros ou o facto de uma integração que funcionava ter deixado de funcionar subitamente. Não espere que termine o prazo previsto para os dados aparecerem nos relatórios.