構造化データ - v4 - 広告掲載オーダー

この SDF バージョンは廃止されました。構造化データファイルを引き続き使用するには、SDF v9 に移行する必要があります。このドキュメントは、以前に生成されたファイルを参照する場合にのみ使用してください。

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

フィールド	必須	タイプ	書き込み可能	説明
Io Id	既存の広告掲載オーダーを編集する場合にのみ必要です	integer	いいえ	広告掲載オーダーの数値 ID 値。空白のままにすると、新しい挿入オーダー ID が作成され、一意の ID が割り当てられます。オプションとして、新しい広告掲載オーダーを作成する際に、新しい広告掲載オーダーに広告申込情報を割り当てる目的でカスタム識別子を使用できます。カスタム識別子の形式は、ext[カスタム識別子] です（例: ext123）。ファイルがアップロードされて処理されると、すべてのカスタム識別子は DBM によって割り当てられる ID に置き換えられ、オブジェクトはカスタム識別子に基づいて関連付けられます（広告申込情報と挿入オーダーなど）。
キャンペーン ID	いいえ	integer	いいえ	キャンペーンの数値 ID 値。この広告申込情報と同時に作成するキャンペーンのカスタム識別子（例: ext[カスタム キャンペーン識別子]）を指定できます。
名前	はい	文字列	はい	エントリの名前。
タイムスタンプ	既存のエントリを編集する場合に必要	integer	いいえ	エントリのタイムスタンプ。これは、ダウンロードとアップロードの間にエントリが変更されていないことを確認するために、システムによって使用されます。
ステータス	はい	文字列	はい	エントリのステータス設定。 有効 一時停止 下書き アーカイブ済み 削除済み
Io Type	はい	文字列	はい	広告掲載オーダーのタイプ。作成時にのみ設定できます。 standard
料金	いいえ	文字列、リストのリスト	はい	このエントリのすべての料金。リスト形式 =（料金カテゴリ; 料金額; 料金タイプ; 請求済み;）。 手数料のカテゴリ CPM メディア Fee amount（手数料） 浮動小数点数 Pct（浮動小数点数） 料金タイプ （文字列、料金の表を参照） 請求書発行済み 正しい 誤り 空白 例: '(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） CPM ShopLocal 必須（True） CPM TrustMetrics 許可しない（空白のままにする） CPM Integral Ad Science 動画 許可（True/False） CPM MOAT 動画 許可しない（空白のままにする） メディア Bid Manager の手数料 必須（True） メディア メディア費用データ 許可しない（空白のままにする） CPM Premium 料金 許可しない（空白のままにする）
統合コード	いいえ	文字列	はい	トラッキング用のオプション コード。
詳細	いいえ	文字列	はい	文字列形式のエントリの詳細。
ペース	はい	文字列	はい	ペース配分額の消化に使用される期間。 毎日 1 か月 フライト
ペース設定率	はい	文字列	はい	このエントリのペース配分率。 できるだけ早く 均等 なった内容
期間内予算	はい	float	はい	ペース配分タイプで設定された期間あたりの費用。
フリークエンシーが有効	はい	文字列	はい	広告掲載オーダーでインプレッション ベースのフリークエンシー キャップを有効または無効にします。 TRUE FALSE
フリークエンシーの表示回数	[Frequency Enabled] が [TRUE] の場合は必須	integer	はい	特定のフリークエンシーの回数（「y 期間に x 回表示」の x）を表す正の整数値。
フリークエンシー期間	[Frequency Enabled] が [TRUE] の場合は必須	文字列	はい	フリークエンシー キャップの期間の単位を指定します。 分 時間 数日間 数週間 月 全期間
Frequency Amount	[Frequency Enabled] が [TRUE] の場合は必須	integer	はい	「フリークエンシー期間」タイプの期間の正の整数値。つまり、「y 期間に x 回のインプレッションを表示する」の y です。
パフォーマンス目標のタイプ	はい	文字列	はい	広告掲載オーダーの目標単位 CPM CPA クリック単価 CPV CPIAVC クリック率 視認性の割合（%） なし その他
パフォーマンス目標値	はい	文字列	はい	目標値（通貨（CPM、CPA、CPC、CPV、CPIAVC）、パーセンテージ（% 視認性、CTR）、文字列（その他））。
DAR を測定する	はい	文字列	はい	Nielsen Digital Ad Ratings を使用したオーディエンス測定を有効または無効にします。 TRUE FALSE
DAR チャネルを測定する	「Measure DAR」が「TRUE」の場合は必須	integer	はい	Nielsen Digital Ad Ratings で測定するチャネル。Format = UniversalChannel.id
予算タイプ	はい	文字列	はい	支出する「収益」額（金額）または購入するインプレッション数（インプレッション）のいずれかで予算のタイプを指定します。 金額 表示回数
予算セグメント	はい	文字列、リストのリスト	はい	特定の予算セグメントを指定します。リストの形式 =（予算、開始日、終了日）。予算は通貨の浮動形式です。日付は MM/DD/YYYY 形式です。例: 「(100.50;01/01/2016;03/31/2016;);(200.00;04/01/2016;06/30/2016;);」
予算の自動割り当て	はい	文字列	はい	予算の自動割り当てを有効または無効にします。 TRUE FALSE
地域ターゲティング - 含む	いいえ	文字列、リスト	はい	ターゲティングに含める地域のリスト。リスト形式 =（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;etc.)。
ブラウザ ターゲティング - 除外	いいえ	文字列、リスト	はい	ターゲット設定で除外するブラウザのリスト。リスト形式 = (Browser.id;Browser.id;etc.)。
ブランド保護ラベル	いいえ	文字列、リスト	はい	ターゲットに設定するデジタル コンテンツ ラベルのリスト。リスト形式 =（G;PG; など）。 G PG T MA ?
ブランド保護の感度設定	いいえ	文字列	はい	周辺のコンテンツのカテゴリに基づいて広告枠をブロックするには、センシティビティ設定を選択します。 ブロックしない DoubleClick Verification を使用する カスタムを使用
ブランド保護のカスタム設定	[ブランド保護のカスタム設定] が [カスタムを使用] の場合に必須	文字列、リスト	はい	ブランド保護の感度設定が [カスタムを使用] の場合は、標準コンテンツ分類子のリストを指定します。例: （成人向け;アルコール;タバコなど）。 アダルト 中傷 ダウンロードと共有 武器および兵器 ギャンブル 暴力 性的内容を示唆 冒とく アルコール 薬物 タバコ 政治 宗教 惨事 交通事故 デリケートな社会問題 衝撃的
第三者認証サービス	いいえ	文字列	はい	第三者ベリフィケーション サービス プロバイダ。 なし Integral Ad Science DoubleVerify Adloox
第三者確認ラベル	いいえ	文字列、リスト	はい	[Third Party Verification Services] が [None] 以外の場合は、選択したプロバイダでサポートされているラベルのリストを指定します。
チャンネル ターゲティング - 含む	いいえ	文字列、リスト	はい	ターゲティングに含めるチャンネルのリスト。リスト形式 =（UniversalChannel.id;UniversalChannel.id; など）。
チャンネル ターゲティング - 除外	いいえ	文字列、リスト	はい	ターゲティングに含めるチャンネルのリスト。リスト形式 =（UniversalChannel.id;UniversalChannel.id; など）。
サイト ターゲティング - 追加	いいえ	文字列、リスト	はい	ターゲティングに含めるサイトのリスト。ユニバーサル サイト テーブルにない場合は、サイト ID のセットまたは URL の文字列をリストに含めることができます。リストの形式 =（UniversalSite.Id;'http://someurl.com'; など）。
サイト ターゲティング - 除外	いいえ	文字列、リスト	はい	ターゲット設定で除外するサイトのリスト。ユニバーサル サイト テーブルにない場合は、サイト ID のセットまたは URL の文字列をリストに含めることができます。リストの形式 =（UniversalSite.Id;'http://someurl.com'; など）。
アプリのターゲティング - 含む	いいえ	文字列、リスト	はい	ターゲティングに含めるアプリのリスト。ユニバーサル サイト テーブルにない場合は、UniversalSite ID のセットまたはアプリ パッケージの文字列をリストに含めることができます。リスト形式 = (UniversalSite.Id; 'some.app.package';etc.)。
アプリのターゲティング - 除外	いいえ	文字列、リスト	はい	ターゲティングで除外するアプリのリスト。ユニバーサル サイト テーブルにない場合は、UniversalSite ID のセットまたはアプリ パッケージの文字列をリストに含めることができます。リスト形式 = (UniversalSite.Id; 'some.app.package';etc.)。
アプリ コレクションのターゲティング - 含む	いいえ	文字列、リスト	はい	ターゲティングに含めるアプリ コレクションのリスト。リスト形式= アプリ コレクション ID; アプリ コレクション ID;
アプリ コレクション ターゲティング - 除外	いいえ	文字列、リスト	はい	ターゲティングで除外するアプリ コレクションのリスト。リスト形式= アプリ コレクション ID; アプリ コレクション ID;
カテゴリ ターゲティング - 追加	いいえ	文字列、リスト	はい	AdX 業種 ID から、ターゲティングに含めるカテゴリのリスト。リスト形式 = (Verticals.Id;Verticals.Id;etc.)。
カテゴリ ターゲティング - 除外	いいえ	文字列、リスト	はい	ターゲティングで除外するカテゴリのリスト（AdX の業種 ID）。リスト形式 = (Verticals.Id;Verticals.Id;etc.)。
キーワード ターゲティング - 含む	いいえ	文字列、リスト	はい	ターゲティングに含めるキーワード文字列のリスト。
キーワード ターゲティング - 除外	いいえ	文字列、リスト	はい	ターゲティングで除外するキーワード文字列のリスト。
キーワード リスト ターゲティング - 除外	いいえ	文字列、リスト	はい	ターゲティングで除外する除外キーワード リストのリスト。リスト形式= 除外キーワード リスト ID; 除外キーワード リスト 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; recency optional;）;（UserList.id; recency optional;）; 例: "(1;1d;);(2;);"。 有効な recency 値は、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 です。
アフィニティと購買意向の強いオーディエンス ターゲティング - 含む	いいえ	文字列、リスト	はい	含めるアフィニティ カテゴリまたは購買意向の強いオーディエンスのリストのリスト。リスト形式= ユーザーリスト 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=月曜日、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 不明
動画広告の掲載位置ターゲティング	いいえ	文字列、リスト	はい	ターゲットとする動画広告の掲載位置のリスト。許容される値から 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 宛先として指定できる値: 25 35 45 55 65 +
ユーザー属性ターゲティングの世帯収入	いいえ	文字列、リスト	はい	世帯収入の範囲をターゲットに設定します。単一の Top_of_Range 収入範囲と単一の Bottom_of_Range 収入範囲を選択し、収入が不明な世帯を含めるかどうか（true / false）を指定して、範囲を指定します。許容される Top_of_Range/Bottom_of_Range の範囲のリストをご覧ください。 例 1: 上位 10 ～ 50% の世帯をターゲットとし、収入が不明な世帯を含めるには、{Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true; という形式を指定します。 例 2: 下位 50% の世帯のみをターゲットとし、収入が不明な世帯を除外するには、{Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true; という形式を指定します。 Top_of_Range/Bottom_of_Range に使用できる値: 上位 10% 11～20% 21～30% 31～40% 41～50% 下位 50%
ユーザー属性ターゲティングの子供の有無	はい	文字列、リスト	はい	ターゲットに設定する子供の有無のリスト。許容される値のいずれか 1 つ以上を選択します。 親 子供なし 不明
接続速度によるターゲティング	いいえ	文字列	はい	特定の接続速度をターゲットに設定します。次のいずれかの値を選択します。 すべて 2G 3G DSL 4G
携帯電話会社のターゲット設定 - 含む	いいえ	文字列、リスト	はい	ターゲットとする ISP または携帯通信会社のリスト。リスト形式 = {ISP.id; ISP.id;}
携帯電話会社のターゲティング - 除外	いいえ	文字列、リスト	はい	除外する ISP または携帯通信会社のリスト。リスト形式 = {ISP.id; ISP.id;}