再营销受众群体

有关此类资源的方法列表,请参阅本页面的结尾部分。

资源表示形式

用于 Google 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 与此再营销受众群体相关的关联广告帐号。再营销受众群体目前只可以有一个 linkedAdAccount。 可写入
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 此外部帐号的类型。例如,“ADWORDS_LINKS”、“DBM_LINKS”、“MCC_LINKS”或“OPTIMIZE”。 可写入
linkedAdAccounts[].webPropertyId string 此关联的外部帐号所属的格式为 UA-XXXXX-YY 的网络媒体资源 ID。
linkedViews[] list 此再营销受众群体关联的数据视图(配置文件)。 可写入
name string 此再营销受众群体的名称。 可写入
stateBasedAudienceDefinition object 基于状态的受众群体定义,会将用户添加到受众群体,或将其从中移除。 可写入
stateBasedAudienceDefinition.excludeConditions object 定义从受众群体中排除用户的条件。 可写入
stateBasedAudienceDefinition.excludeConditions.exclusionDuration string 是将排除设置为 TEMPORARY,还是设置为 PERMANENT。

可接受的值为:
  • 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 此再营销受众群体所属的格式为 UA-XXXXX-YY 的网络媒体资源 ID。

方法

delete
删除再营销受众群体。
get
获取该用户具有访问权限的再营销受众群体。
insert
创建新的再营销受众群体。
list
列出该用户具有访问权限的再营销受众群体。
patch
更新现有再营销受众群体。此方法支持修补语义。
update
更新现有再营销受众群体。