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