私人資料表
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 |
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 |
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 (已停用千次可視曝光出價)1=CPC |
goal_advertiser_micros | integer | 廣告主所用幣別的千次可視曝光出價目標 (以百萬分之一表示)。如果將 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 |
creative_type | Enum |
0=Image or HTML5 |
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。這個欄位可能不存在。 |
min_cpm_micros | integer | 這個廣告空間來源的有效底價 (以貨幣為單位)。 |
min_cpm_currency_code | string | min_cpm_micros 所用的 ISO 4217 貨幣代碼 (由 3 個英文字母組成)。 |
UserList
個資料表
欄位名稱 | 類型 | 說明 |
---|---|---|
id | Numeric Id | 使用者名單的專屬鍵。 |
name | string | 使用者名單的名稱,如 UI 所示。 |
data_partner_id | Numeric Id | 可透過 DataPartner.id 加入。只有第三方使用者名單會設定此欄位。 |
accessing_advertisers | [Numeric Id] | 廣告主 ID 陣列,可與 Advertiser.common_data.id 彙整,有權使用此使用者名單。注意:如果所有廣告客戶都有一份使用者名單,系統就不會顯示這個欄位。 |
partner_pricing | UserListPricing | 費用類型一律是千次曝光出價,貨幣代碼一律為美元。 |
advertiser_pricings | [UserListAdvertiserPricing] | 費用類型一律是千次曝光出價,貨幣代碼一律為美元。 |
CustomAffinity
個資料表
欄位名稱 | 類型 | 說明 |
---|---|---|
id |
Numeric Id |
自訂興趣相似目標對象的專屬鍵。 |
name |
string |
UI 中顯示的自訂相依性名稱。 |
description |
string |
UI 中顯示的自訂相依性說明。 |
advertiser_id |
Numeric Id |
上層廣告主物件的 ID。可透過 Advertiser.common_data.id 加入。 |
UniversalChannel
個資料表
欄位名稱 | 類型 | 說明 |
---|---|---|
id | Numeric Id | 頻道的專屬鍵。 |
name | string | 使用者介面中顯示的頻道名稱。 |
site_ids |
[Numeric Id] |
包含此管道中 UniversalSite 的陣列。可透過 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_TW (繁體) 或 other (其他語言) 的 zh_CN 。 |
DeviceCriteria
個資料表
欄位名稱 | 類型 | 說明 |
---|---|---|
id | Numeric Id | 此裝置條件的專屬鍵。 |
is_mobile | boolean | 如果為 true,這項條件僅涵蓋行動裝置。如果設為 False,這個項目只會涵蓋非行動裝置,包括其名稱 (例如「其他」) 並不表示如此。 |
name | string | 熟悉的裝置條件名稱。 |
criteria_type | Enum | 0=OPERATING_SYSTEM |
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 時,才會填入這個欄位。
|
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 | 此應用程式集合的名稱。 |