Visão geral
Use 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 lead submetido ou outra ação. Anote o que aconteceu e quando, e escolha a pergunta abaixo que se aplica ao seu caso.
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 recolhe 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 que a envia e 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 Acompanhamento de conversões. O seu programador pode utilizar os guias do Pixel, da CAPI e de 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 etapa:
A ação originou o envio de 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 leads?
O Pixel pode carregar sem enviar o evento de compra ou de lead 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 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 foi enviado. O modo de depuração do Pixel pode ajudar.
Verifique se as opções de consentimento, os bloqueios do 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 compras, os sites de reservas, os redirecionamentos e os formulários incorporados. O facto de o Pixel funcionar na página de destino não confirma que o acompanhamento funcione noutros locais.
Se não tiver sido enviado nenhum pedido, corrija essa etapa primeiro. Esperar pelos relatórios não 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, 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. O evento deve situar-se nos últimos 7 dias ou, no máximo, 10 minutos no futuro. 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 foi recebido. Verifique o pedido original e quaisquer registos de receção. Se voltar a tentar enviar 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 ser outra ação.
Investigue sem demora uma rejeição ou uma falha persistente nos pedidos. A estimativa de 24–48 horas para os 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.
Para um novo evento, o seu programador pode consultar os eventos recentes, quando disponíveis. Esta vista apresenta 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 com a resposta original e um evento de exemplo. Indique-nos as verificações que efetuou; não precisa de descobrir 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 cerca de 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? Para eventos personalizados, verifique o tipo personalizado e o nome exato do evento. Não basta que o nome apresentado coincida.
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 de acordo com as definições de atribuição?
Está a consultar a campanha, a coluna de eventos, as datas e a base temporal dos relatórios 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 de clique real 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 os eventos do navegador e do servidor separadamente. Uma referência ou um campo de cliente disponível para o Pixel pode estar em falta 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 discrepância de configuração, verifique a nova atividade elegível. Não pressuponha que a alteração corrige relatórios anteriores. Para conhecer as regras de correspondência, consulte: Medição de conversões.
6. Porque diferem os dados do Gestor de Anúncios, da nossa ferramenta de análise e do nosso CRM?
Compare as mesmas ações e regras de elaboração de relatórios. O seu CRM pode contabilizar todas as compras; um relatório de anúncios contabiliza 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 pós-clique e as conversões pós-visualização elegíveis quando a janela de inclusão de conversões pós-visualização nos relatórios é de 1 dia. Com uma janela de visualização de 0 dias, contabiliza apenas as conversões pó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 contabilizada duas vezes.
Se as designações das fontes de tráfego diferirem, verifique o URL de destino e os parâmetros de acompanhamento utilizados nessa visita. As definições atuais da campanha podem ser diferentes das utilizadas anteriormente.
Compare:
Conta, campanha, tipo de evento, filtros e nível de detalhe dos relatórios.
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 pós-clique e pó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.
Para os valores, a moeda, as unidades e se a comparação utiliza a encomenda completa ou os artigos individuais.
Para a receita, compare impostos, portes de envio, descontos e taxas. Verifique se as cópias do navegador e do servidor enviam o mesmo valor de encomenda. Vendas de encomendas criadas e ROAS de encomendas criadas contabilizam apenas eventos order_created atribuídos.
A atividade importada do GA4 inclui eventos das várias fontes de tráfego da propriedade selecionada. Esses totais não representam conversões atribuídas à campanha. 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 dos relatórios. 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 acompanhadas. 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 de ficheiros CSV e guarde as exportações sem alterações. Consulte: Medir resultados para as vistas do Gestor de Anúncios e Relatórios para as opções da API.
7. Utilizar o Pixel e a CAPI fará com que uma compra seja contabilizada duas vezes?
Para evitar contabilizar a mesma ação duas vezes, utilize o mesmo ID do Pixel, nome do evento e ID do evento nas respetivas cópias do navegador e do 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 voltar a tentar enviar 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 possam já enviar o evento.
Não reenvie um duplicado 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: desduplicação de eventos do navegador e do servidor.
8. Utilizamos a Shopify. Precisamos de outra integração?
Verifique a sua ligação à Shopify antes de adicionar outra integração. Confirme a conta de anúncios e o Pixel ligados e verifique que eventos a aplicação envia para a sua loja.
Se também utilizar etiquetas personalizadas, código de finalização de compras ou um mecanismo de envio no servidor, verifique se enviam os mesmos eventos. As configurações da Shopify podem utilizar diferentes combinações de acompanhamento no navegador e no servidor. Consulte: Configurar o ChatGPT Ads para a Shopify.
9. Como devemos gerir o consentimento e os testes?
Envie apenas dados que tenha autorizaçã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 quaisquer requisitos de normalização e aplicação de funções hash. 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 opt_out têm finalidades diferentes. A opção opt_out diz respeito à personalização; não interrompe 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 impede que os eventos de teste sejam incluídos nos 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 acompanhamento 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 acompanhamento 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 quando ocorrem as atualizações, 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 que tiver disponíveis:
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 receção incerta: 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, base temporal dos relatórios, 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 compras separado ou uma integração de parceiro.
Diga-nos se confirmou que o evento foi enviado, aceite ou recebido, ou se apenas verificou 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 de clientes desnecessárias. Comunique sem demora quaisquer erros ou a paragem súbita de uma integração que funcionava anteriormente. Não espere que termine a janela dos relatórios.