轉換調整

使用 IngestEvents 方法，對先前記錄的 Google Ads 廣告轉換進行調整。在 Data Manager API 中，調整項可以重新設定轉換價值或補充使用者資料。

如果您是從 Google Ads API 遷移，請參閱「從 Google Ads API 升級」，比較各 API 處理調整項的方式。

支援的轉換類型

您可以調整下列 Google Ads 轉換類型：

• 多來源轉換：網站 Google 代碼為「WEBSITE」轉換動作記錄的轉換。
• 離線轉換和待開發客戶強化轉換： 先前為UPLOAD_CLICKS轉換動作上傳的離線事件。

注意： 不支援調整商店銷售轉換。

調整項的運作方式

在同一個轉換動作中，Google Ads 會使用下列項目比對事件transactionId：

• 如果 transactionId 與相同轉換動作的現有轉換相符，Data Manager API 會將要求視為轉換調整項。
• 如果 transactionId 與現有轉換不符，Google Ads 會建立新轉換。請參閱「不相符事件」。

傳送調整項

如要調整現有轉換，請傳送 IngestEvents 要求，其中包含：

• 與原始事件相同的 transactionId。
• 目的地和轉換動作與原始事件相同。
• 要調整的欄位更新值。
• 事件的所有必要欄位，包括至少一個 ID，例如 adIdentifiers 或 userData。請參閱離線轉換或多來源轉換的事件和 ID 規定。

重點： Data Manager API 收到要求後，會先驗證每個事件，再尋找相符的 transactionId。調整項必須符合與新事件相同的欄位和 ID 規定。否則要求會失敗，並顯示 NO_IDENTIFIERS_PROVIDED 等錯誤。

建議您傳送與原始事件相同或擷取的 ID。如果 transactionId 與現有轉換不符，Google Ads 會使用這些 ID 歸因新轉換。

您不需要指定調整項類型。Data Manager API 會根據 transactionId 和您提供的欄位，推論如何處理要求。

如要進一步瞭解如何傳送擷取要求，請參閱離線轉換或多來源轉換的事件傳送指南。

支援的欄位

下表列出事件與現有轉換相符時，Google Ads 如何套用各個欄位：

欄位	行為
conversionValue、currency	已覆寫。新值會取代記錄的值。
userData	如果原始事件沒有使用者資料，則為「已補充」，否則為「已忽略」。
所有其他欄位，例如 adIdentifiers.gclid	未更新。Google Ads 會保留原始事件記錄的值。但仍須提供必填欄位。

轉換價值

傳送新的 conversionValue 和 currency，重編已記錄轉換的價值。新值會覆寫報表和出價中先前記錄的值，但不會增加轉換次數。

注意： 在多來源轉換的初始 14 天試用期內，系統會停用價值更新功能。試用期結束前，系統不會在 Google Ads 報表中覆寫代碼價值。

使用者資料

Google Ads 處理userData (例如電子郵件地址或電話號碼) 的方式如下：

• 補足缺漏資料：如果原始事件擷取時沒有使用者資料，調整項會附加使用者資料，改善歸因。

  注意： 建議您在原始事件發生後的 24 小時內上傳補充離線資料，以利發揮最佳成效。

• 若已存在則忽略：如果 Google 代碼或先前上傳的資料已擷取使用者資料，系統會忽略新的使用者資料。現有的使用者資料不會遭到覆寫或附加。

其他欄位

轉換價值、貨幣和使用者資料以外的 ID 和中繼資料 (例如 adIdentifiers.gclid)，無法針對比對成功的事件進行更新。Google Ads 會保留原始事件記錄的值。

不過，您仍須加入任何必要欄位，例如至少一個 ID。Data Manager API 會驗證每個事件。

不相符的事件

如果 transactionId 與現有事件不符，系統會將要求視為新轉換上傳，而非調整項。

Google Ads 會嘗試使用您提供的 ID (例如 adIdentifiers.gclid 或 userData)，將新轉換歸因給廣告點擊。

注意： 在多來源轉換的 14 天試用期內，新建立的轉換會顯示在報表中，但不會用於出價。試用期結束後，這些轉換就會自動用於出價。