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

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

フィールド必須タイプ書き込み可能説明
広告グループ ID既存の広告グループを編集する場合にのみ必要integerいいえ広告グループの数値 ID 値。空白のままにすると、新しい広告グループ ID が作成され、一意の ID が割り当てられます。オプションとして、新しい広告グループを作成する際に、TrueView 広告を新しい広告グループに割り当てる目的でカスタム識別子を使用できます。カスタム識別子の形式は、ext[カスタム識別子] です（例: ext123）。ファイルがアップロードされて処理されると、すべてのカスタム識別子は DBM によって割り当てられる ID に置き換えられ、オブジェクトはカスタム識別子に基づいて関連付けられます（広告と広告グループなど）。
広告申込情報 ID○integerいいえ親広告申込情報の数値 ID 値。この広告グループと同時に作成する広告申込情報のカスタム識別子（例: ext[カスタム広告申込情報 ID]）を指定できます。
広告申込情報名いいえ文字列いいえ広告申込情報名
名前○文字列○エントリの名前。
ステータス○文字列○エントリのステータス設定。
  • 有効
  • 一時停止
  • 削除済み
動画広告のフォーマット○文字列○広告グループの動画広告フォーマット。
  • インストリーム
  • インフィード動画
  • バンパー
  • スキップ不可
  • レスポンシブ
  • 効率的なアプローチ
  • YouTube オーディオ
入札単価○float○[TrueView 入札戦略タイプ] 列で設定された入札タイプに基づいて、広告グループの目標上限入札単価を表す値。たとえば、TrueView の入札戦略タイプが手動広告視聴単価の場合、これは最大広告視聴単価です。

注: 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 チャンネル - 除外いいえ文字列、リスト○除外する YouTube チャンネルのリスト。
プレースメント ターゲティング - YouTube 動画 - 含むいいえ文字列、リスト○含める YouTube 動画のリスト。
プレースメント ターゲティング - YouTube 動画 - 除外いいえ文字列、リスト○除外する YouTube 動画のリスト。
プレースメント ターゲティング - 人気のコンテンツ - 含めるいいえ文字列、リスト○YouTube と Google 動画パートナーで配信されるポピュラー コンテンツのリスト。許容される値から 1 つ以上選択します。
  • youtube_popular_content::001a1
  • gvp_popular_content::global_tier2
  • video_content::<ID>
プレースメント ターゲティング - URL - 追加いいえ文字列、リスト○含める URL のリスト。
プレースメント ターゲティング - URL - 除外いいえ文字列、リスト○除外する URL のリスト。
プレースメント ターゲティング - アプリ - 追加いいえ文字列、リスト○含めるモバイルアプリのリスト。
プレースメント ターゲティング - アプリ - 除外いいえ文字列、リスト○除外するモバイルアプリのリスト。
プレースメント ターゲティング - アプリ コレクション - 登録いいえ文字列、リスト○ターゲティングに含めるアプリ コレクションのリスト。リスト形式= アプリ コレクション ID; アプリ コレクション ID;
プレースメント ターゲティング - アプリ コレクション - 除外いいえ文字列、リスト○ターゲティングで除外するアプリ コレクションのリスト。リスト形式= アプリ コレクション ID; アプリ コレクション ID;
年齢や性別によるターゲティング - 性別○文字列、リスト○ターゲットに設定する性別のリスト。許容される値から 1 つ以上選択します。
  • 女性
  • 男性
  • 不明
年齢や性別によるターゲティング - 年齢○文字列、リスト○ターゲットとする年齢のリスト。許容される値の 1 つ以上を選択します。
  • 18-24
  • 25～34 歳
  • 35～44 歳
  • 45～54 歳
  • 55～64 歳
  • 65+
  • 不明
ユーザー属性ターゲティングの世帯収入○文字列、リスト○ターゲットに設定する世帯収入のリスト。許容される値の 1 つ以上を選択します。
  • 上位 10%
  • 11～20%
  • 21～30%
  • 31～40%
  • 41～50%
  • 下位 50%
  • 不明
ユーザー属性ターゲティングの子供の有無○文字列、リスト○ターゲットに設定する子供の有無のリスト。許容される値の 1 つ以上を選択します。
  • 親
  • 子供なし
  • 不明
最適化されたターゲティングいいえ文字列○最適化されたターゲティングを有効にします。
  • TRUE
  • FALSE

最適化されたターゲティングは、すべての入札戦略に対応しているわけではありません。次の場合は、この列は「FALSE」にする必要があります。
  • 「入札戦略タイプ」が「固定」である
  • [入札戦略タイプ] が [最適化された視認範囲の CPM] である
  • 「入札戦略タイプ」が「最大」で、「入札戦略単位」が「CIVA」、「IVO_TEN」、「AV_VIEWED」のいずれかである
オーディエンスの拡大レベルいいえinteger○オーディエンスの拡大レベル。値 0、1、2、3 の広告グループにのみ設定できます。
オーディエンス拡張の基となるリストを除外しましたいいえ文字列○オーディエンス拡張の基となるリストを除外しました。
  • TRUE
  • FALSE
オーディエンス ターゲティング - 含むいいえ文字列、リスト○

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

この列では、ディスプレイ＆ビデオ 360 API の FirstPartyAndPartnerAudience リソース ID が使用されます。

リスト形式 =（FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; など）。このリストは数値の昇順で生成されます。

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

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

この列では、ディスプレイ＆ビデオ 360 API の FirstPartyAndPartnerAudience リソース ID が使用されます。

リスト形式 =（FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; など）。このリストは数値の昇順で生成されます。

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

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

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

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

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

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

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

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

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

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

この列では、ディスプレイ＆ビデオ 360 API の CustomList リソース ID が使用されます。

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