形式の説明については、概要をご覧ください。
| フィールド | 必須 | タイプ | 書き込み可能 | 説明 |
|---|---|---|---|---|
| 広告 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 |
| 表示 URL | インストリームとバンパー: ○ | 文字列 | はい | 広告の表示 URL |
| ランディング ページの URL | インストリーム広告、バンパー広告、デマンド ジェネレーション広告に必須 | 文字列 | はい | 広告のランディング ページ URL |
| DCM トラッキング - プレースメント ID | DCM トラッキング広告を更新する場合のみ必要 | integer | はい | 対応するトラッキング広告の DCM プレースメントの ID 値。 DCM トラッキング広告を削除するには、[DCM トラッキング - プレースメント ID]、[DCM トラッキング - 広告 ID]、[DCM トラッキング - クリエイティブ ID] の 3 つの列を空白にします。 |
| DCM トラッキング - 広告 ID | DCM トラッキング広告を更新する場合のみ必要 | integer | はい | 対応するトラッキング広告の DCM 広告の ID 値。DCM トラッキング広告を削除するには、[DCM トラッキング - プレースメント ID]、[DCM トラッキング - 広告 ID]、[DCM トラッキング - クリエイティブ ID] の 3 つの列を空白にします。 |
| DCM トラッキング - クリエイティブ ID | DCM トラッキング広告を更新する場合のみ必要 | integer | はい | 対応するトラッキング広告のクリエイティブの ID 値。DCM トラッキング広告を削除するには、[DCM トラッキング - プレースメント ID]、[DCM トラッキング - 広告 ID]、[DCM トラッキング - クリエイティブ ID] の 3 つの列を空白にします。 |
| クリック トラッカー URL | いいえ | 文字列 | はい | 広告クリック トラッカーの URL |
| クリック トラッカーの URL パラメータ | いいえ | 文字列、リストのリスト | はい | クリック トラッカーの URL のカスタム パラメータ。形式 = (name1; value1;); (name2; value2;); など。 |
| 行動を促すフレーズ | 親の広告申込情報が YouTube 動画アクション広告申込情報で、[広告見出し] が空でない場合、または [広告の種類] が [デマンド ジェネレーション動画]、[デマンド ジェネレーション イメージ]、[デマンド ジェネレーション カルーセル] の場合に必須 | 文字列 | はい | 行動を促すフレーズのボタンのラベル（1 行、半角 10 文字（全角 5 文字）まで）。 |
| 広告見出し | デマンド ジェネレーション広告に必須 | 文字列 | はい | Call-to-Action オーバーレイの広告見出し（1 行、半角 15 文字（全角 7 文字）まで）。 |
| 表示 URL パス 1 | いいえ | 文字列 | はい | 表示 URL パス 1 |
| 表示 URL パス 2 | いいえ | 文字列 | はい | 表示 URL パス 2 |
| インフィード動画のサムネイル | インフィード動画の場合: はい | 文字列 | はい | TrueView ディスカバリー広告に使用する動画のサムネイル
|
| インフィード動画の広告見出し | インフィード動画広告とデマンド ジェネレーション広告に必須 | 文字列 | はい | ファインド広告またはレスポンシブ検索広告の広告見出しテキスト、またはデマンド ジェネレーション広告の長い広告見出し。 |
| 説明文 1 | インフィード動画広告とデマンド ジェネレーション広告に必須 | 文字列 | はい | ファインド広告の説明文 1 またはレスポンシブ広告の説明文 |
| Description 2 | インフィード動画に必須 | 文字列 | はい | ファインド広告の説明文 2 のテキスト |
| インフィード動画のランディング ページ | インフィード動画の場合: はい | 文字列 | はい | ファインド広告のランディング ページ |
| モバイル ランディング ページ URL | いいえ | 文字列 | はい | モバイル デバイス向けの広告ランディング ページ URL |
| ビジネスの名前 | デマンド ジェネレーション広告に必須 | 文字列 | はい | 宣伝しているビジネスの名前 |
| ランディング ページ URL の接尾辞 | いいえ | 文字列 | はい | ランディング ページ URL の接尾辞 |
| ロゴアセット ID | デマンド ジェネレーション広告に必須 | 文字列、リスト | はい | ロゴのアセット ID のリスト。このリストは数値の昇順で生成されます。 |
| マーケティング画像アセット ID | [広告の種類] が [デマンド ジェネレーション イメージ] の場合に必須 | 文字列、リスト | はい | マーケティング画像のアセット ID のリスト。このリストは昇順で生成されます。 |
| デマンド ジェネレーション カード | [広告の種類] が [デマンド ジェネレーション カルーセル] の場合に必須 | 文字列、リストのリスト | はい | カードのリストを次の形式で定義します。 （最終ページ URL、モバイルの最終ページ URL、広告見出し、行動を促すフレーズのテキスト、マーケティング画像アセット ID、その他のマーケティング アセット ID など）。 例:（google.com; mobile.google.com; ヘッドライン; こちらをクリック; 10020; 20020; 30020）。各マーケティング アセットには固有のアスペクト比が必要です。1 つの広告の下にあるカードにスクエアのマーケティング画像がある場合、その広告の下にあるすべてのカードにスクエアのマーケティング画像が必要です（これは他のアスペクト比にも適用されます）。 |
| コンパニオン バナー アセット ID | いいえ | 文字列、リスト | はい | コンパニオン バナーのアセット ID のリスト。このリストは数値の昇順で生成されます。これは、動画パフォーマンス、デマンド ジェネレーション動画、インストリーム、バンパー、スキップ不可の広告でサポートされています。リスト形式 = 100; 200; |