Compartir a través de


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 truees , 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
    }
}