轉換調整

使用 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相同。
  • 與原始事件相同的到達網頁和轉換動作。
  • 要調整的欄位更新值。

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

如要進一步瞭解如何傳送擷取要求,請參閱「傳送事件」。

支援的欄位

下表列出可調整的欄位,以及更新的套用方式:

欄位 行為
conversionValuecurrency 已覆寫。新值會取代記錄的值。
userData 如果原始事件沒有使用者資料,則為「已補充」,否則為「已忽略」
其他所有欄位,例如 adIdentifiers.gclid 已忽略

轉換價值

傳送新的 conversionValuecurrency,重新計算已記錄轉換的價值。新值會覆寫報表和出價中先前記錄的值,但不會增加轉換次數。

使用者資料

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

  • 如果缺少資料,系統會補充:如果擷取原始事件時沒有使用者資料,調整項會附加使用者資料,以提升歸因效果。

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

其他欄位

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

不相符的事件

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

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