インベントリの再販サービス
この読み取り専用サービスを使用すると、プラットフォーム上のネットワークによって再販のために公開されているインベントリを表示できます。 これには、ネットワークやその他のネットワークによって公開されるインベントリが含まれます。
- 在庫の再販を有効にするには、 Site Service を使用します。
- 再販のインベントリを公開するには:
- 在庫カテゴリの場合は、 可視性プロファイル サービスを使用します。
- パブリッシャーの場合は、 Publisher Service を使用します。
- ネットワーク全体の場合は、 メンバー サービスを使用します。
- プラットフォーム メンバーと外部入札者が入札要求に表示する在庫データを制御するには、 Visibility Profile Service を使用します。
REST API
| HTTP メソッド | エンドポイント | 説明 |
|---|---|---|
GET |
https://api.appnexus.com/inventory-resold | 再販のために公開されているすべてのパブリッシャー、コンテンツ カテゴリ、およびメンバーを表示します。 |
GET |
https://api.appnexus.com/inventory-resold?type=publisher | 再販のために公開されているすべての発行元を表示します。 |
GET |
https://api.appnexus.com/inventory-resold?type=publisher&id=1,2,3,etc | 再販のために公開されている特定の発行元を表示します (ID のコンマ区切りの一覧を使用)。 |
GET |
https://api.appnexus.com/inventory-resold?type=content_category&category_type=standard | 再販のために公開されているすべてのコンテンツ カテゴリを表示します。 |
GET |
https://api.appnexus.com/inventory-resold?type=content_category&id=1,2,3,etc | 再販のために公開されている特定のコンテンツ カテゴリを表示します (ID のコンマ区切りのリストを使用)。 |
GET |
https://api.appnexus.com/inventory-resold?type=member | 再販のために公開されているすべてのメンバーを表示します。 |
GET |
https://api.appnexus.com/inventory-resold?type=member&id=1,2,3,etc | 再販のために公開されている特定のメンバーを表示します (ID のコンマ区切りのリストを使用)。 |
GET |
https://api.appnexus.com/inventory-resold/meta | フィルター処理および並べ替えの対象となるフィールドを確認します。 |
JSON フィールド
| フィールド | 型 (長さ) | 説明 |
|---|---|---|
daily_volume |
int | 過去 7 日間の平均 1 日あたりのインプレッション数。 |
description |
string(255) | オブジェクトの説明。 |
id |
int | オブジェクト (publisherまたは membercontent_category) に割り当てられた内部 ID。 |
member_id |
int | 所有するメンバーの ID。 |
member_name |
string | 所有するメンバーの名前。 |
name |
string(255) | オブジェクトの名前。 |
reselling_exposed_on |
timestamp | パブリッシャーまたはメンバーが再販のために公開された日時。 メモ： バージョン 1.13 の時点では、このフィールドはコンテンツ カテゴリでは使用できません。 |
stats |
オブジェクトの配列 | オブジェクトはstats非推奨になりました (2016 年 10 月 17 日現在)。 代わりに Report Service を使用して統計情報を取得します。 |
type |
列挙 | オブジェクトの種類を指定します。 使用可能な値: "publisher"、、 "member"または "content_category"。 |
例
再販対象として公開されているすべてのパブリッシャー、コンテンツ カテゴリ、およびメンバーを表示する
$ curl -b cookies -c cookies 'https://api.appnexus.com/inventory-resold'
{
"response": {
"status": "OK",
"inventory-resold": [
{
"id": 88,
"name": "Kitara Media",
"description": null,
"member_id": 88,
"member_name": "Kitara Media",
"type": "member",
"reselling_exposed_on": "2010-06-07 21:29:56",
"daily_volume": "67119880"
},
{
"id": 95,
"name": "Matomy Media (formerly Xtend Media)",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "member",
"reselling_exposed_on": "2011-05-04 08:51:51",
"daily_volume": "20578570"
},
{
"id": 231,
"name": "Morning Falls",
"description": null,
"member_id": 231,
"member_name": "Morning Falls",
"type": "member",
"reselling_exposed_on": "2010-08-23 20:44:51",
"daily_volume": "24"
},
{
"id": 311,
"name": "Collective Exchange",
"description": null,
"member_id": 311,
"member_name": "Collective Exchange",
"type": "member",
"reselling_exposed_on": "2010-11-19 22:55:15",
"daily_volume": "97485150"
},
...
{
"id": 537,
"name": "Fun & Trivia",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 538,
"name": "Autos & Vehicles",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 539,
"name": "Beauty & Personal Care",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 540,
"name": "Business & Industry",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 541,
"name": "Computers & Electronics",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 541,
"name": "CPXInteractive",
"description": null,
"member_id": 541,
"member_name": "CPXInteractive",
"type": "member",
"reselling_exposed_on": "2011-01-05 17:22:19",
"daily_volume": "1067491726"
},
{
"id": 542,
"name": "Arts & Entertainment",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 543,
"name": "Finance",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 544,
"name": "Food & Drink",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 545,
"name": "Games",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 546,
"name": "Health",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
...
{
"id": 563,
"name": "X-Taringa.org",
"description": "",
"member_id": 332,
"member_name": "D'Arriens",
"type": "publisher",
"reselling_exposed_on": "2012-03-21 18:55:47",
"daily_volume": null
},
{
"id": 564,
"name": "Collective Exchange (UK)",
"description": null,
"member_id": 564,
"member_name": "Collective Exchange (UK)",
"type": "member",
"reselling_exposed_on": "2010-12-15 16:09:48",
"daily_volume": "4322501"
},
{
"id": 564,
"name": "MessengerAdictos",
"description": "",
"member_id": 332,
"member_name": "D'Arriens",
"type": "publisher",
"reselling_exposed_on": "2012-03-21 18:55:47",
"daily_volume": null
},
{
"id": 568,
"name": "Httpool",
"description": null,
"member_id": 568,
"member_name": "Httpool",
"type": "member",
"reselling_exposed_on": "2011-02-24 15:49:52",
"daily_volume": "159637"
},
{
"id": 576,
"name": "Nextperience",
"description": null,
"member_id": 576,
"member_name": "Nextperience",
"type": "member",
"reselling_exposed_on": "2010-10-29 20:46:08",
"daily_volume": "3359929"
},
{
"id": 576,
"name": "Grooveshark",
"description": "",
"member_id": 332,
"member_name": "D'Arriens",
"type": "publisher",
"reselling_exposed_on": "2012-03-21 18:55:48",
"daily_volume": "48"
},
...
],
"count": 13984,
"start_element": 0,
"num_elements": 100
}
}
再販のために公開されているすべてのコンテンツ カテゴリを表示する
$ curl -b cookies -c cookies 'https://api.appnexus.com/inventory-source?type=content_category&category_type=standard'
{
"response": {
"status": "OK",
"inventory-resold": [
{
"id": 537,
"name": "Fun & Trivia",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 538,
"name": "Autos & Vehicles",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 539,
"name": "Beauty & Personal Care",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 540,
"name": "Business & Industry",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 541,
"name": "Computers & Electronics",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 542,
"name": "Arts & Entertainment",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
{
"id": 543,
"name": "Finance",
"description": null,
"member_id": 95,
"member_name": "Matomy Media (formerly Xtend Media)",
"type": "content_category",
"daily_volume": null
},
...
],
"count": 1145,
"start_element": 0,
"num_elements": 100
}
}