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

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

簡介

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

應用情境

再行銷目標對象資源支援 get刪除清單修補更新,但主要用途為:

名單再行銷目標對象

如要列出資源的所有再行銷目標對象,請按照下列步驟操作:

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

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

建立新的再行銷目標對象

如要在資源中建立新的再行銷目標對象,請按照下列步驟進行:

  1. 使用 Management API 或 Account Explorer 擷取 accountIdwebPropertyId
  2. 使用 Management API 或 Account Explorer,擷取 linkedViews [] 資源的資料檢視 (設定檔) ID。
  3. 使用 Google Ads 連結集合,擷取 linkedAdAccounts.linkedAccountId 的 Google Ads 帳戶 ID。
    • linkedAdAccounts[] 屬性目前僅限使用一個 linkedForeignAccount
    • linkedAdAccounts[].type 可以設為 ADWORDS_LINKSDBM_LINKSMCC_LINKSOPTIMIZE
  4. 使用「區隔」集合選項來設定 includeConditionssegment 資源;如果是建立以狀態為依據的目標對象,請為 excludeConditions 進行相同操作。另請參閱區隔參考資料,瞭解如何定義區隔。
  5. 執行再行銷目標對象資源的 insert 方法。

您可以透過這個 API 建立兩種目標對象:SIMPLESTATE_BASED。對於 SIMPLE 目標對象,您只需要使用正數 segment 建構 audienceDefinition,而不使用 NOT 運算子 (! 字元)。如果想加入排除條件,您必須定義 statebasedDefinition;詳情請參閱以狀態為依據的目標對象。詳情請參閱參考範例

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

如要更新資源現有的再行銷目標對象,請按照下列步驟操作:

  1. 如果您已有再行銷目標對象 ID,則可呼叫 get;否則,您可以呼叫 list,然後選取要更新的目標對象。
  2. 更新任何可寫入欄位,並呼叫 update 以傳入更新後的目標對象物件。