Licitadores: servicio de categoría

Artículo
07/05/2024

El servicio de categoría de solo lectura permite ver todas las categorías registradas en el sistema Xandr. Las categorías se asignan tanto a marcas como a creativos: puede ver qué categorías se asignan mediante el Servicio de marca o el Servicio creativo. A continuación, puede permitir o no permitir estas categorías de marcas y creatividades mediante el Servicio de perfil de anuncios.

Nota:

Para las categorías de sitio y selección de ubicación, use el servicio categoría de contenido.

API de REST

Http (método)	Endpoint	Description
`GET`	https://api.adnxs.com/category	Ver todas las categorías del sistema Xandr.
`GET`	https://api.adnxs.com/category/CATEGORY_ID	Ver información sobre una categoría determinada.

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 políticas de compra y venta.
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	Descripción
`id`	Entero	Identificador de la categoría. Obligatorio on:`PUT`, en la cadena de consulta
`name`	string	Nombre de la categoría. Obligatorio activado:`POST`
`is_sensitive`	booleano	Si `true`es , la categoría aparece como "confidencial" y, a menudo, los publicadores la prohíben. Predeterminado:`false`
`last_modified`	Timestamp	Fecha y hora en que se modificó por última vez la categoría.
`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). Predeterminado:`false`
`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. Predeterminado:`false`
`is_brand_eligible`	booleano	Si `true`es , la categoría es apta para asociarse a marcas dentro del proceso de auditoría. Predeterminado:`true`
`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. Predeterminado:`false`
`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	Descripción
`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, vea "Marca" a continuación.
`country`	string	Cadena de 2 caracteres que hace referencia al país en el que se permite la marca. Para obtener una lista de códigos admitidos, consulte los códigos de país ISO 3166-1.

Regiones y marcas

Campo	Tipo	Descripción
`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 allowlisted en esta región.
`region`	string	Cadena que hace referencia a la región en la que se ha permitido la marca. Para obtener una lista de códigos admitidos, consulte iso 3166-2.

Ejemplos

Ver todas las categorías

$ curl -b cookies -c cookies "https://api.adnxs.com/category"
{
  "response": {
    "status": "OK",
    "count": 88,
    "start_element": null,
    "num_elements": null,
    "categories": [
      {
        "id": 1,
        "name": "Airlines",
        "is_sensitive": false,
        "last_modified": "2010-03-19 17:48:36",
        "requires_allowlist_on_external": false,
        "requires_allowlist_on_managed": false,
        "is_brand_eligible": true,
        "requires_allowlist": false,
        "allowlist": {
          "countries_and_brands": [],
          "regions_and_brands": []
        }
      },
      {
        "id": 2,
        "name": "Apparel",
        "is_sensitive": false,
        "last_modified": "2010-03-19 17:48:36",
        "requires_allowlist_on_external": false,
        "requires_allowlist_on_managed": false,
        "is_brand_eligible": true,
        "requires_allowlist": false,
        "allowlist": {
          "countries_and_brands": [],
          "regions_and_brands": []
        }
      },
      {
        "id": 3,
        "name": "Appliances",
        "is_sensitive": false,
        "last_modified": "2010-03-19 17:48:36",
        "requires_allowlist_on_external": false,
        "requires_allowlist_on_managed": false,
        "is_brand_eligible": true,
        "requires_allowlist": false,
        "allowlist": {
          "countries_and_brands": [],
          "regions_and_brands": []
        }
      },
      "dbg": {
      ...
    }
  }
}

Ver una categoría específica

$ curl -b cookies -c cookies "https://api.adnxs.com/category/1"
{
  "response": {
    "status": "OK",
    "count": 1,
    "start_element": null,
    "num_elements": null,
    "category": {
      "id": 1,
      "name": "Airlines",
      "is_sensitive": false,
      "last_modified": "2010-03-19 17:48:36",
      "requires_allowlist_on_external": false,
      "requires_allowlist_on_managed": false,
      "is_brand_eligible": true,
      "requires_allowlist": false,
      "allowlist": {
        "countries_and_brands": [],
        "regions_and_brands": []
      }
    },
    "dbg": {
      ...
    }
  }
}

Compartir a través de