如要瞭解格式,請參閱總覽。
欄位 | 必填 | 類型 | 可寫入 | 說明 |
---|---|---|---|---|
產品 ID | 否 | 整數 | 否 | 媒體產品的數字 ID 值。 |
企劃書 ID | 否 | 整數 | 否 | 媒體提案的數字 ID 值。 |
廣告活動 ID | 否 | 整數 | 否 | |
名稱 | 是 | 字串 | 是 | 項目的名稱。 |
類型 | 否 | 字串 | 否 | 媒體產品類型。
|
開始日期 | 否 | 字串 | 否 | 媒體產品的開始日期,格式為 MM/DD/YYYY HH:mm |
結束日期 | 否 | 字串 | 否 | 媒體產品的結束日期,格式為 MM/DD/YYYY HH:mm |
預算 | 否 | float | 否 | 媒體產品的正數預算金額。由於一律為貨幣預算,因此一律為貨幣金額的浮點數。貨幣會以廣告主的貨幣顯示,並以標準單位表示 (而非以貨幣單位的 1/1,000,000 表示) |
已啟用展示頻率 | 是 | 字串 | 是 | |
頻率曝光次數 | 「Frequency Enabled」為「TRUE」時為必填 | 整數 | 是 | 特定頻率金額的曝光次數,須為正整數,也就是「在 y 期間內顯示 x 次曝光」中的 x。 |
頻率週期 | 「Frequency Enabled」為「TRUE」時為必填 | 字串 | 是 |
|
頻率金額 | 「Frequency Enabled」為「TRUE」時為必填 | 整數 | 是 | |
指定地理區域 - 納入 | 否 | 字串、清單 | 是 | 要納入指定目標的地理區域清單。 這個資料欄會使用 Display & Video 360 API 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。 |
指定語言 - 納入 | 否 | 字串、清單 | 是 | 要納入指定目標的語言清單。 這個資料欄會使用 Display & Video 360 API 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。 |
指定語言 - 排除 | 否 | 字串、清單 | 是 | 要從指定目標中排除的語言清單。 這個資料欄會使用 Display & Video 360 API 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。 |
指定頻道 - 納入 | 否 | 字串、清單 | 是 | 要納入指定目標的頻道清單。 這個資料欄會使用 Display & Video 360 API 清單格式 = (Channel.channelId; Channel.channelId; etc.)。 |
頻道指定目標 - 排除 | 否 | 字串、清單 | 是 | 要從指定目標中排除的頻道清單。 這個資料欄會使用 Display & Video 360 API 清單格式 = (Channel.channelId; Channel.channelId; etc.)。 |
指定類別 - 納入 | 否 | 字串、清單 | 是 | 要納入指定目標的類別清單。這個資料欄會使用 Display & Video 360 API 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。 |
指定類別 - 排除 | 否 | 字串、清單 | 是 | 要從指定目標中排除的類別清單。這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID,指定目標類型為 TARGETING_TYPE_CATEGORY 。清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。 |
指定目標對象 - 納入 | 否 | 字串、成對清單的清單 | 是 | 要納入指定目標的目標對象名單清單。 這個資料欄會使用 Display & Video 360 API 如果是第一方目標對象名單,每個目標對象都會列為一組 FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 和回訪率設定。一對是 (1;1d;),其中 1d 是代表 1 天近期的樣本近期。第三方目標對象無法使用近期搜尋,因此名單格式為 (3;);(4;);。如要「AND」和「OR」目標對象群組,請參考以下範例:如要合併有和沒有近期性限制的配對,請使用「((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));」。也就是說,(名單 1,近期 1 天內曾造訪網站的使用者 OR 名單 2,近期 365 天內曾造訪網站的使用者) AND (名單 3,未指定近期造訪網站的使用者 OR 名單 4,近期 5 分鐘內曾造訪網站的使用者 OR 名單 5,所有使用者)。 有效近來性值如下:
|
指定目標對象 - 排除 | 否 | 字串、成對清單的清單 | 是 | 要在指定目標中排除的目標對象名單。 這個資料欄會使用 Display & Video 360 API 如果目標對象名單是第一方目標對象名單,則每個目標對象都會列為 FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 和回訪率設定的配對。一對是 (1;1d;),其中 1d 是代表 1 天近期的樣本近期。不過,第三方目標對象無法使用回訪率,因此名單格式為 (3;);(4;);。 名單格式 = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);) 有效近來性值如下:
|
興趣相似目標對象和潛在目標消費者指定目標 - 納入 | 否 | 字串、清單 | 是 | |
興趣相似目標對象和潛在目標消費者指定目標 - 排除 | 否 | 字串、清單 | 是 | |
指定客層性別 | 否 | 字串、清單 | 是 | 要指定的性別清單。選取一或多個可接受的值:
|
指定客層年齡 | 否 | 字串、清單 | 是 | 指定使用者年齡範圍。選取單一年齡下限和單一年齡上限,然後選取是否要納入不明年齡 (true/false),即可指定範圍。請參閱可接受的「開始」/「結束」年齡清單。 範例 1:如要指定 18 至 55 歲的使用者,並納入不明年齡,請指定格式 {From; To ; Include unknown True/False} = 18;55;true; 範例 2:如要只指定 35 歲以上的使用者,並排除不明年齡,請指定以下格式 = 35;+;false;。 「開始」可接受的值:
「收件者」可接受的值:
|
指定客層:家長狀態 | 是 | 字串、清單 | 是 | 要指定的家長狀態清單。選取一或多個可接受的值。
|
指定裝置 - 納入 | 否 | 字串、清單 | 是 | 要納入指定目標的裝置清單。 這個資料欄會使用 Display & Video 360 API
清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。 |
影片播放器大小指定目標 | 否 | 字串、清單 | 是 | 要指定的影片廣告播放器大小清單。選取一或多個可接受的值:
|
私人 - 賣方名稱 | 否 | 字串 | 否 | 交易中的發布商名稱。這個欄位僅適用於私人媒體產品。 |
私人 - 訂單 ID | 否 | 字串 | 否 | 保證交易的訂單 ID。這個欄位僅適用於私人媒體產品。 |
私人 - 廣告空間來源 ID | 否 | 字串 | 否 | 廣告空間來源的 DBM ID。這個欄位僅適用於私人媒體產品。 |