從 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，完全移除該筆轉換。您可以修正轉換價值，但轉換次數不會變動。

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

下一頁
升級步驟