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

Xandr fournit un ensemble de catégories « universelles », qui sont des catégories couramment utilisées que les membres peuvent appliquer à leurs sites (groupes de placement) et les placements à des fins de ciblage ou d’information ultérieures. Vous pouvez également créer vos propres catégories personnalisées à l’aide de ce service.

Vous appliquez des catégories de contenu aux sites et aux placements via le service de site et le service de placement à l’aide de l’ID de catégorie de contenu, récupéré à partir de ce service. Les catégories de contenu peuvent ensuite être utilisées pour le ciblage de site et de positionnement pour les campagnes directes via le service de profil.

API REST

HTTP, méthode	Endpoint	Description
`GET`	https://api.appnexus.com/content-category?type=standard	Affichez toutes les catégories de contenu personnalisées standard appartenant à votre membre.
`GET`	https://api.appnexus.com/content-category?category_type=universal& id=CONTENT_CATEGORY_ID	Afficher une catégorie de contenu personnalisée spécifique.
`GET`	https://api.appnexus.com/content-category?id=1,2,3	Affichez plusieurs catégories de contenu par ID à l’aide d’une liste séparée par des virgules.
`POST`	https://api.appnexus.com/content-category	Ajoutez une catégorie de contenu personnalisée.
`PUT`	https://api.appnexus.com/content-category?id=CONTENT_CATEGORY_ID	Modifier une catégorie de contenu personnalisée.
`DELETE`	https://api.appnexus.com/content-category?id=CONTENT_CATEGORY_ID	Supprimer une catégorie de contenu personnalisée. Pointe: Vous ne pouvez pas ajouter, modifier ou supprimer des catégories de contenu universelles (où `is_system` est défini sur `true`). Les catégories de contenu universelles sont gérées par Xandr.

Champs JSON

Champ	Type (Longueur)	Description
`code`	string	Utilisé uniquement pour les transactions.
`description`	string (255)	Description de la catégorie de contenu
`id`	int	ID de la catégorie. Obligatoire sur :`PUT` Par défaut: Nombre généré automatiquement.
`is_system`	valeur booléenne	En lecture seule. Si `true`la valeur est , il s’agit d’une catégorie de contenu « universelle » créée par Xandr. Vous pouvez appliquer des catégories de contenu universelles à vos sites et placements, mais vous ne pouvez pas les modifier.
`last_modified`	Timestamp	En lecture seule. Date et heure de la dernière modification de cette catégorie de contenu.
`member_id`	int	En lecture seule. Votre ID de membre.
`name`	string (100)	Nom de la catégorie. Obligatoire sur :`POST`
`parent_category`	objet	Si la catégorie est l’enfant d’une catégorie parente, l’ID et le nom du parent sont répertoriés dans un format.
`type`	enum	Type de catégorie de contenu. Les valeurs possibles sont `"standard"`, `"deal"`ou `"deal_priority"`.

`parent_category` Format

"parent_category": {
"id": 10,
"name": "Games"
}

Exemples

Afficher toutes les catégories de contenu personnalisées appartenant à votre membre

$ curl -b cookies 'https://api.appnexus.com/content-category'
{
   "response":{
      "status":"OK",
      "content-categories":[
         {
            "id":9999,
            "name":"Animals",
            "description":null,
            "is_system":false,
            "type":"standard",
            "code": null,
            "last_modified":"2010-05-12 22:46:42"
         },
         {
            "id":8888,
            "name":"Arts & Humanities",
            "description":null,
            "is_system":false,
            "type":"standard",
            "code": null,
            "last_modified":"2010-05-12 22:46:42"
         },
         ...
         {
            "id":7777,
            "name":"Travel",
            "description":null,
            "is_system":false,
            "type":"standard",
            "code": null,
            "last_modified":"2010-05-12 22:46:42"
         }
      ]
   }
}

Afficher toutes les catégories de contenu universelles

$ curl -b cookies -c cookies 'https://api.appnexus.com/content-category?is_system=true'
{
    "response": {
        "status": "OK",
        "content-categories": [
            {
              "id": 1,
              "name": "Music",
              "description": null,
              "is_system": true,
              "parent_category": null,
              "type": "standard",
              "code": null,
              "last_modified": "2010-03-04 18:18:52"
            },
            
            {
              "id": 2,
              "name": "Pets & Animals",
              "description": null,
              "is_system": true,
              "parent_category": null,
              "type": "standard",
              "code": null,
              "last_modified": "2010-10-24 02:43:16"
            },
            {
              "id": 3,
              "name": "Fun & Trivia",
              "description": null,
              "is_system": true,
              "parent_category": {
                "id": "10",
                "name": "Arts & Entertainment"
              },
              "type": "standard",
              "code": null,
              "last_modified": "2010-10-24 02:43:16"
            },
            {
              "id": 4,
              "name": "Autos & Vehicles",
              "description": null,
              "is_system": true,
              "parent_category": null,
              "type": "standard",
              "code": null,
              "last_modified": "2010-10-24 02:43:16"
            },
            ...
        ],
        "count": 34,
        "start_element": null,
        "num_elements": null
    }
}

Afficher une catégorie de contenu personnalisée spécifique

$ curl -b cookies -c cookies 'https://api.appnexus.com/content-category?category_type=universal&id=11111'
{
    "response": {
        "status": "OK",
        "content-category": {
            "id": 11111,
            "name": "A fine and private placement",
            "description": null,
            "is_system": false,
            "parent_category": null,
            "type": "standard",
            "code": null,
            "last_modified": "2012-08-29 15:42:01"
        },
        "count": 1,
        "start_element": 0,
        "num_elements": 100
    }
}

Afficher une catégorie de contenu universelle spécifique

$ curl -b cookies -c cookies 'https://api.appnexus.com/content-category?is_system=true&id=2222'
{
    "response": {
        "status": "OK",
        "content-category": {
            "id": 2222,
            "name": "Small Business",
            "description": null,
            "is_system": true,
            "type": "standard",
            "code": null,
            "parent_category": {
                "id": "8"
            },
            "last_modified": "2010-10-24 02:43:16"
        },
        "count": 1,
        "start_element": 0,
        "num_elements": 100
    }
}

Last updated on 2025-04-01

Partager via