API de plataforma digital: servicio de categoría de contenido

Xandr proporciona un conjunto de categorías "universales", que son categorías de uso común que los miembros pueden aplicar a sus sitios (grupos de selección de ubicación) y ubicaciones para fines informativos o de destino posteriores. También puede crear sus propias categorías personalizadas mediante este servicio.

Las categorías de contenido se aplican a sitios y ubicaciones a través del servicio de sitio y el servicio de selección de ubicación mediante el identificador de categoría de contenido, recuperado de este servicio. A continuación, las categorías de contenido se pueden usar para la selección de destinos de sitio y ubicación para campañas directas a través del Servicio de perfiles.

API de REST

Http (método)	Endpoint	Description
`GET`	https://api.appnexus.com/content-category?type=standard	Vea todas las categorías de contenido personalizado estándar que pertenecen a su miembro.
`GET`	https://api.appnexus.com/content-category?category_type=universal& id=CONTENT_CATEGORY_ID	Ver una categoría de contenido personalizada específica.
`GET`	https://api.appnexus.com/content-category?id=1,2,3	Vea varias categorías de contenido por identificador mediante una lista separada por comas.
`POST`	https://api.appnexus.com/content-category	Agregue una categoría de contenido personalizada.
`PUT`	https://api.appnexus.com/content-category?id=CONTENT_CATEGORY_ID	Modificar una categoría de contenido personalizada.
`DELETE`	https://api.appnexus.com/content-category?id=CONTENT_CATEGORY_ID	Elimine una categoría de contenido personalizada. Propina: No se pueden agregar, modificar ni eliminar categorías de contenido universal (donde `is_system` se establece en `true`). Xandr administra las categorías de contenido universal.

Campos JSON

Campo	Tipo (longitud)	Descripción
`code`	string	Solo se usa para ofertas.
`description`	string (255)	Descripción de la categoría de contenido
`id`	Entero	Identificador de la categoría. Obligatorio activado:`PUT` Predeterminado: Número generado automáticamente.
`is_system`	booleano	Solo lectura. Si `true`es , se trata de una categoría de contenido "universal" creada por Xandr. Puede aplicar categorías de contenido universal a sus sitios y ubicaciones, pero no puede editarlas.
`last_modified`	Timestamp	Solo lectura. Fecha y hora en que se modificó por última vez esta categoría de contenido.
`member_id`	Entero	Solo lectura. Su id. de miembro.
`name`	string (100)	Nombre de la categoría. Obligatorio activado:`POST`
`parent_category`	objeto	Si la categoría es el elemento secundario de una categoría primaria, el identificador y el nombre del elemento primario se muestran en un formato.
`type`	enumeración	Tipo de categoría de contenido. Los valores posibles son `"standard"`, `"deal"`o `"deal_priority"`.

`parent_category` formato

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

Ejemplos

Ver todas las categorías de contenido personalizadas que pertenecen a su miembro

$ 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"
         }
      ]
   }
}

Ver todas las categorías de contenido universal

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

Ver una categoría de contenido personalizada específica

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

Visualización de una categoría de contenido universal específica

$ 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-10-22

Partekatu honen bidez: