將轉換上傳方式從 Google Ads API 升級為 Data Manager API,即可使用多項改善功能和特色。
以下比較使用 Data Manager API 和 Google Ads API 管理轉換的差異。
| Data Manager API | Google Ads API | |
|---|---|---|
| 支援傳送離線轉換和待開發客戶強化轉換 | 支援。 | 支援。 |
| 支援將 Google Ads 代碼轉換做為代碼轉換的額外資料來源,提升廣告互動信號、強化資料和整體成效 | 支援。 | 不支援。 |
| 資料模型 | 所有 Google Ads 轉換用途和 Google 廣告產品,都採用統一的資料模型。 | 資料模型僅適用於 Google Ads 用途,且因用途而異。 |
| 加密 | 支援加密。 | 不支援。 |
| 開發人員權杖: | 非必要。 | 必填。 |
| 支援上傳事件的工作階段屬性和 IP 位址 | 所有 API 使用者皆可使用。 | 僅適用於特定 API 使用者。 |
| 轉換調整項 | 統一的 IngestEvents 方法支援這項功能。 |
需要另外安裝 ConversionAdjustmentUploadService。 |
| 配額與限制 | 專案層級配額和單次要求限制。 | 開發人員權杖配額和單次要求限制。 |
| 錯誤模型 | 採用快速失敗模式。 | 使用部分失敗模型。 |
目標帳戶規定的差異
在 Data Manager API 中,目的地的 operating_account 必須是 Google Ads 廣告轉換客戶。這與 Google Ads API 不同。
Google Ads API 支援使用下列任一 customer_id 傳送 Google Ads 帳戶的轉換資料:
Google Ads 轉換客戶。
Data Manager API 支援這種做法。
Google Ads 廣告轉換客戶的任何上層或子系帳戶。
Data Manager API 不支援這種做法。如果您在 Google Ads API 中使用這項行為,請將每個目的地的
operating_account變更為轉換動作的擁有者。這可能與您在 Google Ads API 要求中使用的customer_id不同。
轉換調整
Data Manager API 將初始轉換上傳和後續轉換調整,整合為單一方法。
在 Google Ads API 中:
- 如要調整轉換,必須使用
ConversionAdjustmentUploadService中獨立的UploadConversionAdjustments方法。 - 如果您嘗試使用標準
UploadClickConversions方法,為同一個轉換動作上傳多筆具有相同交易 ID (order_id) 的轉換,要求會失敗。 - 您必須在要求中指定
ConversionAdjustmentType。
在 Data Manager API 中:
- 轉換上傳和調整作業會使用統一的
IngestEvents端點。 - 如果上傳的事件與現有轉換動作具有相同的
transaction_id,但轉換價值或使用者資料已更新,系統會自動將其視為調整項。API 不會傳回交易 ID 重複錯誤。 - 要求中不需指定調整類型。Data Manager API 會根據事件中提供的欄位,推論如何處理調整項。
- 與 Google Ads API 不同,Data Manager API 不支援撤銷轉換,也就是將轉換價值和計數設為
0,完全移除先前記錄的轉換。您可以修正轉換價值,但轉換次數會維持不變。
詳情請參閱「轉換調整項」。