デジタル プラットフォーム API - カテゴリ サービス

  • [アーティクル]

読み取り専用カテゴリ サービスを使用すると、システムに登録されているすべての購入側カテゴリを表示できます。 カテゴリはブランドとクリエイティブの両方に適用されます。 ブランド サービス または クリエイティブ サービスを使用して、ブランドまたはクリエイティブに割り当てられているカテゴリを確認できます。 販売者は、 広告プロファイル サービスを使用して、これらのブランドやクリエイティブのカテゴリを許可または禁止できます。 でクリエイティブを見ると、"機密カテゴリ" と "オファー カテゴリ" が表示されます。これらの両方がカテゴリ サービスからプルされます。 機密性の高いカテゴリでは、is_sensitive フィールドが true に設定されます。

販売者は、 コンテンツ カテゴリ サービスを使用してサイトと配置を分類します。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.appnexus.com/category すべてのカテゴリを表示します。
GET https://api.appnexus.com/category?id=CATEGORY_ID 特定のカテゴリを表示します。
GET https://api.appnexus.com/category/meta フィルター処理および並べ替えの対象となるフィールドを確認します。

JSON フィールド

注:

以下に定義されているフィールド countries_and_brands は countries_and_regions 、ギャンブル関連のクリエイティブが法的に許可されている国や地域でサービスを提供し、適用法を遵守するために、当社のシステムによって使用されています。

  • 公式のギャンブル関連ポリシーの詳細については、「 サービス ポリシーの一部 」のギャンブル ポリシーを参照してください。
  • 国と地域ごとの許可リストの動作の詳細については、 カスタマー サポートにお問い合わせください。
フィールド 種類 説明
id int カテゴリの ID。
name string カテゴリの名前。
is_sensitive bool の場合、カテゴリは "機密" として一覧表示され、多くの場合 true、発行元によって禁止されます。
requires_allowlist ブール値 このカテゴリのブランドまたはクリエイティブが、サービスを提供するために許可リストを必要とするかどうか。
requires_allowlist_on_managed ブール値 このカテゴリのブランドまたはクリエイティブが、マネージド インベントリで配信するために許可リストを必要とするかどうか。
requires_allowlist_on_external ブール値 このカテゴリのブランドまたはクリエイティブが、外部 (つまり RTB) のインベントリで配信するために許可リストを必要とするかどうか。
last_modified timestamp カテゴリが最後に変更された日時。
is_brand_eligible ブール値 true の場合、Xandr の監査チームはカテゴリをブランドに関連付けることができます。
countries_and_brands オブジェクトの配列 この配列には、国別にグループ化されたブランド許可リスト設定が含まれています。 詳細については、以下の 「国とブランド 」を参照してください。

国とブランド

フィールド 種類 説明
brand_id int ブランドの ID。
brand_name string ブランドの名前。
brand multi_object この国で許可されているブランドに関する情報を含むオブジェクト。 詳細については、以下の 「ブランド 」を参照してください。
country string ブランドが許可リストに登録されている国を参照する 2 文字の文字列。

ブランド

フィールド 種類 説明
id int ブランドの ID。
name string ブランドの名前。

例

1 つのカテゴリを表示する

{code}
$ curl -b cookies "https://api.appnexus.com/category?id=1"
{
  "response": {
    
    "category": {
      "allowlist": {
        "countries_and_brands": [
        ],
        "countries": [
        ]
      },
      "requires_allowlist": false,
      "is_brand_eligible": true,
      "requires_allowlist_on_managed": false,
      "requires_allowlist_on_external": false,
      "last_modified": "2010-03-19 17:48:36",
      "is_sensitive": false,
      "name": "Airlines",
      "id": 1
    },
    "num_elements": null,
    "start_element": null,
    "count": 1,
    "status": "OK"
  }
}
{code}

すべてのカテゴリを表示する

{code}
$ curl -b cookies "https://api.appnexus.com/category"
{
  "response": {
    
    "categories": [
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Airlines",
        "id": 1
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Apparel",
        "id": 2
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Appliances",
        "id": 3
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Automotive and Vehicles",
        "id": 4
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Computers and Electronics",
        "id": 5
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-06-01 20:41:02",
        "is_sensitive": true,
        "name": "Context Link Providers",
        "id": 6
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-07-01 20:23:31",
        "is_sensitive": false,
        "name": "Cosmetics and Hygiene",
        "id": 7
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-06-02 19:23:05",
        "is_sensitive": true,
        "name": "Dating",
        "id": 8
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Education",
        "id": 9
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Employment",
        "id": 10
      },
      ...
    ],
    "num_elements": null,
    "start_element": null,
    "count": 78,
    "status": "OK"
  }
}
{code}