本文將說明如何使用 Management API 管理 Google Analytics (分析) 再行銷目標對象。
簡介
透過 Management API,您可以針對 Google Analytics (分析) 資源create
、get
、delete
、list
、update
和 patch
再行銷目標對象。如要進一步瞭解再行銷目標對象的運作方式,請參閱「關於 Analytics (分析) 中的再行銷目標對象」說明中心文章。
用途
再行銷目標對象資源支援 get、delete、list、patch 和 更新,但主要用途如下:
名單再行銷目標對象
如要列出資源的所有再行銷目標對象,請按照下列步驟進行:
- 使用 Management API 或 Account Explorer 擷取
accountId
和webPropertyId
。 - 執行再行銷目標對象資源的
list
方法。
如要進一步瞭解再行銷目標對象資源的 list
方法,請參閱 API 參考資料。
建立新的再行銷目標對象
如要為資源建立新的再行銷目標對象,請按照下列步驟進行:
- 使用 Management API 或 Account Explorer 擷取
accountId
和webPropertyId
。 - 使用 Management API 或 Account Explorer 擷取
linkedViews []
資源的資料檢視 (設定檔) ID。 - 使用 Google Ads 連結集合擷取
linkedAdAccounts.linkedAccountId
的 Google Ads 帳戶 ID。 - 使用「區隔」集合選項,即可設定
includeConditions
的segment
資源;建立以狀態為依據的目標對象時,請為excludeConditions
建立同樣的設定。如要瞭解如何定義區隔,另請參閱區隔參考資料。includeConditions
可視需要提供membershipDurationDays
和daysToLookBack
的值excludeConditions.exclusionDuration
可選擇性地設為PERMANENT
。
- 執行再行銷目標對象資源的
insert
方法。
這個 API 可讓您建立兩種目標對象:SIMPLE
和 STATE_BASED
。對於 SIMPLE
目標對象,您只需使用正 segment
建構 audienceDefinition
,不使用 NOT 運算子 (!
字元)。如要納入排除條件,您必須定義 statebasedDefinition
;詳情請參閱「以狀態為依據的目標對象」一文。詳情請參閱參考範例。
更新現有的再行銷目標對象
若要更新資源現有的再行銷目標對象,請按照下列步驟進行:
- 如果您已經有再行銷目標對象 ID,可以呼叫
get
;或者,您也可以呼叫list
並選取要更新的目標對象。 - 更新任何可寫入欄位,並呼叫
update
來傳入更新後的目標對象物件。