結構化資料 - v8 - 廣告群組

如要進一步瞭解格式，請參閱總覽。

欄位必填類型可寫入說明
廣告群組 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是指定排除類別的清單。這個欄位會使用 Display & Video 360 API TargetingOption 資源 ID 來指定目標類型 TARGETING_TYPE_CATEGORY。

清單格式 = (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；
指定客層性別是字串、清單是要指定的性別清單。選取一個或多個可接受的值：
  • 女性
  • 男性
  • 不明
指定客層年齡層是字串、清單是要指定的年齡層清單。選取一個或多個可接受的值。
  • 18-24
  • 25-34 歲
  • 35-44 歲
  • 45-54 歲
  • 55-64
  • 65+
  • 不明
指定客層家庭收入是字串、清單是要指定的家庭收入清單。選取一或多個可接受的值。
  • 前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 後 50%
  • 不明
指定客層家長狀態是字串、清單是要指定的家長狀態清單。選取一個或多個可接受的值。
  • 有子女
  • 無子女
  • 不明
最佳化指定目標對象否字串是啟用最佳化指定目標對像功能。
  • TRUE
  • FALSE

自 2024 年 9 月 30 日起，最佳化指定目標對像功能將不再支援特定出價策略。這個值將從「TRUE」更新設為「FALSE」如果：
  • 「出價策略類型」為「最佳化千次可視曝光出價」
  • 「出價策略類型」為「Maximum」，「出價策略單位」為「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是

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

這個欄位會使用 Display & Video 360 API FirstAndThirdPartyAudience 資源 ID。

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

指定類似目標對象 - 包含否string, list是

要納入指定目標的類似目標對象清單。

名單格式：類似目標對象 ID類似目標對象 ID

僅適用於需求開發廣告群組。
指定類似目標對象 - 排除否string, list是

要在指定目標中排除的類似目標對象清單。

名單格式：類似目標對象 ID類似目標對象 ID

僅適用於需求開發廣告群組。
興趣相似 &潛在目標消費者指定目標 - 包含否string, list是

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

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

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

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

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

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

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

自訂名單指定目標否string, list是

要指定的自訂名單清單。

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

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

指定語言 - 包含否string, list是

指定要納入指定目標的語言清單。

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_LANGUAGE 的資源 ID。

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

僅適用於需求開發廣告群組。
指定地理區域 - 包含否string, list是

要納入指定目標的地理區域清單。

這個欄位會使用指定類型 TARGETING_TYPE_GEO_REGION 的 Display & Video 360 API TargetingOption 資源 ID。

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

僅適用於需求開發廣告群組。
指定地理區域 - 排除否string, list是

要在指定目標中排除的地理位置清單。

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_GEO_REGION 的資源 ID。

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

僅適用於需求開發廣告群組。