Soumissionnaires - Service de catégorie

Le service de catégorie en lecture seule vous permet d’afficher toutes les catégories inscrites dans le système Xandr. Les catégories sont affectées à la fois aux marques et aux créatifs : vous pouvez voir quelles catégories sont attribuées à l’aide du service de marque ou du service créatif. Vous pouvez ensuite autoriser ou interdire ces catégories de marques et de créations à l’aide du service de profil publicitaire.

Remarque

Pour les catégories de site et de placement, utilisez le service de catégorie de contenu.

API REST

HTTP, méthode	Endpoint	Description
`GET`	https://api.adnxs.com/category	Affichez toutes les catégories dans le système Xandr.
`GET`	https://api.adnxs.com/category/CATEGORY_ID	Afficher des informations sur une catégorie particulière.

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 d’achat et de vente.
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. Obligatoire On :`PUT`, dans la chaîne de requête
`name`	string	Nom de la catégorie. Obligatoire sur :`POST`
`is_sensitive`	valeur booléenne	Si `true`la valeur est , la catégorie est répertoriée comme « sensible » et est souvent interdite par les éditeurs. Par défaut:`false`
`last_modified`	Timestamp	Date et heure de la dernière modification de la catégorie.
`requires_allowlist_on_external`	valeur booléenne	Que les marques ou les créatifs de cette catégorie nécessitent une liste verte pour servir sur un inventaire externe (c’est-à-dire RTB). Par défaut:`false`
`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é. Par défaut:`false`
`is_brand_eligible`	valeur booléenne	Si `true`la valeur est , la catégorie peut être associée à des marques dans le processus d’audit. Par défaut:`true`
`requires_allowlist`	valeur booléenne	Que les marques ou les créatifs de cette catégorie nécessitent une liste d’autorisation pour servir. Par défaut:`false`
`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`	string	Chaîne de 2 caractères faisant référence au pays dans lequel la marque est autorisée. Pour obtenir la liste des codes pris en charge, reportez-vous aux codes pays ISO 3166-1.

Régions 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 cette région.
`region`	chaîne	Chaîne référençant la région dans laquelle la marque est autorisée. Pour obtenir la liste des codes pris en charge, consultez la norme ISO 3166-2.

Exemples

Afficher toutes les catégories

$ 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": {
      ...
    }
  }
}

Afficher une catégorie spécifique

$ 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": {
      ...
    }
  }
}

Last updated on 2025-04-01

Partager via