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

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

フィールド必須タイプ書き込み可能説明
広告グループ 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 に Display & Video 360 API TargetingOption リソース ID を使用します。

リスト形式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など)。このリストは数値順に生成されます。

カテゴリ ターゲティング - 除外いいえ文字列、リスト○ターゲティングから除外するカテゴリのリスト。この列では、ターゲティング タイプ TARGETING_TYPE_CATEGORY に Display & Video 360 API TargetingOption リソース ID を使用します。

リスト形式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など)。このリストは数値順に生成されます。

プレースメント ターゲティング - YouTube チャンネル - 追加いいえ文字列、リスト○

含める YouTube チャンネルのリスト。

リスト形式 = (YouTube チャンネル ID; YouTube チャンネル ID; など)。

プレースメント ターゲティング - YouTube チャンネル - 除外いいえ文字列、リスト○

除外する YouTube チャンネルのリスト。

リスト形式 = (YouTube チャンネル ID; YouTube チャンネル ID; など)。

プレースメント ターゲティング - YouTube 動画 - 追加いいえ文字列、リスト○

含める YouTube 動画のリスト。

リスト形式 = (YouTube 動画 ID; YouTube 動画 ID; など)。

プレースメント ターゲティング - YouTube 動画 - 除外いいえ文字列、リスト○

除外する YouTube 動画のリスト。

リスト形式 = (YouTube 動画 ID; YouTube 動画 ID; など)。

プレースメント ターゲティング - ポピュラー コンテンツ - 追加いいえ文字列、リスト○含める YouTube と Google 動画パートナーの人気のコンテンツのリスト。次のいずれかの許容値を選択します。
  • youtube_popular_content::001a1
  • gvp_popular_content::global_tier2
  • video_content::<ID>
プレースメント ターゲティング - URL - 追加いいえ文字列、リスト○

ターゲティングに含める URL のリスト。リストは URL 文字列で構成されます。

リスト形式 = (someurl.com; someurltwo.com; など)。

プレースメント ターゲティング - URL - 除外いいえ文字列、リスト○

ターゲティングから除外する URL のリスト。リストは URL 文字列で構成されます。

リスト形式 = (someurl.com; someurltwo.com; など)。

プレースメント ターゲティング - アプリ - 追加いいえ文字列、リスト○

ターゲティングから除外するモバイルアプリのリスト。リストはアプリ プラットフォーム ID で構成されます。

ID は関連するプラットフォームから提供されます。たとえば、Android の Google Play ストアのバンドル ID（例: com.google.android.gm）や、Apple の App Store のアプリ ID（例: 422689480）などです。

リスト形式 = (com.google.android.gm; 422689480; など)。

プレースメント ターゲティング - アプリ - 除外いいえ文字列、リスト○

ターゲティングから除外するモバイルアプリのリスト。リストはアプリ プラットフォーム ID で構成されます。

ID は関連するプラットフォームから提供されます。たとえば、Android の Google Play ストアのバンドル ID（例: com.google.android.gm）や、Apple の App Store のアプリ ID（例: 422689480）などです。

リスト形式 = (com.google.android.gm; 422689480; など)。

プレースメント ターゲティング - アプリ コレクション - 追加いいえ文字列、リスト○ターゲティングに含めるアプリ コレクションのリスト。リスト形式= アプリ コレクション ID; アプリ コレクション ID;
プレースメント ターゲティング - アプリ コレクション - 除外いいえ文字列、リスト○ターゲティングから除外するアプリ コレクションのリスト。リスト形式= アプリ コレクション ID; アプリ コレクション ID;
年齢や性別によるターゲティング - 性別○文字列、リスト○ターゲットにする性別のリスト。次のいずれかの許容値を選択します。
  • 女性
  • 男性
  • 不明
年齢や性別によるターゲティング - 年齢○文字列、リスト○

ターゲットにする年齢のリスト。次のいずれかの許容値を選択します。

  • 18-24
  • 25～34 歳
  • 35～44 歳
  • 45～54 歳
  • 55～64 歳
  • 65+
  • 不明
年齢や性別によるターゲティング - 世帯収入○文字列、リスト○

ターゲットにする世帯収入のリスト。次のいずれかの許容値を選択します。

  • 上位 10%
  • 11 ～ 20%
  • 21 ～ 30%
  • 31 ～ 40%
  • 41 ～ 50%
  • 下位 50%
  • 不明
年齢や性別によるターゲティング - 子供の有無○文字列、リスト○

ターゲットにする子供の有無のリスト。 次のいずれかの許容値を選択します。

  • 親
  • 子供なし
  • 不明
最適化されたターゲティングいいえ文字列○最適化されたターゲティングを有効にします。
  • TRUE
  • FALSE

最適化されたターゲティングは、すべての入札戦略と互換性があるわけではありません。次の場合、この列は「FALSE」にする必要があります。
  • [入札戦略タイプ] が [固定] の場合
  • [入札戦略タイプ] が [最適化された vCPM] の場合
  • [入札戦略タイプ] が [最大] で、[入札戦略単位] が [CIVA]、[IVO_TEN]、[AV_VIEWED] の場合

この制限は、広告申込情報が上記の入札戦略のいずれかを親広告掲載オーダーから継承する場合にも適用されます。広告掲載オーダーの [広告掲載オーダーの最適化] 列が [TRUE] に設定されている場合、広告掲載オーダー単位で設定された入札戦略は広告申込情報に継承されます。

オーディエンスの拡大レベルいいえinteger○オーディエンス拡張レベル。値 0、1、2、3 の広告グループにのみ設定できます。
オーディエンス拡張の基となるリストを除外いいえ文字列○オーディエンス拡張の基となるリストの除外を有効にします。
  • TRUE
  • FALSE
オーディエンス ターゲティング - 追加いいえ文字列、リスト○

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

この列では、Display & Video 360 API FirstPartyAndPartnerAudience リソース ID を使用します。

リスト形式 = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; など)。このリストは数値順に生成されます。

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

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

この列では、Display & Video 360 API FirstPartyAndPartnerAudience リソース ID を使用します。

リスト形式 = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; など)。このリストは数値順に生成されます。

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

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

リスト形式 = (類似オーディエンス ID; 類似オーディエンス ID; など)。

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

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

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

リスト形式 = (類似オーディエンス ID; 類似オーディエンス ID; など)。

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

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

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

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

リスト形式 = (オーディエンス ID; オーディエンス ID; など)。このリストは数値順に生成されます。

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

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

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

リスト形式 = (オーディエンス ID; オーディエンス ID; など)。このリストは数値順に生成されます。

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

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

この列では、Display & Video 360 API CustomList リソース ID を使用します。

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

ターゲット言語 - 追加いいえ文字列、リスト○

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

この列では、ターゲティング タイプ TARGETING_TYPE_LANGUAGE に Display & Video 360 API TargetingOption リソース ID を使用します。

リスト形式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など)。このリストは数値順に生成されます。

次の条件を満たす場合にのみ使用できます。

  • [動画広告フォーマット] 列が [デマンド ジェネレーション] に設定されている
  • 親広告申込情報の地域と言語のターゲティング レベルが管理画面で広告グループに設定されている
地域ターゲティング - 追加いいえ文字列、リスト○

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

この列では、ターゲティング タイプ TARGETING_TYPE_GEO_REGION に Display & Video 360 API TargetingOption リソース ID を使用します。

リスト形式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など)。このリストは数値順に生成されます。

次の条件を満たす場合にのみ使用できます。

  • [動画広告フォーマット] 列が [デマンド ジェネレーション] に設定されている
  • 親広告申込情報の地域と言語のターゲティング レベルが管理画面で広告グループに設定されている
地域ターゲティング - 除外いいえ文字列、リスト○

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

この列では、ターゲティング タイプ TARGETING_TYPE_GEO_REGION に Display & Video 360 API TargetingOption リソース ID を使用します。

リスト形式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; など)。このリストは数値順に生成されます。

次の条件を満たす場合にのみ使用できます。
  • [動画広告フォーマット] 列が [デマンド ジェネレーション] に設定されている
  • 親広告申込情報の地域と言語のターゲティング レベルが管理画面で広告グループに設定されている
デマンド ジェネレーションのインベントリ ソース戦略デマンド ジェネレーション広告グループの場合は「はい」文字列○デマンド ジェネレーションのインベントリ ソース戦略。
  • Google のすべての広告枠
  • Google とディスプレイ ネットワークのすべての広告枠
  • 選択した広告枠
デマンド ジェネレーションで有効なインベントリ ソースいいえ文字列、リスト○デマンド ジェネレーションで有効なインベントリ ソース。これは、広告在庫ソース戦略が設定されていない場合に使用されます。
  • YouTube のスキップ可能な広告
  • YouTube のインフィード広告
  • YouTube ショートの広告
  • Gmail
  • Discover
  • Google ディスプレイ ネットワーク