實體讀取檔案格式 - V2

,瞭解如何調查及移除這項存取權。

共用類型

這些類型定義了某些資料表中的巢狀欄位;這些欄位沒有專屬的資料表

Numeric Id」類型

純量說明
integer可做為實體 ID 的數字 ID,ID 不應視為完全不重複,例如同一個廣告活動使用的 ID 值也會用於 Pixel。

Enum」類型

純量說明
integer多個可能選項的列舉。不同選項的詳細說明請見父項類型。

Time」類型

純量說明
integer以微秒為單位的 Unix 時間 (1/1,000,000 秒),例如 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 非即時出價帳戶名額)。

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_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_unit1time_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_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.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)

時區:
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。範圍介於 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.idTarget.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
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包含此廣告客戶的常見資料,例如名稱和編號。
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_namestringUI 中顯示的廣告空間來源名稱。這個欄位可能不會顯示。如果 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顯示於 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顯示在 UI 中的管道名稱。
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.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這個地理位置的指定行銷區域代碼,例如 510。這個欄位可能缺少。

Language 個資料表

欄位名稱類型說明
idNumeric Id這個語言的專屬金鑰。
codestring這個語言的 ISO-639-1 代碼,zh_CN中文 (簡體) 或zh_TW中文 (繁體) 的 ISO-639-1 代碼,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這個應用程式集合的名稱。