如需格式的相關說明,請參閱總覽。
欄位 | 必填 | 類型 | 可寫入 | 說明 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
委刊項 ID | 只有在編輯現有委刊項時才需要 | 整數 | 否 | 委刊項的數字 ID 值。如果留空,系統會建立新委刊項並指派專屬 ID。必要時,您可以在建立新委刊項時使用自訂 ID,將 TrueView 廣告群組指派給新的委刊項。自訂 ID 的格式為「ext[自訂 ID]」,例如 ext123。檔案上傳並處理完畢後,系統就會將所有自訂 ID 替換成 DBM 指派的 ID,並根據自訂 ID 為物件建立關聯 (例如,從廣告群組至委刊項)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Io ID | 是 | 整數 | 否 | 廣告訂單的數字 ID 值。如果您建立的是這個委刊項,而且建立的是廣告訂單,您可以為該廣告訂單指定自訂 ID (例如「ext[自訂 IO ID]」)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Io 名稱 | 否 | 字串 | 否 | 廣告訂單名稱 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
類型 | 是 | 字串 | 是 | 項目類型。只能在建立時寫入,而非編輯。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
子類型 | 是 | 字串 | 是 | 委刊項的必填欄位,用於區分不同格式
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
名稱 | 是 | 字串 | 是 | 項目名稱。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
時間戳記 | 編輯現有項目時必填 | 整數 | 否 | 項目的時間戳記,由系統用於驗證該項目從下載和上傳期間的未變更。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
狀態 | 是 | 字串 | 是 | 項目的狀態設定。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
開始日期 | 是 | 字串 | 是 | 項目檔期開始日期的時間戳記,格式為 MM/DD/YYYY 或「與廣告訂單相同」使用與上層廣告訂單相同的開始日期。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
結束日期 | 是 | 字串 | 是 | 項目檔期結束日期的時間戳記,格式為 MM/DD/YYYY 或「與廣告訂單相同」使用與上層廣告訂單相同的結束日期。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
預算類型 | 是 | 字串 | 是 | 指定預算是以金額或曝光為基礎。如果這個項目的 IO 已啟用自動預算分配功能,您可以將其設為「自動」允許 DBM 自動為這個項目預算。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
預算金額 | 「類型」時必填是「Display」或「影片」或「音訊」 | float | 是 | 這個預算類型的預算金額為正值。這可以是簡單的整數曝光值,也可以是貨幣金額的浮點值。貨幣會以廣告客戶的貨幣單位顯示,而不是以 1/1,000,000s 的貨幣單位顯示。若為「自動」預算分配功能已設定所需項目,您可以指定最低支出金額 (例如「支出至少」這個金額)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
使用速度 | 是 | 字串 | 是 | 用於支出使用速度金額的時間範圍。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
使用速度 | 是 | 字串 | 是 | 這個項目的使用速度速率。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
使用速度金額 | 「類型」時必填是「Display」或「影片」或「音訊」「類型」時必填為「TrueView」和「使用速度」是「每日」 | 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」或「影片」或「音訊」或「TrueView」 | 字串 | 是 | 選擇要納入計算的轉換類型。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
轉換計數位置 | 「類型」時必填是「Display」或「影片」或「音訊」或「TrueView」 | float | 是 | 指定「計數 %」的百分比轉換計數類型。將 % 的格式設定為一個浮點值 (3.123% = 3.123),且精度設有千位數 (小數點後 3 位)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
轉換 Floodlight 活動 ID | 否 | string, 清單清單 | 是 | 用於轉換及相關設定的 Floodlight 活動。 此欄使用「多媒體和」Video 360 API 清單格式清單 = ((FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);(FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;); | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
主要歸因模式 ID | 否 | 整數 | 是 | 相關委刊項使用的歸因模式 ID。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
費用 | 否 | string, 清單清單 | 是 | 這個項目的所有費用。清單格式 = (費用類別;費用金額;費用類型;開立發票);
例如「(千次曝光出價;2;Display & Video 360 費用;錯誤)」;(Media;13;Default;True);
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
整合代碼 | 否 | 字串 | 是 | 用於追蹤的選用程式碼。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
詳細資料 | 否 | 字串 | 是 | 以字串格式輸入項目詳細資料。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出價策略類型 | 「類型」時必填是「Display」或「影片」或「音訊」 | 字串 | 是 | 選取其中一個適用的出價策略:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出價策略價值 | 除非「出價策略類型」為必填欄位是「最小化」、「最大化」或「類型」為「TrueView」 | float | 是 | 請選擇「最佳化千次可視曝光出價」或「固定策略」類型做為目標出價。 請注意,「最小化」出價策略類型不需要出價策略值或「最大化」 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出價策略單位 | 「出價策略類型」為必填欄位是「Beat」「最小化」或「最大化」 | 字串 | 是 | 為「節奏」、「最小化」或「最大化」策略類型選取相應的單元:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出價策略數量限制 | 「類型」時必填是「Display」或「影片」或「音訊」 | float | 是 | 設定「不要超過」千次曝光出價金額。如果值為 0,則「請勿超過」尚未啟用。只有在出價策略為「最小化」、「最大」時才能使用或「Beat」。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
套用交易底價 | 「出價策略類型」為必填欄位是「最小化」或「最大化」 | 字串 | 是 | 是否優先處理交易,而非公開競價廣告空間
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
演算法 ID | 「出價策略單位」為必填欄位自訂曝光次數價值/費用。 | 整數 | 是 | 將出價策略單元設為自訂曝光次數時,必須使用這個對應的演算法 ID。成本/費用。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
廣告素材分配 | 否 | string, list | 是 | 指派給項目的廣告素材 ID 清單。 此欄使用「多媒體和」Video 360 API 清單格式 = (Creative.creativeId、Creative.creativeId 等)。這份清單會依遞增順序產生。 上傳時,使用者也可以加入 Campaign Manager 360 刊登位置 ID。刊登位置 ID 的前面應加上「CM」字母,例如「CM789」。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定地理區域 - 包含 | 否 | string, list | 是 | 要納入指定目標的地理區域清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定地理區域 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的地理位置清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定地理區域地區位置清單 - 包含 | 否 | string, list | 是 | 要納入的地理區域地區清單 ID 清單。清單格式 = (11; 22; 33;)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定地理位置區域清單 - 排除 | 否 | string, list | 是 | 要排除的地理區域位置清單 ID 清單。清單格式 = (11; 22; 33;)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定鄰近目標 | 否 | string, 清單清單 | 是 | 鄰近目標清單,格式為「(Latitude; Longitude; Radius; Unit; FullAddress;);」。緯度介於 -90 到 90 度 (含) 之間;經度介於 -180 度到 180 度 (含) 之間。半徑是指單位中的 1 到 500 (含) 之間的距離;單位可以是「mi」或「公里」;FullAddress 為選用項目。例如:「(38.907192; -77.03687; 1.0; mi; Washington D.C.,美國哥倫比亞特區;(40.712775; -74.005972; 20.5; km; 40.712775, -74.005972;);(20.000234; -56.675423; 5.0; mi; ;);。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定鄰近地區清單 | 否 | string, 清單清單 | 是 | 廣告訂單或非 TrueView 委刊項的鄰近清單目標清單,格式為「(ProximityListId; Radius; Unit; );」。ProximityListId 是廣告客戶資源下的一個位置清單編號。半徑是指單位中的 1 到 500 (含) 之間的距離;單位可以是「mi」或「公里」;每個實體都不能指定兩個地點清單,此外還有地理位置地區清單。例如:「(10041691678; 20.0; mi;);(10038858567; 20.5; km;);"。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定語言 - 包含 | 否 | string, list | 是 | 要納入指定目標的語言清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定語言 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的語言清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定裝置 - 包含 | 否 | string, list | 是 | 要納入指定目標的裝置清單。 此欄使用「多媒體和」以下指定類型的 Video 360 API
名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定裝置 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的裝置清單。 此欄使用「多媒體和」以下指定類型的 Video 360 API
名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定瀏覽器 - 包含 | 否 | string, list | 是 | 要納入指定目標的瀏覽器清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定瀏覽器 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的瀏覽器清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
數位內容標籤 - 排除 | 否 | string, list | 是 | 要排除的數位內容標籤清單。名單格式 = (G;PG 等)。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
品牌安全敏感度設定 | 否 | 字串 | 是 | 選擇靈敏度設定,即可根據周圍內容的主題封鎖廣告空間。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
品牌安全自訂設定 | 「品牌安全自訂設定」時為必填是「使用自訂」 | string, list | 是 | 如果「品牌安全敏感度」設定設為「使用自訂」,請指定標準內容分類項清單。例如 (情色;酒精飲料;菸草等)。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
第三方驗證服務 | 否 | 字串 | 是 | 第三方驗證服務供應商。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
第三方驗證標籤 | 否 | string, list | 是 | 如果第三方驗證服務不是「無」,請指定所選供應商支援的標籤清單。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定頻道 - 包含 | 否 | string, list | 是 | 要納入指定目標的頻道清單。 此欄使用「多媒體和」Video 360 API 清單格式 = (Channel.channelId、Channel.channelId 等等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定頻道 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的頻道清單。 此欄使用「多媒體和」Video 360 API 清單格式 = (Channel.channelId、Channel.channelId 等等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定網站 - 包含 | 否 | string, list | 是 | 要納入指定目標的網站清單。這份清單是網址字串。 清單格式 = (someurl.com、someurltwo.com 等)。這份清單會依字母順序遞增。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定網站 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的網站清單。這份清單是網址字串。 清單格式 = (someurl.com、someurltwo.com 等)。這份清單會依字母順序遞增。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
應用程式指定目標 - 包含 | 否 | string, list | 是 | 要納入指定目標的應用程式清單。這份清單包含應用程式平台和應用程式平台 ID 的串連字串。 以下值可用於定義應用程式平台:
應用程式平台和 ID 的串聯字串以半形冒號分隔,例如: 清單格式 = (APP:com.google.android.gm、APP:422689480; 等等)。這份清單會依字母順序遞增。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
應用程式指定目標 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的應用程式清單。這份清單包含應用程式平台和應用程式平台 ID 的串連字串。 以下值可用於定義應用程式平台:
應用程式平台和 ID 的串聯字串以半形冒號分隔,例如: 清單格式 = (APP:com.google.android.gm、APP:422689480; 等等)。這份清單會依字母順序遞增。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
應用程式組合指定目標 - 包含 | 否 | string, list | 是 | 要納入指定目標的應用程式組合清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
應用程式組合指定目標 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的應用程式組合清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定類別 - 包含 | 否 | string, list | 是 | 要納入指定目標的類別清單。此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定類別 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的類別清單。此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_CATEGORY 的資源 ID。名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定內容類型 - 包含 | 否 | string, list | 是 | 要納入指定目標的內容類型清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定內容類型 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的內容類型清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定關鍵字 - 包含 | 否 | string, list | 是 | 要納入指定目標的關鍵字字串清單。 這份清單會依字母順序遞增。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定關鍵字 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的關鍵字字串清單。 這份清單會依字母順序遞增。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定關鍵字清單 - 排除 | 否 | string, list | 是 | 要在指定目標中排除的排除關鍵字清單。 此欄使用「多媒體和」Video 360 API 清單格式 = (negativeKeywordList. negativeKeywordListId; ExcludeKeywordList. negativeKeywordListId; 等等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
最佳化指定目標對象 | 否 | 字串 | 是 | 啟用最佳化指定目標對像功能。
自 2024 年 9 月 30 日起,最佳化指定目標對像功能將不再支援特定出價策略。這個值將從「TRUE」更新設為「FALSE」如果:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定目標對象 - 包含 | 否 | 字串,配對清單 | 是 | 要納入指定目標的目標對象名單清單。 此欄使用「多媒體和」Video 360 API 如果是第一方目標對象名單,每個目標對像都會列為一組第一方目標對象。firstAndThirdPartyAudienceId 和回訪率設定。組合為 (1;1d;),其中 1d 是代表 1 天回訪率的取樣率範例。第三方目標對象無法使用回訪率,因此名單格式為 (3;);(4;);。收件者和「或」目標對象群組,請按照以下範例操作:如要合併與/不含回訪率的組合:'(1;1d;);(2;365d;));(3;);(3;);(4;5m;);(5;all;));'。亦即名單 1 的回訪率是 1 或名單 2,回訪率為 365 天。 有效的回訪率值如下:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定目標對象 - 排除 | 否 | 字串,配對清單 | 是 | 要在指定目標中排除的目標對象名單。 此欄使用「多媒體和」Video 360 API 如果目標對象名單為第一方目標對象名單,則每個目標對像都會採用一組 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和回訪率設定。組合為 (1;1d;),其中 1d 是代表 1 天回訪率的取樣率範例。然而,第三方目標對象無法使用回訪率,因此名單格式為 (3;);(4;);。 名單格式 = ((FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; Recency optional;); (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; Recencyoptional;);) 有效的回訪率值如下:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
興趣相似 &潛在目標消費者指定目標 - 包含 | 否 | string, list | 是 | 要納入的興趣相似目標對象和/或潛在目標消費者名單。 您可以從多媒體廣告和Video 360 介面。 名單格式 = (目標對象 ID、目標對象 ID 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
興趣相似 &潛在目標消費者指定目標 - 排除 | 否 | string, list | 是 | 要排除的興趣相似目標對象和/或潛在目標消費者名單。 您可以從多媒體廣告和Video 360 介面。 名單格式 = (目標對象 ID、目標對象 ID 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
合併指定目標對象 | 否 | string, list | 是 | 要指定的合併目標對象名單清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定自訂名單 | 否 | string, list | 是 | 要指定的自訂名單清單。 此欄使用「多媒體和」Video 360 API 清單格式 = (CustomList.customListId、CustomList.customListId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
廣告空間來源指定目標 - 授權賣方選項 | 「類型」時必填是「Display」或「影片」或「音訊」 | 字串 | 是 | 設為指定授權直接賣方、授權直接賣方和經銷商,或是授權賣方 + 未知。「授權直接交易」這表示系統只會指定授權賣方「授權直接賣方和經銷商」意即指定授權賣方和經銷商。「授權發布商和未參與計畫的發布商」因此會指定授權賣方、經銷商和不明賣方。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
廣告空間來源指定目標 - 包含 | 「類型」時必填是「Display」或「影片」或「音訊」 | string, list | 是 | 列出要納入指定目標的廣告空間來源、廣告交易平台和子廣告交易平台。 此欄使用「多媒體和」Video 360 API 清單格式 = (InventorySource.inventorySourceId; ExchangeId; TargetingOption.targetingOptionId; 等) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定廣告空間來源 - 排除 | 否 | string, list | 是 | 指定要在指定目標中排除的廣告空間來源、廣告交易平台和子廣告交易平台清單。 此欄使用「多媒體和」Video 360 API 清單格式 = (InventorySource.inventorySourceId; ExchangeId; TargetingOption.targetingOptionId; 等) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
廣告空間來源指定目標 - 指定新廣告交易平台 | 否 | 字串 | 是 | 設定指定新廣告交易平台。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
包含私人交易群組指定目標 | 否 | string, list | 是 | 要納入指定目標的分組交易 ID 清單。如要查看分組交易 ID,請前往「我的廣告空間」頁面的「分組交易」專區,或是委刊項、廣告訂單和廣告活動中的「廣告空間來源」設定「群組」專區。 清單格式 = (DealGroupId、DealGroupId 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定時段 | 否 | string, list | 是 |
這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
時段指定時區 | 「指定時段」時為必填已包含在內。 | 字串 | 是 | 指定時段時使用的時區。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定環境 | 否 | 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 | 是 | 要指定的音訊廣告素材位置。選取一個或多個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
影片播放器大小指定目標 | 否 | string, list | 是 | 要指定的影片廣告播放器大小清單。選取一個或多個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定內容時間長度 | 否 | string, list | 是 | 要指定的內容時間長度清單。單位值為分鐘。選取一個或多個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定內容串流類型 | 否 | 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 | 是 | 指定家庭收入範圍。您可以選取一個「Top_of_Range 收入範圍」和一個 Bottom_of_Range 收入範圍,藉此指定「介於/到」範圍,以及是否納入收入不明為 true/false 的家庭。請查看可接受的 Top_of_Range/Bottom_of_Range 範圍清單。 範例 1:指定收益前 10% 到 50% 的家庭,並納入收入不明的家庭;請指定 {Top_of_Range;Bottom_of_Range;包含不明 True/False 值} = 前 10%;41-50%;true; 範例 2:如果只指定低收入的 50% 家庭,並排除收入不明的家庭,請指定 {Top_of_Range;Bottom_of_Range;包含不明 True/False 值} = 低於 50%;低於 50%;true; Top_of_Range/Bottom_of_Range 的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定客層家長狀態 | 是 | string, list | 是 | 要指定的家長狀態清單。選取一個或多個可接受的值。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
連線速度指定 | 否 | 字串 | 是 | 指定特定連線速度。選取下列其中一個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定通訊業者 - 包含 | 否 | string, list | 是 | 要指定的網際網路服務供應商 (ISP) 或通訊業者清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
指定通訊業者 - 排除 | 否 | string, list | 是 | 要排除的網際網路服務供應商 (ISP) 或電信業者清單。 此欄使用「多媒體和」Video 360 API 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出價調節係數 | 否 | string, 清單清單 | 是 | 這個項目的所有出價調節係數。清單格式 = (列類型;條件 ID;出價調節係數值);(列類型;條件 ID;出價調節係數值);出價調節係數值必須介於 0.1 和 10.0 之間。下表列出可接受的資料列類型,以及對應的條件 ID:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 影片廣告格式 | 對 TrueView 委刊項來說是 | 字串 | 是 | 委刊項的影片廣告格式。 串流內 / 動態內影片屬於按單次收視出價銷售的 TrueView 影片廣告類型。串流內 / 串場廣告是 TrueView 影片廣告類型,以千次曝光出價為依據。串場廣告的長度不超過 6 秒,且以千次曝光出價為依據銷售的影片廣告。不可略過的影片廣告是介於 6 到 15 秒之間的串流內廣告,可根據千次曝光出價銷售。串流內 / 串場廣告 / 不可略過的影片廣告可接受 TrueView 影片廣告類型,適用於以千次曝光出價為依據銷售的目標頻率委刊項。回應式影片廣告是可支援多種格式的廣告。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 出價策略類型 | 對 TrueView 委刊項來說是 | 字串 | 是 | 選取下列其中一個適用的 TrueView 出價策略:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 出價策略值 | 對 TrueView 委刊項來說是 | float | 是 | 請為「目標單次轉換出價」或「目標廣告投資報酬率」出價策略類型選擇目標出價的值。其他「TrueView 出價策略類型」值或非 TrueView 委刊項;上傳時,這個資料欄應為 0。採用「目標廣告投資報酬率」出價策略時,這個資料欄應以分數表示百分比。舉例來說,假設您要將目標廣告投資報酬率設為 150%,請在這一欄中輸入「1.5」。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 行動出價調整幅度選項 | 否 | 字串 | 是 | 可以是「提高」或「調低」
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 行動出價調整幅度百分比 | 如果 TrueView 出價策略類型為「目標單次轉換出價」或「盡量爭取轉換」時為「是」 | 整數 | 是 | 出價調整幅度,可提高廣告在行動裝置上放送的機率。出價調整幅度選項為「提高」可採用的調整幅度:[0;900%];以及「減少」:[0;90%] 或 100%。 如果 TrueView 出價策略類型為「目標單次轉換出價」或 100%,則可用出價調整幅度為「提高」的出價調整幅度:0;而「減少」:100% | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 桌機出價調整幅度選項 | 否 | 字串 | 是 | 可以是「提高」或「調低」
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 桌機出價調整幅度百分比 | 如果 TrueView 出價策略類型為「目標單次轉換出價」或「盡量爭取轉換」時為「是」 | 整數 | 是 | 出價調整幅度,提高廣告在桌機上顯示的機率。出價調整幅度選項為「提高」可採用的調整幅度:[0;900%];以及「減少」:[0;90%] 或 100%。 如果 TrueView 出價策略類型為「目標單次轉換出價」或 100%,則可用出價調整幅度為「提高」的出價調整幅度:0;而「減少」:100% | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 平板電腦出價調整幅度選項 | 否 | 字串 | 是 | 可以是「提高」或「調低」
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 平板電腦出價調整幅度百分比 | 如果 TrueView 出價策略類型為「目標單次轉換出價」或「盡量爭取轉換」時為「是」 | 整數 | 是 | 出價調整幅度,提高廣告在平板電腦上顯示的機會。出價調整幅度選項為「提高」可採用的調整幅度:[0;900%];以及「減少」:[0;90%] 或 100%。 如果 TrueView 出價策略類型為「目標單次轉換出價」或 100%,則可用出價調整幅度為「提高」的出價調整幅度:0;而「減少」:100% | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 連網電視出價調整幅度選項 | 否 | 字串 | 是 | 可以是「提高」或「調低」
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 連網電視出價調整幅度百分比 | 如果 TrueView 出價策略類型為「目標單次轉換出價」或「盡量爭取轉換」時為「是」 | 整數 | 是 | 出價調整幅度,可提高廣告在連網電視上放送的機率。出價調整幅度選項為「提高」可採用的調整幅度:[0;900%];以及「減少」:[0;90%] 或 100%。 如果 TrueView 出價策略類型為「目標單次轉換出價」或 100%,則可用出價調整幅度為「提高」的出價調整幅度:0;而「減少」:100% | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 排除類別指定目標 | 否 | string, list | 是 | 要排除的類別清單。名單格式 = 遊戲;悲劇和衝突;等。 自 2024 年 9 月 30 日起,這個資料欄將不再提供下列選項:「內嵌影片」、「直播」、「所有觀眾」、「學齡前兒童」、「青少年」、「成人」和「未分級」。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 內容篩選器 | 否 | 字串 | 是 | TrueView 內容篩選器。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 廣告空間來源指定目標 | 否 | string, list | 是 | 要納入的 TrueView 廣告空間來源清單
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方可視度供應商 | 編輯現有 TrueView 委刊項時才需要 | string, 清單清單 | 是 | 評估 TrueView 委刊項可視度的第三方供應商。如果在建立 TrueView 委刊項時留空,且已在廣告客戶層級啟用預設的可視度供應商,系統將在建立委刊項時啟用廣告客戶層級預設供應商。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方可視度報表 ID | 如果第三方可視度供應商不是「無」,則為是。 | 字串 | 是 | 第三方可視度供應商使用的 ID,用於識別特定報表的事件。如果此欄顯示空字串,系統就會將報表 ID 設為空白。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方品牌安全供應商 | 編輯現有 TrueView 委刊項時才需要 | string, 清單清單 | 是 | 評估 TrueView 委刊項的品牌安全的第三方供應商。如果在建立 TrueView 委刊項時將此欄位留空,且在廣告客戶層級啟用了預設的品牌安全供應商,系統將在建立委刊項時啟用廣告客戶層級的預設供應商。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方品牌安全報表 ID | 是,當第三方品牌安全供應商不是「無」時是如此。 | 字串 | 是 | 第三方品牌安全供應商使用的 ID,用來識別特定報表的事件。如果此欄顯示空字串,系統就會將報表 ID 設為空白。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方觸及率供應商 | 更新現有 TrueView 委刊項時才需要 | string, 清單清單 | 是 | 評估 TrueView 委刊項的觸及率的第三方供應商。如果在建立 TrueView 委刊項時將此欄位留空,且在廣告客戶層級啟用了預設的觸及率供應商,系統將在建立委刊項時啟用廣告客戶層級預設供應商。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方觸及報表 ID | 是,當第三方觸及供應商不是「無」時是如此。 | 字串 | 是 | 第三方觸及率供應商使用的 ID,用來識別特定報表的事件。如果此欄顯示空字串,系統就會將報表 ID 設為空白。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方品牌提升供應商 | 更新現有 TrueView 委刊項時才需要 | string, 清單清單 | 是 | 評估 TrueView 委刊項的品牌提升的第三方供應商。如果在建立 TrueView 委刊項時將此欄位留空,且廣告客戶層級已啟用預設的品牌提升供應商,系統將在建立委刊項時啟用廣告客戶層級預設供應商。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方品牌提升報表 ID | 是,但第三方品牌提升供應商不是「無」時是如此。 | 字串 | 是 | 第三方品牌提升供應商使用的 ID,用來識別特定報表的事件。如果此欄顯示空字串,系統就會將報表 ID 設為空白。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 目標頻率計數 | 是,當委刊項子類型為「目標頻率」時是 | 整數 | 是 | 針對目標頻率類型 YouTube 委刊項設定的目標頻率計數。這個欄位的值只能設為 2、3 或 4。如果是非目標頻率類型的 YouTube 委刊項,這個欄位必須留空。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 目標頻率時間範圍 | 是,當委刊項子類型為「目標頻率」時是 | 字串 | 是 | 目標頻率類型 YouTube 委刊項的目標頻率時間範圍。這個欄位目前只能設為「每週」。如果 YouTube 委刊項不是目標頻率類型,則這個欄位應留空。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 影片廣告空間控管 | 如果 TrueView 委刊項子類型為「觸及」,且使用動態內和 Shorts 廣告,則為「是」 | string, list | 是 | 這個委刊項的影片廣告空間控制項。選取一個或多個可接受的廣告格式值:
|