实体读取文件格式 - V2

共享类型

这些类型定义了一些表中的嵌套字段;这些字段没有自己的表。

Numeric Id 类型

标量说明
integer用作实体标识符的数字 ID 号。这些 ID 不应被视为具有普遍唯一性,例如,广告系列和像素可能使用相同的 ID 值。

Enum 类型

标量说明
integer一个枚举,包含多个可能的选项。父级类型中详细介绍了不同的选项。

Time 类型

标量说明
integer以微秒(1/1,000,000 秒)为单位的 unix 时间,例如 1330403779608570 表示 2012 年 2 月 28 日星期二 04:36:19.608570。

Currency Micro 类型

标量说明
integer以微单位(货币单位的 1/1,000,000)表示的因货币而异的金额,例如,如果货币为欧元,75000000 表示 75 欧元;如果货币为美元,250000 表示 0.25 美元。系统不会将金额从一种币种换算为另一种币种。

Percentage Milli 类型

标量说明
integer以毫秒(百分之一的 1/1,000)为单位显示的百分比,例如 100 表示 0.1%。

FileSummary 类型

字段名称类型说明
namestring文件的文件名(不包括存储分区或目录名称)。
num_recordsinteger文件中的实体数量。
versioninteger文件的主要版本号。如果将来创建了实体数据格式的新版本,此编号可能会发生变化。

EntityCommonData 类型

字段名称类型说明
idNumeric Id每个实体类型中的唯一 ID - 例如,对于合作伙伴实体,此 ID 为合作伙伴 ID;对于广告客户,此 ID 为广告客户 ID,依此类推。
namestring实体在界面中显示的名称。
activeboolean由用户设置的状态 - 实体可能出于其他原因(例如预算耗尽、广告投放已结束等)而未投放
integration_codestring用户设置的集成代码

ExchangeSettings 类型

字段名称类型说明
exchange_idNumeric Id广告交易平台的 ID。可与 SupportedExchange.id 联接
seat_idstring广告交易平台的账号 ID
seat_user_namestring与此座位相关的用户名(仅适用于 Right Media 非 RTB 座位)。

ApprovalStatus 类型

字段名称类型说明
auditorEnum0=DOUBLECLICK_BID_MANAGER
1=DOUBLECLICK_AD_EXCHANGE
2=APPNEXUS
3=APPNEXUS_MICROSOFT
4=RIGHT_MEDIA_NON_RTB
statusEnum0=APPROVED
1=REJECTED
2=PENDING
3=NO_AUDIT
4=UN_AUDITABLE
5=UNKNOWN
6=IN_AUDIT
feedbackstring审核员的反馈,其中可能包含拒绝原因等其他信息。
sync_timeTime实体上次与 auditor 同步的时间
external_idNumeric Id仅当 auditorAPPNEXUSAPPNEXUS_MICROSOFTRIGHT_MEDIA_NON_RTB 时才填充。这是审核员聊天室中的实体的 ID。

Budget 类型

字段名称类型说明
start_time_usecTime预算周期的开始时间。
end_time_usecTime预算周期的结束时间。
max_impressionsinteger此预算的展示次数上限。如果缺少此字段,则表示展示次数预算不受限。
max_spend_advertiser_microsinteger此预算的支出上限(以广告客户币种的微分表示)。如果缺少此字段,则表示预算支出不受限制。
pacing_typeEnum0=FLIGHT
1=DAILY
pacing_max_impressionsintegerpacing_type 设置的每次节奏间隔的展示次数上限。如果缺少此字段,则展示次数没有限制。
pacing_max_spend_advertiser_microsintegerpacing_type 设置的每个节奏间隔的最高支出(以广告客户币种的百万分之一表示)。如果此字段缺失,则表示没有支出限制。
pacing_distributionEnum0=ASAP
1=EVEN
2=AHEAD

FrequencyCap 类型

字段名称类型说明
max_impressionsinteger每个展示次数上限间隔内的展示次数上限。
time_unitEnum时间单位:
0=MINUTE
1=HOUR
2=DAY
3=WEEK
4=MONTH
5=LIFE_TIME
time_rangeintegertime_units 的数量,例如,如果 time_unit1,则 time_range 的值为 6 表示 6 小时。

PartnerCosts 类型

字段名称类型说明
cpm_fee_1_advertiser_microsintegerCPM 1 费用(以广告客户币种为单位,小数点后 4 位)。
cpm_fee_2_advertiser_microsintegerCPM 2 费用(以广告客户币种为单位)。
cpm_fee_3_advertiser_microsintegerCPM 3 费用(以广告客户币种为单位)。
cpm_fee_4_advertiser_microsintegerCPM 4 费用(以广告客户币种为单位)。
cpm_fee_5_advertiser_microsintegerCPM 5 费用(以广告客户币种为单位)。
media_fee_percent_1_millisintegerPercentage Milli 中的媒体费用 1
media_fee_percent_2_millisintegerPercentage Milli 中的媒体费用 2
media_fee_percent_3_millisintegerPercentage Milli 中的媒体费用 3
media_fee_percent_4_millisintegerPercentage Milli 中的媒体费用 4
media_fee_percent_5_millisintegerPercentage Milli 中的媒体费用 5
cpm_fee_1_cost_typeEnum0=DEFAULT_COST_TYPE
1=BID_MANAGER_FEE
2=THIRDPARTY_AD_SERVER
3=DOUBLE_VERIFY
4=ADSAFE
5=ADXPOSE
6=VIZU
7=AGGREGATE_KNOWLEDGE
8=TERACENT
9=EVIDON
10=ATD_FEE
11=DMP_FEE
12=INTEGRAL_AD_SCIENCE_PREBID
13=DOUBLE_VERIFY_PREBID
14=SHOP_LOCAL
15=TRUST_METRICS
16=MEDIACOST_DATA
17=INTEGRAL_AD_SCIENCE_VIDEO
18=MOAT_VIDEO
19=NIELSON_OCR
20=COMSCORE_VCE
21=ADLOOX
22=ADLOOX_PREBID
23=EXTRA_XBID_FEE
24=ADLINGO_FEE
25=CUSTOM_FEE_1
26=CUSTOM_FEE_2
27=CUSTOM_FEE_3
28=CUSTOM_FEE_4
29=CUSTOM_FEE_5

ATD_FEE 表示代理机构交易公司费用。
cpm_fee_2_cost_typeEnumcpm_fee_1_cost_type 相同。
cpm_fee_3_cost_typeEnumcpm_fee_1_cost_type 相同。
cpm_fee_4_cost_typeEnumcpm_fee_1_cost_type 相同。
cpm_fee_5_cost_typeEnumcpm_fee_1_cost_type 相同。
media_fee_percent_1_cost_typeEnumcpm_fee_1_cost_type 相同。
media_fee_percent_2_cost_typeEnumcpm_fee_1_cost_type 相同。
media_fee_percent_3_cost_typeEnumcpm_fee_1_cost_type 相同。
media_fee_percent_4_cost_typeEnumcpm_fee_1_cost_type 相同。
media_fee_percent_5_cost_typeEnumcpm_fee_1_cost_type 相同。
cpm_fee_1_bill_to_typeEnum0=DEFAULT_BILL_TO_TYPE
1=INVITE_MEDIA
2=PARTNER
cpm_fee_2_bill_to_typeEnumcpm_fee_1_bill_to_type 相同。
cpm_fee_3_bill_to_typeEnumcpm_fee_1_bill_to_type 相同。
cpm_fee_4_bill_to_typeEnumcpm_fee_1_bill_to_type 相同。
cpm_fee_5_bill_to_typeEnumcpm_fee_1_bill_to_type 相同。
media_fee_percent_1_bill_to_typeEnumcpm_fee_1_bill_to_type 相同。
media_fee_percent_2_bill_to_typeEnumcpm_fee_1_bill_to_type 相同。
media_fee_percent_3_bill_to_typeEnumcpm_fee_1_bill_to_type 相同。
media_fee_percent_4_bill_to_typeEnumcpm_fee_1_bill_to_type 相同。
media_fee_percent_5_bill_to_typeEnumcpm_fee_1_bill_to_type 相同。

PartnerRevenueModel 类型

字段名称类型说明
typeEnum0=CPM
1=MEDIA_COST_MARKUP
2=TOTAL_MEDIA_COST_MARKUP
amount_advertiser_microsinteger收入金额(以广告客户当前的微单位表示)。只有当类型为 CPM 时,才会设置此值。
media_cost_markup_percent_millisintegerPercentage Milli 中的收入百分比加价。只有当类型为 MEDIA_COST_MARKUPTOTAL_MEDIA_COST_MARKUP 时,才会设置此值。
post_view_conversion_tracking_fractionfloat在转化跟踪中要统计的浏览后转化次数所占的比例。如果为 0,则只计算点击后转化次数;如果为 1.0,则跟踪所有转化。

CostTrackingPixel 类型

字段名称类型说明
pixel_idNumeric Id跟踪像素的 ID。请注意,两个 CostTrackingPixel 可以共用相同的 pixel_id,但具有不同的查看或点击时间范围值。

此值可以与 Pixel.common_data.id 联接。
view_window_minutesinteger查找观看后转化的时长。
click_window_minutesinteger用于查找点击后转化的分钟数。
floodlight_activity_id数字 IDCM Floodlight 活动 ID。此值可以与 Pixel.dcm_floodlight_id 联接。

Target 类型

字段名称类型说明
criteria_idNumeric Id可与其他表联接,具体取决于 TargetList 中定义的类型。此值可能缺失。
parameterstring其他参数,其定义取决于 TargetList 中定义的类型。可能缺少此值。
excludedboolean如果为 true,则表示排除了目标。缺失值意味着 false

TargetUnion 类型

字段名称类型说明
union[Target]Target 类型的数组,表示目标并集。
excludedbooleantrue 表示排除目标并集。缺失值表示 false

TargetList 类型

字段名称类型说明
inventory_sources [Target]广告资源来源的 Target 类型数组。 Target.criteria_id 可与 InventorySource.id 联接,Target.parameter 未定义。
geo_locations [Target] 地理位置的 Target 类型数组。 Target.criteria_id 可与 GeoLocation.id 联接,Target.parameter 未定义。
ad_position Target 一个 Target,用于指示广告在发布商页面上的位置。Target.criteria_id 的值为
0=ALL_POSITIONS
1=ABOVE_THE_FOLD
2=BELOW_THE_FOLD
3=UNKNOWN_POSITION

Target.parameter 未定义。
net_speed Target 一个表示网络速度的 Target
Target.criteria_id 值包括:
0=ALL_CONNECTION_SPEEDS
1=BROADBAND(2.0mbps 及更快)。
2=DIALUP(56 kbps 及更慢)。
3=UNKNOWN_CONNECTION_SPEED
4=EDGE(增强型 GSM 演进 (2G) 数据。57 kbps 及更快)。
5=UMT(通用移动通讯系统 [3G])。384 kbps 及更快)。
6=DSL(数字用户线。768 kbps 或更快)。
7=HSDPA(高速下行链路分组接入 [3.5G])。1.8 mpbs 及更快)。

Target.parameter 未定义。
browsers TargetUnion TargetUnion 类型(适用于浏览器)。Target.criteria_id 可与 Browser.id 联接,并且 Target.parameter 未定义。
device_criteria [Target]Array of Target 类型作为设备条件。Target.criteria_id 可与 DeviceCriteria.id 联接,并且 Target.parameter 未定义。
languages TargetUnionTargetUnion 类型(语言)。Target.criteria_id 可与 Language.id 联接,并且 Target.parameter 未定义。
day_parting TargetUnionTargetUnion 类型(适用于日分隔)。Target.criteria_id 由 6 位数字组成:(TimeZone)(DayOfWeek)(StartTime)(EndTime)

时区:
0=USER
1=EASTERN
2=PACIFIC
3=LONDON
4=COPENHAGEN
5=SYDNEY
6=AUCKLAND
7=HONG_KONG
8=TOKYO
9=CALCUTTA
10=ADVERTISER


DayOfWeek:
0=MONDAY
1=TUESDAY
2=WEDNESDAY
3=THURSDAY
4=FRIDAY
5=SATURDAY
6=SUNDAY


开始时间:
自午夜起的分钟数,以 15 除以 15。范围为 0 到 95。

EndTime:
自午夜起的分钟数,除以 15。范围为 1 到 96。

例如,值 200380 表示周一 00:45 到 20:00(太平洋时间)。

Target.parameter 未定义。
audience_intersect [TargetUnion]受众群体交集的 TargetUnion 类型数组,例如
[{“union”: [A, B]},
 {“union”: [C, D]},
 {“union”: [E, F],
 “excluded”: true}]
表示“(A OR B) AND (C OR D) AND NOT (E OR F)”。

Target.criteria_id 可与 UserList.id 联接,且 Target.parameter 是以微秒为单位的像素新近度值。 如果此值缺失,则表示定位到所有受众群体。
keywords[Target]关键字的 Target 类型数组。Target.criteria_id 未定义,Target.parameter 是单个关键字。
kct_include_uncrawled_sitesboolean用于指示是否应将未编入索引的网站包含在 KCT 中。
page_categories[Target]适用于 AdExchange 网页行业Target 类型的数组。Target.criteria_id 是垂直列的数字 ID,Target.parameter 未定义。
universal_channels[Target]频道的 Target 类型数组。Target.criteria_id 可与 UniversalChannel.id 联接,并且 Target.parameter 未定义。
sites[Target] 网站的 Target 类型数组。 Target.criteria_id 可与 UniversalSite.id 联接,如果网站不在 UniversalSite 中,则未设置。Target.parameter 是一个类似于 google.com 的网站,但不一定能在 UniversalSite 中找到。
ispsTargetUnionTargetUnion 类型(适用于互联网服务提供商)。Target.criteria_id 可与 ISP.id 联接,并且 Target.parameter 未定义。

SummaryFile 类型

字段名称类型说明
file[FileSummary]包含零个或零个以上 FileSummary 条目的数组。如果此数组为空,则表示当天没有生成任何数据。

UserListAdvertiserPricing 类型

字段名称类型说明
pricingUserListPricing
advertiser_idNumeric Id

UserListPricing 类型

字段名称类型说明
cost_typestring
currency_codestring符合 ISO 4217 标准、由 3 个字母组成的货币代码,例如 USD 表示美元。
cost_microsCurrency Micro

专用表

Partner 个表

字段名称类型说明
common_dataEntityCommonData包含与此合作伙伴相关的常用数据,例如名称和 ID。
currency_codestring符合 ISO 4217 标准、由 3 个字母组成的货币代码,例如 USD 表示美元。
exchange_settings[ExchangeSettings]ExchangeSettings 类型的数组,包含其座位 ID 等信息。系统只会显示已启用的广告交易平台。
default_partner_costsPartnerCosts包含此合作伙伴的默认费用相关信息。
default_partner_revenue_modelPartnerRevenueModel包含此合作伙伴的默认收入模式的相关信息。
default_target_listTargetList包含合作伙伴的默认定位选项。目前,此处仅支持默认地理位置定位。

Advertiser 个表

字段名称类型说明
common_dataEntityCommonData包含与此广告客户相关的常用数据,例如名称和 ID。
partner_idNumeric Id父级合作伙伴对象的 ID。可与 Partner.common_data.id 联接。
currency_codestring符合 ISO 4217 标准、由 3 个字母组成的货币代码,例如 USD 表示美元。
timezone_codestring规范的时区代码,例如“America/Los_Angeles”。如果 dfa_configuration 设置为 NORMALHYBRID,此值将与关联的 DFA 广告客户的时区相同。
landing_page_urlstring默认着陆页网址。
available_channel_ids[integer]一个整数数组,包含与此广告客户关联的可用渠道。可与 UniversalChannel.id 联接。
blacklist_channel_id[integer]包含此广告客户的黑名单渠道的整数数组。可与 UniversalChannel.id 联接。
dcm_configurationEnum0=NONE
1=NORMAL
2=HYBRID
dcm_network_idNumeric IdCM360 广告网络的 ID。如果 dcm_configuration 设置为 NONE,则此值将缺失。
dcm_advertiser_idNumeric IdCM360 广告客户的 ID。如果 dcm_configuration 设置为 NONE,则此值将缺失。
dcm_floodlight_group_idNumeric Id如果 dcm_configuration 设置为 NONE,则此值将缺失。
dcm_syncable_site_ids[Numeric Id]此广告客户的每个可同步网站的 Numeric Id 类型数组。
enable_oba_tagsboolean将此值设置为 true 时,系统会启用 OBA 代码。

Campaign 个表

字段名称类型说明
common_dataEntityCommonData包含与此广告系列相关的常用数据,例如名称和 ID。
advertiser_idNumeric Id父级广告客户对象的 ID。可与 Advertiser.common_data.id 联接
budgetBudget此广告系列的计划预算。包含开始时间和结束时间。
frequency_capFrequencyCap此广告系列的有效频次上限。如果未设置频次上限,则此值将缺失。
default_target_listTargetList包含有关此广告系列当前有效定位条件的信息。
uses_video_creativesboolean如果设置为 true,系统会推荐视频广告订单。
uses_display_creativesboolean如果设为 true,系统会推荐展示广告订单。
uses_audio_creativesboolean如果设为 true,系统将推荐音频广告订单。
objectiveEnum 值为:
1 = BRAND_AWARENESS
2 = ONLINE_ACTION
3 = OFFLINE_ACTION
4 = APP_INSTALL
metricEnum 关键绩效指标。您可以使用此字段跟踪将用来评估广告系列成效的主要指标。 可能的值包括:
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_descriptionString当指标为 OTHER 时,这是指标的简短说明。
metric_amount_microsinteger指标的目标金额(以微单位表示)。

InsertionOrder 个表

字段名称类型说明
common_dataEntityCommonData
advertiser_idNumeric Id父级广告客户对象的 ID。可通过 Advertiser.common_data.id 加入。
campaign_idNumeric Id父级广告系列对象的 ID。
overall_budgetBudget此广告订单的总预算。包括开始时间和结束时间。
scheduled_segments[Budget]包含所有已安排的预算期。此数组可能为空或完全不存在。
frequency_capFrequencyCap此广告订单有效的频次上限。如果未设置频次上限,则此值将缺失。
default_partner_costsPartnerCosts
default_target_listTargetList

LineItem 个表

字段名称类型说明
common_data EntityCommonData
line_item_typeEnum 0=RTB
1=RMX_NON_RTB
2=RTB_EXPANDABLE
3=RTB_MOBILE
4=RTB_VIDEO
5=TRUEVIEW
6=NON_RTB_EXCHANGES
7=RTB_AUDIO
8=GMAIL
9=ADWORDS_UAC
11=OUT_OF_HOME
insertion_order_id Numeric Id 父级广告订单对象的 ID。可与 InsertionOrder.common_data.id 联接。
creative_ids[Numeric Id]分配给此订单项的广告素材的数组。可与 Creative.common_data.id 联接。
max_cpm_advertiser_microsinteger广告客户币种的每千次展示费用最高值(百万分之一单位)。
performance_goalEnum0=NONE(每千次可见展示费用已停用)
1=CPC
2=CPA
3=ROI
4=CPCV
5=CPM
6=AVCPM
7=IMP_VALUE_ROAS
8=CIVA
9=IVO_TEN
10=AV_VIEWED
11=INCREMENTAL_CONVERSIONS
goal_advertiser_microsinteger以广告客户币种微单位表示的每千次可见展示费用目标值。如果 performance_goal 设置为 NONE,则此值将缺失。
partner_revenue_modelPartnerRevenueModel用于此订单项的合作伙伴收入模式。
cost_tracking_pixels[CostTrackingPixel]分配用于跟踪此订单项的 CostTrackingPixel 的数组。
BudgetBudget此订单项的总预算。包括开始时间和结束时间。
frequency_capFrequencyCap此订单项的有效频次上限。如果未设置频次上限,则此值将缺失。
partner_costsPartnerCosts
target_listTargetList包含有关此订单项有效定位条件的信息。

Creative 个表

字段名称类型说明
common_dataEntityCommonData
advertiser_idNumeric Id父级广告客户对象的 ID。可与 Advertiser.common_data.id 联接。
dcm_placement_idNumeric Id与此广告素材相关联的 CM360 展示位置 ID。
width_pixelsinteger广告素材的宽度(以像素为单位)。
height_pixelsinteger广告素材的高度(以像素为单位)。
approval_status[ApprovalStatus]一个包含 ApprovalStatus 对象的数组,表示批准广告素材的广告交易平台中的广告素材的状态。
expanding_directionEnum0=Not Expandable
1=Expanding Up
2=Expanding Down
3=Expanding Left
4=Expanding Right
5=Expanding Up Left
6=Expanding Up Right
7=Expanding Down Left
8=Expanding Down Right
9=Expanding Up or Down
10=Expanding Left or Right
11=Expanding Any Diagonal
creative_typeEnum 0=Image or HTML5
1=Expandable
2=Video
3=Mobile
4=Native Site
5=Facebook Exchange Page Post (News Feed) Ads
6=Templated App Install Mobile Ads (Banner)
10=Native Site Square
12=Templated App Install Mobile Ads (Interstitial/Video Interstitial)
13=Lightbox
14=Native App Install
15=Native App Install Square
16=Audio
17=Publisher Hosted
18=Native Video
22=Flipbook
23=Templated App Install Video
24=TRACKING

Pixel 个表

字段名称类型说明
common_dataEntityCommonData
advertiser_idNumeric Id父级广告客户对象的 ID。可与 Advertiser.common_data.id 联接。
partner_idNumeric Id父级合作伙伴对象的 ID。可与 Partner.common_data.id 联接。
dcm_floodlight_idNumeric Id与此像素相关联的 DFA Floodlight ID。
allow_google_redirectboolean
allow_rm_redirectboolean设置为 true 后,该像素将启用,以便从 Right Media 重定向到/从 Right Media。
remarketing_enabledboolean设置为 true 后,此像素将处于启用状态,可用于定位。只有当父级广告客户的 dfa_configuration 设置为 NONE 时,此值才会出现。
is_secureboolean设置为 true 时,此像素将使用 HTTPS。只有当父级广告客户的 dfa_configuration 设置为 NONE 时,此值才会出现。

Floodlight Activity 个表

字段名称类型说明
common_dataEntityCommonData
advertiser_idNumeric Id父级广告客户对象的 ID。可与 Advertiser.common_data.id 联接。
partner_idNumeric Id父级广告客户的总管理合作伙伴对象的 ID。可通过 Partner.common_data.id 加入。
remarketing_enabledboolean如果设为 true,系统将启用此活动以用于定位。
ssl_requiredboolean设置为 true 时,代码必须符合相关要求。

InventorySource 个表

字段名称类型说明
idNumeric Id广告资源来源的唯一键。
unclassifiedboolean如果设置为 true,则会包含所有未分类的广告资源。
inventory_namestring界面中显示的广告资源来源的名称。此字段可能不存在。如果 inventory_name 不存在且 unclassified 为 true,则表示广告交易平台的未分类广告资源。如果此字段不存在且 unclassified 为 false,则广告资源来源为广告交易平台级广告资源。
exchange_idNumeric Id提供此广告资源来源的广告交易平台的 ID。可通过 SupportedExchange.id 加入。
accessing_advertisers[Numeric Id]广告客户 ID 的数组,可与 Advertiser.common_data.id 联接,并且有权使用此广告资源来源。

注意:如果某个广告资源来源面向所有广告客户开放,则不会显示此字段。

external_idstring分配给此广告资源来源并由广告交易平台定义的外部 ID,通常称为交易 ID 或卖方 ID。此字段可能不存在。
min_cpm_microsinteger此广告资源来源的有效底价(以货币微分表示)。
min_cpm_currency_codestring用于 min_cpm_micros 的 3 个字母 ISO 4217 货币代码。

UserList 个表

字段名称类型说明
idNumeric Id用户列表的唯一键。
namestring界面中显示的用户列表的名称。
data_partner_idNumeric Id可与 DataPartner.id 联接。此字段仅针对第三方用户名单进行设置。
accessing_advertisers[Numeric Id]广告客户 ID 数组,可与 Advertiser.common_data.id 联接,并且有权使用此用户名单。

注意:如果用户名单可供所有广告客户使用,则不会显示此字段。

partner_pricingUserListPricing费用类型始终为每千次展示费用 (CPM),币种代码始终为美元。
advertiser_pricings[UserListAdvertiserPricing]费用类型始终为每千次展示费用 (CPM),币种代码始终为美元。

CustomAffinity 个表

字段名称类型说明
id Numeric Id 自定义亲和度的唯一键。
name string 自定义亲和度的名称(如界面中所示)。
description string 自定义亲和度的说明,如界面中所示。
advertiser_id Numeric Id 父级广告客户对象的 ID。可与 Advertiser.common_data.id 联接。

UniversalChannel 个表

字段名称类型说明
idNumeric Id渠道的唯一键。
namestring界面中显示的频道名称。
site_ids [Numeric Id] 包含此渠道中 UniversalSite 的 ID 的数组。可与 UniversalSite.id 联接。
accessing_advertisers[Numeric Id]广告客户 ID 的数组,可与 Advertiser.common_data.id 联接,并且有权使用此渠道。

注意:如果某个渠道面向所有广告客户开放,则不会显示此字段。

is_deletedboolean设置为 true 后,任何新订单项都无法定位到此渠道,但已定位到此渠道的现有订单项将继续保持原设置。
is_brand_safe_channelboolean将此渠道设置为 true 后,即可用于品牌保障过滤。目前,只有 4 个内置品牌保障层级的 true 为 1。

NegativeKeywordList 个表

字段名称类型说明
id Numeric Id 否定关键字列表的唯一键。
name string 界面中显示的否定关键字列表名称。
advertiser_id Numeric Id 父级广告客户对象的 ID。可通过 Advertiser.common_data.id 加入。

公共表

SupportedExchange 个表

字段名称类型说明
idNumeric Id广告交易平台的唯一键。
namestring广告交易平台的名称,例如 Ad Exchange

DataPartner 个表

字段名称类型说明
idNumeric Id第三方数据提供商的唯一键。
namestring第三方数据提供商的名称,例如 BlueKai

UniversalSite 个表

字段名称类型说明
idNumeric Id通用网站的唯一键。
namestring网站网址或名称,例如 google.comGoogle Unclassified

SiteIdToPlacementId 个表

字段名称类型说明
siteId Numeric Id 从通用网站 ID 映射到网站展示位置 ID。
placementId Numeric Id 网站展示位置网址或名称,例如 google.comGoogle Unclassified

GeoLocation 个表

字段名称类型说明
idNumeric Id地理位置的唯一键。
canonical_namestring相应位置及其父级位置的逗号连接字符串。示例:“美国华盛顿州西雅图”。
geo_namestring营业地点的名称。示例:“Seattle”。
country_codestring此地理位置的 ISO-3166 alpha-2 国家/地区代码,例如 US
region_codestring此地理位置的 ISO-3166-2 子区域代码,例如 US-WA。此字段可能缺失。
city_namestring此地理位置对应的城市名称,例如 Seattle。此字段可能缺失。
postal_codestring此地理位置的邮政编码,例如 98033。此字段可能缺失。
dma_codeinteger此地理位置的特定媒体市场区域代码,例如 510。此字段可能缺失。

Language 个表

字段名称类型说明
idNumeric Id此语言的唯一键。
codestring此语言的 ISO-639-1 代码;zh_CN 表示简体中文,zh_TW 表示中文(繁体),other 表示其他语言。

DeviceCriteria 个表

字段名称类型说明
idNumeric Id此设备条件的唯一键。
is_mobileboolean如果为 true,则此条件仅涵盖移动设备。如果为 false,此条目仅涵盖非移动设备,即使其名称(例如“其他”)并不表示如此。
namestring设备条件的熟悉名称。
criteria_typeEnum0=OPERATING_SYSTEM
1=MOBILE_MAKE_MODEL
2=DEVICE_TYPE
operating_system_idNumeric Id标识操作系统。仅当 criteria_type0 时,系统才会填充此字段。
mobile_brand_namestring设备的品牌名称。仅当 criteria_type1 时,系统才会填充此字段。
mobile_model_namestring设备的型号名称。仅当 criteria_type1 时,系统才会填充此字段。可选。
mobile_make_model_idNumeric Id标识设备的型号。仅当 criteria_type1 时,系统才会填充此字段。可选。
device_typeEnum指示设备类型。仅当 criteria_type2 时,系统才会填充此字段。

0=COMPUTER
1=OTHER
2=SMARTPHONE
3=TABLET
4=SMARTTV
5=CONNECTEDTV
6=SET_TOP_BOX
7=CONNECTEDDEVICE

Browser 个表

字段名称类型说明
idNumeric Id此浏览器的唯一键。
is_mobileboolean如果为 true,则此条件仅涵盖移动设备。如果为 false,则此条目仅涵盖非移动设备,即使其名称(如“其他”)并不表示如此。
namestring浏览器的常用名称,例如 Safari 5。不包含完整的用户代理字符串。

Isp 个表

字段名称类型说明
idNumeric Id此互联网服务提供商的唯一键。
is_mobileboolean如果为 true,则此条件仅涵盖移动设备。如果为 false,则此条目仅涵盖非移动设备,即使其名称(如“其他”)并不表示如此。
namestring此互联网服务提供商的名称。
secondary_criteria_idinteger 可选的备用 ID,可用于标识实体。

AppCollection 个表

字段名称类型说明
idNumeric Id此应用集合的唯一键。
namestring此应用集合的名称。