专用表
Partner
个表
字段名称 | 类型 | 说明 |
---|---|---|
common_data | EntityCommonData | 包含与此合作伙伴相关的常用数据,例如名称和 ID。 |
currency_code | string | 符合 ISO 4217 标准、由 3 个字母组成的货币代码,例如 USD 表示美元。 |
exchange_settings | [ExchangeSettings] | ExchangeSettings 类型的数组,包含其座位 ID 等信息。系统只会显示已启用的广告交易平台。 |
default_partner_costs | PartnerCosts | 包含此合作伙伴的默认费用相关信息。 |
default_partner_revenue_model | PartnerRevenueModel | 包含此合作伙伴的默认收入模式的相关信息。 |
default_target_list | TargetList | 包含合作伙伴的默认定位选项。目前,此处仅支持默认地理位置定位。 |
Advertiser
个表
字段名称 | 类型 | 说明 |
---|---|---|
common_data | EntityCommonData | 包含与此广告客户相关的常用数据,例如名称和 ID。 |
partner_id | Numeric Id | 父级合作伙伴对象的 ID。可与 Partner.common_data.id 联接。 |
currency_code | string | 符合 ISO 4217 标准、由 3 个字母组成的货币代码,例如 USD 表示美元。 |
timezone_code | string | 规范的时区代码,例如“America/Los_Angeles”。如果 dfa_configuration 设置为 NORMAL 或 HYBRID ,此值将与关联的 DFA 广告客户的时区相同。 |
landing_page_url | string | 默认着陆页网址。 |
available_channel_ids | [integer] | 一个整数数组,包含与此广告客户关联的可用渠道。可与 UniversalChannel.id 联接。 |
blacklist_channel_id | [integer] | 包含此广告客户的黑名单渠道的整数数组。可与 UniversalChannel.id 联接。 |
dcm_configuration | Enum | 0=NONE |
dcm_network_id | Numeric Id | CM360 广告网络的 ID。如果 dcm_configuration 设置为 NONE ,则此值将缺失。 |
dcm_advertiser_id | Numeric Id | CM360 广告客户的 ID。如果 dcm_configuration 设置为 NONE ,则此值将缺失。 |
dcm_floodlight_group_id | Numeric Id | 如果 dcm_configuration 设置为 NONE ,则此值将缺失。 |
dcm_syncable_site_ids | [Numeric Id] | 此广告客户的每个可同步网站的 Numeric Id 类型数组。 |
enable_oba_tags | boolean | 将此值设置为 true 时,系统会启用 OBA 代码。 |
Campaign
个表
字段名称 | 类型 | 说明 |
---|---|---|
common_data | EntityCommonData | 包含与此广告系列相关的常用数据,例如名称和 ID。 |
advertiser_id | Numeric Id | 父级广告客户对象的 ID。可与 Advertiser.common_data.id 联接 |
budget | Budget | 此广告系列的计划预算。包含开始时间和结束时间。 |
frequency_cap | FrequencyCap | 此广告系列的有效频次上限。如果未设置频次上限,则此值将缺失。 |
default_target_list | TargetList | 包含有关此广告系列当前有效定位条件的信息。 |
uses_video_creatives | boolean | 如果设置为 true,系统会推荐视频广告订单。 |
uses_display_creatives | boolean | 如果设为 true,系统会推荐展示广告订单。 |
uses_audio_creatives | boolean | 如果设为 true,系统将推荐音频广告订单。 |
objective | Enum |
值为:1 = BRAND_AWARENESS 2 = ONLINE_ACTION 3 = OFFLINE_ACTION 4 = APP_INSTALL |
metric | Enum |
关键绩效指标。您可以使用此字段跟踪将用来评估广告系列成效的主要指标。
可能的值包括:1 = IMPRESSIONS 2 = VIEWABLE_IMPRESSIONS 3 = CPM 4 = CPV 5 = UNIQUES 6 = GRP 7 = TRP 8 = VCR 9 = CPA 10 = ROAS 11 = CTR 12 = CPC 13 = CVR 14 = CPI 15 = VIEWABLE_PERCENT 16 = CPIAVC 17 = OTHER |
objective_description | String | 当指标为 OTHER 时,这是指标的简短说明。 |
metric_amount_micros | integer | 指标的目标金额(以微单位表示)。 |
InsertionOrder
个表
字段名称 | 类型 | 说明 |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | 父级广告客户对象的 ID。可通过 Advertiser.common_data.id 加入。 |
campaign_id | Numeric Id | 父级广告系列对象的 ID。 |
overall_budget | Budget | 此广告订单的总预算。包括开始时间和结束时间。 |
scheduled_segments | [Budget] | 包含所有已安排的预算期。此数组可能为空或完全不存在。 |
frequency_cap | FrequencyCap | 此广告订单有效的频次上限。如果未设置频次上限,则此值将缺失。 |
default_partner_costs | PartnerCosts | |
default_target_list | TargetList |
LineItem
个表
字段名称 | 类型 | 说明 |
---|---|---|
common_data |
EntityCommonData |
|
line_item_type | Enum |
0=RTB |
insertion_order_id |
Numeric Id |
父级广告订单对象的 ID。可与 InsertionOrder.common_data.id 联接。 |
creative_ids | [Numeric Id] | 分配给此订单项的广告素材的数组。可与 Creative.common_data.id 联接。 |
max_cpm_advertiser_micros | integer | 广告客户币种的每千次展示费用最高值(百万分之一单位)。 |
performance_goal | Enum | 0=NONE (每千次可见展示费用已停用)1=CPC |
goal_advertiser_micros | integer | 以广告客户币种微单位表示的每千次可见展示费用目标值。如果 performance_goal 设置为 NONE ,则此值将缺失。 |
partner_revenue_model | PartnerRevenueModel | 用于此订单项的合作伙伴收入模式。 |
cost_tracking_pixels | [CostTrackingPixel] | 分配用于跟踪此订单项的 CostTrackingPixel 的数组。 |
Budget | Budget | 此订单项的总预算。包括开始时间和结束时间。 |
frequency_cap | FrequencyCap | 此订单项的有效频次上限。如果未设置频次上限,则此值将缺失。 |
partner_costs | PartnerCosts | |
target_list | TargetList | 包含有关此订单项有效定位条件的信息。 |
Creative
个表
字段名称 | 类型 | 说明 |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | 父级广告客户对象的 ID。可与 Advertiser.common_data.id 联接。 |
dcm_placement_id | Numeric Id | 与此广告素材相关联的 CM360 展示位置 ID。 |
width_pixels | integer | 广告素材的宽度(以像素为单位)。 |
height_pixels | integer | 广告素材的高度(以像素为单位)。 |
approval_status | [ApprovalStatus] | 一个包含 ApprovalStatus 对象的数组,表示批准广告素材的广告交易平台中的广告素材的状态。 |
expanding_direction | Enum | 0=Not Expandable |
creative_type | Enum |
0=Image or HTML5 |
Pixel
个表
字段名称 | 类型 | 说明 |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | 父级广告客户对象的 ID。可与 Advertiser.common_data.id 联接。 |
partner_id | Numeric Id | 父级合作伙伴对象的 ID。可与 Partner.common_data.id 联接。 |
dcm_floodlight_id | Numeric Id | 与此像素相关联的 DFA Floodlight ID。 |
allow_google_redirect | boolean | |
allow_rm_redirect | boolean | 设置为 true 后,该像素将启用,以便从 Right Media 重定向到/从 Right Media。 |
remarketing_enabled | boolean | 设置为 true 后,此像素将处于启用状态,可用于定位。只有当父级广告客户的 dfa_configuration 设置为 NONE 时,此值才会出现。 |
is_secure | boolean | 设置为 true 时,此像素将使用 HTTPS。只有当父级广告客户的 dfa_configuration 设置为 NONE 时,此值才会出现。 |
Floodlight Activity
个表
字段名称 | 类型 | 说明 |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | 父级广告客户对象的 ID。可与 Advertiser.common_data.id 联接。 |
partner_id | Numeric Id | 父级广告客户的总管理合作伙伴对象的 ID。可通过 Partner.common_data.id 加入。 |
remarketing_enabled | boolean | 如果设为 true ,系统将启用此活动以用于定位。 |
ssl_required | boolean | 设置为 true 时,代码必须符合相关要求。 |
InventorySource
个表
字段名称 | 类型 | 说明 |
---|---|---|
id | Numeric Id | 广告资源来源的唯一键。 |
unclassified | boolean | 如果设置为 true ,则会包含所有未分类的广告资源。 |
inventory_name | string | 界面中显示的广告资源来源的名称。此字段可能不存在。如果 inventory_name 不存在且 unclassified 为 true,则表示广告交易平台的未分类广告资源。如果此字段不存在且 unclassified 为 false,则广告资源来源为广告交易平台级广告资源。 |
exchange_id | Numeric Id | 提供此广告资源来源的广告交易平台的 ID。可通过 SupportedExchange.id 加入。 |
accessing_advertisers | [Numeric Id] | 广告客户 ID 的数组,可与 Advertiser.common_data.id 联接,并且有权使用此广告资源来源。注意:如果某个广告资源来源面向所有广告客户开放,则不会显示此字段。 |
external_id | string | 分配给此广告资源来源并由广告交易平台定义的外部 ID,通常称为交易 ID 或卖方 ID。此字段可能不存在。 |
min_cpm_micros | integer | 此广告资源来源的有效底价(以货币微分表示)。 |
min_cpm_currency_code | string | 用于 min_cpm_micros 的 3 个字母 ISO 4217 货币代码。 |
UserList
个表
字段名称 | 类型 | 说明 |
---|---|---|
id | Numeric Id | 用户列表的唯一键。 |
name | string | 界面中显示的用户列表的名称。 |
data_partner_id | Numeric Id | 可与 DataPartner.id 联接。此字段仅针对第三方用户名单进行设置。 |
accessing_advertisers | [Numeric Id] | 广告客户 ID 数组,可与 Advertiser.common_data.id 联接,并且有权使用此用户名单。注意:如果用户名单可供所有广告客户使用,则不会显示此字段。 |
partner_pricing | UserListPricing | 费用类型始终为每千次展示费用 (CPM),币种代码始终为美元。 |
advertiser_pricings | [UserListAdvertiserPricing] | 费用类型始终为每千次展示费用 (CPM),币种代码始终为美元。 |
CustomAffinity
个表
字段名称 | 类型 | 说明 |
---|---|---|
id |
Numeric Id |
自定义亲和度的唯一键。 |
name |
string |
自定义亲和度的名称(如界面中所示)。 |
description |
string |
自定义亲和度的说明,如界面中所示。 |
advertiser_id |
Numeric Id |
父级广告客户对象的 ID。可与 Advertiser.common_data.id 联接。 |
UniversalChannel
个表
字段名称 | 类型 | 说明 |
---|---|---|
id | Numeric Id | 渠道的唯一键。 |
name | string | 界面中显示的频道名称。 |
site_ids |
[Numeric Id] |
包含此渠道中 UniversalSite 的 ID 的数组。可与 UniversalSite.id 联接。 |
accessing_advertisers | [Numeric Id] | 广告客户 ID 的数组,可与 Advertiser.common_data.id 联接,并且有权使用此渠道。注意:如果某个渠道面向所有广告客户开放,则不会显示此字段。 |
is_deleted | boolean | 设置为 true 后,任何新订单项都无法定位到此渠道,但已定位到此渠道的现有订单项将继续保持原设置。 |
is_brand_safe_channel | boolean | 将此渠道设置为 true 后,即可用于品牌保障过滤。目前,只有 4 个内置品牌保障层级的 true 为 1。 |
NegativeKeywordList
个表
字段名称 | 类型 | 说明 |
---|---|---|
id |
Numeric Id |
否定关键字列表的唯一键。 |
name |
string |
界面中显示的否定关键字列表名称。 |
advertiser_id |
Numeric Id |
父级广告客户对象的 ID。可通过 Advertiser.common_data.id 加入。 |
公共表
SupportedExchange
个表
字段名称 | 类型 | 说明 |
---|---|---|
id | Numeric Id | 广告交易平台的唯一键。 |
name | string | 广告交易平台的名称,例如 Ad Exchange 。 |
DataPartner
个表
字段名称 | 类型 | 说明 |
---|---|---|
id | Numeric Id | 第三方数据提供商的唯一键。 |
name | string | 第三方数据提供商的名称,例如 BlueKai 。 |
UniversalSite
个表
字段名称 | 类型 | 说明 |
---|---|---|
id | Numeric Id | 通用网站的唯一键。 |
name | string | 网站网址或名称,例如 google.com 或 Google Unclassified 。 |
SiteIdToPlacementId
个表
字段名称 | 类型 | 说明 |
---|---|---|
siteId |
Numeric Id |
从通用网站 ID 映射到网站展示位置 ID。 |
placementId |
Numeric Id |
网站展示位置网址或名称,例如 google.com 或 Google Unclassified 。 |
GeoLocation
个表
字段名称 | 类型 | 说明 |
---|---|---|
id | Numeric Id | 地理位置的唯一键。 |
canonical_name | string | 相应位置及其父级位置的逗号连接字符串。示例:“美国华盛顿州西雅图”。 |
geo_name | string | 营业地点的名称。示例:“Seattle”。 |
country_code | string | 此地理位置的 ISO-3166 alpha-2 国家/地区代码,例如 US 。 |
region_code | string | 此地理位置的 ISO-3166-2 子区域代码,例如 US-WA 。此字段可能缺失。 |
city_name | string | 此地理位置对应的城市名称,例如 Seattle 。此字段可能缺失。 |
postal_code | string | 此地理位置的邮政编码,例如 98033 。此字段可能缺失。 |
dma_code | integer | 此地理位置的特定媒体市场区域代码,例如 510 。此字段可能缺失。 |
Language
个表
字段名称 | 类型 | 说明 |
---|---|---|
id | Numeric Id | 此语言的唯一键。 |
code | string | 此语言的 ISO-639-1 代码;zh_CN 表示简体中文,zh_TW 表示中文(繁体),other 表示其他语言。 |
DeviceCriteria
个表
字段名称 | 类型 | 说明 |
---|---|---|
id | Numeric Id | 此设备条件的唯一键。 |
is_mobile | boolean | 如果为 true,则此条件仅涵盖移动设备。如果为 false,此条目仅涵盖非移动设备,即使其名称(例如“其他”)并不表示如此。 |
name | string | 设备条件的熟悉名称。 |
criteria_type | Enum | 0=OPERATING_SYSTEM |
operating_system_id | Numeric Id | 标识操作系统。仅当 criteria_type 为 0 时,系统才会填充此字段。 |
mobile_brand_name | string | 设备的品牌名称。仅当 criteria_type 为 1 时,系统才会填充此字段。 |
mobile_model_name | string | 设备的型号名称。仅当 criteria_type 为 1 时,系统才会填充此字段。可选。 |
mobile_make_model_id | Numeric Id | 标识设备的型号。仅当 criteria_type 为 1 时,系统才会填充此字段。可选。 |
device_type | Enum | 指示设备类型。仅当 criteria_type 为 2 时,系统才会填充此字段。
|
Browser
个表
字段名称 | 类型 | 说明 |
---|---|---|
id | Numeric Id | 此浏览器的唯一键。 |
is_mobile | boolean | 如果为 true,则此条件仅涵盖移动设备。如果为 false,则此条目仅涵盖非移动设备,即使其名称(如“其他”)并不表示如此。 |
name | string | 浏览器的常用名称,例如 Safari 5 。不包含完整的用户代理字符串。 |
Isp
个表
字段名称 | 类型 | 说明 |
---|---|---|
id | Numeric Id | 此互联网服务提供商的唯一键。 |
is_mobile | boolean | 如果为 true,则此条件仅涵盖移动设备。如果为 false,则此条目仅涵盖非移动设备,即使其名称(如“其他”)并不表示如此。 |
name | string | 此互联网服务提供商的名称。 |
secondary_criteria_id | integer |
可选的备用 ID,可用于标识实体。 |
AppCollection
个表
字段名称 | 类型 | 说明 |
---|---|---|
id | Numeric Id | 此应用集合的唯一键。 |
name | string | 此应用集合的名称。 |