实体读取文件格式 - V2

共享类型

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

Numeric Id 类型

标量说明
integer用作实体标识符的数字 ID 号。不应将这些 ID 视为通用唯一 ID,例如,某个广告系列使用的 ID 值可能与像素相同。

Enum 类型

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

Time 类型

标量说明
integer以微秒为单位的 unix 时间(1/1,000,000 秒),例如 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仅当 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 费用(以广告客户币种微单位表示)。
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_millisinteger媒体费用 1(Percentage Milli
media_fee_percent_2_millisinteger媒体费用 2(Percentage Milli
media_fee_percent_3_millisinteger媒体费用 3(Percentage Milli
media_fee_percent_4_millisinteger媒体费用 4(Percentage Milli
media_fee_percent_5_millisinteger媒体费用 5(Percentage Milli
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 类型的数组,表示目标并集。
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.8mpb 及更快)。

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。

结束时间:
午夜以来的分钟数,除以 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 货币代码,例如 USD(代表美元)。
cost_microsCurrency Micro

私密表

Partner 个表

字段名称类型说明
common_dataEntityCommonData包含该合作伙伴的通用数据,例如名称和 ID。
currency_codestring由三个字母组成的 ISO 4217 货币代码,例如 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 货币代码,例如 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最高 CPM 值(以广告客户币种微单位表示)。
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_codestringmin_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费用类型始终为每千次展示费用,货币代码始终为美元。
advertiser_pricings[UserListAdvertiserPricing]费用类型始终为每千次展示费用,货币代码始终为美元。

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,此渠道可用于品牌保障过滤。目前,true 仅适用于 4 个内置品牌保障等级。

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地理位置名称。例如:“西雅图”。
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_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此应用集合的名称。