Campaign Manager 360 API v3.3 已被弃用,并将于 2021 年 6 月 30 日停用。所有用户都必须在该截止日期之前迁移到新版 API。

TargetingTemplates

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

资源表示形式

包含某个定位模板的属性。定位模板涵盖可在多个广告中重复使用的定位信息。

{
  "kind": "dfareporting#targetingTemplate",
  "id": long,
  "accountId": long,
  "subaccountId": long,
  "advertiserId": long,
  "advertiserIdDimensionValue": dimensionValues Resource,
  "name": string,
  "geoTargeting": {
    "excludeCountries": boolean,
    "countries": [
      countries Resource
    ],
    "regions": [
      regions Resource
    ],
    "cities": [
      cities Resource
    ],
    "metros": [
      metros Resource
    ],
    "postalCodes": [
      postalCodes Resource
    ]
  },
  "technologyTargeting": {
    "operatingSystems": [
      operatingSystems Resource
    ],
    "browsers": [
      browsers Resource
    ],
    "platformTypes": [
      platformTypes Resource
    ],
    "mobileCarriers": [
      mobileCarriers Resource
    ],
    "connectionTypes": [
      connectionTypes Resource
    ],
    "operatingSystemVersions": [
      operatingSystemVersions Resource
    ]
  },
  "dayPartTargeting": {
    "userLocalTime": boolean,
    "daysOfWeek": [
      string
    ],
    "hoursOfDay": [
      integer
    ]
  },
  "keyValueTargetingExpression": {
    "expression": string
  },
  "languageTargeting": {
    "languages": [
      languages Resource
    ]
  },
  "listTargetingExpression": {
    "expression": string
  }
}
属性名称 说明 备注
accountId long 此定位模板的帐号 ID。如果未设置,系统会在插入时自动生成该字段;在插入后,该字段是只读字段。
advertiserId long 此定位模板的广告客户 ID。在插入时,该字段是必填字段;在插入后,会变成只读字段。
advertiserIdDimensionValue nested object 广告客户的 ID 的维度值。该字段是自动生成的只读字段。
dayPartTargeting nested object 时间和日期定位条件。
dayPartTargeting.daysOfWeek[] list 广告将在一周中的哪几天投放。

可接受的值包括:
  • SUNDAY
  • MONDAY
  • TUESDAY
  • WEDNESDAY
  • THURSDAY
  • FRIDAY
  • SATURDAY
dayPartTargeting.hoursOfDay[] list 广告将在一天中的哪些时段投放,其中 0 表示午夜零点至凌晨 1 点,23 表示晚上 11 点至午夜零点。该字段可搭配星期几一同指定。在这种情况下,广告会在指定日期的这些时段投放。例如,如果在一周中指定了星期一、星期三、星期五这几天,同时指定了上午 9 点至 10 点和下午 3 点至 5 点(即时段 91516),广告就会在星期一、星期三和星期五的上午 9 点至 10 点和下午 3 点至 5 点投放。可接受的值介于 0(含)到 23(含)之间。
dayPartTargeting.userLocalTime boolean 是否使用用户的当地时间。如果此字段设为 false,则适用美国/纽约时区。
geoTargeting nested object 地理位置定位条件。
geoTargeting.cities[] list 要定位到的城市。对于各个城市,只有 dartId 是必填字段。其他字段会在广告插入或更新时自动填充。如果定位的是某个城市,请不要定位或排除该城市所在的国家/地区,也不要定位该城市所在的都市圈或区域。
geoTargeting.countries[] list 要在定位条件中定位或排除的国家/地区,具体取决于 excludeCountries 字段的设置。对于各个国家/地区,只有 dartId 是必填字段。其他字段会在广告插入或更新时自动填充。如果定位或排除的是某个国家/地区,请不要定位该国家/地区内的区域、城市、都市圈或邮政编码。
geoTargeting.excludeCountries boolean 是否从定位条件中排除 countries 字段中的国家/地区。如果此字段设为 false,countries 字段则会引用广告将要定位的国家/地区。
geoTargeting.metros[] list 要定位到的都市圈。对于各个都市圈,只有 dmaId 是必填字段。其他字段会在广告插入或更新时自动填充。如果定位的是某个都市圈,请不要定位或排除该都市圈所在的国家/地区。
geoTargeting.postalCodes[] list 要定位到的邮政编码。对于各个邮政编码,只有 id 是必填字段。其他字段会在广告插入或更新时自动填充。如果定位的是某个邮政编码,请不要定位或排除该邮政编码所属的国家/地区。
geoTargeting.regions[] list 要定位到的区域。对于各个区域,只有 dartId 是必填字段。其他字段会在广告插入或更新时自动填充。如果定位的是某个区域,请不要定位或排除该区域所在的国家/地区。
id long 此定位模板的 ID。该字段是自动生成的只读字段。
keyValueTargetingExpression nested object 键值对定位条件。
keyValueTargetingExpression.expression string 广告当前定位到的关键字表达式。
kind string 标识所属资源种类。值:固定字符串 "dfareporting#targetingTemplate"
languageTargeting nested object 语言定位条件。
languageTargeting.languages[] list 此广告定位到的语言。对于各种语言,只有 languageId 是必填字段。其他字段会在广告插入或更新时自动填充。
listTargetingExpression nested object 再营销列表定位条件。
listTargetingExpression.expression string 说明广告当前定位到的列表的表达式。
name string 此定位模板的名称。该字段为必填字段。该值的长度必须少于 256 个字符,且在同一个广告客户中是唯一的。
subaccountId long 此定位模板的子帐号 ID。如果未设置,系统会在插入时自动生成该字段;在插入后,该字段是只读字段。
technologyTargeting nested object 技术平台定位条件。
technologyTargeting.browsers[] list 此广告定位到的浏览器。对于各个浏览器,请设置 browserVersionIddartId 以及版本号。如果这两者都被指定了,系统只会使用 browserVersionId。其他字段会在广告插入或更新时自动填充。
technologyTargeting.connectionTypes[] list 此广告定位到的连接类型。对于各个连接类型,只有 id 是必填字段。其他字段会在广告插入或更新时自动填充。
technologyTargeting.mobileCarriers[] list 此广告定位到的移动运营商。对于各个移动运营商,只有 id 是必填字段。其他字段会在广告插入或更新时自动填充。如果已定位到移动运营商,请不要同时定位到邮政编码。
technologyTargeting.operatingSystemVersions[] list 此广告定位到的操作系统版本。如需定位到所有版本,请使用 operatingSystems。对于各个操作系统版本,只有 id 是必填字段。其他字段会在广告插入或更新时自动填充。如果已定位到操作系统版本,请不要同时在 operatingSystems 中定位到相应的操作系统。
technologyTargeting.operatingSystems[] list 此广告定位到的操作系统。如需定位特定版本,请使用 operatingSystemVersions。对于各个操作系统,只有 dartId 是必填字段。其他字段会在广告插入或更新时自动填充。如果已定位到操作系统,请不要同时使用操作系统版本定位到同一操作系统。
technologyTargeting.platformTypes[] list 此广告定位到的平台类型。例如,桌面设备、移动设备或平板电脑。对于各个平台类型,只有 id 是必填字段。其他字段会在广告插入或更新时自动填充。

方法

get
根据 ID 获取一个定位模板。
insert
插入新的定位模板。
list
检索定位模板列表,该列表可能经过了过滤。此方法支持分页
patch
更新现有定位模板。此方法支持补丁语义。
update
更新现有定位模板。