配置サービス

プレースメントサービスを使用すると、プレースメント広告タグの作成、および変更や表示が可能です。マネージドパブリッシャーまたはダイレクトメディア購入のプレースメントを使用します。

配置 ID とそれに関連する情報は、Xandr のサーバー側に保存され、簡単に変更できます。
プレースメントを作成するときに、そのプレースメントに配信できるクリエイティブの種類を指定します (以下の supported_media_types と supported_media_subtypes を参照してください)。

注:

このサービスによる広告主、広告申込情報、またはキャンペーンのターゲティングは、支払いルールサービスで定義されているターゲティングをオーバーライドします。

タグの形式

プレースメント ID を取得したら、プレースメントタグの書式を設定して、代理するパブリッシャーまたは購入保証のあるパブリッシャーに渡します。

注:

"id" はプレースメント ID です。

ヒント

プレースホルダーを含めて、広告呼び出し中にプラットフォームに追加のクエリ文字列パラメーターを渡すことができます。

重要

Secure Inventory (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` (placement 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` (placement 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`	パブリッシャーの 1 つのすべてのプレースメントを表示します。
`GET`	`https://api.appnexus.com/placement?id=PLACEMENT_ID`	パブリッシャーの 1 つの特定の配置を表示します。
`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 マーケットプレースの一部です。既定値: `False`
`pixel_url`	string	ユーザーが配置を読み込む際にピギーバック呼び出しを行います。既定値: `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 の一覧については、 Inventory Attribute Service を参照してください。
`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 日あたりのボリュームの最大 % (パブリッシャーサービスの`max_learn_pct`フィールド) を超えてしまう場合でも、既定値を提供するよりも利用可能なマネージド学習のインプレッションを提供する場合は、このオプションを使用します。 - `"external_non_preferred"` - リザーブ価格は、外部入札(購入メンバーと販売メンバーが異なる)、またはインプレッションが利用可能なマネージド学習インプレッションであり、学習の1日の最大ボリュームの割合を超える場合に適用されます。学習の 1 日の最大ボリュームの割合を超える利用可能なマネージド Learn インプレッションを提供するのではなく、既定値を提供する場合は、このオプションを使用します。 - `"all"` - 予約価格は、マネージド学習インプレッションを除くすべての入札単価に、学習の 1 日あたりのボリュームの最大の割合以内に適用されます。既定値: `"all"`
`pixel_url_secure`	string	ユーザーが配置を読み込む際の安全なピギーバック呼び出し。既定値: `null`
`site_audit_status`	列挙	サイトがクリエイティブ監査を実行することを決定した方法を示します。使用可能な値は `"self"` または `"unaudited"` です。既定値: `unaudited`
`toolbar`	object	出品者は、すべてのツールバーとブラウザープラグインの在庫を申告する必要があります。販売者が "toolbar" 在庫属性を割り当てる場合は、この追加のメタデータも含める必要があります。
`acb_code`	文字列 (32)	非推奨です。
`tag_data`	string	非推奨です。
`cost_cpm`	double	値が存在する場合は、配置の支払い情報として使用されます。これにより、パブリッシャーに関連付けられている支払いルールがオーバーライドされます。既定値: `null`
`is_prohibited`	ブール型	読み取り専用です。 `true`場合、Xandr コンテンツポリシーに違反しているため、配置が禁止されています。禁止されたプレースメントに対して直接オークションやサードパーティオークションを実行することはありません。既定値: `false`
`last_modified`	timestamp	読み取り専用です。プレースメントが最後に変更された日時。
`stats`	object	`stats` オブジェクトは非推奨になりました (2016 年 10 月 17 日現在)。代わりに、統計情報を取得するためにレポートサービスを使用します。
`content_retrieval_timeout_ms`	int	この配置のタイムアウトは、"メディエーションされた" クリエイティブ ( `content_source` が `"mediation"` に設定されているクリエイティブ) から取得されたコンテンツに対して設定されます。詳細については、クリエイティブサービスを参照してください。 - `0` に設定すると、広告サーバーはメンバーサービスの値を使用します - `PUT` または `POST` 呼び出しで API に指定されない場合、既定値は `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 レンダラーアセットの最低価格」を参照してください。必須:`PUT`
`is_ss_native_assembly_enabled`	ブール値	有効にすると、元の要求はバナー要求になりますが、応答でネイティブアセットを返すために、入札者に送信される要求にはネイティブ情報が設定されます。最終的な応答は、ネイティブに組み立てられた広告マークアップがアタッチされたバナー広告タイプに戻されます。 `true`であれば、はい。
`GPID`	string (255)	グローバルプレースメント ID (GPID)。ページ上の特定の広告の配置を示すためにパブリッシャーによって提供されるグローバル配置レベルの識別子。

サポートされているメディアの種類

クリエイティブは、メディアタイプとメディアサブタイプによって分類されます。メディアタイプはクリエイティブの一般的な表示スタイル ( "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。 Media Subtype Service を使用すると、すべてのメディアサブタイプを表示できます。既定値: `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 ドキュメントの「アウトストリームビデオプレーヤーの設定」を参照してください。

フィールド	種類	説明
`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	このフィールドは、配置でサポートされる最高の VAST バージョンを指定し、プレイヤーがサポートする最高の値に設定する必要があります。プレイヤーバージョンよりも高い VAST バージョンを必要とするクリエイティブは、配置で配信する資格がありません。使用可能な値: - `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	すべて小文字の `ad_type` の名前 (例: `video` または `banner`)。
`display_name`	string	`ad_type`の表示名。広告タイプに最初の大文字 (`Video` や `Banner` など) があります。
`renderer`	マルチオブジェクト	レンダラーの `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	読み取り専用です。既定のクリエイティブの名前。

POP 値

supported_media_typeが"Pop"の場合、またはsupported_media_subtypesが"Popup"または"Popunder"の場合、これらのフィールドはpop_values配列に含める必要があります。例については、以下を参照してください。

フィールド	種類	説明
`pop_freq_times`	int	`pop_frequency_duration` 秒以内にタグを一意のユーザー ID にポップできる回数。 `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` が指定されている場合、タグによって表示されるクリエイティブの幅は 1 以下である必要があります`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	インプレッションに関連付けられている地理的な場所の国コード。

プライベートサイズ

この配列は、カスタム取引またはパッケージで提供できる特定の配置サイズを決定します。これらのプライベートサイズが標準配置サイズと共に機能するには、ディールサービスまたはパッケージサービスのoverride_size_preferenceを append に設定する必要があります。

フィールド	種類	説明
`width`	int	配置の幅。
`height`	int	配置の高さ。

統計情報

stats オブジェクトは非推奨になりました (2016 年 10 月 17 日現在)。代わりに、統計情報を取得するためにレポートサービスを使用します。

プラットフォームポリシーに従って、販売者はすべてのツールバー/ブラウザープラグインインベントリを特定し、独自の配置で他のインベントリから分離する必要があります。ツールバーの在庫を特定するには、販売者は次の条件を満たしている必要があります。

inventory_attributeを適切に設定します。
ここで説明する必要な情報をツールバー配列で送信します。

パラメーター	型	説明
`name`	string	ツールバーの一般的な商品名。
`company`	string	ツールバーのデベロッパー。商号ではなく、法人の事業体を特定してください。
`tos_url`	string	監査人が完全な利用規約を見つけることができる Web ページへのリンク。
`install_url`	string	監査人がツールバーをインストールできる Web ページへのリンク。

例

パブリッシャーの 1 つのすべての配置を表示しています

$ 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
            }
        }
}

Last updated on 2026-08-18

配置サービス

タグの形式

IFRAME

JavaScript

REST API

JSON フィールド

サポートされているメディアの種類

サポートされるメディア サブタイプ

サポートされている MIME の種類

ビデオの設定

ビデオ バンパー

縦横比

広告タイプ

Tinytag レンダラー アセットのフロア価格

既定のクリエイティブ

POP 値

推定クリア価格

プライベート サイズ

統計情報

ツール バー & ブラウザー プラグインの宣言

例

パブリッシャーの 1 つのすべての配置を表示しています

特定の配置の表示

"Interstitial"メディア タイプのクリエイティブのみを許可するプレースメントを追加する

"In-Banner Video"メディア サブタイプのクリエイティブのみを許可するプレースメントを追加する

"Popup"メディア サブタイプのクリエイティブのみを許可するプレースメントを追加する

"Video Standard VAST"メディア サブタイプのクリエイティブのみを許可するプレースメントを追加する

イントロ バンパーを許可する広告ポッドの配置を追加する