REST Resource: curators.curatedPackages

资源:CuratedPackage

表示由甄选方创建和管理的精选广告资源包。

JSON 表示法
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
字段
name

string

标识符。精选软件包的唯一资源名称。格式:curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

必需。由管护者分配给管护软件包的显示名称。可用于过滤 curatedPackages.list 方法的响应。

description

string

可选。甄选广告资源包的说明,由甄选方提供。

createTime

string (Timestamp format)

仅限输出。创建精选资源包时的时间戳。可用于过滤 curatedPackages.list 方法的响应。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

updateTime

string (Timestamp format)

仅限输出。上次更新精选资源包时的时间戳。可用于过滤 curatedPackages.list 方法的响应。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

floorPriceCpm

object (Money)

可选。买方必须出价的最低每千次展示费用,才能参与此精选资源包中广告资源的竞价。可用于过滤 curatedPackages.list 方法的响应。

state

enum (State)

仅限输出。精选软件包的状态。可用于过滤 curatedPackages.list 方法的响应。

accessSettings

object (AccessControlSettings)

必需。用于控制对精选软件包的访问权限的设置。

只有列入许可清单的媒体规划人员和创作者才能访问此精选资源包。买方和出价方无法列入此资源的许可名单,也无法直接访问此资源。

targeting

object (PackageTargeting)

可选。精选广告资源包的定位条件。

curationFeeVisibility

enum (CurationFeeVisibility)

可选。不可变。甄选广告资源包费用和基于数据的细分受众群费用(甄选总费用)的可见性。

向此竞价包的甄选方支付的费用。以下是互斥字段的列表。在响应中,最多只能设置以下字段之一:
feeCpm

object (Money)

可选。精选方针对使用此精选包的买方收取的每千次展示费用。可用于过滤 curatedPackages.list 方法的响应。

millipercentOfMediaFee

string (int64 format)

可选。该费用将按展示费用的百分比收取,以千分之一百分比表示。例如,1% 表示为 1000。

互斥字段结束。

州

精选软件包的状态。

枚举
STATE_UNSPECIFIED 默认值。
ACTIVE 精选资源包已启用。
INACTIVE 精选资源包处于无效状态。

AccessControlSettings

用于控制对精选软件包的访问权限的设置。

JSON 表示法
{
  "allowlistedMediaPlanners": [
    string
  ]
}
字段
allowlistedMediaPlanners[]

string

必需。不可变。明确获得精选资源包访问权限的媒体规划人员列表。您可以在 mediaPlanners.list 方法中找到符合条件的媒体策划方案。目前只能将一个媒体规划师列入许可清单。

格式:mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

精选竞价包和竞价包的定位条件。

JSON 表示法
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
字段
includedDeviceTypes[]

enum (DeviceType)

可选。要定位到的设备类型列表。如果留空,则定位到所有设备类型。

includedEnvironment

enum (Environment)

可选。要定位的环境。如果未指定,则定位到所有环境。

includedCreativeFormat

enum (CreativeFormat)

可选。要定位的广告素材格式。如果未设置,则会定位到所有广告素材标记类型。

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

可选。定位到的 AMP 网页类型。如果未设置,系统会定位到广告资源,而不管 AMP 状态如何。

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

可选。包含的定位到的授权卖方状态列表。如果留空,则无论卖家状态如何,都会定位到广告资源。

includedNativeInventoryTypes[]

enum (NativeInventoryType)

可选。定位到的原生广告资源类型。如果留空,系统会定位到广告资源,而不考虑原生广告资源类型。

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

可选。目标开放式衡量类型的列表。如果留空,则无论是否支持开放式衡量,系统都会定位到广告资源。

includedRestrictedCategories[]

enum (RestrictedCategory)

可选。定位到的受限类别列表。如果为空,则无论是否属于受限类别,广告资源都会被定位。

includedRewardedType

enum (RewardedType)

可选。定位到的激励广告类型。如果未设置,系统会定位到广告资源,而不管奖励类型如何。

videoTargeting

object (PackageVideoTargeting)

可选。视频专用定位条件。

minimumPredictedViewabilityPercentage

string (int64 format)

可选。目标最低预计可见度百分比。

此值必须是 10 到 90(含)之间 10 的倍数。例如,10 有效,但 0、15 和 100 无效。值为 10 表示该配置只会匹配我们预测可见度至少为 10% 的广告位。

如果未设置值,则表示无论预测的可见度如何,都会定位到相应广告资源。

languageTargeting

object (StringTargetingDimension)

可选。要定位的语言。如果未设置,系统会定位到广告资源,而不考虑语言。如需查看支持的语言代码列表,请参阅 https://developers.google.com/google-ads/api/data/codes-formats#languages。

includedAdSizes[]

object (AdSize)

可选。要定位的广告尺寸列表。如果未设置,系统会定位到广告资源,而不管广告尺寸如何。

精选包支持 PIXEL 和 INTERSTITIAL 广告尺寸。

publisherTargeting

object (StringTargetingDimension)

可选。目标发布商。如果未设置,系统会定位到广告资源,而不考虑发布商。发布商通过其 ads.txt/app-ads.txt 中的发布商 ID 进行标识。如需了解详情,请参阅 https://iabtechlab.com/ads-txt/ 和 https://iabtechlab.com/app-ads-txt/。

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

可选。目标最低预测点击率,值范围为 [10, 10000] (0.01% - 10%)。值为 50 表示该配置只会匹配我们预测点击率至少为 0.05% 的广告位。

如果未设置值,则表示无论预测点击率如何,都会定位到相应广告资源。

verticalTargeting

object (CriteriaTargeting)

可选。包含或排除的行业,如 https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals 中所定义。如果未设置,系统会定位到所有广告资源,而不考虑垂直领域。

geoTargeting

object (CriteriaTargeting)

可选。要包含或排除的地理位置条件 ID,如 https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv 中所定义。如果未设置,系统将定位到所有地理位置的广告资源。

includedDataSegments[]

string

可选。要定位到的有效数据细分受众群。如果未设置,系统将定位到广告资源,而不考虑数据细分受众群。格式:curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

可选。展示位置定位信息,例如网址、移动应用。

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

可选。要定位到的发布商提供的信号。如果未设置,系统将定位到广告资源,而不管发布商提供的信号如何。

DeviceType

要定位的设备的一般类型。

枚举
DEVICE_TYPE_UNSPECIFIED 默认值。不应在定位规范中使用。
DEVICE_TYPE_PERSONAL_COMPUTER 定位到台式机或笔记本电脑。
DEVICE_TYPE_CONNECTED_TV 定位到联网电视:可在线播放电视内容的设备,包括智能电视、游戏机和流媒体盒/棒。
DEVICE_TYPE_PHONE 定位到高端移动设备。
DEVICE_TYPE_TABLET 定位到平板电脑设备。

环境

要定位的环境。

枚举
ENVIRONMENT_UNSPECIFIED 默认值。不应在定位规范中使用。
ENVIRONMENT_SITE 定位到在含广告的网站中呈现的广告资源。
ENVIRONMENT_APP 定位到移动应用内的广告资源。

CreativeFormat

可定位的广告素材格式。

枚举
CREATIVE_FORMAT_UNSPECIFIED 默认值。不应在定位规范中使用。
CREATIVE_FORMAT_DISPLAY 定位到适用于 HTML 展示广告素材的广告位。
CREATIVE_FORMAT_VIDEO 定位到用于投放视频广告素材的广告位。
CREATIVE_FORMAT_AUDIO 定位到专用于音频广告素材的广告位。

AcceleratedMobilePageType

要定位的 Accelerated Mobile Pages (AMP) 实现类型。

枚举
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED 默认值。不应在定位规范中使用。
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP 定位到未使用任何 AMP 框架的标准网页上的广告资源。
ACCELERATED_MOBILE_PAGE_TYPE_AMP 定位到使用核心 AMP HTML 框架构建的网页上的广告资源。
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY 定位到使用 AMP 故事 (STAMP) 格式的网页上的广告资源,该格式针对视觉叙事(例如可点按的全屏体验)进行了优化。

AuthorizedSellerStatus

表示发布商与卖方之间的关系,如 ads.txt 或 app-ads.txt 文件中所声明。

枚举
AUTHORIZED_SELLER_STATUS_UNSPECIFIED 默认值。不应在定位规范中使用。
AUTHORIZED_SELLER_STATUS_DIRECT 定位到卖家声明为“DIRECT”的广告资源。这表示发布商(内容所有者)会直接控制卖家账号,并表示发布商和广告系统之间就此账号达成了直接业务合同。
AUTHORIZED_SELLER_STATUS_RESELLER 定位到卖方声明为“RESELLER”的广告资源。这表示发布商已授权另一实体来运营所列的卖家账号,并转售其广告空间。

NativeInventoryType

表示广告位支持的广告素材呈现类型,特别是与原生广告相关的类型。

枚举
NATIVE_INVENTORY_TYPE_UNSPECIFIED 默认值。不应在定位规范中使用。
NATIVE_INVENTORY_TYPE_NATIVE_ONLY 定位到仅接受和呈现原生广告的广告位。
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER 定位到接受并呈现原生广告或横幅广告的广告位。

OpenMeasurementType

要定位到的 Open Measurement 接口定义 (OMID) 的类型。

枚举
OPEN_MEASUREMENT_TYPE_UNSPECIFIED 默认值。不应在定位规范中使用。
OPEN_MEASUREMENT_TYPE_OMID_V1 定位到支持 v1 Open Measurement 接口定义 (OMID) 的广告资源。

RestrictedCategory

表示受政策限制而无法定位的特定广告类别。

枚举
RESTRICTED_CATEGORY_UNSPECIFIED 默认值。不应在定位规范中使用。
RESTRICTED_CATEGORY_ALCOHOL 定位到发布商允许投放酒精饮料广告的广告资源。
RESTRICTED_CATEGORY_GAMBLING 定位到发布商允许投放赌博广告的广告资源。

RewardedType

根据广告资源是否会向观看广告的用户提供奖励来定义定位条件。

枚举
REWARDED_TYPE_UNSPECIFIED 默认值。不应在定位规范中使用。
REWARDED_TYPE_NON_REWARDED 定位到不向观看广告或与广告互动的用户提供明确奖励的广告资源。
REWARDED_TYPE_REWARDED 定位到向用户提供奖励以换取其观看广告或与广告互动的广告资源。

PackageVideoTargeting

视频专用定位条件。

JSON 表示法
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
字段
includedMimeTypes[]

enum (VideoMimeType)

可选。使用 IANA 发布的 MIME 类型字符串 (https://www.iana.org/assignments/media-types/media-types.xhtml)) 的定位视频 MIME 类型列表。如果留空,则无论视频 MIME 类型如何,都会定位到广告资源。

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

可选。定位到的视频广告时长上限。如果未设置,则无论视频广告时长上限如何,都会定位到广告资源。

includedPositionTypes[]

enum (PositionType)

可选。定位到的视频广告位置类型。如果为空,则无论视频广告位置类型如何,都会定位到广告资源。

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

可选。定位到的视频投放方式。如果未设置,系统会定位到广告资源,而不管视频投放方式如何。

plcmtTargeting

object (VideoPlcmtTargeting)

可选。定位到的视频展示位置类型。如果未设置,则无论视频广告展示位置类型如何,系统都会定位到广告资源。

includedPlaybackMethods[]

enum (PlaybackMethod)

可选。定位到的视频播放方法列表。如果留空,则无论视频播放方法如何,都会定位到广告资源。

minimumPredictedCompletionRatePercentage

string (int64 format)

可选。目标最低预计完整播放率百分比。

此值必须是 10 到 90(含)之间 10 的倍数。例如,10 有效,但 0、15 和 100 无效。值为 10 表示该配置只会匹配我们预测完整播放率至少为 10% 的广告位。

如果未设置值,则表示无论预测的完整播放率如何,都会定位到相应广告资源。

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

可选。定位到的视频播放器尺寸。如果未设置,系统会定位到广告资源,而不考虑视频播放器尺寸。

VideoMimeType

要定位的视频 MIME 类型。

枚举
VIDEO_MIME_TYPE_UNSPECIFIED 默认值。不应在定位规范中使用。
VIDEO_MIME_TYPE_THREEGPP 3G 手机上使用的 3GPP 容器格式。
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 MPEG-4 容器,通常采用 H.264 编解码器。
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH DASH。
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT JavaScript(用于 VPAID 广告)。
VIDEO_MIME_TYPE_WEBM 采用 VP9 编解码器的 WebM 容器。

MaximumVideoAdDuration

要定位的视频广告素材的时长上限。枚举值定义了存储桶,选择某个值意味着广告素材的时长必须小于或等于指定时间。

枚举
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED 默认值。不应在定位规范中使用。
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS 适用于时长不超过 15 秒(0 < 时长 <= 15 秒)的视频广告。
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS 适用于时长不超过 20 秒(0 < 时长 <= 20 秒)的视频广告。
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS 适用于时长不超过 30 秒(0 < 时长 <= 30 秒)的视频广告。
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS 适用于时长不超过 60 秒(0 < 时长 <= 60 秒)的视频广告。
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS 适用于时长不超过 90 秒(0 < 时长 <= 90 秒)的视频广告。
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS 适用于时长不超过 120 秒(0 < 时长 <= 120 秒)的视频广告。

PositionType

广告在视频中可定位的位置。

枚举
POSITION_TYPE_UNSPECIFIED 默认值。不应在定位规范中使用。
POSITION_TYPE_MIDROLL 广告在视频内容播放期间展示。
POSITION_TYPE_POSTROLL 广告在视频内容播放完毕后播放。
POSITION_TYPE_PREROLL 广告在视频内容播放前展示。

ContentDeliveryMethod

基于视频内容传送方式的定位条件。

枚举
CONTENT_DELIVERY_METHOD_UNSPECIFIED 默认值。不应在定位规范中使用。
CONTENT_DELIVERY_METHOD_STREAMING 定位到正在直播的视频内容。
CONTENT_DELIVERY_METHOD_PROGRESSIVE 定位到根据客户端播放需求增量传输的视频内容。

VideoPlcmtTargeting

根据视频广告展示位置类型定义定位条件,通常对应于 IAB OpenRTB 的“plcmt”字段。

JSON 表示法
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
字段
selectionType

enum (SelectionType)

必需。视频展示位置列表的选择类型。

videoPlcmtTypes[]

enum (VideoPlcmtType)

必需。定位到的视频广告展示位置类型列表。如果留空,系统将定位到广告资源,而不考虑视频广告展示位置类型。

SelectionType

定位维度使用的可能选择类型的枚举。

枚举
SELECTION_TYPE_UNSPECIFIED 未指定选择类型。不应使用。
SELECTION_TYPE_INCLUDE 定位维度中的值包含在内。
SELECTION_TYPE_EXCLUDE 定位维度中的值会被排除。

VideoPlcmtType

表示视频广告展示位置类型,符合 OpenRTB 标准。

枚举
VIDEO_PLCMT_TYPE_UNSPECIFIED 默认值。不应在定位规范中使用。
INSTREAM 在消费者请求的流式视频内容播放前、播放期间或播放后呈现的前贴片广告、中贴片广告和后贴片广告。插播视频广告在播放器启动时必须默认设置为“开启声音”,或者用户必须有明确清晰的用户意图来观看视频内容。虽然播放器周围可能还有其他内容,但视频内容必须是用户访问的重点。它应始终是网页上的主要内容,并且是唯一一个在播放时能够发出声音的可见视频播放器。如果播放器转换为悬浮/粘性播放器,后续广告请求应准确传达更新后的播放器尺寸。
ACCOMPANYING_CONTENT 在流式视频内容播放前、播放期间或播放后呈现的前贴片广告、中贴片广告和后贴片广告。视频播放器会在文本段落或图形内容之前、之间或之后加载和播放,并且仅在进入视口时才开始播放。随播内容应仅在进入视口后开始播放。当用户滚动页面导致视频播放器移出屏幕时,播放器可能会转换为浮动/粘性播放器。
INTERSTITIAL 在没有视频内容的情况下播放的视频广告。在播放期间,它必须是页面的主要焦点,占据大部分视口,并且无法通过滚动移出视图。这可以是在应用内视频或幻灯片等展示位置。
NO_CONTENT 在播放时不会显示流式视频内容的视频广告。这些广告可以投放到幻灯片、原生信息流、内容内或粘性/浮动广告位等位置。

PlaybackMethod

要定位的播放方法。

枚举
PLAYBACK_METHOD_UNSPECIFIED 未指定视频播放方法。不应使用。
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON 当网页/内容加载时,系统会自动开始播放。
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF 当网页/内容加载时,视频会自动开始播放,但处于静音状态。
PLAYBACK_METHOD_CLICK_TO_PLAY 播放由用户操作(例如点击播放按钮)启动。

VideoPlayerSizeTargeting

表示可定位到的视频播放器的尺寸。宽度和高度都必须设置为非零值。

JSON 表示法
{
  "minimumWidth": string,
  "minimumHeight": string
}
字段
minimumWidth

string (int64 format)

必需。视频播放器的最小宽度(以像素为单位)。

minimumHeight

string (int64 format)

必需。视频播放器的最小高度(以像素为单位)。

StringTargetingDimension

使用字符串值进行通用定位。

JSON 表示法
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
字段
selectionType

enum (SelectionType)

必需。此列表中各项内容的定位方式。

values[]

string

必需。指定的值。

AdSize

表示单个广告位或广告素材的尺寸。

JSON 表示法
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
字段
width

string (int64 format)

广告位的宽度(以像素为单位)。仅当尺寸类型为 PIXEL 时,此字段才会显示。

height

string (int64 format)

广告位的高度(以像素为单位)。仅当尺寸类型为 PIXEL 时,此字段才会显示。

type

enum (Type)

广告位尺寸的类型。

类型

表示不同类型的广告位/广告素材尺寸。

枚举
TYPE_UNSPECIFIED 未定义尺寸类型的占位符。
PIXEL 广告位,其尺寸由高度和宽度(以像素为单位)指定。
INTERSTITIAL 用于描述插页式广告位的特殊尺寸。
NATIVE 由发布商呈现的原生(移动)广告。
FLUID 自适应尺寸(自适应大小)可随外部环境的变化而自动调整。

CriteriaTargeting

用于定位维度的通用定位,其中包含已包含和已排除的数字 ID 列表。无法使用列表过滤条件语法过滤此内容。

JSON 表示法
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
字段
targetedCriteriaIds[]

string (int64 format)

要包含的数字 ID 列表。

excludedCriteriaIds[]

string (int64 format)

要排除的数字 ID 列表。

PackagePlacementTargeting

表示关于广告展示位置(例如特定网站或移动应用)的定位条件。不同的展示位置定位类型将采用逻辑“或”关系。

JSON 表示法
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
字段
uriTargeting

object (StringTargetingDimension)

可选。定位或排除的网址列表。网域应去除 http/https(例如 google.com),且每个网址最多可包含 5 个路径。

mobileAppTargeting

object (StringTargetingDimension)

可选。发布商拥有的定位或排除的移动应用 ID 列表。目前仅支持 Android 和 Apple 应用。

Android 应用 ID(例如 com.google.android.apps.maps)可在 Google Play 商店网址中找到。iOS 应用 ID(一个数字)可在 iTunes 商店网址末尾找到。第一方移动应用要么包含,要么排除。

includedMobileAppCategoryTargeting[]

string (int64 format)

可选。定位到的移动应用类别列表。

PackagePublisherProvidedSignalsTargeting

表示与发布商提供的信号相关的定位条件。不同类型的发布商提供的信号将采用逻辑“或”关系。

JSON 表示法
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
字段
audienceTargeting

object (TaxonomyTargeting)

可选。定位或排除的受众群体 ID 列表。基于 IAB 受众群体类目 1.1 版 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)

contentTargeting

object (TaxonomyTargeting)

可选。定位或排除的 Content ID 的列表。基于 IAB 内容分类 2.2 版 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv)

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

可选。定位和排除的视频和音频信号 ID 的列表。这些是发布商提供的信号所支持的其他信号。

TaxonomyTargeting

定义用于处理 IAB 受众群体和内容类目 ID 空间的定位条件。

JSON 表示法
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
字段
targetedTaxonomyIds[]

string

可选。定位到的内容分类 ID 的列表。

excludedTaxonomyIds[]

string

可选。排除的内容分类 ID 的列表。

CurationFeeVisibility

甄选广告资源包费用和基于数据的细分受众群费用(总甄选费用)的可见性。套餐创建者始终可以看到费用。

枚举
CURATION_FEE_VISIBILITY_UNSPECIFIED 未指定总甄选费用的公开范围。
DISCLOSED 所有买方都可以看到总甄选费。如果未设置,则这是默认值。
NON_DISCLOSED 并非所有买方都能看到总甄选费。

方法

activate

激活现有精选包。

create

创建新的精选软件包。

deactivate

停用现有的精选包。

get

获取指定资源名称的精选软件包。

list

列出由指定精选者拥有的精选软件包。

patch

更新现有精选资源包。