轉換調整

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

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

支援的轉換類型

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

調整幅度的運作方式

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

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

傳送調整項

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

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

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

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

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

支援的欄位

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

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

轉換價值

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

使用者資料

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

  • 補足遺漏的資料：如果原始事件是在沒有使用者資料的情況下擷取，調整項會附加使用者資料，以提升歸因效果。

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

其他欄位

除了轉換價值、幣別和使用者資料以外的 ID 和中繼資料 (例如 adIdentifiers.gclid)，都無法更新相符事件。Google Ads 會保留原始事件記錄的值。

您仍須加入必要欄位，例如至少一個 ID。Data Manager API 會驗證每個事件的參數。

不相符的事件

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

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