概覽
如果事件遺漏、請求失敗,或廣告管理平台的資料與你的業務紀錄不符,請參考本指南。先從一筆已完成的購買、一次已提交的潛在客戶資料,或其他動作著手。記下發生的情況和時間,再從下方選擇符合情況的問題。
事件用來記錄動作,例如購買。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 天,則只計算點擊後轉換。比較報表時,請使用相同的設定。
例如,有人點擊廣告,之後直接返回網站並購買。某個工具可能將這次造訪標示為「直接流量」,另一個工具則可能將成效歸因於先前的廣告。僅有這項差異,並不代表該筆購買被計算了兩次。
如果流量來源標籤不同,請檢查該次造訪使用的到達網址和追蹤參數。目前的廣告活動設定可能與先前使用的設定不同。
請比較:
帳號、廣告活動、事件類型、篩選條件和報表層級。
日期範圍、時區,以及日期是指廣告互動時間還是轉換本身的時間。
點擊後轉換和瀏覽後轉換的設定,以及實際選取的指標或欄位。
近期的處理延遲、重複事件處理方式、使用者同意狀態,以及可用的比對資訊。
如有提供,請比較模型推估的轉換;這些轉換可能與直接記錄的交易不同。
比較價值時,請確認幣別、單位,以及比較的是整筆訂單還是個別品項。
比較營收時,請核對稅金、運費、折扣和手續費。請確認瀏覽器端和伺服器端傳送的事件副本使用相同的訂單金額。訂單建立銷售額和訂單建立廣告投資報酬率只計入已歸因的 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 和非必要的客戶資訊。若發生錯誤,或原本正常運作的整合突然停止運作,請儘速回報。不必等到報表預估處理時間結束才回報。
