API de plataforma digital: servicio de categoría
El servicio de categoría de solo lectura le permite ver todas las categorías de compra que están registradas en nuestro sistema. Las categorías se aplican tanto a marcas como a creativos: puede ver qué categorías se asignan a una marca o creatividad mediante el Servicio de marca o el Servicio creativo. Los vendedores pueden permitir o no permitir estas categorías de marcas y creatividades mediante el Servicio de perfil de anuncios. Al examinar una creatividad en , verá "Categorías confidenciales" y "Categoría de oferta", ambas se extraen del servicio de categorías. Las categorías confidenciales tendrán el campo is_sensitive establecido en true.
Los vendedores clasificarán los sitios y las ubicaciones mediante el servicio de categoría de contenido.
API de REST
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/category | Ver todas las categorías. |
GET |
https://api.appnexus.com/category?id=CATEGORY_ID | Ver una categoría determinada. |
GET |
https://api.appnexus.com/category/meta | Averigüe por qué campos puede filtrar y ordenar. |
Campos JSON
Nota:
Los campos countries_and_brands y countries_and_regions definidos a continuación están siendo utilizados por nuestro sistema para permitir que los creativos relacionados con juegos de azar sirvan en los países y regiones donde están permitidos legalmente, lo que nos pone en conformidad con las leyes aplicables.
- Para obtener más información sobre nuestras políticas oficiales relacionadas con los juegos de azar, consulte nuestras directivas de juego de parte de las directivas de servicio .
- Para obtener más información sobre cómo funciona la lista de permitidos por país y región, póngase en contacto con el servicio de atención al cliente.
| Campo | Tipo | Description |
|---|---|---|
id |
Entero | Identificador de la categoría. |
name |
string | Nombre de la categoría. |
is_sensitive |
bool | Si truees , la categoría aparece como "confidencial" y, a menudo, los publicadores la prohíben. |
requires_allowlist |
booleano | Tanto si las marcas como los creativos de esta categoría requieren la inclusión en la lista de permitidos para poder servir. |
requires_allowlist_on_managed |
booleano | Tanto si las marcas como los creativos de esta categoría requieren la inclusión en la lista de permitidos para servir en el inventario administrado. |
requires_allowlist_on_external |
booleano | Tanto si las marcas como los creativos de esta categoría requieren la inclusión en la lista de permitidos para servir en el inventario externo (es decir, RTB). |
last_modified |
Timestamp | Fecha y hora en que se modificó por última vez la categoría. |
is_brand_eligible |
booleano | Si es true, el equipo de auditoría de Xandr puede asociar la categoría a las marcas. |
| countries_and_brands | matriz de objetos | Esta matriz contiene la configuración de la lista de permitidos de marca agrupada por país. Para obtener más información, consulte Países y marcas a continuación. |
Países y marcas
| Campo | Tipo | Description |
|---|---|---|
brand_id |
Entero | Identificador de la marca. |
brand_name |
string | Nombre de la marca. |
brand |
multi_object | Objeto que contiene información sobre la marca permitida en este país. Para obtener más información, consulte Marca a continuación. |
country |
string | Cadena de 2 caracteres que hace referencia al país en el que se permite la marca. |
Marca
| Campo | Tipo | Description |
|---|---|---|
id |
Entero | Identificador de la marca. |
name |
string | Nombre de la marca. |
Ejemplos
Ver una sola categoría
{code}
$ curl -b cookies "https://api.appnexus.com/category?id=1"
{
"response": {
"category": {
"allowlist": {
"countries_and_brands": [
],
"countries": [
]
},
"requires_allowlist": false,
"is_brand_eligible": true,
"requires_allowlist_on_managed": false,
"requires_allowlist_on_external": false,
"last_modified": "2010-03-19 17:48:36",
"is_sensitive": false,
"name": "Airlines",
"id": 1
},
"num_elements": null,
"start_element": null,
"count": 1,
"status": "OK"
}
}
{code}
Ver todas las categorías
{code}
$ curl -b cookies "https://api.appnexus.com/category"
{
"response": {
"categories": [
{
"allowlist": {
"countries_and_brands": [
],
"countries": [
]
},
"requires_allowlist": false,
"is_brand_eligible": true,
"requires_allowlist_on_managed": false,
"requires_allowlist_on_external": false,
"last_modified": "2010-03-19 17:48:36",
"is_sensitive": false,
"name": "Airlines",
"id": 1
},
{
"allowlist": {
"countries_and_brands": [
],
"countries": [
]
},
"requires_allowlist": false,
"is_brand_eligible": true,
"requires_allowlist_on_managed": false,
"requires_allowlist_on_external": false,
"last_modified": "2010-03-19 17:48:36",
"is_sensitive": false,
"name": "Apparel",
"id": 2
},
{
"allowlist": {
"countries_and_brands": [
],
"countries": [
]
},
"requires_allowlist": false,
"is_brand_eligible": true,
"requires_allowlist_on_managed": false,
"requires_allowlist_on_external": false,
"last_modified": "2010-03-19 17:48:36",
"is_sensitive": false,
"name": "Appliances",
"id": 3
},
{
"allowlist": {
"countries_and_brands": [
],
"countries": [
]
},
"requires_allowlist": false,
"is_brand_eligible": true,
"requires_allowlist_on_managed": false,
"requires_allowlist_on_external": false,
"last_modified": "2010-03-19 17:48:36",
"is_sensitive": false,
"name": "Automotive and Vehicles",
"id": 4
},
{
"allowlist": {
"countries_and_brands": [
],
"countries": [
]
},
"requires_allowlist": false,
"is_brand_eligible": true,
"requires_allowlist_on_managed": false,
"requires_allowlist_on_external": false,
"last_modified": "2010-03-19 17:48:36",
"is_sensitive": false,
"name": "Computers and Electronics",
"id": 5
},
{
"allowlist": {
"countries_and_brands": [
],
"countries": [
]
},
"requires_allowlist": false,
"is_brand_eligible": true,
"requires_allowlist_on_managed": false,
"requires_allowlist_on_external": false,
"last_modified": "2010-06-01 20:41:02",
"is_sensitive": true,
"name": "Context Link Providers",
"id": 6
},
{
"allowlist": {
"countries_and_brands": [
],
"countries": [
]
},
"requires_allowlist": false,
"is_brand_eligible": true,
"requires_allowlist_on_managed": false,
"requires_allowlist_on_external": false,
"last_modified": "2010-07-01 20:23:31",
"is_sensitive": false,
"name": "Cosmetics and Hygiene",
"id": 7
},
{
"allowlist": {
"countries_and_brands": [
],
"countries": [
]
},
"requires_allowlist": false,
"is_brand_eligible": true,
"requires_allowlist_on_managed": false,
"requires_allowlist_on_external": false,
"last_modified": "2010-06-02 19:23:05",
"is_sensitive": true,
"name": "Dating",
"id": 8
},
{
"allowlist": {
"countries_and_brands": [
],
"countries": [
]
},
"requires_allowlist": false,
"is_brand_eligible": true,
"requires_allowlist_on_managed": false,
"requires_allowlist_on_external": false,
"last_modified": "2010-03-19 17:48:36",
"is_sensitive": false,
"name": "Education",
"id": 9
},
{
"allowlist": {
"countries_and_brands": [
],
"countries": [
]
},
"requires_allowlist": false,
"is_brand_eligible": true,
"requires_allowlist_on_managed": false,
"requires_allowlist_on_external": false,
"last_modified": "2010-03-19 17:48:36",
"is_sensitive": false,
"name": "Employment",
"id": 10
},
...
],
"num_elements": null,
"start_element": null,
"count": 78,
"status": "OK"
}
}
{code}