Remarketing Audiences

如需本資源的方法清單，請見本頁結尾。

資源表示法

Analytics (分析) 再行銷目標對象的 JSON 範本。

{
  "kind": "analytics#remarketingAudience",
  "id": string,
  "accountId": string,
  "webPropertyId": string,
  "internalWebPropertyId": string,
  "created": datetime,
  "updated": datetime,
  "name": string,
  "description": string,
  "linkedAdAccounts": [
    {
      "kind": "analytics#linkedForeignAccount",
      "id": string,
      "accountId": string,
      "webPropertyId": string,
      "internalWebPropertyId": string,
      "remarketingAudienceId": string,
      "linkedAccountId": string,
      "type": string,
      "status": string,
      "eligibleForSearch": boolean
    }
  ],
  "linkedViews": [
    string
  ],
  "audienceType": string,
  "audienceDefinition": {
    "includeConditions": {
      "kind": "analytics#includeConditions",
      "isSmartList": boolean,
      "segment": string,
      "membershipDurationDays": integer,
      "daysToLookBack": integer
    }
  },
  "stateBasedAudienceDefinition": {
    "includeConditions": {
      "kind": "analytics#includeConditions",
      "isSmartList": boolean,
      "segment": string,
      "membershipDurationDays": integer,
      "daysToLookBack": integer
    },
    "excludeConditions": {
      "segment": string,
      "exclusionDuration": string
    }
  }
}

資源名稱	值	說明	附註
`accountId`	`string`	此再行銷目標對象所屬的帳戶 ID。
`audienceDefinition`	`object`	是簡單的目標對象定義，可將使用者加進目標對象。	可寫入
`audienceDefinition.includeConditions`	`nested object`	定義將使用者納入目標對象的條件。	可寫入
`audienceDefinition.includeConditions.daysToLookBack`	`integer`	回溯期讓您可以指定時間範圍評估將使用者列入目標對象的行為準則。舉例來說，如果您的篩選器包含「來自中亞的使用者」和「交易次數大於 2」，且您將回溯期設為 14 天，系統就會將過去 14 天內累計交易次數超過 2 的所有中亞使用者加入目標對象。	可寫入
`audienceDefinition.includeConditions.isSmartList`	`boolean`	布林值，表示此區隔是否為智慧名單。https://support.google.com/analytics/answer/4628577	可寫入
`audienceDefinition.includeConditions.kind`	`string`	包含條件的資源類型。
`audienceDefinition.includeConditions.membershipDurationDays`	`integer`	使用者保留在目標對像中的天數 (介於 1 至 540 之間)。	可寫入
`audienceDefinition.includeConditions.segment`	`string`	會將使用者加進目標對象的區隔條件。	可寫入
`audienceType`	`string`	目標對象類型：SIMPLE 或 STATE_BASED。可接受的值如下： "`SIMPLE`" "`STATE_BASED`"	可寫入
`created`	`datetime`	這個再行銷目標對象的建立時間。
`description`	`string`	此再行銷目標對象的說明。
`id`	`string`	再行銷目標對象 ID。
`internalWebPropertyId`	`string`	這個再行銷目標對象所屬的網站資源內部 ID。
`kind`	`string`	集合類型。
`linkedAdAccounts[]`	`list`	與這個再行銷目標對象相關聯的已連結廣告帳戶。一個再行銷目標對象目前只能有一個 linkAdAccount。	可寫入
`linkedAdAccounts[].accountId`	`string`	此已連結外國帳戶所屬的帳戶 ID。
`linkedAdAccounts[].eligibleForSearch`	`boolean`	布林值，指出這項資訊是否符合搜尋資格。
`linkedAdAccounts[].id`	`string`	實體廣告帳戶連結 ID。
`linkedAdAccounts[].internalWebPropertyId`	`string`	這個已連結外國帳戶所屬的網站資源內部 ID。
`linkedAdAccounts[].kind`	`string`	已連結外國帳戶的資源類型。
`linkedAdAccounts[].linkedAccountId`	`string`	外國帳戶 ID。舉例來說，Google Ads「linkedAccountId」格式為 XXX-XXX-XXXX。	可寫入
`linkedAdAccounts[].remarketingAudienceId`	`string`	此已連結外國帳戶所屬的再行銷目標對象 ID。
`linkedAdAccounts[].status`	`string`	這個外國帳戶連結的狀態。可接受的值如下： "`CLOSED`" "`OPEN`"
`linkedAdAccounts[].type`	`string`	外國帳戶的類型。例如「ADS_LINKS」、「DBM_LINKS」、「MCC_LINKS」或「OPTIMIZE」。	可寫入
`linkedAdAccounts[].webPropertyId`	`string`	此已連結外國帳戶所屬的網站資源 ID (格式為 UA-XXXXX-YY)。
`linkedViews[]`	`list`	這個再行銷目標對象所連結的資料檢視 (設定檔)。	可寫入
`name`	`string`	此再行銷目標對象的名稱。	可寫入
`stateBasedAudienceDefinition`	`object`	以狀態為依據的目標對象定義，是指在目標對像中新增或移除使用者。	可寫入
`stateBasedAudienceDefinition.excludeConditions`	`object`	定義要從目標對像中排除使用者的條件。	可寫入
`stateBasedAudienceDefinition.excludeConditions.exclusionDuration`	`string`	要排除暫時或永久排除。可接受的值如下： "`PERMANENT`" "`TEMPORARY`"	可寫入
`stateBasedAudienceDefinition.excludeConditions.segment`	`string`	會導致使用者從目標對像中移除的區隔條件。	可寫入
`stateBasedAudienceDefinition.includeConditions`	`nested object`	定義將使用者納入目標對象的條件。	可寫入
`stateBasedAudienceDefinition.includeConditions.daysToLookBack`	`integer`	回溯期讓您可以指定時間範圍評估將使用者列入目標對象的行為準則。舉例來說，如果您的篩選器包含「來自中亞的使用者」和「交易次數大於 2」，且您將回溯期設為 14 天，系統就會將過去 14 天內累計交易次數超過 2 的所有中亞使用者加入目標對象。	可寫入
`stateBasedAudienceDefinition.includeConditions.isSmartList`	`boolean`	布林值，表示此區隔是否為智慧名單。https://support.google.com/analytics/answer/4628577	可寫入
`stateBasedAudienceDefinition.includeConditions.kind`	`string`	包含條件的資源類型。
`stateBasedAudienceDefinition.includeConditions.membershipDurationDays`	`integer`	使用者保留在目標對像中的天數 (介於 1 至 540 之間)。	可寫入
`stateBasedAudienceDefinition.includeConditions.segment`	`string`	會將使用者加進目標對象的區隔條件。	可寫入
`updated`	`datetime`	這個再行銷目標對象的上次修改時間。
`webPropertyId`	`string`	此再行銷目標對象所屬網站資源 ID 格式：UA-XXXXX-YY。

方法

刪除: 刪除再行銷目標對象。
get: 取得使用者有權存取的再行銷目標對象。
插入: 建立新的再行銷目標對象。
list: 列出使用者有權存取的再行銷目標對象。
修補程式: 更新現有的再行銷目標對象。這個方法可支援 patch 語意。
更新: 更新現有的再行銷目標對象。