形式の説明については、概要をご覧ください。
| フィールド | 必須 | タイプ | 書き込み可能 | 説明 |
|---|---|---|---|---|
| 広告 ID | 既存の広告を編集する場合にのみ必須 | integer | いいえ | 広告グループ広告の数値 ID 値。空白のままにすると、新しい広告が作成されて一意の ID が割り当てられます。 |
| 広告グループ ID | ○ | integer | いいえ | 親広告グループの数値 ID 値。この広告と同時に作成する広告グループのカスタム識別子（例: ext[カスタム広告グループ ID]）を指定できます。 |
| 広告グループ名 | いいえ | 文字列 | いいえ | 広告グループ名 |
| 名前 | ○ | 文字列 | ○ | エントリの名前。 |
| ステータス | ○ | 文字列 | ○ | エントリのステータス設定。
|
| 広告の種類 | YouTube 広告とデマンド ジェネレーション広告で必須 | 文字列 | ○ | 広告の広告フォーマット。 インストリーム動画とインフィード動画は、CPV ベースで販売される YouTube 動画広告の種類です。バンパー広告は、インプレッション単価制で販売される 6 秒以下の動画 YouTube 広告です。スキップ不可の動画広告は、インプレッション単価制で販売される 6 ～ 15 秒の YouTube インストリーム広告です。YouTube オーディオは、YouTube のオーディオ広告です。レスポンシブ動画広告は、複数のフォーマットで配信される YouTube 広告の種類です。効率的なリーチ広告は、動画が十分に短い場合は YouTube バンパー広告として、それ以外の場合は YouTube インストリーム広告として配信されます。デマンド ジェネレーション動画広告は、YouTube を含む複数のフォーマットで配信されます。デマンド ジェネレーション イメージ広告には画像が表示されます。デマンド ジェネレーション カルーセル広告にはカードが表示されます。デマンド ジェネレーション商品広告に商品を表示します。 次のいずれかの値を選択します。
|
| 動画 ID | YouTube とデマンド ジェネレーション動画広告で必須 | 文字列 | ○ | 広告で使用される YouTube 動画の ID。 各 YouTube 動画 ID は、ローカルの AI ラベル付け規則がある地域で配信される場合に、AI を使用して作成または編集された動画としてラベルを追加するかどうかを指定する合成コンテンツの証明ステータス値とペアにすることもできます。
YouTube 動画 ID に値「ON」または「OFF」が指定されている場合、この広告主の YouTube 動画 ID の既存のすべての使用にその証明書が適用されます。詳しくは、SDF を使用した広告の AI ラベル付けをご覧ください。 リスト形式 = （YouTube 動画 ID; 合成コンテンツの証明ステータス）; （YouTube 動画 ID; 合成コンテンツの証明ステータス）; など） 例: 「(abdefg; ON);(hijlk; OFF);(mnopq;)」 |
| 表示 URL | インストリームとバンパーは可 | 文字列 | ○ | 広告の表示 URL |
| ランディング ページの URL | インストリーム広告、バンパー広告、デマンド ジェネレーション広告で必須 | 文字列 | ○ | 広告のランディング ページ URL |
| DCM トラッキング - プレースメント ID | DCM トラッキング広告を更新する場合にのみ必須 | integer | ○ | 対応するトラッキング広告の DCM プレースメントの数値 ID 値。 DCM トラッキング広告を削除するには、[DCM Tracking - Placement ID]、[DCM Tracking - Ad ID]、[DCM Tracking - Creative ID] の 3 つの列を空白のままにします。 |
| DCM トラッキング - 広告 ID | DCM トラッキング広告を更新する場合にのみ必須 | integer | ○ | 対応するトラッキング広告の DCM 広告の数値 ID 値。DCM トラッキング広告を削除するには、[DCM Tracking - Placement ID]、[DCM Tracking - Ad ID]、[DCM Tracking - Creative ID] の 3 つの列を空白のままにします。 |
| DCM トラッキング - クリエイティブ ID | DCM トラッキング広告を更新する場合のみ必須 | integer | ○ | 対応するトラッキング広告のクリエイティブの数値 ID 値。DCM トラッキング広告を削除するには、[DCM Tracking - Placement ID]、[DCM Tracking - Ad ID]、[DCM Tracking - Creative ID] の 3 つの列を空白のままにします。 |
| クリック トラッカー URL | いいえ | 文字列 | ○ | 広告クリック トラッカー URL |
| クリック トラッカー URL パラメータ | いいえ | 文字列、リストのリスト | ○ | クリック トラッカー URL のカスタム パラメータ。形式 = (name1; value1;); (name2; value2;); など |
| 行動を促すフレーズ | 「広告見出し」が空でない場合、または「広告タイプ」が「デマンド ジェネレーション動画」、「デマンド ジェネレーション画像」、「デマンド ジェネレーション カルーセル」の場合は必須 | 文字列 | ○ | 行動を促すフレーズのボタンのラベル（1 行、半角 10 文字（全角 5 文字）まで）。 |
| 広告見出し | デマンド ジェネレーション広告で必須 | 文字列 | ○ | 行動を促すフレーズのオーバーレイの広告見出し（1 行、最大半角 15 文字（全角 7 文字））。 |
| 表示 URL のパス 1 | いいえ | 文字列 | ○ | 表示 URL のパス 1 |
| 表示 URL のパス 2 | いいえ | 文字列 | ○ | 表示 URL のパス 2 |
| インフィード動画のサムネイル | インフィード動画の場合は「はい」 | 文字列 | ○ | ファインド広告で使用する動画のサムネイル
|
| インフィード動画の広告見出し | インフィード動画広告とデマンド ジェネレーション広告で必須 | 文字列 | ○ | ファインド広告またはレスポンシブ広告の広告見出しテキスト、またはデマンド ジェネレーション広告の長い広告見出し。 |
| 説明文 1 | インフィード動画広告とデマンド ジェネレーション広告で必須 | 文字列 | ○ | ファインド広告の説明文 1 のテキストまたはレスポンシブ広告の説明文 |
| 説明文 2 | インフィード動画で必須 | 文字列 | ○ | ファインド広告の説明文 2 のテキスト |
| インフィード動画のランディング ページ | インフィード動画の場合は「はい」 | 文字列 | ○ | ファインド広告のランディング ページ |
| モバイル ランディング ページ URL | いいえ | 文字列 | ○ | モバイル デバイス用の広告ランディング ページ URL |
| ビジネスの名前 | 広告主レベルで設定されていない場合は、デマンド ジェネレーション広告で必須 | 文字列 | ○ | 宣伝されているビジネスの名前。設定されていない状態で、広告主レベルでデフォルト値が設定されている場合は、デフォルト値が適用されます。 2026 年 10 月 12 日より、広告主レベルで設定されていない場合、この列はすべての YouTube レスポンシブ広告で必須になります。 |
| ランディング ページ URL の接尾辞 | いいえ | 文字列 | ○ | ランディング ページ URL の接尾辞 |
| ロゴアセット ID | 広告主レベルで設定されていない場合は、デマンド ジェネレーション広告で必須 | 文字列、リスト | ○ | ロゴのアセット ID のリスト。このリストは数値の昇順で生成されます。設定されていない状態で、広告主レベルでデフォルト値が設定されている場合は、デフォルト値が適用されます。 2026 年 10 月 12 日より、広告主レベルで設定されていない場合、この列はすべての YouTube レスポンシブ広告で必須になります。 |
| マーケティング画像アセット ID | [広告タイプ] が [デマンド ジェネレーション イメージ] の場合は必須 | 文字列、リスト | ○ | マーケティング画像の画像アセット ID のリスト。このリストは昇順で生成されます。 |
| デマンド ジェネレーション カード | [広告タイプ] が [デマンド ジェネレーション カルーセル] の場合は必須 | 文字列、リストのリスト | ○ | これは、次の形式でカードのリストを定義します。 （最終ページ URL、モバイルの最終ページ URL、URL、広告見出し、行動を促すフレーズのテキスト、マーケティング画像アセット ID、追加のマーケティング アセット ID など）。 例: (google.com; mobile.google.com; 見出し; こちらをクリック; 10020; 20020; 30020)。マーケティング アセットごとに固有のアスペクト比が必要です。広告内の 1 枚のカードにスクエアのマーケティング画像を使用している場合、その広告内のすべてのカードにスクエアのマーケティング画像を使用する必要があります（これは他のアスペクト比にも当てはまります）。 |
| コンパニオン バナーのアセット ID | いいえ | 文字列、リスト | ○ | コンパニオン バナーのアセット ID のリスト。このリストは数値の昇順で生成されます。この機能は、動画パフォーマンス広告、デマンド ジェネレーション動画広告、インストリーム広告、バンパー広告、スキップ不可の広告でサポートされています。リスト形式 = 100; 200; |
| 一時停止時の広告の画像アセット ID | いいえ | 文字列、リスト | ○ | 一時停止時の広告画像のリストのアセット ID。 例: (100;200;300;) インスタント取引の広告申込情報、広告グループ、広告に対する SDF のサポートはベータ版であり、許可リストに登録されたパートナーのみが利用できます。インスタント取引広告申込情報の広告は、ダウンロードしたファイルには含まれません。ディスプレイ＆ビデオ 360 インターフェースの YouTube インスタント取引作成ワークフローからアップロードする必要があります。 |
| 親クリエイティブ ID | いいえ | integer | いいえ | 親のディスプレイ＆ビデオ 360 クリエイティブの数値 ID 値。 |