英語で読む

次の方法で共有


Bidders - カテゴリ サービス

読み取り専用カテゴリ サービスを使用すると、Xandr システムに登録されているすべてのカテゴリを表示できます。 カテゴリはブランドとクリエイティブの両方に割り当てられます。 ブランド サービス または クリエイティブ サービスを使用して割り当てられているカテゴリを確認できます。 その後、 広告プロファイル サービスを使用して、これらのブランドやクリエイティブのカテゴリを許可または禁止できます。

注意

サイトと配置のカテゴリの場合は、 コンテンツ カテゴリ サービスを使用します。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.adnxs.com/category Xandr システムのすべてのカテゴリを表示します。
GET https://api.adnxs.com/category/CATEGORY_ID 特定のカテゴリに関する情報を表示します。

JSON フィールド

注意

以下に定義されている 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": {
      ...
    }
  }
}