使用 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相同。 - 與原始事件相同的到達網頁和轉換動作。
- 要調整的欄位更新值。
您不需要指定調整類型。Data Manager API 會根據 transactionId 和您提供的欄位,推斷如何處理要求。
如要進一步瞭解如何傳送擷取要求,請參閱「傳送事件」。
支援的欄位
下表列出可調整的欄位,以及更新的套用方式:
| 欄位 | 行為 |
|---|---|
conversionValue、currency |
已覆寫。新值會取代記錄的值。 |
userData |
如果原始事件沒有使用者資料,則為「已補充」,否則為「已忽略」。 |
其他所有欄位,例如 adIdentifiers.gclid |
已忽略 |
轉換價值
傳送新的 conversionValue 和 currency,重新計算已記錄轉換的價值。新值會覆寫報表和出價中先前記錄的值,但不會增加轉換次數。
使用者資料
Google Ads 處理 userData (例如電子郵件地址或電話號碼) 的方式如下:
如果缺少資料,系統會補充:如果擷取原始事件時沒有使用者資料,調整項會附加使用者資料,以提升歸因效果。
如果存在則忽略:如果 Google 代碼或先前的上傳作業已擷取使用者資料,系統會忽略新的使用者資料。現有使用者資料不會遭到覆寫或附加。
其他欄位
除了轉換價值、幣別和使用者資料以外的 ID 和中繼資料 (例如 adIdentifiers.gclid),都無法更新相符事件。Google Ads 會忽略這些欄位,並保留原始事件記錄的值。
不相符的事件
如果 transactionId 與現有事件不符,系統會將要求視為新的轉換上傳,而非調整項。
Google Ads 會嘗試使用您提供的 ID (例如 adIdentifiers.gclid 或 userData),將這項新轉換歸因給廣告點擊。