結構化資料 - 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; 等)。這份清單會依遞增順序產生。