再行銷目標對象開發人員指南

本文將說明如何使用 Management API 管理 Google Analytics (分析) 再行銷目標對象。

簡介

透過 Management API，您可以針對 Google Analytics (分析) 資源create、get、delete、list、update 和 patch 再行銷目標對象。如要進一步瞭解再行銷目標對象的運作方式，請參閱「關於 Analytics (分析) 中的再行銷目標對象」說明中心文章。

用途

再行銷目標對象資源支援 get、delete、list、patch 和 更新，但主要用途如下：

• 名單再行銷目標對象。
• 建立新的再行銷目標對象。
• 更新現有的再行銷目標對象。

名單再行銷目標對象

如要列出資源的所有再行銷目標對象，請按照下列步驟進行：

1. 使用 Management API 或 Account Explorer 擷取 accountId 和 webPropertyId。
2. 執行再行銷目標對象資源的 list 方法。

如要進一步瞭解再行銷目標對象資源的 list 方法，請參閱 API 參考資料。

建立新的再行銷目標對象

如要為資源建立新的再行銷目標對象，請按照下列步驟進行：

1. 使用 Management API 或 Account Explorer 擷取 accountId 和 webPropertyId。
2. 使用 Management API 或 Account Explorer 擷取 linkedViews [] 資源的資料檢視 (設定檔) ID。
3. 使用 Google Ads 連結集合擷取 linkedAdAccounts.linkedAccountId 的 Google Ads 帳戶 ID。
   • 「linkedAdAccounts[]」資源目前只限於一個 linkedForeignAccount。
   • linkedAdAccounts[].type 可設為 ADWORDS_LINKS、DBM_LINKS、MCC_LINKS 或 OPTIMIZE。
4. 使用「區隔」集合選項，即可設定 includeConditions 的 segment 資源；建立以狀態為依據的目標對象時，請為 excludeConditions 建立同樣的設定。如要瞭解如何定義區隔，另請參閱區隔參考資料。
   • includeConditions 可視需要提供 membershipDurationDays 和 daysToLookBack 的值
   • excludeConditions.exclusionDuration 可選擇性地設為 PERMANENT。
5. 執行再行銷目標對象資源的 insert 方法。

這個 API 可讓您建立兩種目標對象：SIMPLE 和 STATE_BASED。對於 SIMPLE 目標對象，您只需使用正 segment 建構 audienceDefinition，不使用 NOT 運算子 (! 字元)。如要納入排除條件，您必須定義 statebasedDefinition；詳情請參閱「以狀態為依據的目標對象」一文。詳情請參閱參考範例。

更新現有的再行銷目標對象

若要更新資源現有的再行銷目標對象，請按照下列步驟進行：

1. 如果您已經有再行銷目標對象 ID，可以呼叫 get；或者，您也可以呼叫 list 並選取要更新的目標對象。
2. 更新任何可寫入欄位，並呼叫 update 來傳入更新後的目標對象物件。