結構化資料 - v7 - YouTube 廣告群組

如需格式的相關說明，請參閱總覽。

欄位必填類型可寫入說明
廣告群組 ID只有在編輯現有廣告群組時才需要提供整數否廣告群組的數字 ID 值。如果留空，系統會建立一個新的廣告群組 ID，並指派專屬 ID。視需要在建立新廣告群組時，您可以使用自訂識別碼，將 TrueView 廣告指派至新的廣告群組。自訂 ID 的格式為「ext[自訂 ID]」，例如 ext123。檔案上傳並處理完畢後，系統就會將所有自訂 ID 替換成 DBM 指派的 ID，並根據自訂 ID 將物件建立關聯 (例如，廣告至廣告群組)。
委刊項 ID是整數否父項委刊項的數字 ID 值。如果您在建立這個廣告群組時建立委刊項，可以為委刊項指定自訂 ID (例如「ext<自訂委刊項 ID]」)。
委刊項名稱否字串否委刊項名稱
名稱是字串是項目名稱。
狀態是字串是項目的狀態設定。
  • 有效
  • 已暫停
  • 已刪除
影片廣告格式是字串是廣告群組的影片廣告格式。
  • 串流內廣告
  • 動態內影片
  • 串場廣告
  • 不可略過
  • 回應式
  • 有效觸及率
  • YouTube 音訊
出價是float是根據「TrueView 出價策略類型」欄中設定的出價類型，代表廣告群組最高目標出價的值。比方說，如果 TrueView 出價策略類型為「手動單次收視出價」，就是最高單次收視出價。

注意：如果 TrueView 出價策略類型為「盡量爭取轉換」、「盡量提高轉換價值」或「目標廣告投資報酬率」欄，則上傳時，此欄必須為 0。
指定關鍵字 - 包含否string, list是

要納入指定目標的關鍵字字串清單。

這份清單會依字母順序遞增。

指定關鍵字 - 排除否string, list是

要在指定目標中排除的關鍵字字串清單。

這份清單會依字母順序遞增。

指定類別 - 包含否string, list是

要納入指定目標的類別清單。此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_CATEGORY 的資源 ID。

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定類別 - 排除否string, list是要在指定目標中排除的類別清單。此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_CATEGORY 的資源 ID。

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定刊登位置 - YouTube 頻道 - 包括否string, list是要納入的 YouTube 頻道清單。
指定刊登位置 - YouTube 頻道 - 排除否string, list是要排除的 YouTube 頻道清單。
指定刊登位置 - YouTube 影片 - 包含否string, list是要包含的 YouTube 影片清單。
指定刊登位置 - YouTube 影片 - 排除否string, list是要排除的 YouTube 影片清單。
指定刊登位置 - 熱門內容 - 包括否string, list是列出 YouTube 和 Google 影片合作夥伴網站的熱門內容。選取一個或多個可接受的值：
  • youtube_popular_content::001a1
  • gvp_popular_content::global_tier2
  • video_content::&lt;ID&gt;
指定刊登位置 - 網址 - 包含否string, list是要納入的網址清單。
指定刊登位置 - 網址 - 排除否string, list是要排除的網址清單。
指定刊登位置 - 應用程式 - 包含否string, list是要納入的行動應用程式清單。
指定刊登位置 - 應用程式 - 排除否string, list是要排除的行動應用程式清單。
指定刊登位置 - 應用程式組合 - 包含否string, list是要納入指定目標的應用程式組合清單。清單格式= 應用程式集合 ID；應用程式集合 ID；
指定刊登位置 - 應用程式組合 - 排除否string, list是要排除在指定目標中的應用程式組合清單。清單格式= 應用程式集合 ID；應用程式集合 ID；
指定客層性別是string, list是要指定的性別清單。選取一個或多個可接受的值：
  • 女性
  • 男性
  • 不明
指定客層年齡層是string, list是要指定的年齡層清單。選取一個或多個可接受的值。
  • 18-24
  • 25-34 歲
  • 35-44 歲
  • 45-54 歲
  • 55-64
  • 65+
  • 不明
指定客層家庭收入是string, list是要指定的家庭收入清單。選取一個或多個可接受的值。
  • 前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 後 50%
  • 不明
指定客層家長狀態是string, list是要指定的家長狀態清單。選取一個或多個可接受的值。
  • 有子女
  • 無子女
  • 不明
最佳化指定目標對象否字串是啟用最佳化指定目標對像功能。
  • TRUE
  • FALSE

自 2024 年 9 月 30 日起，最佳化指定目標對像功能將不再支援特定出價策略。這個值將從「TRUE」更新設為「FALSE」如果：
  • 出價策略類型是「最佳化千次可視曝光出價」
  • 出價策略類型是「最大」和「出價策略單元」是「CIVA」、「IVO_TEN」或「AV_VIEWED」
目標對象擴展層級否整數是目標對象擴展層級。它只能設為值 0、1、2、3 的 AdGroup。
已排除目標對象擴展種子名單否字串是請啟用目標對象擴展種子名單。
  • TRUE
  • FALSE
指定目標對象 - 包含否string, list是

要納入的目標對象名單清單。

此欄使用「多媒體和」Video 360 API FirstAndThirdPartyAudience 資源 ID。

名單格式 = (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId;等等)。這份清單會依遞增順序產生。

指定目標對象 - 排除否string, list是

要排除的目標對象名單清單。

此欄使用「多媒體和」Video 360 API FirstAndThirdPartyAudience 資源 ID。

名單格式 = (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId;等等)。這份清單會依遞增順序產生。

興趣相似 &潛在目標消費者定位 - 包含否string, list是

要納入的興趣相似目標對象和/或潛在目標消費者名單。

您可以從多媒體廣告和Video 360 介面。

名單格式 = (目標對象 ID、目標對象 ID 等)。這份清單會依遞增順序產生。

興趣相似 &潛在目標消費者指定目標 - 排除否string, list是

要排除的興趣相似目標對象和/或潛在目標消費者名單。

您可以從多媒體廣告和Video 360 介面。

名單格式 = (目標對象 ID、目標對象 ID 等)。這份清單會依遞增順序產生。

指定自訂名單否string, list是

要指定的自訂名單清單。

此欄使用「多媒體和」Video 360 API CustomList 資源 ID。

清單格式 = (CustomList.customListId、CustomList.customListId; 等)。這份清單會依遞增順序產生。