從 Google Ads API 升級

將轉換上傳方式從 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 帳戶的轉換資料:

  1. Google Ads 轉換客戶。

    Data Manager API 支援這種做法。

  2. 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,完全移除先前記錄的轉換。您可以修正轉換價值,但轉換次數會維持不變。

詳情請參閱「轉換調整項」。