實體讀取檔案格式 - V2

共用類型

這些類型在某些資料表中定義了巢狀欄位,但這些欄位並沒有自己的表格。

Numeric Id」類型

純量說明
integer用來當做實體 ID 的數字 ID。請勿將這些 ID 視為通用 ID,例如廣告活動和 Pixel 所用的 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實體在 UI 上顯示的名稱。
activeboolean使用者設定的狀態 - 出於其他原因 (例如預算用盡、檔期結束等),實體可能不會放送
integration_codestring使用者設定的整合代碼

ExchangeSettings」類型

欄位名稱類型說明
exchange_idNumeric Id廣告交易平台的 ID。可使用 SupportedExchange.id 彙整
seat_idstring廣告交易平台的席位 ID
seat_user_namestring與這個席位相關的使用者名稱 (僅適用於 Right Media 非即時出價帳戶)。

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_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_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 IdTargetList 中定義的類型而定,可與其他資料表彙整。可能缺少這個值。
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.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 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


StartTime:
從午夜算起的分鐘數,除以 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.parametergoogle.com 之類的網站,但不一定在 UniversalSite 中找到。
ispsTargetUnion網際網路服務供應商的 TargetUnion 類型。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內含此廣告主的常見資料,例如名稱和 ID。
partner_idNumeric Id上層合作夥伴物件的 ID。可透過 Partner.common_data.id 加入。
currency_codestringISO 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以廣告主貨幣為單位的最高千次曝光出價值。
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_nameunclassified 為 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使用者名單的名稱,如 UI 所示。
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 UI 中顯示的自訂相依性名稱。
description string UI 中顯示的自訂相依性說明。
advertiser_id Numeric Id 上層廣告主物件的 ID。可透過 Advertiser.common_data.id 加入。

UniversalChannel 個資料表

欄位名稱類型說明
idNumeric Id頻道的專屬鍵。
namestring使用者介面中顯示的頻道名稱。
site_ids [Numeric Id] 包含此管道中 UniversalSite 的陣列。可透過 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.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_TW (繁體) 或 other (其他語言) 的 zh_CN

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此應用程式集合的名稱。