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

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

フィールド必須タイプ書き込み可能説明
広告グループ 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] の場合
オーディエンスの拡大レベルいいえ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 は、ディスプレイ＆ビデオ 360 の管理画面で取得できます。

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

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

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

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

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

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

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

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

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