实体读取文件格式 - V2

共享类型

这些类型用于定义某些表中的嵌套字段;这些字段没有自己的表。

Numeric Id 类型

标量说明
integer一个数字 ID 号,用作实体的标识符。这些 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),例如,如果货币是 EUR,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仅当 auditor 为 APPNEXUS、APPNEXUS_MICROSOFT 或 RIGHT_MEDIA_NON_RTB 时才填充。这是审核员聊天室中的实体的 ID。

Budget 类型

字段名称类型说明
start_time_usecTime预算周期的开始时间。
end_time_usecTime预算周期的结束时间。
max_impressionsinteger此预算的展示次数上限。如果缺少此字段,则表示展示次数预算不受限。
max_spend_advertiser_microsinteger此预算的支出上限(以广告客户币种的微分表示)。如果缺少此字段,则表示预算没有支出限制。
pacing_typeEnum0=FLIGHT
1=DAILY
pacing_max_impressionsinteger由 pacing_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_unit 为 1,则 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_typeEnum与 cpm_fee_1_cost_type 相同。
cpm_fee_3_cost_typeEnum与 cpm_fee_1_cost_type 相同。
cpm_fee_4_cost_typeEnum与 cpm_fee_1_cost_type 相同。
cpm_fee_5_cost_typeEnum与 cpm_fee_1_cost_type 相同。
media_fee_percent_1_cost_typeEnum与 cpm_fee_1_cost_type 相同。
media_fee_percent_2_cost_typeEnum与 cpm_fee_1_cost_type 相同。
media_fee_percent_3_cost_typeEnum与 cpm_fee_1_cost_type 相同。
media_fee_percent_4_cost_typeEnum与 cpm_fee_1_cost_type 相同。
media_fee_percent_5_cost_typeEnum与 cpm_fee_1_cost_type 相同。
cpm_fee_1_bill_to_typeEnum0=DEFAULT_BILL_TO_TYPE
1=INVITE_MEDIA
2=PARTNER
cpm_fee_2_bill_to_typeEnum与 cpm_fee_1_bill_to_type 相同。
cpm_fee_3_bill_to_typeEnum与 cpm_fee_1_bill_to_type 相同。
cpm_fee_4_bill_to_typeEnum与 cpm_fee_1_bill_to_type 相同。
cpm_fee_5_bill_to_typeEnum与 cpm_fee_1_bill_to_type 相同。
media_fee_percent_1_bill_to_typeEnum与 cpm_fee_1_bill_to_type 相同。
media_fee_percent_2_bill_to_typeEnum与 cpm_fee_1_bill_to_type 相同。
media_fee_percent_3_bill_to_typeEnum与 cpm_fee_1_bill_to_type 相同。
media_fee_percent_4_bill_to_typeEnum与 cpm_fee_1_bill_to_type 相同。
media_fee_percent_5_bill_to_typeEnum与 cpm_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_MARKUP 或 TOTAL_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 类型的数组,表示目标的并集。
excludedboolean如果为 true,则表示排除了目标联合。缺失值意味着 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.8mbps 及更快)。

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


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


开始时间:
自午夜起经过的分钟数,除以 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]包含座位 ID 等信息的 ExchangeSettings 类型数组。系统只会显示已启用的广告交易平台。
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 设置为 NORMAL 或 HYBRID,此值将与关联的 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 中。
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 的 ISO 4217 货币代码(由 3 个字母组成)。

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,货币代码始终为 USD。

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。

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.com 或 Google Unclassified。

SiteIdToPlacementId 个表

字段名称类型说明
siteId Numeric Id 从通用网站 ID 映射到网站展示位置 ID。
placementId Numeric Id 网站展示位置网址或名称,例如 google.com 或 Google 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此地理位置的 DMA 代码,例如 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_type 为 0 时,系统才会填充此字段。
mobile_brand_namestring设备的品牌名称。仅当 criteria_type 为 1 时,系统才会填充此字段。
mobile_model_namestring设备的型号名称。仅当 criteria_type 为 1 时,系统才会填充此字段。可选。
mobile_make_model_idNumeric Id标识设备的型号。仅当 criteria_type 为 1 时,系统才会填充此字段。可选。
device_typeEnum指示设备类型。仅当 criteria_type 为 2 时,系统才会填充此字段。

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此应用集合的名称。