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

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

フィールド必須タイプ書き込み可能説明
広告グループ ID既存の広告グループを編集する場合にのみ必須integerいいえ広告グループの数値 ID 値。空白のままにすると、新しい広告グループ ID が作成されて一意の ID が割り当てられます。新しい広告グループを作成する際に、必要に応じてカスタム識別子を使用して、TrueView 広告を新しい広告グループに割り当てることができます。カスタム識別子の形式は「ext[カスタム識別子]」です（例: ext123）。ファイルがアップロードされて処理されると、すべてのカスタム識別子は DBM によって割り当てられる ID に置き換えられ、オブジェクトはカスタム識別子に基づいて関連付けられます（広告と広告グループなど）。
広告申込情報 ID○integerいいえ親広告申込情報の数値 ID 値。この広告グループと同時に作成する広告申込情報のカスタム識別子（「ext[カスタム広告申込情報 ID]」など）を指定できます。
広告申込情報名いいえ文字列いいえ広告申込情報名
名前○文字列○エントリの名前。
ステータス○文字列○エントリのステータス設定。
  • 有効
  • 一時停止
  • 削除する
動画広告のフォーマット○文字列○広告グループの広告フォーマット。

次のいずれかの値を選択します。
  • インストリーム
  • インフィード動画
  • バンパー
  • スキップ不可
  • レスポンシブ
  • 効率的なアプローチ
  • YouTube オーディオ
  • デマンド ジェネレーション
入札単価○float○[TrueView 入札戦略タイプ] で設定された入札方法に基づく、広告グループの最大目標入札単価を表す値選択します。たとえば「TrueView 入札戦略タイプ」が「手動 CPV」の場合は上限広告視聴単価です。

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

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

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

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

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

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

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

ターゲティングに含めるカテゴリのリスト。この列にはディスプレイとVideo 360 API の TargetingOption リソース ID（ターゲティング タイプ TARGETING_TYPE_CATEGORY 向け）。

リスト形式 =（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 つ以上選択します。
  • 女性
  • 男性
  • 不明
年齢によるターゲティング○文字列、リスト○ターゲットとする年齢層のリストです。使用できる値を 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

2024 年 9 月 30 日をもって、最適化されたターゲティングは特定の入札戦略でご利用いただけなくなります。この値は「TRUE」から更新されます「FALSE」に変更もし:
  • 「入札戦略タイプ」「最適化された vCPM」
  • 「入札戦略タイプ」は「Maximum」です「入札戦略ユニット」を指定します「CIVA」、「IVO_TEN」、「AV_VIEWED」
オーディエンス拡張レベルいいえinteger○オーディエンス拡張レベルです。値が 0、1、2、3 の広告グループにのみ設定できます。
オーディエンス拡張基となるリストが除外されましたいいえ文字列○オーディエンス拡張の基となるリストを除外して有効にします。
  • TRUE
  • FALSE
オーディエンス ターゲティング - 含めるいいえ文字列、リスト○

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

この列にはディスプレイとVideo 360 API の FirstAndThirdPartyAudience リソース ID。

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

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

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

この列にはディスプレイとVideo 360 API の FirstAndThirdPartyAudience リソース ID。

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

類似オーディエンス ターゲティング - 含めるいいえ文字列、リスト○

ターゲティングに含める類似オーディエンスのリスト。

リスト形式: 類似オーディエンス ID類似オーディエンス ID

デマンド ジェネレーション広告グループでのみ使用できます。
類似オーディエンス ターゲティング - 除外いいえ文字列、リスト○

ターゲティングで除外する類似オーディエンスのリスト。

リスト形式: 類似オーディエンス ID類似オーディエンス ID

デマンド ジェネレーション広告グループでのみ使用できます。
アフィニティと購買意向の強いオーディエンス ターゲティング - 含めるいいえ文字列、リスト○

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

オーディエンス リスト ID は、ディスプレイ &ビデオ 360 からビデオ 360 のインターフェース。

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

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

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

オーディエンス リスト ID は、ディスプレイ &ビデオ 360 からビデオ 360 のインターフェース。

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

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

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

この列にはディスプレイとVideo 360 API の CustomList リソース ID。

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

ターゲット言語 - 含めるいいえ文字列、リスト○

ターゲティングに含める言語のリストです。

この列にはディスプレイとVideo 360 API の TargetingOption リソース ID（ターゲティング タイプ TARGETING_TYPE_LANGUAGE 向け）。

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

デマンド ジェネレーション広告グループでのみ使用できます。
地域ターゲティング - 含めるいいえ文字列、リスト○

ターゲティングに含める地域のリスト。

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

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

デマンド ジェネレーション広告グループでのみ使用できます。
地域ターゲティング - 除外いいえ文字列、リスト○

ターゲティングで除外する地域のリストです。

この列にはディスプレイとVideo 360 API の TargetingOption リソース ID（ターゲティング タイプ TARGETING_TYPE_GEO_REGION 向け）。

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

デマンド ジェネレーション広告グループでのみ使用できます。