實體讀取檔案格式 - 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只有在 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_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_unit 是 1,time_range 的值就是 6 小時。

「PartnerCosts」類型

欄位名稱類型說明
cpm_fee_1_advertiser_microsinteger廣告主所用幣別的千次曝光出價費用 1 (微分)。
cpm_fee_2_advertiser_microsinteger千次曝光出價 2 費用 (以廣告主所用幣別 (百萬分之一) 表示)。
cpm_fee_3_advertiser_microsinteger以廣告主所用幣別微分表示的千次曝光出價費用 3。
cpm_fee_4_advertiser_microsinteger以廣告主所用幣別微分表示的千次曝光出價費用 4。
cpm_fee_5_advertiser_microsinteger千次曝光出價 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_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_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 為 1 時,表示已排除目標。如果缺少值,表示 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.0 mbps 以上)。
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.8mpbs 以上)。

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 TargetUnionTargetUnion 類型,用於日間分區。Target.criteria_id 有 6 個數字:(TimeZone)(DayOfWeek)(StartTime)(EndTime)

TimeZone:
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


StartTime:
從午夜開始算起的分鐘數,除以 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 類型陣列。如果網站不在 UniversalSite 中,Target.criteria_id 可與 UniversalSite.id 彙整,或未設定。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_codestringISO 4217 三字母貨幣代碼,例如 USD 代表美元。
cost_microsCurrency Micro

私人表格

Partner 個資料表

欄位名稱類型說明
common_dataEntityCommonData包含這位合作夥伴的常用資料,例如名稱和 ID。
currency_codestringISO 4217 三字母貨幣代碼,例如 USD 代表美元。
exchange_settings[ExchangeSettings]ExchangeSettings 類型的陣列,其中包含座位 ID 等資訊。系統只會顯示已啟用的廣告交易平台。
default_partner_costsPartnerCosts包含這位合作夥伴的已發生錯誤費用資訊。
default_partner_revenue_modelPartnerRevenueModel包含此夥伴預設收益模式的相關資訊。
default_target_listTargetList包含合作夥伴的預設指定目標選項。目前僅支援預設地理區隔。

Advertiser 個資料表

欄位名稱類型說明
common_dataEntityCommonData包含此廣告客戶的常見資料,例如名稱和編號。
partner_idNumeric Id上層合作夥伴物件的 ID。可與 Partner.common_data.id 結合。
currency_codestringISO 4217 三字母貨幣代碼,例如 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以廣告主幣別微分表示的 vCPM 目標。如果 performance_goal 設為 NONE,則這個值會缺少。
partner_revenue_modelPartnerRevenueModel這個委刊項使用的夥伴收益模式。
cost_tracking_pixels[CostTrackingPixel]指派給追蹤此委刊項的 CostTrackingPixels 陣列。
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。這個欄位可能不存在。
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]可與 Advertiser.common_data.id 彙整的廣告主 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 時,即可用於品牌安全篩選。目前只有 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位置和父項的半形逗號連接字串。例如:「Seattle, Washington, United States」。
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_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這個應用程式集合的名稱。