本文將說明如何使用 Management API 管理 Google Analytics (分析) 再行銷目標對象。
簡介
透過 Management API,您可以針對 Google Analytics (分析) 資源create
、get
、delete
、list
、update
和patch
再行銷目標對象。如要進一步瞭解再行銷目標對象的運作方式,請參閱說明中心的「關於 Analytics (分析) 中的再行銷目標對象」一文。
應用情境
再行銷目標對象資源支援 get、刪除、清單、修補和更新,但主要用途為:
名單再行銷目標對象
如要列出資源的所有再行銷目標對象,請按照下列步驟操作:
- 使用 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。linkedAdAccounts[]
屬性目前僅限使用一個linkedForeignAccount
。linkedAdAccounts[].type
可以設為ADWORDS_LINKS
、DBM_LINKS
、MCC_LINKS
或OPTIMIZE
。
- 使用「區隔」集合選項來設定
includeConditions
的segment
資源;如果是建立以狀態為依據的目標對象,請為excludeConditions
進行相同操作。另請參閱區隔參考資料,瞭解如何定義區隔。includeConditions
可選擇含有membershipDurationDays
和daysToLookBack
的值- 您可以選擇將
excludeConditions.exclusionDuration
設為PERMANENT
。
- 執行再行銷目標對象資源的
insert
方法。
您可以透過這個 API 建立兩種目標對象:SIMPLE
和 STATE_BASED
。對於 SIMPLE
目標對象,您只需要使用正數 segment
建構 audienceDefinition
,而不使用 NOT 運算子 (!
字元)。如果想加入排除條件,您必須定義 statebasedDefinition
;詳情請參閱以狀態為依據的目標對象。詳情請參閱參考範例。
更新現有的再行銷目標對象
如要更新資源現有的再行銷目標對象,請按照下列步驟操作:
- 如果您已有再行銷目標對象 ID,則可呼叫
get
;否則,您可以呼叫list
,然後選取要更新的目標對象。 - 更新任何可寫入欄位,並呼叫
update
以傳入更新後的目標對象物件。