形式の説明については、概要をご覧ください。
フィールド | 必須 | タイプ | 書き込み可能 | 説明 |
---|---|---|---|---|
エクスチェンジ | タグ形式以外の保証型取引では必須 | 文字列 | ○ | 広告枠ソースのエクスチェンジ。 |
製品 ID | タグ形式以外の保証型取引の作成または編集、タグ形式の保証型取引の編集に必須です。 | 文字列 | ○ | 広告枠ソースのエクスチェンジ固有の取引 ID。この値は、タグ保証型取引の作成時に書き込みできません。 |
広告枠ソース ID | 既存の広告枠ソースを編集する場合にのみ必要です | 文字列 | いいえ | 広告枠ソースの DBM ID。空白のままにすると、指定されたエクスチェンジ ID と取引 ID を持つ新しい広告枠ソースが作成されます。 |
プロダクト名 | ○ | 文字列 | ○ | 広告枠ソース名。 |
コミットメント タイプ | ○ | 文字列 | ○ | 広告枠ソースの契約タイプ。作成時にのみ編集できます。指定できる値は、Guaranteed と Nonguaranteed です。
|
料金の種類 | ○ | 文字列 | ○ | 広告枠ソースのレートタイプ。作成時にのみ編集できます。使用できるのは [オークション] と [固定] のみです。
|
配信方法 | ○ | 文字列 | ○ | 広告枠ソースの配信方法。作成時にのみ編集できます。使用できるのは「タグ」と「プログラマティック」のみです。
|
パブリッシャー/販売者 | タグ形式予約型配信でのみ必須 | 文字列 | ○ | 取引のパブリッシャーの名前 |
評価 | ○ | float | ○ | 取引の CPM の正の金額。これは、単純な整数のインプレッション値でも、通貨金額の浮動小数点数でもかまいません。通貨は [通貨] 列に指定されている通貨で表示されます。タグ形式以外の予約型配信取引や、完全に設定されたタグ形式予約型配信取引では、この値を編集できません。 |
通貨コード | ○ | 文字列 | ○ | 取引の CPM で使用される通貨
|
開始日 | タグ形式予約型配信でのみ必須 | 文字列 | ○ | 取引の開始日時のタイムスタンプ(MM/DD/YYYY HH:mm 形式)。タグなしの保証取引や、完全に設定されたタグ保証取引では、この値を編集できません。 |
終了日 | タグ形式予約型配信でのみ必須 | 文字列 | ○ | 取引の終了日を MM/DD/YYYY HH:mm の形式で指定します。タグ保証以外の取引タイプに終了日が指定されていない場合、取引は無期限に実行されます。 |
取得日 | いいえ | 文字列 | いいえ | 取引の獲得日時のタイムスタンプ(MM/DD/YYYY HH:mm 形式)。 |
ステータス | ○ | 文字列 | ○ | エントリのステータス設定。
|
一時停止の理由 | タグ形式以外の保証型取引の一時停止には必須です。 | 文字列 | ○ | 取引が一時停止されている理由を、購入者が指定したものです。このフィールドは、優先取引またはプライベート オークションには適用されません。 |
権限のあるパートナー | [許可された広告主] フィールドが空の場合は必須です。 | 文字列、リスト | ○ | この取引の権限を持つパートナーのパートナー ID のリスト。リスト形式 = (10; 20; 30;) |
Permissioned Advertisers | [許可されたパートナー] フィールドが空の場合は必須です。 | 文字列、リスト | ○ | この取引の権限を持つ広告主の広告主 ID のリスト。リスト形式 = (11; 22; 33;) |
オーダー ID | いいえ | 文字列 | いいえ | 保証型取引のオーダー ID。このフィールドは、優先取引またはプライベート オークションには適用されません |
オーダー名 | タグ形式予約型配信でのみ必須です。 | 文字列 | ○ | 保証型取引のオーダー名。このフィールドは、優先取引またはプライベート オークションには適用されません。 |
購入数 | タグ形式予約型配信でのみ必須 | integer | ○ | 純広告商品の保証表示回数。書き込みできるのは、タグ形式予約型配信のみです。このフィールドは、優先取引またはプライベート オークションには適用されません。 |
形式 | タグ形式予約型配信でのみ必須 | 文字列 | ○ | 取引のクリエイティブ タイプ(ディスプレイ、動画など)。書き込みできるのは、タグ形式予約型配信の作成時と、構成されていないタグ形式予約型配信の場合のみです。このフィールドは、優先取引またはプライベート オークションには適用されません。
|
サイズ | タグ形式予約型配信でのみ必須 | 文字列、リスト | ○ | 取引に必要なクリエイティブのサイズ。書き込みできるのは、タグ形式予約型配信の作成時と、タグ形式予約型配信が設定されていない場合のみです。クリエイティブのタイプがディスプレイの場合、コンテンツは <width>x<height> 形式のリストとして記述されます(例:「300x250; 728x90;」)。クリエイティブ タイプが動画の場合、コンテンツは秒単位の再生時間のリストとして書き込まれます(例:「15; 20;」)。このフィールドは、優先取引またはプライベート オークションには適用されません |