構造化データ - v3.1 - 広告申込情報

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

フィールド必須タイプ書き込み可能説明
広告申込情報 ID既存の広告申込情報を編集する場合にのみ必要integerいいえ広告申込情報の数値 ID 値。空白のままにすると、新しい広告申込情報が作成されて一意の ID が割り当てられます。必要に応じて、新しい広告申込情報を作成する際に、カスタム識別子を使用して、TrueView 動画広告グループを新しい広告申込情報に割り当てることができます。カスタム識別子の形式は、ext[カスタム識別子] です（例: ext123）。ファイルがアップロードされて処理されると、すべてのカスタム識別子は DBM によって割り当てられる ID に置き換えられ、オブジェクトはカスタム識別子に基づいて関連付けられます（広告グループと広告申込情報など）。
Io IDはいintegerいいえ広告掲載オーダーの数値 ID 値。この広告申込情報と同時に作成する広告掲載オーダーのカスタム識別子（例: ext[カスタム IO ID]）を指定できます。
タイプはい文字列はいエントリのタイプ。作成時にのみ書き込み可能で、編集時には書き込みできません。
  • ディスプレイ
  • 動画
  • TrueView
  • 音声
サブタイプはい文字列はいTrueView 広告申込情報で、標準の TrueView フォーマットとモバイルアプリ インストールの TrueView フォーマットを区別するために必要なフィールド
  • シンプル
  • モバイルアプリをインストールしましょう
名前はい文字列はいエントリの名前。
タイムスタンプ既存のエントリを編集する場合に必要integerいいえエントリのタイムスタンプ。これは、ダウンロードとアップロードの間にエントリが変更されていないことを確認するために、システムによって使用されます。
ステータスはい文字列はいエントリのステータス設定。
  • 有効
  • 一時停止
  • 下書き
  • アーカイブ済み
  • 削除済み
開始日はい文字列はいエントリのフライト開始日のタイムスタンプ（MM/DD/YYYY HH:mm 形式）。
終了日はい文字列はいエントリのフライト終了日のタイムスタンプ（MM/DD/YYYY HH:mm の形式）。
予算タイプはい文字列はい予算が金額ベースかインプレッション ベースかを指定します。このエントリの IO で予算の自動割り当てが有効になっている場合は、[自動] に設定して、DBM がこのエントリの予算を自動的に割り当てるようにできます。
  • 金額
  • 表示回数
  • 無制限
  • 自動
  • TrueView の 1 日の予算
予算額[タイプ] が「ディスプレイ」、「動画」、「オーディオ」のいずれかの場合、必須floatはい予算タイプの正の予算額。これは、単純な整数のインプレッション値でも、通貨金額の浮動小数点数でもかまいません。通貨は、広告主の通貨で標準単位（通貨単位の 1/1,000,000 ではなく）で表示されます。エントリで予算の自動割り当てが設定されている場合は、最低限の費用（「少なくともこの金額を費やす」など）を指定できます。
ペースはい文字列はいペース設定額に達するまでに費やす期間。
  • 毎日
  • 1 か月
  • フライト
ペースレートはい文字列はいこのエントリのパシング レート。
  • できるだけ早く
  • 均等
  • なった内容
期間内予算はいfloatはいペース設定タイプで設定された期間あたりの費用。
フリークエンシーが有効はい文字列はい広告申込情報でインプレッション ベースのフリークエンシー キャップを有効または無効にします。
  • TRUE
  • FALSE
フリークエンシー エクスポージャー[Frequency Enabled] が [TRUE] の場合に必須integerはい特定のフリークエンシー額のインプレッション数を示す正の整数値（「y 期間に x 回表示」の x に相当）。
フリークエンシー期間[Frequency Enabled] が [TRUE] の場合に必須文字列はいフリークエンシー キャップの期間の単位を指定します。TrueView 広告申込情報の場合、サポートされている期間は日、週、月です。
  • 分
  • 時間
  • 数日間
  • 数週間
  • 月
  • 全期間
頻度[Frequency Enabled] が [TRUE] の場合に必須integerはいフリークエンシー期間のタイプに指定する期間の正の整数値（「y 期間に x 回のインプレッションを表示」の y）。この金額は、TrueView 広告申込情報ではサポートされていません。
TrueView の視聴回数の有効化[タイプ] が [TrueView] の場合に必須文字列はいTrueView 広告申込情報で視聴回数ベースのフリークエンシー キャップを有効または無効にします
  • TRUE
  • FALSE
TrueView 視聴フリークエンシーの表示回数[TrueView 視聴回数の有効化] が [TRUE] の場合に必須integerはいTrueView の視聴回数を示す正の整数値（「期間内の視聴回数を x 件表示」の x に相当）
TrueView のフリークエンシー期間[TrueView 視聴回数の有効化] が [TRUE] の場合に必須文字列はいTrueView の視聴回数ベースのフリークエンシー キャップの期間の単位を指定します。
  • 日
  • 数週間
  • 月
パートナーの収益モデルはい文字列はいパートナーの収益モデルとは、Bid Manager での収益計算方法を決める仕組みのことです。サービス料金の利幅をトラッキングするには、パートナーの収益モデルを使用します。
  • TMCM - 合計メディア費用の上乗せ分
  • MCM - メディア費用の上乗せ分
  • CPM - インプレッション 1,000 回あたりの費用
パートナー収益額はいfloatはいパートナーの収益モデルに対応する正の浮動小数点値。
コンバージョンのカウント方法[タイプ] が「ディスプレイ」、「動画」、「オーディオ」のいずれかの場合、必須文字列はいカウントするコンバージョンの種類を選択します。
  • すべての項目数
  • ポストクリックをカウントする
  • カウント（%）
コンバージョンのカウント率[タイプ] が「ディスプレイ」、「動画」、「オーディオ」のいずれかの場合、必須floatはいコンバージョンのカウント方法が [カウント %] の場合は、% を指定します。% を浮動小数点数として書式設定します（3.123% = 3.123）。精度は 1,000 単位（小数点以下 3 桁）に制限されます。
コンバージョン ピクセル IDいいえ文字列、リストのリストはいコンバージョン ピクセルは、リストのリストとして指定します。各ピクセルは、ピクセル ID、ポストビュー ウィンドウ（分単位）、ポストクリック ウィンドウ（分単位）として指定します。リスト形式 = (Pixel.common_data.id; view_window_minutes; click_window_minutes;).
料金いいえ文字列、リストのリストはいこのエントリのすべての料金。リスト形式 =（料金カテゴリ、料金の金額、料金タイプ、請求済み）。
  • 料金カテゴリ
    • CPM
    • メディア
  • 手数料の金額
    • 浮動小数点数
    • 勝率（浮動小数点数）
  • 料金タイプ
    • （文字列、料金の表を参照）
  • 請求済み
    • 正しい
    • False
    • 空白

例:「(CPM; 2; Bid Manager Fee; False) ; (Media; 13; Default; True)」
使用できる値は次の表のとおりです。

注: プレミアム料金の CPM 料金はシステムによって予約され、変更できません。必要に応じてデフォルトの CPM 料金を挿入することで、プレミアム料金のカーディナリティがミューテーション間で保持されます。

料金カテゴリ料金タイプ請求書発行オプション
CPM/メディアデフォルト許可されない（空白のままにする）
CPM/メディア第三者広告サーバー許可されない（空白のままにする）
CPM/メディアDoubleVerify許可（True/False）
CPM/メディアAdsafe許可されない（空白のままにする）
CPM/メディアAdXpose許可されない（空白のままにする）
CPM/メディアVizu許可されない（空白のままにする）
CPM/メディアAggregate Knowledge許可されない（空白のままにする）
CPM/メディアTeracent許可されない（空白のままにする）
CPM/メディアEvidon許可されない（空白のままにする）
CPM/メディア代理店の取引デスク料金許可されない（空白のままにする）
CPM/メディアAdloox許可（True/False）
CPMShopLocal必須（True）
CPMTrustMetrics許可されない（空白のままにする）
CPMIntegral Ad Science 動画許可（True/False）
CPMMOAT 動画許可されない（空白のままにする）
メディア入札単価管理料金必須（True）
メディアメディア費用データ許可されない（空白のままにする）
CPMプレミアム料金許可されない（空白のままにする）
統合コードいいえ文字列はいトラッキング用コード（省略可）。
詳細いいえ文字列はいエントリの詳細（文字列形式）。
入札戦略のタイプ[タイプ] が「ディスプレイ」、「動画」、「オーディオ」のいずれかの場合、必須文字列はい 該当する入札戦略のいずれかを選択します。
  • 最小化: 予算を使い切る、かつ CPA/CPC を最小限にする
  • 最大化: 予算を使い切る、かつインプレッション値または質の高いインプレッション数を最大化
  • 達成: X の CPA/CPC の目標値の達成を目指します
  • 視認範囲のインプレッション単価を最適化: X の視認範囲のインプレッション単価を最適化
  • 修正済み: 固定入札単価 X を指定
入札単価戦略の値[入札戦略タイプ] が [最小化]、[最大化]、または [タイプ] が [TrueView] でない限り必須floatはい目標値の達成を目指します、コンバージョン単価の目標値の達成を目指します、固定の入札戦略タイプの場合は、目標入札単価の値を選択します。
入札戦略タイプが「最小化」または「最大化」の場合は、入札戦略の値は必要ありません。
入札戦略の単位[入札戦略の種類] が [目標達成]、[最小化]、または [最大化] の場合に必須文字列はい戦略タイプが「上回る」、「最小化する」、「最大化する」場合は、対応する単位を選択します。
  • CPA
  • CPC
  • 費用あたりのカスタム インプレッション値
  • CIVA
  • IVO_TEN
  • AV_VIEWED
  • INCREMENTAL_CONVERSIONS
入札戦略の「上限なし」[タイプ] が「ディスプレイ」、「動画」、「オーディオ」のいずれかの場合、必須floatはい「超過しない」CPM 値を設定します。0 の場合、「超過しない」は有効になりません。この機能は、入札戦略が [費用の最小化]、[費用の最大化]、[競合他社より低い価格] の場合にのみ使用できます。
クリエイティブの割り当ていいえ文字列、リストはいエントリに割り当てるクリエイティブ ID のリスト。リスト形式 =（Creative.common_data.id;Creative.common_data_id;etc.）。
地域ターゲティング - 含めるいいえ文字列、リストはいターゲティングに含める地域のリスト。リスト形式 =（GeoLocation.id; GeoLocation.id; など）。
地域ターゲティング - 除外いいえ文字列、リストはいターゲティングから除外する地域のリスト。リスト形式 = (GeoLocation.id;GeoLocation.id; など)。
ターゲット言語 - 含めるいいえ文字列、リストはいターゲティングに含める言語のリスト。リスト形式 = (Language.id;Language.id;etc.)。
ターゲット言語 - 除外いいえ文字列、リストはいターゲティングで除外する言語のリスト。リスト形式 = (Language.id;Language.id;etc.)。
デバイス ターゲティング - 含めるいいえ文字列、リストはいターゲティングに含めるデバイスのリスト。リストの形式 =（DeviceCriteria.id;DeviceCriteria.id;など）。
デバイス ターゲティング - 除外いいえ文字列、リストはいターゲティングで除外するデバイスのリスト。リストの形式 =（DeviceCriteria.id;DeviceCriteria.id;など）。
ブラウザ ターゲティング - 含めるいいえ文字列、リストはいターゲティングに含めるブラウザのリスト。リストの形式 =（Browser.id;Browser.id;など）。
ブラウザ ターゲティング - 除外いいえ文字列、リストはいターゲティングで除外するブラウザのリスト。リストの形式 =（Browser.id;Browser.id;など）。
ブランド保護ラベルいいえ文字列、リストはいターゲティングするデジタル コンテンツ ラベルのリスト。リスト形式 =（G、PG など）。
  • G
  • PG
  • T
  • MA
  • ?
ブランド保護の機密性設定いいえ文字列はい周辺のコンテンツのカテゴリに基づいて広告枠をブロックする感度設定を選択します。
  • ブロックしない
  • DoubleClick の確認を使用する
  • カスタムを使用
ブランド保護のカスタム設定[ブランド セーフティのカスタム設定] が [カスタムを使用する] の場合に必須文字列、リストはいブランド セーフティの機密性設定が [カスタムを使用する] の場合は、標準コンテンツ分類システムのリストを指定します。例:（成人向け、アルコール、タバコなど）。
  • アダルト
  • 中傷
  • ダウンロードと共有
  • 武器および兵器
  • ギャンブル
  • 暴力
  • 性的内容を示唆
  • 冒とく
  • アルコール
  • 薬物
  • タバコ
  • 政治
  • 宗教
  • 惨事
  • 交通事故
  • デリケートな社会問題
  • 衝撃的
第三者認証サービスいいえ文字列はい第三者認証サービス プロバイダ。
  • なし
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三者確認ラベルいいえ文字列、リストはい[サードパーティの認証サービス] が [なし] 以外の場合は、選択したプロバイダでサポートされているラベルのリストを指定します。
チャンネル ターゲティング - 含めるいいえ文字列、リストはいターゲティングに含めるチャンネルのリスト。リスト形式 =（UniversalChannel.id;UniversalChannel.id;など）。
チャンネル ターゲティング - 除外いいえ文字列、リストはいターゲティングに含めるチャンネルのリスト。リスト形式 =（UniversalChannel.id;UniversalChannel.id;など）。
サイト ターゲティング - 含めるいいえ文字列、リストはいターゲティングに含めるサイトのリスト。このリストには、ユニバーサル サイトの表にない場合は、サイト ID のセットまたは URL の文字列を含めることができます。リストの形式 = (UniversalSite.Id;'http://someurl.com';etc.)。
サイト ターゲティング - 除外いいえ文字列、リストはいターゲティングで除外するサイトのリスト。このリストには、ユニバーサル サイトの表にない場合は、サイト ID のセットまたは URL の文字列を含めることができます。リストの形式 = (UniversalSite.Id;'http://someurl.com';etc.)。
アプリのターゲティング - 含めるいいえ文字列、リストはいターゲティングに含めるアプリのリスト。このリストには、UniversalSite ID のセットや、ユニバーサル サイトの表にない場合はアプリ パッケージの文字列を含めることができます。リスト形式 =（UniversalSite.Id; 'some.app.package'; など）。
アプリのターゲティング - 除外いいえ文字列、リストはいターゲティングから除外するアプリのリスト。このリストには、UniversalSite ID のセットや、ユニバーサル サイトの表にない場合はアプリ パッケージの文字列を含めることができます。リスト形式 =（UniversalSite.Id; 'some.app.package'; など）。
カテゴリ ターゲティング - 含めるいいえ文字列、リストはいAdX カテゴリ ID から、ターゲティングに含めるカテゴリのリスト。リスト形式 =（Verticals.Id;Verticals.Id;など）。
カテゴリ ターゲティング - 除外いいえ文字列、リストはいAdX カテゴリ ID から、ターゲティングで除外するカテゴリのリスト。リスト形式 =（Verticals.Id;Verticals.Id;など）。
キーワード ターゲティング - 含めるいいえ文字列、リストはいターゲティングに含めるキーワード文字列のリスト。
キーワード ターゲティング - 除外いいえ文字列、リストはいターゲティングで除外するキーワード文字列のリスト。
オーディエンス ターゲティング - 類似ユーザー[タイプ] が「ディスプレイ」、「動画」、「オーディオ」のいずれかの場合、必須文字列はい ターゲットに設定した自社リストに対して類似ユーザーを有効にします。
  • TRUE
  • FALSE
オーディエンス ターゲティング - 含めるいいえ文字列、ペアのリストのリストはいターゲティングに含めるオーディエンス リストのリスト。自社オーディエンス リストの場合、各オーディエンスは UserList ID と更新頻度の設定のペアとして一覧表示されます。ペアは（1;1d;）です。ここで、1d は 1 日前のサンプルの更新頻度を表します。サードパーティ オーディエンスでは「直近」は使用できないため、リストの形式は（3;）;（4;）となります。オーディエンスのグループを「AND」または「OR」で結合するには、次の例のようにします。最近のアクセス有無にかかわらずペアを結合するには、「((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;))」とします。つまり、（リスト 1 で過去 1 日以内、またはリスト 2 で過去 365 日以内）かつ（リスト 3 で過去の指定なし、またはリスト 4 で過去 5 分以内、またはリスト 5 ですべてのユーザー）です。
有効な過去の値は、
all、1m、5m、10m、15m、30m、1h、2h、3h、6h、12h、1d、2d、3d、5d、7d、10d、14d、15d、21d、28d、30d、45d、60d、90d、120d、180d、270d、365d です。
オーディエンス ターゲティング - 除外いいえ文字列、ペアのリストのリストはいターゲティングで除外するオーディエンス リストのリスト。オーディエンス リストがファーストパーティ オーディエンス リストの場合、各オーディエンスは UserList ID と更新頻度の設定のペアとして一覧表示されます。ペアは（1;1d;）です。ここで、1d は 1 日前のサンプルの更新頻度を表します。ただし、サードパーティ オーディエンスでは「最近」は使用できないため、リストの形式は（3;）;（4;）となります。リストの形式= (UserList.id; 直近の値（省略可）;); (UserList.id; 直近の値（省略可）;);
例: "(1;1d;);(2;);"。
有効な直近の値は、all、1m、5m、10m、15m、30m、1h、2h、3h、6h、12h、1d、2d、3d、5d、7d、10d、14d、15d、21d、28d、30d、45d、60d、90d、120d、180d、270d、365d です。
アフィニティと購買意向の強いオーディエンス ターゲティング - 含めるいいえ文字列、リストはい含めるアフィニティ カテゴリまたは購買意向の強いオーディエンスのリスト。リスト形式= UserList ID; UserList ID;
アフィニティと購買意向に基づくターゲティング - 除外いいえ文字列、リストはい除外するアフィニティ カテゴリまたは購買意向の強いオーディエンスのリスト。リスト形式= UserList ID; UserList ID;
カスタム アフィニティ ターゲティングいいえ文字列、リストはいターゲットとするカスタムリストのリスト。リスト形式= UserList ID; UserList ID;
広告枠ソース ターゲティング - 含める[タイプ] が「ディスプレイ」、「動画」、「オーディオ」のいずれかの場合、必須文字列、リストはいターゲティングに含める広告枠のリスト。リストの形式 = (InventorySource.id; InventorySource.id;)。
広告枠ソース ターゲティング - 除外いいえ文字列、リストはいターゲット設定で除外する広告枠のリスト。リストの形式 = (InventorySource.id; InventorySource.id;)。
時間帯ターゲティングいいえ文字列、リストはいID のリスト。各デイパート ID は次の形式で作成されます。
daypart_id = base_dayparting_id
+ days_since_monday * 10000
+ start * 100
+ end

base_dayparting_id = 300000
days_since_monday: 0=月曜日、1=火曜日、...、6=日曜日
start: 0..95（00:00 ～ 23:45）15 分間のスロットを表す 0 ～ 95 の整数
end: 1..96（00:15 ～ 24:00）15 分間のスロットを表す 0 ～ 95 の整数
start < end
新しいエンティティの場合、時刻はユーザーのタイムゾーン（」）を選択します。既存のエンティティのタイムゾーンは変更されません。
環境ターゲティング[タイプ] が「ディスプレイ」、「動画」、「オーディオ」のいずれかの場合、必須文字列、リストはいターゲットとする環境のリスト。リスト形式 =（PC ウェブ、モバイルアプリなど）。
ディスプレイ環境の場合:
  • パソコン（ウェブ）
  • モバイルウェブ
  • モバイル アプリ
  • モバイルアプリ インタースティシャル
  • モバイル向けデスクトップ ウェブ
動画の場合:
  • デスクトップ ウェブ動画
  • デスクトップ ウェブ ゲーム
  • デスクトップ ウェブ - 記事内
  • デスクトップ ウェブ フィード内
  • モバイルウェブ動画
  • モバイルアプリ動画
  • モバイルアプリ動画インタースティシャル
音声の場合:
  • デスクトップ ウェブ オーディオ
  • モバイルウェブ オーディオ
  • モバイルアプリのオーディオ
視認性ターゲティング（アクティブ ビュー）いいえ文字列はい予測される視認性の割合を目標に設定します。パーセンテージは浮動小数点数で表されます。{0.1、0.2、0.3、0.4、0.5、0.6、0.7、0.8、0.9} のいずれか
視認性ターゲティングの広告の位置 - 含めるいいえ文字列はい広告の掲載位置をターゲットに設定します。次のいずれかの値を選択します。
  • すべて
  • ATF
  • BTF
  • 不明
視認性ターゲティングの広告の掲載順位 - 除外いいえ文字列はいターゲティングで広告の掲載位置を除外する。次のいずれかの値を選択します。
  • ATF
  • BTF
  • 不明
動画広告の掲載位置ターゲティングいいえ文字列、リストはいターゲットに設定する動画広告の掲載位置のリスト。次のいずれかの値を選択します。
  • 不明
  • プレロール
  • ミッドロール
  • ポストロール
動画プレーヤーのサイズによるターゲティングいいえ文字列、リストはいターゲットとする動画広告プレーヤーのサイズのリスト。次のいずれかの値を選択します。
  • 不明
  • 小
  • 大
  • HD
年齢や性別によるターゲティング: 性別いいえ文字列、リストはいターゲットに設定する性別のリスト。次のいずれかの値を選択します。
  • 女性
  • 男性
  • 不明
年齢によるターゲティングいいえ文字列、リストはいユーザーの年齢層をターゲットに設定します。開始年齢と終了年齢を 1 つずつ選択し、不明な年齢を含めるかどうかを true または false で指定して、開始年齢から終了年齢までの範囲を指定します。使用できる [開始] と [終了] の年齢のリストをご覧ください。
例 1: 18 ～ 55 歳のユーザーをターゲットに設定し、不明な年齢のユーザーも含めるには、{開始; 終了; 不明な年齢を含める（true または false）} の形式で指定します = 18;55;true;
例 2: 35 歳以上のユーザーのみをターゲットに設定し、不明な年齢のユーザーを除外するには、次のように指定します = 35;+;false;。
[開始] に指定できる値:
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

To に指定できる値:
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
接続速度によるターゲティングいいえ文字列はい特定の接続速度をターゲットに設定します。次のいずれかの値を選択します。
  • すべて
  • 2G
  • 3G
  • DSL
  • 4G
携帯通信会社によるターゲティング - 含めるいいえ文字列、リストはいターゲットとするISP または携帯通信会社のリスト。リストの形式 = {ISP.id; ISP.id;}
携帯通信会社によるターゲティング - 除外いいえ文字列、リストはい除外するISP または携帯通信会社のリスト。リストの形式 = {ISP.id; ISP.id;}
TrueView モバイルの入札単価調整オプションいいえ文字列はい[増加] または [減少]
  • 増やす
  • 減らす
TrueView モバイルの入札単価調整率いいえintegerはいモバイルで広告が表示される可能性を高めるための入札単価調整。許可される調整は、入札単価調整オプション「増加」の場合: [0;900%]、および「減少」の場合: [0;90%] または 100% です。
TrueView カテゴリ除外ターゲティングいいえ文字列、リストはい除外するカテゴリのリスト。リストの形式 = ゲーム、惨事、紛争など
  • 埋め込み動画
  • ライブ配信
  • ゲーム
  • 惨事、紛争
  • デリケートな社会問題
  • ファミリー
  • すべてのオーディエンス
  • 13 ～ 17 歳
  • ティーン
  • 大人
  • 未評価
  • 性的内容を示唆するコンテンツ
  • 刺激的、衝撃的
  • 冒とく、乱暴な表現
TrueView の広告枠ソース ターゲティングいいえ文字列、リストはい含める TrueView 広告枠ソースのリスト
  • YouTube 検索
  • YouTube 動画
  • 動画パートナー