概览
如果事件缺失、请求失败,或广告管理平台的数据与你的业务记录不一致,请参考本指南。从一次已完成的购买、已提交的销售线索或其他操作入手。记下发生的情况和时间,然后在下方选择对应的问题。
事件用于记录某个操作,例如一次购买。Pixel 从访客的浏览器发送事件;转化 API(CAPI)则从你的服务器发送事件。广告管理平台会将这些事件收集到一个数据源中。归因用于确定应将转化计入哪条广告。归因窗口规定了与广告互动后多长时间内发生的操作可计为转化。
常见问题
1. 我应该从哪里开始?
明确要衡量的操作、发送该操作事件的来源,以及所用的广告账户和 Pixel ID。你的配置可能使用 Pixel、CAPI、合作伙伴集成,或这些方式的组合。即使尚未安装浏览器端 Pixel,CAPI 也需要 Pixel ID。
首次设置时,请参阅:转化衡量和转化跟踪。你的开发者可以参考 Pixel、CAPI 和支持的事件指南。请在服务器端发送 CAPI 请求并保管密钥。
如果你的集成由合作伙伴管理,请参考衡量合作伙伴设置指南或移动衡量合作伙伴设置指南。如需连接 HubSpot,请参阅:在 HubSpot 中设置 ChatGPT Ads。
对于现有配置,请逐步检查:
该操作是否触发了事件请求的发送?
请求返回了错误,还是已被接受?
能否确认正确的数据源已收到该事件?
该事件是否已在广告系列报告中归因于某条广告?
2. 我已安装 Pixel。为什么看不到购买或销售线索?
Pixel 即使成功加载,也可能没有发送你需要的购买或销售线索事件。请开发者针对一次已完成的操作进行以下检查:
检查事件名称、Pixel ID,以及发送该事件的页面或回调。浏览页面不等于完成购买。
确认 Pixel 在发送事件前已完成初始化,通过标签管理器加载时也不例外。
检查浏览器控制台和网络请求。仅凭标签管理器的“已触发”消息,无法确认事件已发送。Pixel 调试模式可以帮助排查。
检查请求是否被用户的同意选项、浏览器拦截机制或网站安全策略阻止。
检查登录后的页面、结账流程、预订网站、重定向和嵌入式表单。落地页上的 Pixel 正常运行,并不能确认其他位置的跟踪也正常。
如果请求未发送,请先修复这一环节。等待报告更新无法解决问题。添加其他集成前,请先参考 Pixel 故障排查指南。
3. 如果事件被拒绝、超时或返回服务器错误,我该怎么办?
保存响应代码、确切的错误信息、请求时间和事件 ID。请开发者检查事件格式、Pixel ID 和密钥。CAPI 事件请求使用同一广告账户的转化 API 密钥。设置、管理和报告请求则使用单独的广告主 API 密钥。请勿向支持团队发送 API 密钥。
对于 CAPI 批量请求,一个无效事件就可能导致整个批次失败。
CAPI 要求以 Unix 毫秒时间戳提供操作最初发生的时间。事件时间不得早于过去 7 天,也不得晚于当前时间之后的 10 分钟。这一提交时限与归因窗口无关。请勿为了通过验证而修改旧事件的时间。
发生超时或服务器错误后,你可能无法确定事件是否已送达。请检查原始请求及所有接收记录。如果重试同一操作,请保留其原始事件 ID 和时间戳。使用新 ID 可能会使其被视为另一次操作。
如果请求被拒绝或持续失败,请及时排查。报告预计需 24–48 小时更新,但这一时间不适用于这些错误。有关请求要求,请参阅:转化 API。
4. 我看到事件已被接受。为什么报告中没有显示?
事件被接受并不意味着它已归因于某条广告。请检查响应确认了哪些信息,以及请求是否使用了正确的数据源。在 CAPI 中,将 validate_only 设置为 true 只会验证事件,不会保存事件。
对于新事件,你的开发者可以查看近期事件(如可用)。这里展示的是近期事件样本,而非完整历史记录或归因结果。
如果无法检查接收情况,请联系支持团队,并提供原始响应和一个示例事件。请告诉我们你已完成哪些检查;无需先找出原因。
如果已确认事件被接收,请继续查看问题 5。请勿仅因广告系列报告尚未变化,就使用新 ID 重新发送事件。
已归因的转化可能需要约 24–48 小时才会显示,近期总数在处理过程中也可能发生变化。这并不保证每个被接受的事件都会显示,也不能据此确认事件已被接收。请参阅:衡量成效。
5. 事件正在被接收。为什么广告系列仍显示零转化?
更改集成前,请检查:
要使用的数据源是否已连接到正确的账户?
你发送的事件是否与广告系列的转化设置一致?对于自定义事件,请检查自定义类型和确切的事件名称。仅显示标签一致还不够。
在你检查的活动发生之前,是否已将正确的转化关联到广告系列?
该操作是否发生在符合归因设置条件的广告点击或浏览之后?
你查看的广告系列、事件列、日期和报告时间口径是否正确?
匹配信息有助于将事件与广告关联起来,但不保证能成功归因。在整个访问过程中保留真实的 OpenAI 点击引用标识 oppref,并在可用时将其包含在服务器端事件中。切勿编造引用标识或使用其他访客的引用标识。
分别检查浏览器端和服务器端事件。Pixel 中可用的引用标识或客户字段可能未包含在服务器端事件中。
以转化为优化目标的广告系列创建后,无法更改所选目标。如需使用不同目标,请创建新的广告系列。自定义事件不能作为优化目标。请参阅:以转化为优化目标的广告系列。
修复配置不一致的问题后,请检查新发生的、符合条件的活动。不要假定这项更改会修正之前的报告。有关匹配规则,请参阅:转化衡量。
6. 为什么广告管理平台、我们的分析工具和 CRM 的数据不一致?
请针对相同的操作,按相同的报告规则进行比较。你的 CRM 可能统计每一笔购买,而广告报告只统计归因于该平台的购买。不同平台可能对同一笔购买采用不同的归因方式。
在广告管理平台中,当浏览后转化的报告窗口为 1 天时,转化次数同时包含点击后转化和符合条件的浏览后转化。当浏览窗口为 0 天时,只统计点击后转化。比较报告时,请使用相同的设置。
例如,有人点击广告,之后直接返回网站并完成购买。一个工具可能将此次访问标记为“直接访问”,另一个工具则将其归因于此前的广告。仅凭这一差异,并不能说明该笔购买被计算了两次。
如果流量来源标签不同,请检查此次访问所用的落地页 URL 和跟踪参数。当前的广告系列设置可能与之前使用的设置不同。
请比较:
账户、广告系列、事件类型、筛选条件和报告层级。
日期范围、时区,以及日期依据的是广告互动时间还是转化发生时间。
点击后和浏览后转化设置,以及具体选择的指标或列。
近期的处理延迟、重复事件处理方式、用户同意情况和可用的匹配信息。
建模转化数据(如有),这可能与直接记录的交易不同。
对于价值数据,请比较币种、单位,以及比较的是整笔订单还是单件商品。
对于收入,请比较税费、运费、折扣和手续费。检查浏览器端和服务器端的事件副本是否发送了相同的订单价值。订单创建销售额和订单创建广告支出回报率仅统计已归因的 order_created 事件。
导入的 GA4 活动数据包含所选媒体资源各个流量来源的事件。这些总数并不是归因于广告系列的转化次数。请参阅:将 Google Analytics 4 连接到 OpenAI 广告管理平台。
比较 API 数据时,请记录端点,并明确设置报告选项。未指定的设置可能与广告管理平台中的设置不一致。报告所包含的事件也可能不同:有些报告涵盖广告系列目标,但不包含其他已跟踪的操作。某份报告中缺少一个事件,并不能证明该事件从未被接收。
比较 CSV 数据时,请使用相同设置,并保留未经编辑的导出文件。有关广告管理平台的视图,请参阅衡量成效;有关 API 选项,请参阅报告。
7. 同时使用 Pixel 和 CAPI 会将一次购买计算两次吗?
为避免同一操作被计算两次,请为其浏览器端和服务器端事件副本使用相同的 Pixel ID、事件名称和事件 ID。事件 ID 字段在 CAPI 中为 id,在 Pixel 中为 event_id。两端也应使用相同的自定义事件名称。
重试同一操作时保留原 ID;每次不同的操作则使用新 ID。检查是否存在重复的标签、重复的页面加载或回调,以及可能已在发送该事件的合作伙伴集成。
请勿通过重复发送事件来更改原始事件的价值或匹配信息。尝试更正前,请先查阅文档中说明的处理方式。请参阅:浏览器端和服务器端事件去重。
8. 我们使用 Shopify。还需要其他集成吗?
添加其他集成前,请先检查你的 Shopify 连接。确认已连接的广告账户和 Pixel,然后检查应用为你的商店发送了哪些事件。
如果你还使用了自定义标签、结账代码或服务器端发送程序,请检查它们是否发送了相同的事件。Shopify 配置可以采用不同的浏览器端和服务器端跟踪组合。请参阅:为 Shopify 设置 ChatGPT Ads。
9. 我们应该如何处理用户同意和测试?
仅发送你获准共享的数据,并尊重访客的同意选择。你的开发者应遵循该集成有关用户同意和支持的匹配数据的指南,包括必要的规范化和哈希处理要求。请勿为了增加报告中的转化次数或提高评分而移除用户同意控制机制。
衡量数据收集的用户同意与 opt_out 用途不同。opt_out 选项针对个性化,并不会停止所有衡量请求。请开发者检查浏览器端和服务器端集成对用户同意的处理方式。
记录一次测试操作的时间、名称和 ID。检查其是否已发送、通过验证并被接收。实现测试成功,并不表明某条广告符合归因条件。
CAPI 的 validate_only 选项只验证事件,不保存事件。Pixel 调试模式会记录活动日志,但不会将测试事件排除在报告之外。请在记录中标注测试,并且不要为了强行得到结果而虚构购买或更改事件时间。
10. 事件质量评分偏低或不可用,是否意味着跟踪出现故障?
仅凭这一点无法判断。事件质量评估的是从数据源收到的信息。它并不说明有多少次转化归因于广告。仅凭评分偏低或不可用,无法确定跟踪是否正常。
请先检查近期真实发生的操作是否被正确捕获,再排查警告原因。请勿为了提高评分而发送额外事件或虚构的标识符。有关检查方法和刷新时间,请参阅:了解并改善事件质量。
11. 联系支持团队时,我应该提供哪些信息?
请告诉我们你的预期结果、实际情况、问题开始的时间,以及已进行的检查。请尽可能提供以下信息:
广告账户 ID、Pixel ID 或数据源,以及受影响的广告系列和广告的标识符。
集成类型和确切的事件名称,包括任何自定义事件名称。
一两个现有示例事件的 ID 和操作时间戳,并注明时区。
对于请求失败或无法确认接收的情况:响应代码、确切的错误信息、请求时间、返回的请求 ID 或 CF-Ray,以及已隐去敏感信息的载荷或日志片段。
对于报告差异:日期范围、报告时间口径、归因设置、所选列、导出的 CSV,以及相同统计范围内的对比。
相关截图及近期的配置变更,包括独立结账流程或合作伙伴集成。
请告诉我们,你是否已确认事件已发送、已被接受或已被接收,还是仅查看了报告。即使无法完成这些检查,你仍然可以寻求帮助。
请从附件中移除 API 密钥、授权标头、密码、Cookie 和不必要的客户信息。如果出现错误,或原本正常运行的集成突然停止工作,请及时报告。无需等到报告更新时限结束。
