实体读取文件格式 - V2

我们将于 2024 年 10 月 31 日弃用实体读取文件 并且不会再生成有关详情，请参阅迁移到新版 展示广告与Video 360 API。

。

文件中省略了 null 标量和空数组。

• 共享类型
• 专用表
• 公共表

共享类型

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

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），例如，如果货币是欧元，75000000 表示 75 欧元；如果货币是美元，250000 表示 0.25 美元。既无法换算为美元金额，也无法换算为美元金额。

Percentage Milli 类型

标量	说明
integer	以毫秒表示的百分比（百分比的 1/1,000），例如 100 表示 0.1%。

FileSummary 类型

字段名称	类型	说明
name	string	文件的文件名（不包括存储分区或目录名称）。
num_records	integer	文件中的实体数量。
version	integer	文件的主要版本号。如果将来创建了新版实体数据格式，此数字可能会发生变化。

EntityCommonData 类型

字段名称	类型	说明
id	Numeric Id	每个实体类型中的唯一 ID - 例如，对于合作伙伴实体，此 ID 是合作伙伴 ID，对于广告客户，则是广告客户 ID，以此类推。
name	string	界面可见的实体名称。
active	boolean	用户设置的状态 - 实体可能因其他原因而未投放广告，例如例如预算耗尽、广告排期结束等
integration_code	string	用户设置的集成代码

ExchangeSettings 类型

字段名称	类型	说明
exchange_id	Numeric Id	广告交易平台的 ID。可使用 SupportedExchange.id 联接
seat_id	string	广告交易平台的席位 ID
seat_user_name	string	与此席位相关的用户名（仅适用于 Right Media 非 RTB 席位）。

ApprovalStatus 类型

字段名称	类型	说明
auditor	Enum	0=DOUBLECLICK_BID_MANAGER 1=DOUBLECLICK_AD_EXCHANGE 2=APPNEXUS 3=APPNEXUS_MICROSOFT 4=RIGHT_MEDIA_NON_RTB
status	Enum	0=APPROVED 1=REJECTED 2=PENDING 3=NO_AUDIT 4=UN_AUDITABLE 5=UNKNOWN 6=IN_AUDIT
feedback	string	审计人员的反馈，其中可能会提供更多信息（例如拒绝原因）。
sync_time	Time	实体上次与 auditor 同步的时间
external_id	Numeric Id	仅当 auditor 为 APPNEXUS、APPNEXUS_MICROSOFT 或 RIGHT_MEDIA_NON_RTB 时填充。这是实体在审核人员空间中的 ID。

Budget 类型

字段名称	类型	说明
start_time_usec	Time	预算期的开始时间。
end_time_usec	Time	预算期的结束时间。
max_impressions	integer	此预算的最大展示次数。如果缺少此字段，则为展示次数不受限制的预算。
max_spend_advertiser_micros	integer	此预算的支出上限（以广告客户币种的微单位表示）。如果缺少此字段，则表示预算没有支出限制。
pacing_type	Enum	0=FLIGHT 1=DAILY
pacing_max_impressions	integer	每个投放安排间隔的最大展示次数，由 pacing_type 设置。如果缺少此字段，则表示对展示次数没有限制。
pacing_max_spend_advertiser_micros	integer	由pacing_type设置的每种投放安排间隔的最高支出（以广告客户币种的微单位表示）。如果缺少此字段，则表示没有支出限制。
pacing_distribution	Enum	0=ASAP 1=EVEN 2=AHEAD

FrequencyCap 类型

字段名称	类型	说明
max_impressions	integer	每个频次上限间隔中的最大展示次数。
time_unit	Enum	时间单位： 0=MINUTE 1=HOUR 2=DAY 3=WEEK 4=MONTH 5=LIFE_TIME
time_range	integer	time_units 的数量，例如，如果 time_unit 为 1，则 time_range 的值为 6 表示 6 小时。

PartnerCosts 类型

字段名称	类型	说明
cpm_fee_1_advertiser_micros	integer	CPM 1 费用（以广告客户币种的微单位表示）。
cpm_fee_2_advertiser_micros	integer	CPM 2 费用（以广告客户币种的微单位表示）。
cpm_fee_3_advertiser_micros	integer	CPM 3 费用（以广告客户币种的微单位表示）。
cpm_fee_4_advertiser_micros	integer	CPM 4 费用（以广告客户币种的微单位表示）。
cpm_fee_5_advertiser_micros	integer	CPM 5 费用（以广告客户币种的微单位表示）。
media_fee_percent_1_millis	integer	媒体费用 1（Percentage Milli）
media_fee_percent_2_millis	integer	媒体费用 2（Percentage Milli）
media_fee_percent_3_millis	integer	媒体费用 3（Percentage Milli）
media_fee_percent_4_millis	integer	媒体费用 4（Percentage Milli）
media_fee_percent_5_millis	integer	媒体费用 5（Percentage Milli）
cpm_fee_1_cost_type	Enum	0=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_type	Enum	与 cpm_fee_1_cost_type 相同。
cpm_fee_3_cost_type	Enum	与 cpm_fee_1_cost_type 相同。
cpm_fee_4_cost_type	Enum	与 cpm_fee_1_cost_type 相同。
cpm_fee_5_cost_type	Enum	与 cpm_fee_1_cost_type 相同。
media_fee_percent_1_cost_type	Enum	与 cpm_fee_1_cost_type 相同。
media_fee_percent_2_cost_type	Enum	与 cpm_fee_1_cost_type 相同。
media_fee_percent_3_cost_type	Enum	与 cpm_fee_1_cost_type 相同。
media_fee_percent_4_cost_type	Enum	与 cpm_fee_1_cost_type 相同。
media_fee_percent_5_cost_type	Enum	与 cpm_fee_1_cost_type 相同。
cpm_fee_1_bill_to_type	Enum	0=DEFAULT_BILL_TO_TYPE 1=INVITE_MEDIA 2=PARTNER
cpm_fee_2_bill_to_type	Enum	与 cpm_fee_1_bill_to_type 相同。
cpm_fee_3_bill_to_type	Enum	与 cpm_fee_1_bill_to_type 相同。
cpm_fee_4_bill_to_type	Enum	与 cpm_fee_1_bill_to_type 相同。
cpm_fee_5_bill_to_type	Enum	与 cpm_fee_1_bill_to_type 相同。
media_fee_percent_1_bill_to_type	Enum	与 cpm_fee_1_bill_to_type 相同。
media_fee_percent_2_bill_to_type	Enum	与 cpm_fee_1_bill_to_type 相同。
media_fee_percent_3_bill_to_type	Enum	与 cpm_fee_1_bill_to_type 相同。
media_fee_percent_4_bill_to_type	Enum	与 cpm_fee_1_bill_to_type 相同。
media_fee_percent_5_bill_to_type	Enum	与 cpm_fee_1_bill_to_type 相同。

PartnerRevenueModel 类型

字段名称	类型	说明
type	Enum	0=CPM 1=MEDIA_COST_MARKUP 2=TOTAL_MEDIA_COST_MARKUP
amount_advertiser_micros	integer	收入金额（以广告客户当前的微单位表示）。只有当类型为 CPM 时，才会设置此值。
media_cost_markup_percent_millis	integer	收入百分比加价（以 Percentage Milli 为单位）。只有当类型为 MEDIA_COST_MARKUP 或 TOTAL_MEDIA_COST_MARKUP 时，才会设置此值。
post_view_conversion_tracking_fraction	float	要用于转化跟踪的浏览后转化次数所占的比例。如果为 0，则只计算点击后转化次数；如果为 1.0，系统将跟踪所有转化。

CostTrackingPixel 类型

字段名称	类型	说明
pixel_id	Numeric Id	跟踪像素的 ID - 请注意，两个 CostTrackingPixel 可能共用同一个 pixel_id，但浏览或点击窗口值不同。 此值可与 Pixel.common_data.id 联接在一起。
view_window_minutes	integer	查找浏览后转化所用的时间（以分钟为单位）。
click_window_minutes	integer	查找点击后转化次数的分钟数。
floodlight_activity_id	数字 ID	CM Floodlight 活动 ID。此值可与 Pixel.dcm_floodlight_id 联接起来。

Target 类型

字段名称	类型	说明
criteria_id	Numeric Id	可与另一个表联接，具体取决于 TargetList 中定义的类型。可能缺少此值。
parameter	string	其他参数，其定义取决于 TargetList 中定义的类型。可能缺少此值。
excluded	boolean	如果为 true，则表示已排除该定位条件。缺失值意味着 false。

TargetUnion 类型

字段名称	类型	说明
union	[Target]	Target 类型的数组，表示目标并集。
excluded	boolean	当 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.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	TargetUnion	TargetUnion 类型。Target.criteria_id 可与 Language.id 联接，但 Target.parameter 未定义。
day_parting	TargetUnion	TargetUnion 类型，表示时段。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。 结束时间： 午夜起的分钟数，除以 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_sites	boolean	此标记指示是否应将未编入索引的网站包含在 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。
isps	TargetUnion	TargetUnion 类型表示互联网服务提供商。Target.criteria_id 可与 ISP.id 联接，但 Target.parameter 未定义。

SummaryFile 类型

字段名称	类型	说明
file	[FileSummary]	零个或零个以上 FileSummary 条目的数组。如果此数组为空，则表示在该日期未生成任何数据。

UserListAdvertiserPricing 类型

字段名称	类型	说明
pricing	UserListPricing
advertiser_id	Numeric Id

UserListPricing 类型

字段名称	类型	说明
cost_type	string
currency_code	string	由三个字母组成的 ISO 4217 货币代码，例如 USD 代表美元。
cost_micros	Currency Micro

专用表

Partner 个表

字段名称	类型	说明
common_data	EntityCommonData	包含此合作伙伴的常用数据，例如名称和 ID。
currency_code	string	由三个字母组成的 ISO 4217 货币代码，例如 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 货币代码，例如 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 1=NORMAL 2=HYBRID
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 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_micros	integer	以广告客户币种微单位表示的最高每千次展示费用值。
performance_goal	Enum	0=NONE（vCPM 已停用） 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_micros	integer	vCPM 目标（以广告客户币种的微单位表示）。如果 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 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_type	Enum	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_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 中。
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 的 ISO 4217 货币代码（由 3 个字母组成）。

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，货币代码始终为 USD。
advertiser_pricings	[UserListAdvertiserPricing]	费用类型始终为 CPM，货币代码始终为 USD。

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。

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	地理位置名称。例如：“西雅图”。
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	此地理位置的 DMA 代码，例如 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 1=MOBILE_MAKE_MODEL 2=DEVICE_TYPE
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 时，系统才会填充此字段。 0=COMPUTER 1=OTHER 2=SMARTPHONE 3=TABLET 4=SMARTTV 5=CONNECTEDTV 6=SET_TOP_BOX 7=CONNECTEDDEVICE

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