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 Portal de soporte al cliente de Microsoft Advertising.

Campo	Tipo	Descripción
`id`	Entero	Identificador de la categoría.
`name`	string	Nombre de la categoría.
`is_sensitive`	bool	Si `true`es , 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 o región. 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 o región. Para obtener más información, consulte Marca a continuación.
`country`	string	Cadena de 2 caracteres que hace referencia al país o región en el que se permite la marca.

Marca

Campo	Tipo	Descripción
`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": {
          "country or region_and_brands": [
          ],
          "country or region": [
          ]
        },
        "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": {
          "country or region_and_brands": [
          ],
          "country or region": [
          ]
        },
        "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}

Last updated on 2025-10-22

Compartir a través de