如需格式的相關說明,請參閱總覽。
欄位 | 必填 | 類型 | 可寫入 | 說明 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
委刊項 ID | 只有在編輯現有委刊項時才需要 | 整數 | 否 | 委刊項的數字 ID 值。如果留空,系統會建立新委刊項並指派專屬 ID。必要時,您可以在建立新委刊項時使用自訂 ID,將 TrueView 廣告群組指派給新的委刊項。自訂 ID 的格式為「ext[自訂 ID]」,例如 ext123。檔案上傳並處理完畢後,系統就會將所有自訂 ID 替換成 DBM 指派的 ID,並根據自訂 ID 為物件建立關聯 (例如,從廣告群組至委刊項)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Io ID | 是 | 整數 | 否 | 廣告訂單的數字 ID 值。如果您建立的是這個委刊項,而且建立的是廣告訂單,您可以為該廣告訂單指定自訂 ID (例如「ext[自訂 IO ID]」)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
類型 | 是 | 字串 | 是 | 項目類型。只能在建立時寫入,而非編輯。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
子類型 | 是 | 字串 | 是 | 用於區分標準和行動應用程式安裝 TrueView 格式的 TrueView 委刊項欄位
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
名稱 | 是 | 字串 | 是 | 項目名稱。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
時間戳記 | 編輯現有項目時必填 | 整數 | 否 | 項目的時間戳記,由系統用於驗證該項目從下載和上傳期間的未變更。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
狀態 | 是 | 字串 | 是 | 項目的狀態設定。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
開始日期 | 是 | 字串 | 是 | 項目檔期開始日期的時間戳記,格式為 MM/DD/YYYY HH:mm。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
結束日期 | 是 | 字串 | 是 | 項目檔期結束日期的時間戳記,格式為 MM/DD/YYYY HH:mm。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
預算類型 | 是 | 字串 | 是 | 指定預算是以金額或曝光為基礎。如果這個項目的 IO 已啟用自動預算分配功能,您可以將其設為「自動」允許 DBM 自動為這個項目預算。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
預算金額 | 「類型」時必填是「Display」或「影片」或「音訊」 | float | 是 | 這個預算類型的預算金額為正值。這可以是簡單的整數曝光值,或是貨幣金額的浮點值。貨幣會以廣告客戶的貨幣單位顯示,而不是以 1/1,000,000s 的貨幣單位顯示。若為「自動」預算分配功能已設定所需項目,您可以指定最低支出金額 (例如「支出至少」這個金額)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
使用速度 | 是 | 字串 | 是 | 用於支出使用速度金額的時間範圍。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
使用速度 | 是 | 字串 | 是 | 這個項目的使用速度速率。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
使用速度金額 | 是 | float | 是 | 每個使用速度類型所設時間範圍內可支出的金額。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
已啟用頻率 | 是 | 字串 | 是 | 為委刊項啟用/停用以曝光次數為準的展示頻率上限。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
頻率曝光 | 「已啟用頻率」時為必填為「TRUE」 | 整數 | 是 | 指定展示頻率金額中,以正整數表示的曝光次數,也就是「顯示 Y 期間的 x 次曝光次數」。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
頻率週期 | 「已啟用頻率」時為必填為「TRUE」 | 字串 | 是 | 指定展示頻率上限的時間範圍單位。TrueView 委刊項的支援時段為「天」、「週」、「月」。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
頻率金額 | 「已啟用頻率」時為必填為「TRUE」 | 整數 | 是 | 展示頻率週期類型時間長度的正整數值,亦即「顯示 Y 期間的 x 次曝光次數」中的 y。TrueView 委刊項不支援這個金額。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 觀看頻率已啟用 | 「類型」時必填為「TrueView」 | 字串 | 是 | 針對 TrueView 委刊項啟用/停用以觀看為準的展示頻率上限
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 觀看頻率曝光 | 「已啟用 TrueView 觀看頻率」時為必填為「TRUE」 | 整數 | 是 | TrueView 觀看次數的正整數金額,也就是「顯示期間顯示 x 次觀看」的 x 號 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 觀看頻率期間 | 「已啟用 TrueView 觀看頻率」時為必填為「TRUE」 | 字串 | 是 | 指定以 TrueView 觀看為準展示頻率上限的時間範圍單位
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
合作夥伴收益模式 | 是 | 字串 | 是 | 夥伴收益模式是控制出價管理工具如何計算收益的機制。您可以使用夥伴收益模式追蹤服務費的成本加價情況。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
合作夥伴收益金額 | 是 | float | 是 | 與合作夥伴收益模式對應的正浮點值。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
轉換計算方式類型 | 「類型」時必填是「Display」或「影片」或「音訊」 | 字串 | 是 | 選擇要納入計算的轉換類型。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
轉換計數位置 | 「類型」時必填是「Display」或「影片」或「音訊」 | float | 是 | 指定「計數 %」的百分比轉換計數類型。將 % 的格式設定為一個浮點值 (3.123% = 3.123),且精度設有千位數 (小數點後 3 位)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
轉換像素 ID | 否 | string, 清單清單 | 是 | 以清單的形式指定轉換像素。每個像素都會指定為像素 ID、瀏覽後回溯期 (以分鐘為單位) 和點擊後回溯期 (以分鐘為單位)。清單格式 = (Pixel.common_data.id; view_window_minutes; click_window_minutes;)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
費用 | 否 | string, 清單清單 | 是 | 這個項目的所有費用。清單格式 = (費用類別;費用金額;費用類型;開立發票);
例如「(千次曝光出價;2;Bid Manager 費用;錯誤)」;(Media;13;Default;True); 注意:附加費率千次曝光出價費用由系統保留,且無法變更。視需要插入預設千次曝光出價費用,在變更時保留付費費用的基數。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
整合代碼 | 否 | 字串 | 是 | 用於追蹤的選用程式碼。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
詳細資料 | 否 | 字串 | 是 | 以字串格式輸入項目詳細資料。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出價策略類型 | 「類型」時必填是「Display」或「影片」或「音訊」 | 字串 | 是 | 選取其中一個適用的出價策略:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出價策略價值 | 除非「出價策略類型」為必填欄位是「最小化」、「最大化」或「類型」為「TrueView」 | float | 是 | 請選擇「最佳化千次可視曝光出價」或「固定策略」類型做為目標出價。 請注意,「最小化」出價策略類型不需要出價策略值或「最大化」 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出價策略單位 | 「出價策略類型」為必填欄位是「Beat」「最小化」或「最大化」 | 字串 | 是 | 為「節奏」、「最小化」或「最大化」策略類型選取相應的單元:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出價策略數量限制 | 「類型」時必填是「Display」或「影片」或「音訊」 | float | 是 | 設定「不要超過」千次曝光出價金額。如果值為 0,則「請勿超過」尚未啟用。只有在出價策略為「最小化」、「最大」時才能使用或「Beat」。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
廣告素材分配 | 否 | string, list | 是 | 要指派給項目的廣告素材 ID 清單。清單格式 = (Creative.common_data.id;Creative.common_data_id;etc.)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定地理區域 - 包含 | 否 | string, list | 是 | 要納入指定目標的地理區域清單。清單格式 = (GeoLocation.id、GeoLocation.id;等等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定地理區域 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的地理區域清單。清單格式 = (GeoLocation.id;GeoLocation.id 等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定語言 - 包含 | 否 | string, list | 是 | 要納入指定目標的語言清單。清單格式 = (Language.id;Language.id;等等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定語言 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的語言清單。清單格式 = (Language.id;Language.id;等等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定裝置 - 包含 | 否 | string, list | 是 | 要納入指定目標的裝置清單。清單格式 = (Device 條件.id;Device 條件.id;等等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定裝置 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的裝置清單。清單格式 = (Device 條件.id;Device 條件.id;等等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定瀏覽器 - 包含 | 否 | string, list | 是 | 要納入指定目標的瀏覽器清單。清單格式 = (Browser.id、Browser.id;等等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定瀏覽器 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的瀏覽器清單。清單格式 = (Browser.id、Browser.id;等等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
品牌安全標籤 | 否 | string, list | 是 | 要指定的數位內容標籤清單。名單格式 = (G;PG 等)。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
品牌安全敏感度設定 | 否 | 字串 | 是 | 選擇靈敏度設定,即可根據周圍內容的主題封鎖廣告空間。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
品牌安全自訂設定 | 「品牌安全自訂設定」時為必填是「使用自訂」 | string, list | 是 | 如果「品牌安全敏感度」設定設為「使用自訂」,請指定標準內容分類項清單。例如 (成人;酒精飲料;菸草等)。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
第三方驗證服務 | 否 | 字串 | 是 | 第三方驗證服務供應商。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
第三方驗證標籤 | 否 | string, list | 是 | 如果第三方驗證服務不是「無」,請指定所選供應商支援的標籤清單。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定頻道 - 包含 | 否 | string, list | 是 | 要納入指定目標的管道清單。清單格式 = (UniversalChannel.id;UniversalChannel.id 等等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定頻道 - 排除 | 否 | string, list | 是 | 要納入指定目標的管道清單。清單格式 = (UniversalChannel.id;UniversalChannel.id 等等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定網站 - 包含 | 否 | string, list | 是 | 要納入指定目標的網站清單。如果在「通用網站」表格中找不到,清單可包含一組網站 ID 或網址字串。清單格式 = (UniversalSite.Id;'http://someurl.com';etc.)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定網站 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的網站清單。如果在「通用網站」表格中找不到,清單可包含一組網站 ID 或網址字串。清單格式 = (UniversalSite.Id;'http://someurl.com';etc.)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
應用程式指定目標 - 包含 | 否 | string, list | 是 | 要納入指定目標的應用程式清單。如果「通用網站」表格中沒有找到這組 ID,清單則可包含一組 UniversalSite ID 或應用程式套件的字串。清單格式 = (UniversalSite.Id; 'some.app.package';etc.)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
應用程式指定目標 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的應用程式清單。如果「通用網站」表格中沒有找到這組 ID,清單則可包含一組 UniversalSite ID 或應用程式套件的字串。清單格式 = (UniversalSite.Id; 'some.app.package';etc.)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定類別 - 包含 | 否 | string, list | 是 | 來自「AdX 產業 ID」的指定目標類別清單。清單格式 = (Verticals.Id;Verticals.Id;etc.)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定類別 - 排除 | 否 | string, list | 是 | 要從「AdX 產業 ID」中排除的類別清單。清單格式 = (Verticals.Id;Verticals.Id;etc.)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定關鍵字 - 包含 | 否 | string, list | 是 | 要納入指定目標的關鍵字字串清單。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定關鍵字 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的關鍵字字串清單。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定目標對象 - 類似目標對象 | 「類型」時必填是「Display」或「影片」或「音訊」 | 字串 | 是 | 針對明確指定的第一方名單啟用類似目標對象。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定目標對象 - 包含 | 否 | 字串,配對清單 | 是 | 要納入指定目標的目標對象名單。對於第一方目標對象名單,每個目標對像都會列為一組 UserList ID 和回訪率設定。組合為 (1;1d;),其中 1d 是代表 1 天回訪率的取樣率範例。第三方目標對象無法使用回訪率,因此名單格式為 (3;);(4;);。收件者和「或」請根據以下這個例子找出目標對象群組,如要合併與未回訪率的組合,請按照下列步驟操作:'((1;1d;);(2;365d;));(3;);(4;5m;);(5;all;));'。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定目標對象 - 排除 | 否 | 字串,配對清單 | 是 | 要在指定目標中排除的目標對象名單。如果目標對象名單為第一方目標對象名單,則每個目標對像都會採用一對 UserList ID 和回訪率設定。組合為 (1;1d;),其中 1d 是代表 1 天回訪率的取樣率範例。然而,第三方目標對象無法使用回訪率,因此名單格式為 (3;);(4;);。清單格式= (UserList.id;回訪率選用;);(UserList.id; recency 選用;); 例如:「(1;1d;);(2;);". 有效的回訪率值如下: all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 6h, 12h, 1d, 1d, 5d, 2d, 4d, 2d, 4d, 2d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 2;);(2;);" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
興趣相似 &潛在目標消費者定位 - 包含 | 否 | string, list | 是 | 要納入的興趣相似目標對象和/或潛在目標消費者名單清單。名單格式= 使用者清單 ID;使用者名單 ID; | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
興趣相似 &潛在目標消費者指定目標 - 排除 | 否 | string, list | 是 | 要排除的興趣相似目標對象和/或潛在目標消費者名單清單。名單格式= 使用者清單 ID;使用者名單 ID; | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
自訂興趣相似目標對象指定 | 否 | string, list | 是 | 要指定的自訂名單清單。名單格式= 使用者清單 ID;使用者名單 ID; | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
廣告空間來源指定目標 - 包含 | 「類型」時必填是「Display」或「影片」或「音訊」 | string, list | 是 | 要納入指定目標的廣告空間清單。清單格式 = (InventorySource.id; InventorySource.id;)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定廣告空間來源 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的廣告空間清單。清單格式 = (InventorySource.id; InventorySource.id;)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定時段 | 否 | string, list | 是 | 介於 0 到 95 之間的整數,代表 15 分鐘 start <end 如果是新實體,時間則會以使用者的時區 (即「當地」)。現有實體的時區不會變更。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定環境 | 「類型」時必填是「Display」或「影片」或「音訊」 | string, list | 是 | 要指定的環境清單。清單格式 = (電腦版網站、行動應用程式等)。 多媒體廣告環境:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定 Active View 的可視度 | 否 | 字串 | 是 | 指定預測可視度百分比。百分比會以浮點值表示。可能是 {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定可視度 - 包含 | 否 | 字串 | 是 | 指定廣告排序。選取下列其中一個值,或完全不選取任何值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定可視度 - 排除 | 否 | 字串 | 是 | 在指定目標中排除廣告位置。選取下列其中一個值,或完全不選取任何值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
影片廣告位置指定目標 | 否 | string, list | 是 | 要指定的影片廣告位置清單。選取一個或多個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
影片播放器大小指定目標 | 否 | string, list | 是 | 要指定的影片廣告播放器大小清單。選取一個或多個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定客層性別 | 否 | string, list | 是 | 要指定的性別清單。選取一個或多個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定客層年齡層 | 否 | string, list | 是 | 指定使用者年齡層。選取一個「從年齡」和「從年齡」一個「到年齡」,並選擇是否要納入未知年齡的 true/false,藉此指定介於/寄送範圍。查看可接受的年齡範圍清單。 範例 1:如要指定 18 到 55 歲並納入未知年齡,請指定以下格式:{From;收件者:包含 Unknown True/False} = 18;55;true; 範例 2:如果只指定年滿 35 歲的使用者,但排除不明的年齡層,請指定下列 = 35;+;false;。 可接受的「寄件者」值:
以下為可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
連線速度指定 | 否 | 字串 | 是 | 指定特定連線速度。選取下列其中一個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定通訊業者 - 包含 | 否 | string, list | 是 | 要指定的網際網路服務供應商或電信業者清單。清單格式 = {ISP.id;ISP.id;} | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定通訊業者 - 排除 | 否 | string, list | 是 | 要排除的網際網路服務供應商或電信業者清單。清單格式 = {ISP.id;ISP.id;} | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 行動出價調整幅度選項 | 否 | 字串 | 是 | 可以是「提高」或「調低」
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 行動出價調整幅度百分比 | 否 | 整數 | 是 | 出價調整幅度,可提高廣告在行動裝置上放送的機率。出價調整幅度選項為「提高」可採用的調整幅度:[0;900%];以及「降低」的值:[0;90%] 或 100% | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 排除類別指定目標 | 否 | string, list | 是 | 要排除的類別清單。名單格式 = 遊戲;悲劇和衝突;其他
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 廣告空間來源指定目標 | 否 | string, list | 是 | 要納入的 TrueView 廣告空間來源清單
|