配置サービス
プレースメント サービスを使用すると、プレースメント広告タグを作成したり、広告タグを変更したり表示したりできます。 配置は、マネージド パブリッシャーまたは直接メディア購入に使用します。
- 配置 ID とそれに関連する情報は、Xandr でサーバー側に格納され、簡単に変更できます。
- プレースメントを作成するときは、そのプレースメントで配信できるクリエイティブの種類を指定します (下記の「
supported_media_types
とsupported_media_subtypes
」を参照してください)。
注:
このサービスを介した広告主、広告申込情報、またはキャンペーンのターゲット設定は、 支払ルール サービスによって定義されたターゲティングよりも優先されます。
タグ形式
配置 ID を取得したら、次のように配置タグを書式設定し、自分が表す発行元、または購入が保証されている発行元に渡します。
注:
"id"
は配置 ID です。
ヒント
プレースホルダーを含め、広告呼び出し中に追加のクエリ文字列パラメーターをプラットフォームに渡すことができます。
重要
セキュア インベントリ (SSL) で配置タグを提供する場合は、ホストを使用するように次のタグを変更する必要があります。 "https://secure.adnxs.com/..."
IFRAME
<!-- BEGIN IFRAME TAG < - DO NOT MODIFY -->
<IFRAME SRC="https://ib.adnxs.com/tt?id=2704"
FRAMEBORDER="0"
SCROLLING="no"
MARGINHEIGHT="0"
MARGINWIDTH="0"
TOPMARGIN="0"
LEFTMARGIN="0"
ALLOWTRANSPARENCY="true"
WIDTH="120"
HEIGHT="600"></IFRAME>
<!-- END TAG -->
JavaScript
<!-- BEGIN JS TAG < - DO NOT MODIFY -->
<SCRIPT SRC="https://ib.adnxs.com/ttj?id=2704" TYPE="text/javascript"></SCRIPT>
<!-- END TAG -->
REST API
注:
code
、placement_code
、site_code
、publisher_code
は、以下の呼び出しで対応する ID の代わりに使用できます。
HTTP メソッド | エンドポイント | 説明 |
---|---|---|
POST |
https://api.appnexus.com/placement?publisher_id=PUBLISHER_ID https://api.appnexus.com/placement?site_id=SITE_ID (配置 JSON) |
配置を追加する (NETWORK)。 |
PUT |
https://api.appnexus.com/placement?id=PLACEMENT_ID&publisher_id=PUBLISHER_ID https://api.appnexus.com/placement?code=PLACEMENT_ID&site_id=SITE_ID (配置 JSON) |
既存の配置 (NETWORK) を変更します。 |
DELETE |
https://api.appnexus.com/placement?id=PLACEMENT_ID&publisher_id=PUBLISHER_ID https://api.appnexus.com/placement?code=PLACEMENT_CODE&publisher_code=PUBLISHER_CODE |
既存の配置を削除します。 |
GET |
https://api.appnexus.com/placement?publisher_id=PUBLISHER_ID |
いずれかのパブリッシャーのすべての配置を表示します。 |
GET |
https://api.appnexus.com/placement?id=PLACEMENT_ID |
いずれかの発行元の特定の配置を表示します。 |
GET |
https://api.appnexus.com/placement?id=1,2,3 |
サイトのすべての配置を表示します。 |
JSON フィールド
フィールド | 種類 | 説明 |
---|---|---|
id |
int | 配置の ID。 既定値: 自動インクリメントされた数値 (つまり 123) 必須: クエリ文字列内の PUT |
name |
string (100) | 配置の名前。 必須: POST |
code |
string (100) | 配置のカスタム コード。 注: コードは英数字でなければならず、スペースを含めることはできません。 次の文字も使用できます。 - ピリオド (".") - アンダースコア ("_") - ハイフン ("-") - パーセント ("%") |
code2 |
string (100) | 配置の 2 番目のカスタム コード。 注: コードは英数字でなければならず、スペースを含めることはできません。 次の文字も使用できます。 - ピリオド (".") - アンダースコア ("_") - ハイフン ("-") - パーセント ("%") |
code3 |
string (100) | 配置の 3 番目のカスタム コード。 注: コードは英数字でなければならず、スペースを含めることはできません。 次の文字も使用できます。 - ピリオド (".") - アンダースコア ("_") - ハイフン ("-") - パーセント ("%") |
state |
列挙 | 配置の状態。 使用可能な値: "active" または "inactive" 。既定値: "active" |
width |
int | 配置の幅。 |
height |
int | 配置の高さ。 |
is_resizable |
ブール型 | 配置で使いやすい iFrame を使用し、配置のサイズを小さいクリエイティブまたは大きいクリエイティブに合わせてサイズ変更する場合は、このフィールドを true に設定します。既定値: false |
default_position |
列挙 | ページ上の配置の既定の位置。 使用可能な値: - "above" (フォールドの上)"below" (フォールドの下)"unknown" 既定値: "unknown" |
publisher_id |
int | 配置に関連付けられている発行元の ID。 必須: POST |
publisher_name |
string (100) | 配置に関連付けられている発行元の名前。 |
site_id |
int | この配置の親サイトの ID。 各配置はサイトに属している必要があります。 既定値: 発行元のサイト |
site_name |
string (100) | 配置が使用されるサイトの名前。 |
inventory_source_id |
int | 非推奨。 |
ad_profile_id |
int | 配置に関連付けられている広告プロファイルの ID。 注: 広告プロファイルを配置に "割り当てる" 方法は、次のとおりです。ターゲット プロファイルを使用して広告品質ルールを作成します (プロファイルは配置を "ターゲット" にします)。 広告プロファイルを広告品質規則にリンクします。 パブリッシャーに広告品質ルールを割り当てます。 そうすることで、ターゲティング プロファイルを使用して柔軟性を高めることができます。 |
supported_media_types |
オブジェクトの配列 | 配置で提供できるメディアの種類。 詳細については 、以下の「サポートされているメディアの種類 」を参照してください。 重要: supported_media_types または supported_media_subtypes を指定しない場合は、 "Banner" メディアの種類とそのすべてのサブタイプが既定で許可されます。 |
supported_media_subtypes |
オブジェクトの配列 | 配置で提供できるメディア サブタイプ。 詳細については、以下 の「サポートされているメディア サブタイプ 」を参照してください。 |
pop_values |
配列 | 非推奨。 |
default_creative_id |
int |
非推奨。 代わりに default_creatives を使用してください。 |
default_creatives |
配列 | オークションの勝者がいない場合に、PSA の代わりに表示される既定のクリエイティブ。 既定のクリエイティブごとに、予約価格は配列の [ "price" ] フィールドで設定されます。 詳細については 、以下の「既定のクリエイティブ 」を参照してください。注: 事前入力の場合を除き、予約価格が満たされていない場合、配置はポップされません。 |
reserve_price |
double | 各プレースメントの既定のクリエイティブの予約価格は、 default_creatives 配列で設定されます (下記の 「既定のクリエイティブ 」を参照)。 プレースメントに既定のクリエイティブがない場合は、ここでプレースメントの予約価格を設定できます。ただし、予約価格がPSAの表示を引き起こす可能性があるため、これはベストプラクティスではありません。 重要: 利回り管理プロファイルは、配置レベルの予約価格設定よりも優先されます。 このようなプロファイルがある場合は、ハードフロアを介して希望の予約価格を設定する必要があります。 |
hide_referer |
ブール型 |
true 場合、参照元は報告されません。 |
default_referrer_url |
string | [可視性プロファイル] が入札要求で在庫 URL を非表示にするように設定されている場合は、代わりにバニティ URL を渡すようにこのフィールドを設定できます。 これは、パブリッシャーが実際のドメインを共有したくないが、それでも買い手がドメインで識別できるようにしたい場合に特に便利です。 |
visibility_profile_id |
int | 配置に直接割り当てられた可視性プロファイルの ID。 可視性プロファイルの詳細については、「 可視性プロファイル」を参照してください。 |
exclusive |
ブール型 |
読み取り専用。 配置のインベントリを再販可能にするかどうかを指定するには、配置のサイトの marketplace_map オブジェクトのrtb フィールドを使用します。 このフィールドの説明については、「 サイト サービス 」を参照してください。 再販可能なすべてのインベントリは、RTB Marketplace の一部です。既定値: False |
pixel_url |
string | ユーザーが配置を読み込む際の Piggyback 呼び出し。 既定値: null |
pixel_type |
列挙 | ピクセルの種類を識別します。 使用可能な値は "javascript" または "image" です。既定値: image |
content_categories |
配列 | この配置に関連付けられているコンテンツ カテゴリの一覧。 配置には最大 20 個のカテゴリを指定できます。 |
filtered_advertisers |
配列 | プレースメントをターゲットに設定できる広告主の一覧。 |
filtered_line_items |
配列 | 配置をターゲットにできる広告申込情報の一覧。 |
filtered_campaigns |
配列 | 配置をターゲットにできるキャンペーンの一覧。 |
segments |
配列 | この配置を表示したときにユーザーが追加されるセグメントの一覧。 |
estimated_clear_prices |
オブジェクトの配列 | 過去に参加しているサード パーティのオークションの過半数 (95%) を獲得した入札金額。 詳細については、以下の 「見積もりクリア価格 」を参照してください。 |
media_subtypes |
配列 |
非推奨。 代わりに supported_media_types と supported_media_subtypes を使用してください。 |
intended_audience |
列挙 | 自己監査専用の値。 使用可能な値: - "general" - "children" - "young_adult" - "mature" |
inventory_attributes |
配列 | 配置に含まれる機密性の高い属性。 ヒント: inventory_attributes はサイト レベルでも適用でき、この場合は配置レベルのオブジェクトにも影響します。 これは、ID を持つオブジェクトの配列です。 ID の一覧については、 インベントリ属性サービス を参照してください。 |
audited |
ブール型 |
true 場合、配置は所有者によって自己監査されています。既定値: false |
audit_level |
列挙 | 自己監査専用の値。 注: サイト レベルでの自己監査は、配置レベルでオーバーライドできます。 使用可能な値: - "site" - audited フィールドが配置で false に設定されているが、サイト内で true 場合は、この値を使用します。- "placement" - audited フィールドが配置で true に設定されている場合は、この値を使用します。既定値: "site" |
default_calculation_type |
列挙 | これにより、既定のクリエイティブが配信される入札価格のしきい値が決まります。 このしきい値がネットワークの総収益か、パブリッシャーの純収益かを選択できます。 追加の対象となるキャンペーンがない場合、または利用可能な既定のクリエイティブがない場合は、PSA が提供されます。 使用可能な値: "gross" または "net" 。既定値: "gross" |
apply_floor_to_direct |
ブール型 |
削除されました。 代わりに floor_application_target を使用してください。 |
demand_filter_action |
string | 含めるか除外できる需要ソースを示します。 既定値: default |
floor_application_target |
列挙 | 予約価格が適用される入札の種類。 使用可能な値: - "external_only" - 予約価格は外部の入札にのみ適用されます (購入メンバーと販売メンバーは異なります)。 このオプションは、学習の 1 日あたりの最大量 (Publisher Service の [max_learn_pct ] フィールド) を超える場合でも、既定値を提供するよりも、使用可能なマネージド学習インプレッションを提供する場合に使用します。- "external_non_preferred" - 予約価格は外部の入札に適用されます (購入メンバーと販売メンバーは異なります)、またはインプレッションが学習の 1 日のボリュームの最大 % を超える使用可能なマネージド 学習インプレッションである場合。 このオプションは、学習の 1 日のボリュームの最大 % を超える使用可能なマネージド学習インプレッションを提供するよりも、既定値を提供する場合に使用します。- "all" - 予約価格は、Learn の 1 日のボリュームの最大 % 以内のマネージド 学習インプレッションを除くすべての入札に適用されます。既定値: "all" |
pixel_url_secure |
string | ユーザーの読み込み時にピギーバック呼び出しをセキュリティで保護します。 既定値: null |
site_audit_status |
列挙 | サイトがクリエイティブ監査を実行することを決定した方法を示します。 使用可能な値は "self" または "unaudited" です。既定値: unaudited |
toolbar |
object | 販売者は、すべてのツール バーとブラウザー プラグイン インベントリを宣言する必要があります。 販売者が "ツールバー" インベントリ属性を割り当てる場合は、この追加のメタデータも含める必要があります。 |
acb_code |
string (32) | 非推奨。 |
tag_data |
文字列 | 非推奨。 |
cost_cpm |
double | 値が存在する場合は、配置の支払情報として使用されます。 これにより、発行元に関連付けられている支払い規則がオーバーライドされます。 既定値: null |
is_prohibited |
ブール型 |
読み取り専用。
true 場合、Xandr コンテンツ ポリシーに違反したため、配置が禁止されています。 直接および第三者のオークションは禁止された配置に対して実行されません。既定値: false |
last_modified |
timestamp | 読み取り専用。 配置が最後に変更された日時。 |
stats |
object |
stats オブジェクトは非推奨になりました (2016 年 10 月 17 日現在)。 代わりに Report Service を使用して統計情報を取得します。 |
content_retrieval_timeout_ms |
int | この配置のタイムアウトは、"仲介された" クリエイティブから取得されたコンテンツ (つまり、 content_source が "mediation" に設定されているクリエイティブ) に設定されます。 詳細については、 クリエイティブ サービスに関するページを参照してください。 - 0 に設定されている場合、広告サーバーはメンバー サービスの値を使用します- PUT 呼び出しまたはPOST 呼び出しで API に指定されていない場合、既定値は 0 です。- 広告サーバーがこのフィールドの 0 を読み取ると、メンバー参照が実行され、 メンバー サービス によって定義された既定のタイムアウトが使用されます (0 以外の場合)。- 配置を作成するときに、メンバーの既定の設定からこのフィールドに値はコピーされません。 POST の呼び出しで明示的に指定する必要があります。 詳細については、メンバー サービスのdefault_content_retrieval_timeout_ms フィールドを参照してください。既定値: 0 |
enable_for_mediation |
ブール型 | これは、配置が仲介コンテンツを受け入れる必要があるかどうかの真実のソースになります。
PUT またはPOST に設定しない限り、このフィールドはメンバーから既定値を継承します。
メンバー サービスで既定値が変更された場合、そのアクションは以前に作成した配置にさかのぼって影響を与えるものではありません。これらは引き続き古い既定値に設定されます。 つまり、メンバーの既定値を設定することで、このフィールドの値をさかのぼって更新することはできません。 詳細については、メンバー サービスのdefault_enable_for_mediation フィールドを参照してください。既定値: メンバー サービス default_enable_for_mediation フィールドから継承されます。 |
private_sizes |
オブジェクトの配列 | 取引やパッケージでサービスを提供できる可能性がある配置サイズの一覧。 詳細については、以下の 「プライベート サイズ 」を参照してください。 |
video |
object | 配置で提供できるメディア サブタイプ。 詳細については、以下の 「ビデオ設定」 を参照してください。 既定値: null |
ad_types |
オブジェクトの配列 | 広告タイプ ID やレンダラーに関する情報など、配置の種類に関する情報が含まれます。 詳細については、以下の 「広告の種類」を 参照してください。 既定値: null 必須: PUT |
use_detected_domain |
ブール値 |
読み取り専用。 検出されたドメインと報告されたドメインのどちらを使用するか。 既定値は、すべてのクライアントの true です。既定値: true |
mime_types |
文字列の配列 | 配置に含める、または除外する MIME の種類の一覧。
supported_mime_types_action_include は、これらの MIME の種類を含めるか除外するかを指定するために使用されます。 各 MIME の種類を識別するために使用される文字列の一覧については、「 サポートされている Mime の種類」を参照してください。既定値: empty |
supported_mime_types_action_include |
ブール値 |
true 場合、mime_types 配列に一覧表示されている mime 型が含まれます。既定値: false |
handles_mixed_media |
ブール値 | これにより、ビデオ プレーヤーがさまざまな MIME の種類の VAST ファイルをサポートできるかどうかをプラットフォームに通知します。 既定値: true |
tinytag_renderer_asset_floor_prices |
オブジェクトの配列 | フロア価格を、配置に割り当てられているネイティブ クリエイティブに関連付けます。 詳細については、「 Tinytag Renderer Asset Floor Prices」を参照してください。 必須: PUT |
is_ss_native_assembly_enabled |
ブール値 | 有効にすると、元の要求はバナー要求になりますが、入札者に送信される要求には、応答でネイティブ資産を受信するためにネイティブ情報が設定されます。 最終的な応答は、ネイティブの組み立て広告マークアップが添付されたバナー広告の種類に戻されます。
true 場合は 、はい。 |
サポートされているメディアの種類
クリエイティブは、メディアの種類とメディア サブタイプによって分類されます。 メディアの種類は、クリエイティブの一般的な表示スタイルを定義します (たとえば、 "Banner"
、メディア サブタイプは、 "Standard Banner"
や "In-Banner Video"
など、クリエイティブの特定の表示スタイルを定義します。 この配列を使用して、クリエイティブの一般的な表示スタイルであるメディアの種類を制限し、配置で配信できます。 クリエイティブの特定の表示スタイルであるメディア サブタイプを制限するには、 supported_media_subtypes
配列を使用します (後述の 「サポートされているメディア サブタイプ 」を参照してください)。
フィールド | 種類 | 説明 |
---|---|---|
id |
int | 許可されるメディアの種類の ID。
Media Type Service を使用すると、すべてのメディアの種類を表示できます。 既定値: 1 |
name |
string | 許可されるメディアの種類の名前。 既定値: "Banner" |
media_type_group_id |
int | メディアの種類のグループ ID。 |
uses_sizes |
列挙 | メディアの種類にサイズ指定があるかどうか。 使用可能な値: - "always" - "sometimes" - "never" |
last_modified |
date |
allowed_media_type オブジェクトが最後に更新されたとき。 |
サポートされているメディア サブタイプ
クリエイティブは、メディアの種類とメディア サブタイプによって分類されます。 メディアの種類は、クリエイティブの一般的な表示スタイルを定義します (たとえば、 "Banner"
、メディア サブタイプは、 "Standard Banner"
や "In-Banner Video"
など、クリエイティブの特定の表示スタイルを定義します。 この配列を使用して、配置で配信できるメディア サブタイプ (クリエイティブの特定の表示スタイル) を制限できます。 クリエイティブの一般的な表示スタイルであるメディアの種類を制限するには、 supported_media_types
配列を使用します (上記の「 サポートされているメディアの種類 」を参照してください)。
フィールド | 種類 | 説明 |
---|---|---|
id |
int | 許可されるメディア サブタイプの ID。
メディア サブタイプ サービスを使用して、すべてのメディア サブタイプを表示できます。 既定値: null |
name |
string | 許可されるメディア サブタイプの名前。 |
is_private |
ブール値 | メディア サブタイプがプライベートに設定されているかどうか。
true 場合は 、はい。 |
media_type_group_id |
int | メディアの種類のグループ ID。 |
注:
サポートされているメディアの種類とメディア サブタイプ
- サポートされているメディアタイプまたはサポートされているメディアサブタイプを指定しない場合は、
"Banner"
メディアタイプとそのすべてのサブタイプが既定で許可されます。 -
"Banner"
メディアタイプと"Text"
メディアタイプとそのメディアサブタイプの任意の組み合わせを1つの配置で組み合わせることができますが、他のメディアタイプとメディアサブタイプを組み合わせることはできません。 この制限により、適切なクリエイティブのみが配置に配信されるようになります。 たとえば、"Video"
メディア タイプのクリエイティブをビデオ プレーヤーにフィードできるようにする配置は、他のメディア タイプのクリエイティブ ("Interstitial"
など) がその配置に対して配信できるようにすることは意味がありません。 - 配置を設定して、直接インベントリの
"Expandable"
メディア タイプまたはそのサブタイプを許可できます。 他のプラットフォーム メンバーへの転売に使用できるプレースメントに対して拡張可能なクリエイティブをサポートする場合は、確認を サポート するプレースメントの ID を指定してください。
サポートされている MIME の種類
オブジェクトの mime_types
配列では、次の表に示す MIME 型がサポートされています。 MIME タイプが指定されていない場合は、すべての MIME タイプが受け入れられます。 Placement API では 、Name 列の文字列が使用されます。 この情報をタグに渡す必要がある場合は、ID を使用します。
名前 | Id |
---|---|
application/x-shockwave-flash |
1 |
video/x-flv |
2 |
video/mp4 |
3 |
video/webm |
4 |
application/javascript |
5 |
application/octet-stream |
6 |
image/jpeg |
7 |
image/gif |
8 |
image/png |
9 |
application/zip |
10 |
application/vnd.ms-asf |
11 |
video/x-ms-wmv |
12 |
video/ogg |
13 |
video/x-msvideo |
14 |
video/mpeg |
15 |
video/quicktime |
16 |
video/3gpp |
17 |
video/3gpp2 |
18 |
video/x-m4v |
19 |
audio/ogg |
20 |
audio/x-pn-realaudio |
21 |
audio/mpeg |
22 |
text/css |
23 |
text/html |
24 |
text/plain |
25 |
audio/mp4 |
26 |
ビデオ設定
supported_media_type
が"video"
されているか、supported_media_subtypes
が"Standard VAST"
されている場合は、これらのフィールドを video
オブジェクトに含める必要があります。 以下 の例を 参照してください。
注:
次の設定は、オークションの結果に影響します。アウトストリーム ビデオ プレーヤーの最終的な動作を決定するアウトストリーム プレーヤー設定については、UI ドキュメントの「Outstream Video Player Settings」を参照してください。
フィールド | 種類 | 説明 |
---|---|---|
id |
int | ビデオ設定オブジェクトの一意の ID。 |
width |
int | ビデオ クリエイティブの幅。 |
max_duration_secs |
int | 配置で再生できる動画広告の最大再生時間。 - maximum_number_ads が >1 の場合、最大期間は広告ポッドの長さ全体 (1 つの配置を埋めるように設計された複数の広告の線形グループ) に適用されます。注: 広告ポッドを有効にするには、このフィールドを設定する必要があります。 |
maximum_ad_duration_secs |
int | 配置で再生できる 1 つの広告の最大動画広告の再生時間 (秒単位)。 これは広告ポッドにのみ適用されます。 |
maximum_number_ads |
int | 配置で再生できる広告の最大数。
maximum_number_ads が>1 の場合、配置は広告ポッド (1 つの配置を埋めるように設計された複数の広告の線形グループ) にすることができます。 |
start_delay_secs |
int | 配置の開始遅延 (秒単位)。 開始遅延値が >0 場合、配置の位置が "mid-roll" されます。注: コンテキストが "mid-roll" 場合は、このフィールドを設定する必要があります。 |
skipoffset_seconds |
int | ビデオをスキップするまでの再生が許可される秒数。 既定値は null です。 注意: この値を null 以外の値に設定する場合は、 supports_skippable フィールドを true に設定する必要があります。 (以下を参照)。 |
supports_skippable |
ブール値 | 広告スロットはスキップ可能です。 使用可能な値: "true" または "false" |
context |
string | ビデオ クリエイティブのロール位置。 使用可能な値: "pre-roll" 、 "mid-roll" 、 "post-roll" 。重要: 広告ポッドを有効にするには、このフィールドを設定する必要があります。 |
layback_method |
string | さまざまな再生方法は次のとおりです。 - Auto-play, sound-on - Auto-play, sound-off - Click-to-play - Mouse-over - Auto-play, sound unknown 使用可能な値: - "auto_play_sound_on" - "auto_play_sound_off" - "click_to_play" - "mouse_over" - "auto_play_sound_unknown" - null |
frameworks |
文字列の配列 | 配置のフレームワーク。 オプションは以下のとおりです。 - VPAID 1.0 - VPAID 2.0 - MRAID-1 - ORMMA - MRAID-2 使用可能な値: - "vpaid_1_0" - "vpaid_2_0" - "mraid_1" - "ormma" - "mraid_2" |
video_bumpers |
オブジェクトの配列 | 広告ポッドに関連付けることができるバンパー。 バンパー期間は、広告ポッドの全体の期間には含まれません。 ビデオ バンパー オブジェクトを参照してください。 |
player_vast_version |
string | このフィールドは、配置でサポートされる最も大きいバージョンを指定し、プレイヤーがサポートする最大値に設定する必要があります。 プレイヤーのバージョンを超える膨大なバージョンを必要とするクリエイティブは、プレースメントで配信することはできません。 使用可能な値: - 2.0 - 3.0 - 4.0 注意: プレイヤーがサポートしている値より大きい値を指定すると、サポートされていないクリエイティブがレンダリングされるとエラーが発生する可能性があります。 |
vmin_ad_duration |
int | 許可されている最小クリエイティブ期間 (秒単位)。 |
minbitrate |
int | 最小ビットレート (kbps)。 |
mf_min_width |
int | ビデオ クリエイティブの最小幅。 |
mf_min_height |
int | ビデオ クリエイティブの最小高さ。 |
aspect_ratios |
オブジェクトの配列 | ビデオの配置に役立つクリエイティブアスペクト比。 配列には、 ratio_width と ratio_height が含まれています。 |
ビデオ バンパー
このオブジェクトの配列には、広告ポッドのバンパーに関連する情報が含まれています。
フィールド | 種類 | 説明 |
---|---|---|
video_bumper_type |
string | バンパーの種類。 オプションは以下のとおりです。 - intro - outro 既定値: null |
max_duration_secs |
int | バンパーの最大継続時間。 既定値: null |
縦横比
このオブジェクトの配列には、ビデオの配置に役立つクリエイティブな縦横比に関する情報が含まれています。
フィールド | 種類 | 説明 |
---|---|---|
ratio_width |
int | 縦横比の幅 |
ratio_height |
int | 縦横比の高さ |
広告の種類
このオブジェクトの配列には、広告の種類 ID やレンダラーに関する情報など、配置の種類に関する情報が含まれています。
フィールド | 種類 | 説明 |
---|---|---|
id |
int |
ad_type の ID。使用可能な値: 1 = バナー2 = ビデオ3 = ネイティブ既定値: null 必須: POST /PUT |
renderer_id |
int | レンダラーの ID。 使用可能な値: 1 = アウトストリーム バナー2 = アウトストリーム ビデオ既定値: null 必須: POST /PUT |
name |
string |
video やbanner など、すべての小文字のad_type の名前。 |
display_name |
string |
Video やBanner など、初期大文字の広告の種類として表示されるad_type の表示名。 |
renderer |
multi オブジェクト | レンダラーの id と display_name で構成されるオブジェクト。既定値: null 必須: POST /PUT |
Tinytag レンダラーの資産フロア価格
このオブジェクトの配列は、配置に割り当てられているネイティブ クリエイティブにフロア価格を関連付けるために使用されます。
フィールド | 型 (長さ) | 説明 |
---|---|---|
renderer_id |
int | レンダラーの ID。 必須: POST /PUT |
ad_type_id |
int |
ad_type の ID。 フロア価格をネイティブ クリエイティブにのみ関連付けることができるため、これは常に 3 になります。既定値: 3 必須: POST /PUT |
asset_type |
string | 資産の種類。 次の値を指定できます。 - main_image - video 必須: POST /PUT |
floor_price |
double | ネイティブアセットのインプレッションと引き換えに推奨される入札金額。 必須: POST /PUT |
既定のクリエイティブ
この配列を使用して、既定のクリエイティブを配置に割り当てます。 次の要件に注意してください。
既定のクリエイティブの有効期限が切れてはいけません。 詳細については、クリエイティブ サービスの [
is_expired
] フィールドを参照してください。既定のクリエイティブは、配置の
supported_media_types
とsupported_media_subtypes
に一致するクリエイティブ テンプレートに割り当てる必要があります。 たとえば、配置で"Banner"
メディア タイプのクリエイティブが許可されている場合、"Interstitial"
メディア タイプにクリエイティブ テンプレートを使用する既定のクリエイティブを関連付けることはできません。 詳細については、クリエイティブ サービスの [template
] フィールドを参照してください。配置のサイズが設定されている場合 (
"width"
フィールドと"height"
フィールドが配置用に定義されている場合)、この配列には、一致するディメンションを持つクリエイティブが 1 つだけ含まれている必要があります。
フィールド | 種類 | 説明 |
---|---|---|
id |
int | 既定のクリエイティブの ID。 |
width |
int | 既定のクリエイティブの幅。 |
height |
int | 既定のクリエイティブの高さ。 |
price |
double | 既定のクリエイティブの予約価格。 落札額は、この価格を超える必要があります。 |
name |
string | 読み取り専用。 既定のクリエイティブの名前。 |
ポップ値
supported_media_type
が"Pop"
されている場合、またはsupported_media_subtypes
が"Popup"
または"Popunder"
されている場合は、これらのフィールドをpop_values
配列に含める必要があります。 例については、以下を参照してください。
フィールド | 種類 | 説明 |
---|---|---|
pop_freq_times |
int | タグが一意のユーザー ID に pop_frequency_duration 秒でポップできる回数。
pop_is_prepop が true に設定されている場合、効果はありません。既定値: No frequency cap |
pop_freq_duration |
int |
pop_freq_times を参照してください。既定値: No frequency cap |
pop_is_prepop |
ブール型 |
true 場合、タグはプレポップ タグであり、パブリッシャー ページが既にポップされているウィンドウに機能します。既定値: false |
pop_max_width |
int |
pop_max_width が指定されている場合、タグによって表示されるクリエイティブの幅は、pop_max_width 既定値: no max width 。 |
pop_max_height |
int | クリエイティブの最大高さ。
pop_max_height が指定されている場合、タグによって表示されるクリエイティブの高さは、pop_max_height 以下である必要があります。既定値: no max height |
見積もりクリア価格
フィールド | 種類 | 説明 |
---|---|---|
clear_price |
int | 過去にこのプレースメントに参加するサード パーティのオークションの過半数 (95%) を獲得した入札金額。 |
average_price |
double | これは、このプレースメントに送信されたすべての入札の平均です。 |
width |
int | 提供するサイズレス配置タグをエクスポートする場合、配置の幅が決まります。 |
height |
int | 提供するサイズレス配置タグをエクスポートする場合、配置の高さが決まります。 |
verified |
ブール型 | クリエイティブが検証済みかどうかを示します。 |
geo_country |
string | インプレッションに関連付けられている地理的な場所の国コード。 |
プライベート サイズ
この配列は、カスタム取引またはパッケージで提供できる特定の配置サイズを決定します。 これらのプライベート サイズを標準の配置サイズと共に使用するには、Deal Service または Package Service のoverride_size_preference
をappend
に設定する必要があります。
フィールド | 種類 | 説明 |
---|---|---|
width |
int | 配置の幅。 |
height |
int | 配置の高さ。 |
統計
stats
オブジェクトは非推奨になりました (2016 年 10 月 17 日現在)。 代わりに Report Service を使用して統計情報を取得します。
ブラウザー プラグイン宣言 & ツール バー
プラットフォーム ポリシーに従って、販売者はすべてのツール バー/ブラウザー プラグイン インベントリを識別し、独自の配置で他のインベントリから分離する必要があります。 ツール バーのインベントリを識別するには、販売者は次の手順を実行する必要があります。
-
inventory_attribute
を適切に設定します。 - ツールバー配列で必要な情報を送信します。ここで説明します。
パラメーター | 型 | 説明 |
---|---|---|
name |
string | ツール バーの一般的な商品名。 |
company |
string | ツール バーの開発者。 会社名ではなく、法人を特定してください。 |
tos_url |
string | 監査者が完全なサービス条件を見つけることができる Web ページへのリンク。 |
install_url |
string | 監査者がツール バーをインストールできる Web ページへのリンク。 |
例
いずれかのパブリッシャーのすべての配置を表示する
$ curl -b cookies -c cookies 'https://api.appnexus.com/placement?publisher_id=88888'
{
"response": {
"status": "OK",
"count": 4,
"start_element": 0,
"num_elements": 100,
"placements": [
{
"id": 594595,
"name": "Test Placement 1",
"code": null,
"code2": null,
"code3": null,
"state": "active",
"cost_cpm": null,
"publisher_id": 88888,
"site_id": 188040,
"reserve_price": null,
"width": 300,
"height": 250,
"default_position": "unknown",
"default_creative_id": null,
"ad_profile_id": null,
"acb_code": null,
"tag_data": null,
"hide_referer": false,
"inventory_source_id": null,
"pixel_url": "",
"pixel_type": "image",
"last_modified": "2011-10-24 19:45:31",
"media_subtypes": [
"banner"
],
"intended_audience": "general",
"audited": true,
"audit_level": "placement",
"default_calculation_type": "gross",
"publisher_name": "National Public Radio",
"site_name": "[Test Publisher 1] - ROS",
"site_audit_status": "unaudited",
"demand_filter_action": "include",
"is_resizable": true,
"pixel_url_secure": "",
"floor_application_target": "all",
"pop_values": null,
"inventory_attributes": [
{
"id": 2,
"name": "Political opinion"
},
{
"id": 16,
"name": "Blogs"
}
],
"supported_media_types": [
{
"name": "Banner",
"id": 1
}
],
"supported_media_subtypes": null,
"content_categories": [
{
"id": 7,
"name": "Arts & Entertainment",
"is_system": true
},
{
"id": 17,
"name": "News",
"is_system": true
},
{
"id": 25,
"name": "Society",
"is_system": true
},
{
"id": 11445,
"name": "Books & Literature",
"is_system": true
}
],
"segments": null,
"estimated_clear_prices": [
{
"clear_price": 1,
"average_price": 0.5,
"width": 0,
"height": 0,
"verified": true
}
],
"filtered_advertisers": [
{
"id": 35081,
"name": "Test Advertiser 1"
}
],
"filtered_line_items": null,
"filtered_campaigns": null,
"default_creatives": null
},
{
"id": 605055,
"name": "Test Placement 2",
"code": null,
"code2": null,
"code3": null,
"state": "active",
"cost_cpm": null,
"publisher_id": 88888,
"site_id": 188040,
"reserve_price": null,
"width": null,
"height": null,
"default_position": "unknown",
"default_creative_id": null,
"ad_profile_id": null,
"acb_code": null,
"tag_data": null,
"hide_referer": false,
"inventory_source_id": null,
"pixel_url": null,
"pixel_type": "image",
"last_modified": "2012-03-08 00:49:50",
"media_subtypes": null,
"intended_audience": null,
"audited": false,
"audit_level": "site",
"default_calculation_type": "gross",
"publisher_name": "Test Publisher 1",
"site_name": "[Test Publisher 1] - ROS",
"site_audit_status": "unaudited",
"demand_filter_action": "default",
"is_resizable": false,
"pixel_url_secure": null,
"floor_application_target": "all",
"pop_values": null,
"inventory_attributes": null,
"supported_media_types": [
{
"id": 1,
"name": "Banner"
},
{
"id": 5,
"name": "Text"
}
],
"supported_media_subtypes": null,
"content_categories": null,
"segments": null,
"estimated_clear_prices": [
{
"clear_price": 1,
"average_price": 0.5,
"width": 0,
"height": 0,
"verified": true
}
],
"filtered_advertisers": null,
"filtered_line_items": null,
"filtered_campaigns": null,
"default_creatives": null
},
{
"id": 605056,
"name": "Test Placement 3",
"code": null,
"code2": null,
"code3": null,
"state": "active",
"cost_cpm": null,
"publisher_id": 88888,
"site_id": 188040,
"reserve_price": null,
"width": null,
"height": null,
"default_position": "unknown",
"default_creative_id": null,
"ad_profile_id": null,
"acb_code": null,
"tag_data": null,
"hide_referer": false,
"inventory_source_id": null,
"pixel_url": null,
"pixel_type": "image",
"last_modified": "2012-03-08 00:54:37",
"media_subtypes": null,
"intended_audience": null,
"audited": false,
"audit_level": "site",
"default_calculation_type": "gross",
"publisher_name": "Test Publisher 1",
"site_name": "[Test Publisher 1] - ROS",
"site_audit_status": "unaudited",
"demand_filter_action": "default",
"is_resizable": false,
"pixel_url_secure": null,
"floor_application_target": "all",
"pop_values": null,
"inventory_attributes": null,
"supported_media_types": null,
"supported_media_subtypes": [
{
"id": 3,
"name": "In-Banner Video",
"media_type": {
"id": 1
}
}
],
"content_categories": null,
"segments": null,
"estimated_clear_prices": [
{
"clear_price": 1,
"average_price": 0.5,
"width": 0,
"height": 0,
"verified": true
}
],
"filtered_advertisers": null,
"filtered_line_items": null,
"filtered_campaigns": null,
"default_creatives": null
},
{
"id": 605057,
"name": "Test Placement 4",
"code": null,
"code2": null,
"code3": null,
"state": "active",
"cost_cpm": null,
"publisher_id": 88888,
"site_id": 188040,
"reserve_price": null,
"width": 1,
"height": 1,
"default_position": "unknown",
"default_creative_id": null,
"ad_profile_id": null,
"acb_code": null,
"tag_data": null,
"hide_referer": false,
"inventory_source_id": null,
"pixel_url": null,
"pixel_type": "image",
"last_modified": "2012-03-08 01:07:47",
"media_subtypes": null,
"intended_audience": null,
"audited": false,
"audit_level": "site",
"default_calculation_type": "gross",
"publisher_name": "Test Publisher 1",
"site_name": "[Test Publisher 1] - ROS",
"site_audit_status": "unaudited",
"demand_filter_action": "default",
"is_resizable": false,
"pixel_url_secure": null,
"floor_application_target": "all",
"pop_values": null,
"inventory_attributes": null,
"supported_media_types": [
{
"id": 3,
"name": "Interstitial"
}
],
"supported_media_subtypes": null,
"content_categories": null,
"segments": null,
"estimated_clear_prices": [
{
"clear_price": 1,
"average_price": 0.5,
"width": 0,
"height": 0,
"verified": true
}
],
"filtered_advertisers": null,
"filtered_line_items": null,
"filtered_campaigns": null,
"default_creatives": null
}
]
}
}
特定の配置を表示する
$ curl -b cookies -c cookies 'https://api.appnexus.com/placement?id=605057'
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"placement": {
"id": 605057,
"name": "Test Placement 4",
"code": null,
"code2": null,
"code3": null,
"state": "active",
"cost_cpm": null,
"publisher_id": 88888,
"site_id": 188040,
"reserve_price": null,
"width": 1,
"height": 1,
"default_position": "unknown",
"default_creative_id": null,
"ad_profile_id": null,
"acb_code": null,
"tag_data": null,
"hide_referer": false,
"inventory_source_id": null,
"pixel_url": null,
"pixel_type": "image",
"last_modified": "2012-03-08 01:07:47",
"media_subtypes": null,
"intended_audience": null,
"audited": false,
"audit_level": "site",
"default_calculation_type": "gross",
"publisher_name": "Test Publisher 1",
"site_name": "[Test Publisher 1] - ROS",
"site_audit_status": "unaudited",
"demand_filter_action": "default",
"is_resizable": false,
"pixel_url_secure": null,
"floor_application_target": "all",
"pop_values": null,
"inventory_attributes": null,
"supported_media_types": [
{
"id": 3,
"name": "Interstitial"
}
],
"supported_media_subtypes": null,
"content_categories": null,
"segments": null,
"estimated_clear_prices": [
{
"clear_price": 1,
"average_price": 0.5,
"width": 0,
"height": 0,
"verified": true
}
],
"filtered_advertisers": null,
"filtered_line_items": null,
"filtered_campaigns": null,
"default_creatives": null
}
}
}
"Interstitial"
メディアタイプのクリエイティブのみを許可する配置を追加する
$ cat placement
{
"placement": {
"name": "Placement for Interstitials",
"publisher_id": 88888,
"supported_media_types": [
{
"id": 3
}
],
"video": 10,
"supports_skippable": true,
"player_vast_version" "3.0"
}
}
}
$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement'
{
"response": {
"status": "OK",
"count": 1,
"id": 605058,
"start_element": 0,
"num_elements": 100,
"placement": {
"id": 605058,
"name": "Placement for Interstitials",
"code": null,
"code2": null,
"code3": null,
"state": "active",
"cost_cpm": null,
"publisher_id": 88888,
"site_id": 188040,
"reserve_price": null,
"width": 1,
"height": 1,
"default_position": "unknown",
"default_creative_id": null,
"ad_profile_id": null,
"acb_code": null,
"tag_data": null,
"hide_referer": false,
"inventory_source_id": null,
"pixel_url": null,
"pixel_type": "image",
"last_modified": "2012-03-08 01:41:52",
"media_subtypes": null,
"intended_audience": null,
"audited": false,
"audit_level": "site",
"default_calculation_type": "gross",
"publisher_name": "Test Publisher 1",
"site_name": "[Test Publisher 1] - ROS",
"site_audit_status": "unaudited",
"demand_filter_action": "default",
"is_resizable": false,
"pixel_url_secure": null,
"floor_application_target": "all",
"pop_values": null,
"inventory_attributes": null,
"supported_media_types": [
{
"id": 3,
"name": "Interstitial"
}
],
"supported_media_subtypes": null,
"content_categories": null,
"segments": null,
"estimated_clear_prices": [
{
"clear_price": 1,
"average_price": 0.5,
"width": 0,
"height": 0,
"verified": true
}
],
"filtered_advertisers": null,
"filtered_line_items": null,
"filtered_campaigns": null,
"default_creatives": null
}
}
}
"In-Banner Video"
メディア サブタイプを持つクリエイティブのみを許可する配置を追加する
$ cat placement
{
"placement": {
"name": "Placement for In-Banner Video",
"publisher_id": 88888,
"supported_media_subtypes": [
{
"id": 3
}
],
"video": 10,
"supports_skippable": true,
"player_vast_version" "3.0"
}
}
}
$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement'
{
"response": {
"status": "OK",
"count": 1,
"id": 605059,
"start_element": 0,
"num_elements": 100,
"placement": {
"id": 605059,
"name": "Placement for In-Banner Video",
"code": null,
"code2": null,
"code3": null,
"state": "active",
"cost_cpm": null,
"publisher_id": 88888,
"site_id": 188040,
"reserve_price": null,
"width": null,
"height": null,
"default_position": "unknown",
"default_creative_id": null,
"ad_profile_id": null,
"acb_code": null,
"tag_data": null,
"hide_referer": false,
"inventory_source_id": null,
"pixel_url": null,
"pixel_type": "image",
"last_modified": "2012-03-08 01:46:43",
"media_subtypes": null,
"intended_audience": null,
"audited": false,
"audit_level": "site",
"default_calculation_type": "gross",
"publisher_name": "Test Publisher 1",
"site_name": "[Test Publisher 1] - ROS",
"site_audit_status": "unaudited",
"demand_filter_action": "default",
"is_resizable": false,
"pixel_url_secure": null,
"floor_application_target": "all",
"pop_values": null,
"inventory_attributes": null,
"supported_media_types": null,
"supported_media_subtypes": [
{
"id": 3,
"name": "In-Banner Video",
"media_type": {
"id": 1
}
}
],
"content_categories": null,
"segments": null,
"estimated_clear_prices": [
{
"clear_price": 1,
"average_price": 0.5,
"width": 0,
"height": 0,
"verified": true
}
],
"filtered_advertisers": null,
"filtered_line_items": null,
"filtered_campaigns": null,
"default_creatives": null
}
}
}
"Popup"
メディア サブタイプを持つクリエイティブのみを許可する配置を追加する
$ cat placement
{
"placement": {
"name": "Placement for Popups",
"publisher_id": 88888,
"supported_media_subtypes": [
{
"id": 2
}
],
"pop_values":{
"pop_is_prepop":false,
"pop_freq_times":4,
"pop_freq_duration":1440,
"pop_max_width":500,
"pop_max_height":100
}
}
}
$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement?publisher_id=88888'
{
"response": {
"status": "OK",
"count": 1,
"id": 605076,
"start_element": 0,
"num_elements": 100,
"placement": {
"id": 605076,
"name": "Placement for Popups",
"code": null,
"code2": null,
"code3": null,
"state": "active",
"cost_cpm": null,
"publisher_id": 88888,
"site_id": 188040,
"reserve_price": null,
"width": null,
"height": null,
"default_position": "unknown",
"default_creative_id": null,
"ad_profile_id": null,
"acb_code": null,
"tag_data": null,
"hide_referer": false,
"inventory_source_id": null,
"pixel_url": null,
"pixel_type": "image",
"last_modified": "2012-03-08 15:56:05",
"media_subtypes": null,
"intended_audience": null,
"audited": false,
"audit_level": "site",
"default_calculation_type": "gross",
"publisher_name": "National Public Radio",
"site_name": "[National Public Radio] - ROS",
"site_audit_status": "unaudited",
"demand_filter_action": "default",
"is_resizable": false,
"pixel_url_secure": null,
"floor_application_target": "all",
"pop_values": {
"pop_freq_times": 4,
"pop_freq_duration": 1440,
"pop_is_prepop": false,
"pop_max_width": 500,
"pop_max_height": 100
},
"inventory_attributes": null,
"supported_media_types": null,
"supported_media_subtypes": [
{
"id": 2,
"name": "Popup",
"media_type": {
"id": 2
}
}
],
"content_categories": null,
"segments": null,
"estimated_clear_prices": [
{
"clear_price": 1,
"average_price": 0.5,
"width": 0,
"height": 0,
"verified": true
}
],
"filtered_advertisers": null,
"filtered_line_items": null,
"filtered_campaigns": null,
"default_creatives": null
}
}
}
"Video Standard VAST"
メディア サブタイプを持つクリエイティブのみを許可する配置を追加する
$ cat placement
{
"placement": {
"name": "Placement for Standard VAST Video",
"publisher_id": 585173,
"supported_media_subtypes": [
{
"id": 64
}
],
"video": {
"id": 5,
"width": 750,
"max_duration_secs": 30,
"supports_skippable": true,
"player_vast_version": "3.0",
"context": "pre-roll",
"playback_method": null,
"frameworks": [
"vpaid_1_0",
"vpaid_2_0",
"mraid_1",
"ormma",
"mraid_2"
]
}
}
}
$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement?publisher_id=585173'
{
"response": {
"status": "OK",
"count": 1,
"id": 5078562,
"start_element": 0,
"num_elements": 100,
"placement": {
"id": 5078562,
"name": "Placement for Standard VAST Video",
"code": null,
"code2": null,
"code3": null,
"state": "active",
"cost_cpm": null,
"publisher_id": 585173,
"content_retrieval_timeout_ms": 0,
"enable_for_mediation": true,
"is_prohibited": false,
"site_id": 1275896,
"default_referrer_url": null,
"reserve_price": null,
"width": 1,
"height": 1,
"default_position": "unknown",
"default_creative_id": null,
"ad_profile_id": null,
"acb_code": null,
"tag_data": null,
"hide_referer": false,
"inventory_source_id": null,
"pixel_url": null,
"pixel_type": "image",
"last_modified": "2015-07-07 20:44:42",
"media_subtypes": null,
"intended_audience": null,
"audited": false,
"audit_level": "site",
"default_calculation_type": "gross",
"publisher_name": "National Public Radio",
"site_name": "[National Public Radio] - ROS",
"site_audit_status": "unaudited",
"member_id": 958,
"demand_filter_action": "default",
"visibility_profile_id": null,
"is_resizable": false,
"pixel_url_secure": null,
"floor_application_target": "all",
"client_js_tracking_pct": 0,
"use_detected_domain": true,
"pop_values": null,
"toolbar": null,
"inventory_attributes": null,
"supported_media_types": null,
"supported_media_subtypes": [
{
"id": 64,
"name": "Standard VAST",
"media_type": {
"id": 4
}
}
],
"content_categories": null,
"segments": null,
"estimated_clear_prices": [
{
"clear_price": 1,
"average_price": 0.5,
"width": 0,
"height": 0,
"verified": true
}
],
"filtered_advertisers": null,
"filtered_line_items": null,
"filtered_campaigns": null,
"default_creatives": null,
"private_sizes": null,
"video": {
"id": 9,
"width": 750,
"max_duration_secs": 30,
"supports_skippable": true,
"context": "pre-roll",
"playback_method": null,
"frameworks": [
"vpaid_1_0",
"vpaid_2_0",
"mraid_1",
"ormma",
"mraid_2"
]
}
}
}
}
イントロバンパーを可能にする広告ポッドの配置を追加する
$ cat placement
{
"placement": {
"video": {
"supports_skippable": false,
"player_vast_version": "3.0",
"playback_method": null,
"max_duration_sec": 200,
"maximum_number_ads": 20,
"context": "mid-roll",
"start_delay_secs": 30,
"frameworks": [
"vpaid_2_0"
],
"video_bumpers": [
{
"video_bumper_type": "outro",
"max_duration_secs": 30
}
]
}
}
}
$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement?publisher_id=626425'
{
"response": {
"status": "OK",
"count": 1,
"id": "11323022",
"start_element": 0,
"num_elements": 100,
"placement": {
"id": 11323022,
"name": "Ad Pod Placement",
"code": null,
"code2": null,
"code3": null,
"state": "active",
"cost_cpm": null,
"publisher_id": 626425,
"content_retrieval_timeout_ms": 0,
"enable_for_mediation": true,
"is_prohibited": false,
"site_id": 1433875,
"default_referrer_url": null,
"reserve_price": null,
"width": 1,
"height": 1,
"default_position": "unknown",
"default_creative_id": null,
"ad_profile_id": null,
"acb_code": null,
"tag_data": null,
"hide_referer": false,
"exclusive": false,
"pixel_url": null,
"pixel_type": "image",
"last_modified": "2017-05-23 15:27:18",
"media_subtypes": null,
"intended_audience": null,
"audited": false,
"audit_level": "site",
"default_calculation_type": "gross",
"publisher_name": "New_Publisher",
"site_name": "[New_Publisher] - ROS",
"site_audit_status": "unaudited",
"member_id": 958,
"demand_filter_action": "default",
"visibility_profile_id": null,
"is_resizable": false,
"pixel_url_secure": null,
"floor_application_target": "all",
"client_js_tracking_pct": 0,
"use_detected_domain": true,
"auction_timeout_ms": null,
"pop_values": null,
"toolbar": null,
"inventory_attributes": null,
"supported_media_types": null,
"supported_media_subtypes": [
{
"id": 64,
"is_private": false,
"name": "Standard VAST",
"media_type": {
"id": 4
}
}
],
"content_categories": null,
"segments": null,
"estimated_clear_prices": [
{
"clear_price": 1,
"average_price": 0.5,
"width": 0,
"height": 0,
"verified": true,
"geo_country": ""
}
],
"filtered_advertisers": null,
"filtered_line_items": null,
"filtered_campaigns": null,
"default_creatives": null,
"private_sizes": null,
"video": {
"id": 282568,
"width": null,
"max_duration_secs": null,
"supports_skippable": false,
"context": "mid-roll",
"playback_method": null,
"maximum_number_ads": 20,
"maximum_ad_duration_secs": null,
"start_delay_secs": 30,
"frameworks": [
"vpaid_2_0"
],
"video_bumpers": [
{
"video_bumper_type": "outro",
"max_duration_secs": 30
}
]
},
"ad_types": null
}
}
}
スキップオフセット機能を有効にした配置の追加
{
"placement": {
"id": 11633087,
...
"video": {
"id": 336328,
"width": null,
"max_duration_secs": 60,
"supports_skippable": true,
"player_vast_version": "3.0",
"context": "pre-roll",
"playback_method": null,
"maximum_number_ads": 3,
"maximum_ad_duration_secs": null,
"start_delay_secs": null,
"use_server_side_trackers": false,
"frameworks": null,
"video_bumpers": [
{
"video_bumper_type": "outro",
"max_duration_secs": 15
}
],
"skipoffset_seconds": 10
}
}
}