構造化データ - v9 - 広告

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

フィールド必須タイプ書き込み可能説明
広告 ID既存の広告を編集する場合にのみ必要integerいいえ広告グループ広告の数値 ID 値。空白のままにすると、新しい広告が作成されて一意の ID が割り当てられます。
広告グループ ID○integerいいえ親広告グループの数値 ID 値。この広告と同時に作成する広告グループのカスタム識別子（例: ext[カスタム広告グループ ID]）を指定できます。
広告グループ名いいえ文字列いいえ広告グループ名
名前○文字列○エントリの名前。
ステータス○文字列○エントリのステータス設定。
  • 有効
  • 一時停止
  • 削除済み
広告の種類YouTube 広告とデマンド ジェネレーション広告で必須文字列○広告の広告フォーマット。

インストリーム動画とインフィード動画は、CPV ベースで販売される YouTube 動画広告の種類です。バンパー広告は、CPM ベースで販売される 6 秒以下の動画の YouTube 広告です。スキップ不可の動画広告は、CPM ベースで販売される 6 ～ 15 秒のインストリーム YouTube 広告です。YouTube オーディオは、オーディオの YouTube 広告です。レスポンシブ動画広告は、複数のフォーマットで配信される YouTube 広告の種類です。効率的なリーチ広告は、動画が十分に短い場合は YouTube バンパーとして、それ以外の場合は YouTube インストリームとして配信されます。デマンド ジェネレーション動画広告は、YouTube を含む複数のフォーマットで配信されます。デマンド ジェネレーション イメージ広告には画像が表示されます。デマンド ジェネレーション カルーセル広告にはカードが表示されます。デマンド ジェネレーション商品広告には商品が表示されます。

次のいずれかの値を選択します。
  • インストリーム
  • インフィード動画
  • バンパー
  • スキップ不可
  • YouTube オーディオ
  • レスポンシブ
  • 効率的なリーチ
  • デマンド ジェネレーション プロダクト
  • デマンド ジェネレーション動画
  • デマンド ジェネレーション画像
  • デマンド ジェネレーション カルーセル
動画 IDYouTube 動画広告とデマンド ジェネレーション動画広告で必須文字列○YouTube 動画 ID
表示 URLインストリームとバンパーの場合は○文字列○広告の表示 URL
ランディング ページの URLインストリーム広告、バンパー広告、デマンド ジェネレーション広告で必須文字列○広告のランディング ページ URL
DCM トラッキング - プレースメント IDDCM トラッキング広告を更新する場合にのみ必要integer○対応するトラッキング広告の DCM プレースメントの数値 ID 値。
DCM トラッキング広告を削除するには、[DCM トラッキング - プレースメント ID]、[DCM トラッキング - 広告 ID]、[DCM トラッキング - クリエイティブ ID] の 3 つの列を空白のままにします。
DCM トラッキング - 広告 IDDCM トラッキング広告を更新する場合にのみ必要integer○対応するトラッキング広告の DCM 広告の数値 ID 値。DCM トラッキング広告を削除するには、[DCM トラッキング - プレースメント ID]、[DCM トラッキング - 広告 ID]、[DCM トラッキング - クリエイティブ ID] の 3 つの列を空白のままにします。
DCM トラッキング - クリエイティブ IDDCM トラッキング広告を更新する場合にのみ必要integer○対応するトラッキング広告のクリエイティブの数値 ID 値。DCM トラッキング広告を削除するには、[DCM トラッキング - プレースメント ID]、[DCM トラッキング - 広告 ID]、[DCM トラッキング - クリエイティブ ID] の 3 つの列を空白のままにします。
クリック トラッカー URLいいえ文字列○広告クリック トラッカー URL
クリック トラッカー URL パラメータいいえ文字列、リストのリスト○クリック トラッカー URL のカスタム パラメータ。形式 = (name1; value1;); (name2; value2;); など
行動を促すフレーズ親広告申込情報が YouTube 動画アクション広告申込情報の場合、[広告見出し] が空でない場合、または [広告の種類] が [デマンド ジェネレーション動画]、[デマンド ジェネレーション画像]、[デマンド ジェネレーション カルーセル] の場合に必須文字列○行動を促すフレーズのボタンのラベル（1 行、半角 10 文字まで）。
広告見出しデマンド ジェネレーション広告で必須文字列○行動を促すフレーズのオーバーレイの広告見出し（1 行、半角 15 文字まで）。
表示 URL のパス 1いいえ文字列○表示 URL のパス 1
表示 URL のパス 2いいえ文字列○表示 URL のパス 2
インフィード動画のサムネイルインフィード動画の場合は○文字列○動画ディスカバリー広告に使用する動画のサムネイル
  • 0
  • 1
  • 2
  • 3
インフィード動画の広告見出しインフィード動画とデマンド ジェネレーション広告で必須文字列○ファインド広告またはレスポンシブ広告の広告見出しテキスト、またはデマンド ジェネレーション広告の長い広告見出し。
説明文 1インフィード動画とデマンド ジェネレーション広告で必須文字列○ファインド広告の説明文 1 のテキストまたはレスポンシブ広告の説明文
説明文 2インフィード動画で必須文字列○ファインド広告の説明文 2 のテキスト
インフィード動画のランディング ページインフィード動画の場合は○文字列○ファインド広告のランディング ページ
モバイルのランディング ページ URLいいえ文字列○モバイル デバイス向けの広告のランディング ページ URL
ビジネスの名前デマンド ジェネレーション広告で必須文字列○宣伝するビジネスの名前

2026 年 7 月 13 日より、この列はデマンド ジェネレーション広告に加えてレスポンシブ広告にも設定できるようになります。設定しない場合は、親広告主のデフォルト値が継承されます。デフォルト値が設定されていない場合は、空白のままになります。広告主レベルでデフォルト値が設定されている場合、この列はデマンド ジェネレーション広告で不要になります。
ランディング ページ URL の接尾辞いいえ文字列○ランディング ページ URL の接尾辞
ロゴアセット IDデマンド ジェネレーション広告で必須文字列、リスト○ロゴのアセット ID のリスト。このリストは数値の昇順で生成されます。

2026 年 7 月 13 日より、この列はデマンド ジェネレーション広告に加えてレスポンシブ広告にも設定できるようになります。設定しない場合は、親広告主のデフォルト値が継承されます。デフォルト値が設定されていない場合は、空白のままになります。広告主レベルでデフォルト値が設定されている場合、この列はデマンド ジェネレーション広告で不要になります。
マーケティング画像のアセット ID[広告の種類] が [デマンド ジェネレーション画像] の場合に必須文字列、リスト○マーケティング画像のアセット ID のリスト。このリストは昇順で生成されます。
デマンド ジェネレーション カード[広告の種類] が [デマンド ジェネレーション カルーセル] の場合に必須文字列、リストのリスト○次の形式でカードのリストを定義します。

(最終ページ URL; モバイルの最終ページ URL; 広告見出し; 行動を促すフレーズのテキスト; マーケティング画像のアセット ID; 追加のマーケティング アセット ID...)。

例: (google.com; mobile.google.com; Headline; Click Here; 10020; 20020; 30020)。

各マーケティング アセットには固有のアスペクト比が必要です。広告のカードの 1 つにスクエアのマーケティング画像がある場合、その広告のすべてのカードにスクエアのマーケティング画像が必要です（他のアスペクト比にも適用されます）。

コンパニオン バナーのアセット IDいいえ文字列、リスト○コンパニオン バナーのアセット ID のリスト。このリストは数値の昇順で生成されます。動画のパフォーマンス、デマンド ジェネレーション動画、インストリーム広告、バンパー広告、スキップ不可の広告でサポートされています。リスト形式 = 100; 200;