Bidders - カテゴリ サービス
読み取り専用カテゴリ サービスを使用すると、Xandr システムに登録されているすべてのカテゴリを表示できます。 カテゴリはブランドとクリエイティブの両方に割り当てられます。 ブランド サービス または クリエイティブ サービスを使用して割り当てられているカテゴリを確認できます。 その後、 広告プロファイル サービスを使用して、これらのブランドやクリエイティブのカテゴリを許可または禁止できます。
注意
サイトと配置のカテゴリの場合は、 コンテンツ カテゴリ サービスを使用します。
HTTP メソッド | エンドポイント | 説明 |
---|---|---|
GET |
https://api.adnxs.com/category | Xandr システムのすべてのカテゴリを表示します。 |
GET |
https://api.adnxs.com/category/CATEGORY_ID | 特定のカテゴリに関する情報を表示します。 |
注意
以下に定義されている countries_and_brands
および countries_and_regions
フィールドは、ギャンブル関連のクリエイティブが法的に許可されている国や地域でサービスを提供し、適用される法律に準拠するために当社のシステムによって使用されています。
- 公式のギャンブル関連ポリシーの詳細については、バイサイドおよび販売側のギャンブルポリシーを参照してください。
- 国と地域ごとの許可リストの動作の詳細については、 カスタマー サポートにお問い合わせください。
フィールド | 種類 | 説明 |
---|---|---|
id |
int | カテゴリの ID。 クエリ文字列で必要な On: PUT |
name |
string | カテゴリの名前。 必須: POST |
is_sensitive |
ブール値 |
true 場合、カテゴリは "機密" として一覧表示され、多くの場合、発行元によって禁止されます。デフォルト: false |
last_modified |
timestamp | カテゴリが最後に変更された日時。 |
requires_allowlist_on_external |
ブール値 | このカテゴリのブランドまたはクリエイティブが、外部 (つまり RTB) インベントリで配信するために許可リストを必要とするかどうか。 デフォルト: false |
requires_allowlist_on_managed |
ブール値 | このカテゴリのブランドまたはクリエイティブが、マネージド インベントリで配信するために許可リストを必要とするかどうか。 デフォルト: false |
is_brand_eligible |
ブール値 |
true 場合、カテゴリは監査プロセス内のブランドに関連付けられる資格があります。デフォルト: true |
requires_allowlist |
ブール値 | このカテゴリのブランドまたはクリエイティブが、サービスを提供するために許可リストを必要とするかどうか。 デフォルト: false |
countries_and_brands |
オブジェクトの配列 | この配列には、国別にグループ化されたブランド許可リスト設定が含まれています。 詳細については、以下の「国とブランド」を参照してください。 |
フィールド | 種類 | 説明 |
---|---|---|
brand_id |
int | ブランドの ID。 |
brand_name |
string | ブランドの名前。 |
brand |
multi_object | この国で許可されているブランドに関する情報を含むオブジェクト。 詳細については、以下の「ブランド」を参照してください。 |
country |
string | ブランドが許可リストに登録されている国を参照する 2 文字の文字列。 サポートされているコードの一覧については、ISO 3166-1 の国コードを参照してください。 |
フィールド | 種類 | 説明 |
---|---|---|
brand_id |
int | ブランドの ID。 |
brand_name |
string | ブランドの名前。 |
brand |
multi_object | このリージョンに登録されているブランド許可リストに関する情報を含むオブジェクト。 |
region |
string | ブランドが許可リストに登録されているリージョンを参照する文字列。 サポートされているコードの一覧については、 ISO 3166-2 を参照してください。 |
$ curl -b cookies -c cookies "https://api.adnxs.com/category"
{
"response": {
"status": "OK",
"count": 88,
"start_element": null,
"num_elements": null,
"categories": [
{
"id": 1,
"name": "Airlines",
"is_sensitive": false,
"last_modified": "2010-03-19 17:48:36",
"requires_allowlist_on_external": false,
"requires_allowlist_on_managed": false,
"is_brand_eligible": true,
"requires_allowlist": false,
"allowlist": {
"countries_and_brands": [],
"regions_and_brands": []
}
},
{
"id": 2,
"name": "Apparel",
"is_sensitive": false,
"last_modified": "2010-03-19 17:48:36",
"requires_allowlist_on_external": false,
"requires_allowlist_on_managed": false,
"is_brand_eligible": true,
"requires_allowlist": false,
"allowlist": {
"countries_and_brands": [],
"regions_and_brands": []
}
},
{
"id": 3,
"name": "Appliances",
"is_sensitive": false,
"last_modified": "2010-03-19 17:48:36",
"requires_allowlist_on_external": false,
"requires_allowlist_on_managed": false,
"is_brand_eligible": true,
"requires_allowlist": false,
"allowlist": {
"countries_and_brands": [],
"regions_and_brands": []
}
},
"dbg": {
...
}
}
}
$ curl -b cookies -c cookies "https://api.adnxs.com/category/1"
{
"response": {
"status": "OK",
"count": 1,
"start_element": null,
"num_elements": null,
"category": {
"id": 1,
"name": "Airlines",
"is_sensitive": false,
"last_modified": "2010-03-19 17:48:36",
"requires_allowlist_on_external": false,
"requires_allowlist_on_managed": false,
"is_brand_eligible": true,
"requires_allowlist": false,
"allowlist": {
"countries_and_brands": [],
"regions_and_brands": []
}
},
"dbg": {
...
}
}
}