常見問題

請注意以下限制：

• 個別 batchinsert 和 batchupdate 要求最多只能包含 1,000 項轉換。
• 轉換時間戳記最久只能回溯至提交時間的 28 天前。
• 您只能將轉換提交至 Campaign Manager 360 使用者個人資料有權存取的 Floodlight 設定。

如要詳細比較這兩項產品提供的功能，請參閱 Search Ads 360 說明中心。

如果將同一筆轉換同時插入 Campaign Manager 360 和 Search Ads 360，系統不會簡化項目。在這種情況下，請使用不同的 Floodlight 活動。

建議使用 Data Manager API，提升開發人員體驗並存取其他功能。

序數值會控制重複轉換的處理方式。如果插入的多筆轉換具有相同的 Floodlight 活動、Floodlight 設定 ID、使用者 ID 和轉換時間戳記，系統會使用序數來判斷：

• 系統會簡化轉換，只保留一項。如果所有轉換的序數值都相同，就會發生這種情況。
• 系統會個別處理轉換，且所有轉換都會保留。如果所有轉換的序數值都「不同」，就會發生這種情況。

值本身不一定要有意義。一般來說，為所有轉換使用固定值 (例如 1) 即可啟用簡化功能。如果為每次轉換使用隨機或不重複的值，系統就會停用這項功能。

batchinsert 和 batchupdate 會盡可能處理轉換：批次要求可能會傳回 HTTP 200 OK 回應，但批次中的個別轉換失敗。請務必檢查回應中的 hasFailures，並檢查每個 ConversionStatus 物件上的 errors[] 清單：

• INTERNAL (重試)：Google 系統在處理轉換時發生暫時性錯誤。系統未插入或更新轉換。使用指數輪詢重試失敗的轉換 (例如，在幾分鐘後開始，並在幾小時內重試)，並保留完全相同的 ordinal、timestampMicros、floodlightActivityId 和使用者或點擊 ID。
• NOT_FOUND (延遲重試)：找不到 ID (gclid、dclid、matchId 或 mobileDeviceId) 或要編輯的現有轉換。線上點擊、Floodlight 代碼和轉換可能需要 1 到 2 小時才能處理及建立索引，因此請定期重試 NOT_FOUND 轉換 (例如每 1 到 3 小時重試一次，最多 6 小時)。如果 NOT_FOUND 在 6 小時後仍未解決，請參閱下列各節，瞭解不同 ID 類型的常見原因。
• INVALID_ARGUMENT 和 PERMISSION_DENIED (不重試)：轉換資料無效 (例如轉換時間戳記超過 28 天或欄位格式不正確)，或您的使用者個人資料不具備目標 Floodlight 設定的權限。請勿在未修正根本問題的情況下，重試這些轉換。

如果整個 HTTP 要求失敗，並傳回 5xx 伺服器錯誤或 429 配額/頻率限制錯誤，請使用指數輪詢重試要求。

安全重試和簡化：重試因 INTERNAL 或 NOT_FOUND 失敗的轉換 (或在 HTTP 5xx 逾時後，結果未知)，請務必傳送完全相同的 ordinal 和 timestampMicros。如果轉換已記錄，Campaign Manager 360 會根據 ordinal、使用者 ID、Floodlight 活動和轉換日期，自動簡化轉換。

這項錯誤最常見的原因如下：

• mobileDeviceId 無效。
• Search Ads 360 無法辨識 mobileDeviceId。這表示 Campaign Manager 360 尚未向該裝置放送廣告。

這項錯誤最常見的原因如下：

• gclid 無效。
• gclid 未與 Search Ads 360 廣告活動或 Display & Video 360 YouTube 委刊項建立關聯。如果 gclid 是從未經過 Search Ads 360 的 Google Ads 點擊重新導向 (例如點擊地點額外資訊) 收集而來，或從與 Display & Video 360 YouTube 委刊項無關聯的 YouTube 廣告點擊重新導向收集而來，就可能發生這種情況。
• 與gclid相關的點擊發生時間過於久遠。 只能為 60 天內的點擊插入轉換。
• 與gclid相關的點擊發生時間太近。建議您將以 gclid 為基礎的轉換上傳作業延遲 1 小時，確保 gclid 已處理完畢，可供比對。

這項錯誤最常見的原因如下：

• dclid 無效。
• 與dclid相關的點擊發生時間過於久遠。 只能為 60 天內的點擊插入轉換。
• 與dclid相關的點擊發生時間太近，建議您將以 dclid 為基礎的轉換上傳作業延遲 1 小時，確保 dclid 已處理完畢，可供比對。

這項錯誤最常見的原因如下：

• Campaign Manager 360 無法辨識 matchId。如果 matchId 是從未正確通過 Campaign Manager 360 的 Floodlight 呼叫收集而來，就可能發生這種情況 (請確認 Floodlight 呼叫正常運作，包括 matchId 代碼參數)。
• 與 matchId 相關聯的 Floodlight 呼叫不含 Cookie。Floodlight 呼叫必須包含 Cookie / ID，Campaign Manager 360 才能正確儲存 matchId (例如使用者可能已封鎖 Cookie 或選擇不採用)。
• 與 matchId 相關聯的 Floodlight 呼叫發生時間過早。離線轉換上傳作業必須在包含 matchId 的 Floodlight 呼叫後 60 天內完成。
• 與 matchId 相關聯的 Floodlight 呼叫發生時間太近。 建議您將以 matchId 為基礎的轉換上傳作業延遲 2 小時，確保 matchId 已處理完畢，可供比對。

如果上傳的離線轉換時間戳記早於 Floodlight 活動建立時間，系統可能會將其回報為 Floodlight 曝光，以及未歸因/已歸因轉換，最久可回溯至提交時間的 28 天前。不過，這項行為不一定會發生，因此不應依賴。最佳做法是在離線轉換的最早時間戳記之前，建立 Floodlight 活動。

除了廣告使用者資料同意聲明外，nonPersonalizedAd 欄位也必須明確設為 false，才能建立目標對象名單。