Partager via

API de plateforme numérique - Service de catégorie

Le service de catégorie en lecture seule vous permet d’afficher toutes les catégories côté achat qui sont inscrites dans notre système. Les catégories sont appliquées à la fois aux marques et aux créatifs : vous pouvez voir quelles catégories sont attribuées à une marque ou créatives à l’aide du service de marque ou du service créatif. Les vendeurs peuvent ensuite autoriser ou interdire ces catégories de marques et de créations à l’aide du service de profil publicitaire. Lorsque vous examinez un élément créatif dans , vous verrez « Catégories sensibles » et « Catégorie d’offre », tous deux extraits du service de catégorie. Le champ is_sensitive est défini sur true pour les catégories sensibles.

Les vendeurs catégorisent les sites et les placements à l’aide du service de catégorie de contenu.

API REST

HTTP, méthode Endpoint Description
GET https://api.appnexus.com/category Afficher toutes les catégories.
GET https://api.appnexus.com/category?id=CATEGORY_ID Afficher une catégorie particulière.
GET https://api.appnexus.com/category/meta Découvrez les champs que vous pouvez filtrer et trier.

Champs JSON

Remarque

Les champs countries_and_brands et countries_and_regions définis ci-dessous sont utilisés par notre système pour permettre aux créateurs liés aux jeux d’argent et de hasard de servir dans les pays et régions où ils sont légalement autorisés, ce qui nous met en conformité avec les lois applicables.

  • Pour plus d’informations sur nos politiques officielles relatives aux jeux d’argent et de hasard, consultez nos politiques sur les jeux d’argent et de hasard.
  • Pour plus d’informations sur le fonctionnement de la liste d’autorisation par pays et par région, contactez le support technique.
Champ Type Description
id int ID de la catégorie.
name string Nom de la catégorie.
is_sensitive bool Si truela valeur est , la catégorie est répertoriée comme « sensible » et est souvent interdite par les éditeurs.
requires_allowlist valeur booléenne Que les marques ou les créatifs de cette catégorie nécessitent une liste d’autorisation pour servir.
requires_allowlist_on_managed valeur booléenne Que les marques ou les créatifs de cette catégorie nécessitent une liste d’autorisation pour servir sur l’inventaire managé.
requires_allowlist_on_external valeur booléenne Que les marques ou les créatifs de cette catégorie nécessitent une liste d’autorisation pour servir sur l’inventaire externe (c’est-à-dire, RTB).
last_modified Timestamp Date et heure de la dernière modification de la catégorie.
is_brand_eligible valeur booléenne Si la valeur est true, l’équipe d’audit de Xandr peut associer la catégorie aux marques.
countries_and_brands tableau d’objets Ce tableau contient les paramètres de liste d’autorisation de marque regroupés par pays. Pour plus d’informations, consultez Pays et marques ci-dessous.

Pays et marques

Champ Type Description
brand_id int ID de la marque.
brand_name chaîne Nom de la marque.
brand multi_object Objet contenant des informations sur la marque autorisée dans ce pays. Pour plus d’informations, consultez Marque ci-dessous.
country chaîne Chaîne de 2 caractères faisant référence au pays dans lequel la marque est autorisée.

Marque

Champ Type Description
id int ID de la marque.
name chaîne Nom de la marque.

Exemples

Afficher une seule catégorie

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

Afficher toutes les catégories

{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}
  • Last updated on