私人資料表
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 | 包含此廣告客戶的常見資料,例如名稱和編號。 |
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 | UI 中顯示的廣告空間來源名稱。這個欄位可能不會顯示。如果 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 | 顯示在 UI 中的管道名稱。 |
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 | 這個地理位置的指定行銷區域代碼,例如 510 。這個欄位可能缺少。 |
Language
個資料表
欄位名稱 | 類型 | 說明 |
---|---|---|
id | Numeric Id | 這個語言的專屬金鑰。 |
code | string | 這個語言的 ISO-639-1 代碼,zh_CN 中文 (簡體) 或zh_TW 中文 (繁體) 的 ISO-639-1 代碼,other 則是其他語言。 |
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 | 這個應用程式集合的名稱。 |