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

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

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

例 '(CPM; 2; Bid Manager 料金; False) ; (Media; 13; デフォルト; 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 動画許可されない（空白のまま）
MediaBid Manager 料金必須（True）
Mediaメディア費用データ許可されない（空白のまま）
CPMプレミアム料金許可されない（空白のまま）
統合コード×string○トラッキング用のコード（省略可）。
詳細×string○文字列形式のエントリの詳細。
入札戦略のタイプ[タイプ] が [ディスプレイ]、[動画]、[オーディオ] の場合は必須string○ 該当する入札戦略を 1 つ選択します。
  • 最小化: 予算全額を使い切りながら、CPA/CPC を最小限に抑える
  • 最大化: 予算を全額使い切りながら、インプレッション値または質の高いインプレッションを最大化します
  • 達成: CPA/CPC の目標 X を達成する
  • vCPM を最適化: 視認範囲のインプレッション単価を X に最適化
  • 固定: 固定入札単価 X を指定します
入札単価戦略の値[入札戦略タイプ] が [最小化]、[最大化]、[タイプ] が [TrueView] の場合は必須float○ビート、VCPM の最適化、固定の戦略タイプの場合は、目標入札単価の値を選択します。
なお、入札戦略タイプが「最小化」または「最大化」の場合、入札戦略の値は必要ありません。
入札戦略ユニット[入札戦略タイプ] が [ビート]、[最小化]、[最大化] の場合は必須string○ビート、最小化、最大化の戦略タイプで、対応するユニットを選択します。
  • CPA
  • CPC
  • 費用あたりのカスタム インプレッション値
  • CIVA
  • IVO_TEN
  • AV_VIEWED
  • INCREMENTAL_CONVERSIONS
入札戦略が超えない[タイプ] が [ディスプレイ]、[動画]、[オーディオ] の場合は必須float○CPM 値に「超えない」を設定してください。0 の場合、「超過不可」は有効になりません。入札戦略が「最小化」、「最大化」、「ビート」のいずれかの場合にのみ使用できます。
クリエイティブの割り当て×文字列、リスト○エントリに割り当てるクリエイティブ ID のリスト。リストの形式 = (Creative.common_data.id;Creative.common_data_id;など)。
地域ターゲティング - 追加×文字列、リスト○ターゲティングに含める地域のリスト。リスト形式 =（GeoLocation.id、GeoLocation.id など）。
地域ターゲティング - 除外×文字列、リスト○ターゲティングで除外する地域のリスト。リスト形式 = (GeoLocation.id;GeoLocation.id; など)。
ターゲット言語 - 一致×文字列、リスト○ターゲティングに含める言語のリストです。リスト形式 = (Language.id;Language.id;など)。
ターゲット言語 - 除外×文字列、リスト○ターゲティングで除外する言語のリストです。リスト形式 = (Language.id;Language.id;など)。
デバイス ターゲティング - 追加×文字列、リスト○ターゲティングに含めるデバイスのリスト。リスト形式 = (DeviceCriteria.id;DeviceCriteria.id; など)。
デバイス ターゲティング - 除外×文字列、リスト○ターゲティングで除外するデバイスのリストです。リスト形式 = (DeviceCriteria.id;DeviceCriteria.id; など)。
ブラウザ ターゲティング - 追加×文字列、リストはいターゲティングに含めるブラウザのリストです。リスト形式 = (Browser.id;Browser.id;など)。
ブラウザ ターゲティング - 除外×文字列、リスト○ターゲティングで除外するブラウザのリストです。リスト形式 = (Browser.id;Browser.id;など)。
ブランド保護ラベル×文字列、リスト○ターゲットとするデジタル コンテンツ ラベルのリストです。リスト形式 = (G;PG; など)
  • 1 階
  • PG
  • T
  • MA
  • ?
ブランド保護の感度設定×string○機密性の設定を選択して、周囲のコンテンツのテーマに基づいて広告枠をブロックします。
  • ブロックしない
  • DoubleClick ベリフィケーションを使用する
  • カスタムを使用
ブランド保護のカスタム設定[ブランド保護のカスタム設定] が [カスタムを使用] の場合は必須文字列、リスト○ブランド保護の感度設定が [カスタムを使用] の場合は、標準のコンテンツ分類のリストを指定します。たとえば、「成人」、「アルコール」、「タバコ」などです。
  • Adult
  • 中傷
  • ダウンロードと共有
  • 武器および兵器
  • ギャンブル
  • 暴力行為
  • 性的内容を示唆
  • 冒とく
  • アルコール
  • 治療薬
  • タバコ
  • 政治
  • 宗教
  • 悲劇
  • 交通事故
  • デリケートな社会問題
  • 衝撃的
第三者検証サービス×string○第三者のベリフィケーション サービス プロバイダ。
  • なし
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三者の認証ラベル×文字列、リスト○第三者検証サービスの設定が [なし] でない場合は、選択したプロバイダでサポートされているラベルのリストを指定します。
チャネル ターゲティング - 追加×文字列、リスト○ターゲティングに含めるチャネルのリストです。リスト形式 = (UniversalChannel.id;UniversalChannel.id; など)。
チャネル ターゲティング - 除外×文字列、リスト○ターゲティングに含めるチャネルのリストです。リスト形式 = (UniversalChannel.id;UniversalChannel.id; など)。
サイト ターゲティング - 追加×文字列、リスト○ターゲティングに含めるサイトのリストです。[ユニバーサル サイト] の表にサイト ID や URL 文字列がない場合は、リストに一連のサイト ID や URL 文字列を含めることができます。リスト形式 = (UniversalSite.Id;'http://someurl.com'; など)。
サイト ターゲティング - 除外×文字列、リスト○ターゲティングで除外するサイトのリストです。[ユニバーサル サイト] の表にサイト ID や URL 文字列がない場合は、リストに一連のサイト ID や URL 文字列を含めることができます。リスト形式 = (UniversalSite.Id;'http://someurl.com'; など)。
アプリ ターゲティング - 追加×文字列、リスト○ターゲティングに含めるアプリのリストです。このリストには、一連の 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; など)。
キーワード ターゲティング - 追加×文字列、リスト○ターゲティングに含めるキーワード文字列のリスト。
キーワード ターゲティング - 除外×文字列、リスト○ターゲティングで除外するキーワード文字列のリスト。
オーディエンス ターゲティング - 類似ユーザー[タイプ] が [ディスプレイ]、[動画]、[オーディオ] の場合は必須string○ ターゲットの自社リストに対して類似ユーザーを有効にします。
  • TRUE
  • FALSE
オーディエンス ターゲティング - 追加×文字列、ペアのリスト○ターゲティングに含めるオーディエンス リストのリスト。自社オーディエンス リストの場合、各オーディエンスは、ユーザーリスト ID と期限設定のペアとして表示されます。ペアは (1;1d;) で、1d は 1 日のリピート間隔を表すサンプルリピート間隔です。第三者オーディエンスでは期限を指定できないため、リストの形式は (3;);(4;); となります。オーディエンスのグループを「AND」または「OR」で結合するには、次の例をご覧ください。「((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));」。つまり、（1 日 1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、3 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日、1 日

オーディエンス ターゲティング - 除外×文字列、ペアのリスト○ターゲティングで除外するオーディエンス リストのリストです。オーディエンス リストが自社オーディエンス リストの場合、各オーディエンスは、ユーザーリスト ID と期限の設定のペアとして表示されます。ペアは (1;1d;) で、1d は 1 日のリピート間隔を表すサンプルリピート間隔です。ただし、サードパーティ オーディエンスの場合、リピート間隔は確認できないため、リストの形式は「(3;);(4;);」となります。List format= (UserList.id; recency optional;); (UserList.id; recency optional;);
例: "(1;1d;);(2;);"。
有効なリピートの値は次のとおりです。
all、1m、5m、10m、15m、30m、1h、2h、3h、1h、6h
アフィニティ ターゲティングと購買意向の強いターゲティング - 追加×文字列、リスト○含めるアフィニティまたは購買意向の強いオーディエンスのリストのリスト。リスト形式= ユーザーリスト ID; ユーザーリスト ID;
アフィニティと購買意向の強いオーディエンスによるターゲティング - 除外×文字列、リスト○除外するアフィニティまたは購買意向の強いオーディエンスのリストのリスト。リスト形式= ユーザーリスト ID; ユーザーリスト ID;
カスタム アフィニティ ターゲティング×文字列、リスト○ターゲットとするカスタムリストのリストです。リスト形式= ユーザーリスト ID; ユーザーリスト 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=Monday, 1=6=Tuesday, ...,



「ローカル」）。既存のエンティティについては、タイムゾーンは変更されません。
環境ターゲティング[タイプ] が [ディスプレイ]、[動画]、[オーディオ] の場合は必須文字列、リスト○対象とする環境のリスト。リストの形式 =（PC ウェブ、モバイルアプリなど）。
ディスプレイ環境の場合:
  • PC ウェブ
  • モバイルウェブ
  • モバイル アプリ
  • モバイルアプリ インタースティシャル
  • モバイル向けデスクトップ ウェブ
動画の場合:
  • PC ウェブ動画
  • PC ウェブゲーム
  • PC ウェブ インリード
  • PC ウェブ インフィード
  • モバイルウェブ動画
  • モバイルアプリ動画
  • モバイルアプリ動画インタースティシャル
オーディオの場合:
  • PC ウェブ オーディオ
  • モバイルウェブ オーディオ
  • モバイルアプリ オーディオ
視認性ターゲティングのアクティブ ビュー×string○視認性の予測割合を目標にします。割合は浮動小数点数で表されます。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} のいずれか
視認性ターゲティングによる広告掲載順位 - 追加×string○広告内の位置をターゲットに設定します。使用可能な値を 1 つ選択するか、まったく選択しないようにします。
  • すべて
  • ATF
  • 部分一致
  • 不明
視認性ターゲティングの広告の掲載順位 - 除外×string○ターゲティングで広告位置を除外する。使用可能な値を 1 つ選択するか、まったく選択しないようにします。
  • ATF
  • 部分一致
  • 不明
動画広告の掲載位置のターゲティング×文字列、リスト○ターゲットとする動画広告内の位置のリストです。使用可能な値を 1 つ以上選択します。
  • 不明
  • プレロール
  • ミッドロール
  • ポストロール
動画プレーヤーのサイズによるターゲティング×文字列、リスト○ターゲットとする動画広告プレーヤー サイズのリストです。使用可能な値を 1 つ以上選択します。
  • 不明
  • 小さく初めて
  • 大
  • HD
年齢や性別によるターゲティング: 性別×文字列、リスト○ターゲットとする性別のリストです。使用可能な値を 1 つ以上選択します。
  • 女性
  • 男性
  • 不明
年齢や性別によるターゲティング×文字列、リスト○ユーザーの年齢層をターゲットに設定する。「開始」と「終了」の範囲を指定するには、「開始の年齢」と「終了の年齢」を 1 つだけ選択し、不明な年齢を含めるかどうか（true または false）を指定します。使用できる開始/終了の年齢のリストをご覧ください。
例 1: 18 ～ 55 歳をターゲットとし、不明な年齢を含めるには、{From; To ; include unknown True/False} = 18;55;true; の形式を指定します。
例 2: 35 歳以上のユーザーのみをターゲットに設定し、不明な年齢を除外するには、次のように指定します。= 35;+;false;。
From に指定できる値:
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

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