構造化データ - v7 - YouTube 広告グループ

形式の説明については、概要をご覧ください。

フィールド必須タイプ書き込み可能説明
広告グループ ID既存の広告グループを編集する場合にのみ必要ですintegerいいえ広告グループの数値 ID 値。空白のままにすると、新しい広告グループ ID が作成されて一意の ID が割り当てられます。必要に応じて、新しい広告グループを作成するときに、カスタム識別子を使用して TrueView 広告を新しい広告グループに割り当てることができます。カスタム識別子の形式は、ext[カスタム識別子] です（例: ext123）。ファイルがアップロードされて処理されると、すべてのカスタム識別子は DBM によって割り当てられる ID に置き換えられ、オブジェクトはカスタム識別子に基づいて関連付けられます（広告と広告グループなど）。
広告申込情報 IDはいintegerいいえ親広告申込情報の数値 ID 値。この広告グループと同時に作成する広告申込情報のカスタム識別子（例: ext[カスタム広告申込情報 ID]）を指定できます。
広告申込情報名いいえ文字列いいえ広告申込情報名
名前はい文字列はいエントリの名前。
ステータスはい文字列はいエントリのステータス設定。
  • 有効
  • 一時停止
  • 削除する
動画広告のフォーマットはい文字列はい広告グループの動画広告フォーマット。
  • インストリーム
  • インフィード動画
  • バンパー
  • スキップ不可
  • レスポンシブ
  • 効率的なアプローチ
  • YouTube オーディオ
入札単価はいfloatはい[TrueView 入札戦略の種類] 列に設定された入札単価に基づいて、広告グループの目標入札単価の上限を表す値。たとえば、[TrueView 入札戦略タイプ] 列が [手動 CPV] の場合は、最大視聴回数単価です。

注: [TrueView 入札戦略タイプ] 列が [コンバージョン数の最大化]、[コンバージョン値の最大化]、または [目標広告費用対効果] の場合は、アップロード時にこの列を 0 にする必要があります。
キーワード ターゲティング - 含めるいいえ文字列、リストはい

ターゲティングに含めるキーワード文字列のリスト。

このリストはアルファベット順で生成されます。

キーワード ターゲティング - 除外いいえ文字列、リストはい

ターゲティングで除外するキーワード文字列のリスト。

このリストはアルファベット順で生成されます。

カテゴリ ターゲティング - 含めるいいえ文字列、リストはい

ターゲティングに含めるカテゴリのリスト。この列では、ターゲティング タイプ TARGETING_TYPE_CATEGORY にディスプレイ＆ビデオ 360 API の TargetingOption リソース ID を使用します。

リストの形式は（TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など）です。このリストは数値の昇順で生成されます。

カテゴリ ターゲティング - 除外いいえ文字列、リストはいターゲティングで除外するカテゴリのリスト。この列では、ターゲティング タイプ TARGETING_TYPE_CATEGORY にディスプレイ＆ビデオ 360 API の TargetingOption リソース ID を使用します。

リストの形式は（TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など）です。このリストは数値の昇順で生成されます。

プレースメント ターゲティング - YouTube チャンネル - 含めるいいえ文字列、リストはい含める YouTube チャンネルのリスト。
プレースメント ターゲティング - YouTube チャンネル - 除外いいえ文字列、リストはい除外する YouTube チャンネルのリスト。
プレースメント ターゲティング - YouTube 動画 - 含めるいいえ文字列、リストはい含める YouTube 動画のリスト。
プレースメント ターゲティング - YouTube 動画 - 除外いいえ文字列、リストはい除外する YouTube 動画のリスト。
プレースメント ターゲティング - 人気コンテンツ - 含めるいいえ文字列、リストはい含める YouTube と Google 動画パートナーの人気のコンテンツのリスト。次のいずれかの値を選択します。
  • youtube_popular_content::001a1
  • gvp_popular_content::global_tier2
  • video_content::<ID>
プレースメント ターゲティング - URL - 含めるいいえ文字列、リストはい含める URL のリスト。
プレースメント ターゲティング - URL - 除外いいえ文字列、リストはい除外する URL のリスト。
プレースメント ターゲティング - アプリ - 含めるいいえ文字列、リストはい含めるモバイルアプリのリスト。
プレースメント ターゲティング - アプリ - 除外いいえ文字列、リストはい除外するモバイルアプリのリスト。
プレースメント ターゲティング - アプリ コレクション - 含めるいいえ文字列、リストはいターゲティングに含めるアプリコレクションのリスト。リスト形式= アプリ コレクション ID; アプリ コレクション ID;
プレースメント ターゲティング - アプリ コレクション - 除外いいえ文字列、リストはいターゲティングで除外するアプリ コレクションのリスト。リスト形式= アプリ コレクション ID; アプリ コレクション ID;
年齢や性別によるターゲティング: 性別はい文字列、リストはいターゲットに設定する性別のリスト。次のいずれかの値を選択します。
  • 女性
  • 男性
  • 不明
年齢によるターゲティングはい文字列、リストはいターゲットとする年齢のリスト。使用可能な値を 1 つ以上選択します。
  • 18-24
  • 25～34 歳
  • 35～44 歳
  • 45～54 歳
  • 55～64 歳
  • 65+
  • 不明
ユーザー層ターゲティングの世帯収入はい文字列、リストはいターゲットに設定する世帯収入のリスト。使用可能な値を 1 つ以上選択します。
  • 上位 10%
  • 11～20%
  • 21～30%
  • 31～40%
  • 41～50%
  • 下位 50%
  • 不明
ユーザー層ターゲティング: 子供の有無はい文字列、リストはいターゲットに設定する子供の有無のリスト。使用可能な値を 1 つ以上選択します。
  • 親
  • 子供なし
  • 不明
最適化されたターゲティングいいえ文字列はい最適化されたターゲティングを有効にします。
  • TRUE
  • FALSE

「最適化されたターゲティング」は、すべての入札戦略に対応しているわけではありません。次のいずれかに該当する場合、この列は「FALSE」にする必要があります。
  • [入札戦略の種類] が [最適化されたインプレッション単価] である
  • [入札戦略の種類] が [最大]、[入札戦略の単位] が [CIVA]、[IVO_TEN]、または [AV_VIEWED] である


2025 年 3 月 6 日をもって、この列は [入札戦略の種類] 列の値「固定」との互換性を失います。
オーディエンスの拡大レベルいいえintegerはいオーディエンスの拡大レベル。値は 0、1、2、3 の AdGroup にのみ設定できます。
オーディエンス拡張の基となるリストを除外しましたいいえ文字列はいオーディエンス拡張の基となるリストを除外する機能を有効にします。
  • TRUE
  • FALSE
オーディエンス ターゲティング - 含めるいいえ文字列、リストはい

含めるオーディエンス リストのリスト。

この列には、ディスプレイ＆ビデオ 360 API の FirstAndThirdPartyAudience リソース ID が使用されます。

リストの形式は、（FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; など）です。このリストは数値の昇順で生成されます。

オーディエンス ターゲティング - 除外いいえ文字列、リストはい

除外するオーディエンス リストのリスト。

この列には、ディスプレイ＆ビデオ 360 API の FirstAndThirdPartyAudience リソース ID が使用されます。

リストの形式は、（FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; など）です。このリストは数値の昇順で生成されます。

アフィニティと購買意向の強いオーディエンス ターゲティング - 含めるいいえ文字列、リストはい

含めるアフィニティ カテゴリ リストまたは購買意向の強いオーディエンス リストのリスト。

オーディエンス リスト ID は、ディスプレイ＆ビデオ 360 の管理画面から取得できます。

リストの形式 =（オーディエンス ID、オーディエンス ID など）。このリストは数値の昇順で生成されます。

アフィニティと購買意向に基づくターゲティング - 除外いいえ文字列、リストはい

除外するアフィニティ カテゴリまたは購買意向の強いオーディエンス リストのリスト。

オーディエンス リスト ID は、ディスプレイ＆ビデオ 360 の管理画面から取得できます。

リストの形式 =（オーディエンス ID、オーディエンス ID など）。このリストは数値の昇順で生成されます。

カスタムリスト ターゲティングいいえ文字列、リストはい

ターゲットとするカスタムリストのリスト。

この列には、ディスプレイ＆ビデオ 360 API の CustomList リソース ID が使用されます。

リスト形式 = (CustomList.customListId; CustomList.customListId; など）。このリストは数値の昇順で生成されます。