API de plataforma digital: servicio de límite de objetos
Xandr limita el número de artículos de línea, campañas, creativos, editores, sitios, ubicaciones, paquetes, ofertas, redes mediadas y ofertas mediadas que puede tener en la plataforma. Además, Xandr limita el número de dominios que se pueden usar en una sola lista de dominios, el número de determinados destinos que se pueden usar en un solo perfil y el número de categorías de contenido que se pueden asignar a una sola ubicación. Para todos los tipos de objeto excepto las creatividades, los objetos activos e inactivos se cuentan con respecto al límite. En el caso de las creatividades, solo los objetos no expirados se cuentan con respecto al límite.
El servicio de límite de objetos le permite ver estos límites y supervisar de forma proactiva el uso actual.
API de REST
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/object-limit |
Vea los límites y el uso actual de todos los tipos de objeto. |
GET |
https://api.appnexus.com/object-limit?object_type=OBJECT_TYPE |
Vea el límite y el uso actual de un tipo de objeto específico. Nota: Están disponibles los siguientes tipos de objetos: - campaign - profile - domain_list - creative - publisher - site - placement - package - deal - mediated_network - mediated_bid. Tenga en cuenta que para recuperar el límite de elementos de línea, debe usar campaign_group. |
Campos JSON
| Campo | Tipo | Description |
|---|---|---|
count_active |
Entero | Número actual de objetos activos. En el caso de las creatividades, este recuento no incluye objetos expirados. |
count_inactive |
Entero | Número actual de objetos inactivos, sin incluir los objetos eliminados. En el caso de las creatividades, este recuento no incluye objetos expirados. |
count_total |
Entero | Número total actual de objetos activos e inactivos. En el caso de las creatividades, este recuento no incluye objetos expirados. |
limit |
Entero | Número máximo de objetos permitidos por el miembro. Para todos los tipos de objeto excepto "creative", los objetos activos e inactivos vuelven a contar el límite. En el caso de las creatividades, solo los objetos no expirados se cuentan con respecto al límite. |
mapping_limits |
object | Este campo solo se rellena para los "profile"tipos de objeto , "domain_list"y "placement" . Enumera los límites de los objetos dentro de cada perfil y lista de dominios, por ejemplo, el número máximo de destinos de segmento que puede usar en un único perfil o el número máximo de dominios que puede usar en una lista de dominios única. En el caso de las ubicaciones, muestra el número máximo de categorías de contenido que se pueden aplicar a una ubicación Consulte límites de asignación a continuación para obtener más detalles. |
object_type |
enumeración | Tipo de objeto. Posibles valores: - "line_item" - "campaign" - "profile" - "domain_list" - "creative" - "publisher" - "site" - "placement" - "package" - "deal" - "mediated_network" - "mediated bid".Nota: Para "profile" y "domain_list", los limitcampos , count_active, count_inactive, count_total mostrarán un valor de null, ya que Xandr no limita el número de perfiles y listas de dominios que puede tener. Sin embargo, Xandr limita el número de objetos dentro de cada perfil o lista de dominios. Estos límites se mostrarán en el mapping_limits campo . |
Límites de asignación
Esta parte de la respuesta JSON solo se rellena para los "profile"tipos de objeto , "domain_list"y "placement" .
Para perfiles
| Campo | Tipo | Description |
|---|---|---|
content_category_targets |
Entero | Número máximo de categorías de contenido personalizadas a las que puede dirigirse en un único perfil. |
inventory_source_targets |
Entero | En desuso. |
placement_targets |
Entero | Número máximo de ubicaciones a las que puede dirigirse en un único perfil. |
platform_content_category_targets |
Entero | Número máximo de categorías de contenido definidas por la plataforma a las que puede dirigirse en un único perfil. |
postal_code_targets |
Entero | Número máximo de códigos postales a los que puede dirigirse en un único perfil. |
publisher_targets |
Entero | Número máximo de publicadores a los que puede dirigirse en un único perfil. |
segment_targets |
Entero | Número máximo de segmentos a los que puede dirigirse en un único perfil. |
segment_group_targets |
Entero | Número máximo de grupos de segmentos a los que puede dirigirse en un único perfil. |
site_targets |
Entero | El número máximo de sitios a los que puede dirigirse en un único perfil. |
Para listas de dominios
| Campo | Tipo | Description |
|---|---|---|
domains |
Entero | El número máximo de dominios que puede incluir o excluir en una sola lista de dominios. |
Para las ubicaciones
| Campo | Tipo | Description |
|---|---|---|
content_categories |
Entero | Número máximo de categorías de contenido que puede aplicar a una sola ubicación. |
Ejemplos
Visualización de los límites y el uso actual de todos los tipos de objetos
$ curl -b cookies -c cookies 'https://api.appnexus.com/object-limit'
{
"response": {
"status": "OK",
"count": 21,
"start_element": 0,
"num_elements": 100,
"object-limits": [
{
"object_type": "site",
"limit": 10000,
"mappings": [
],
"count_active": 8,
"count_inactive": 0,
"count_total": 8
},
{
"object_type": "publisher",
"limit": 3000,
"mappings": [
],
"count_active": 8,
"count_inactive": 0,
"count_total": 8
},
{
"object_type": "profile",
"limit": null,
"mappings": {
"site_targets": 100,
"publisher_targets": 300,
"inventory_source_targets": 500,
"content_category_targets": 300,
"placement_targets": 250,
"segment_targets": 400
},
"count_active": null,
"count_inactive": null,
"count_total": null
},
{
"object_type": "placement",
"limit": 20000,
"mappings": [
],
"count_active": 21,
"count_inactive": 0,
"count_total": 21
},
{
"object_type": "line_item",
"limit": 3000,
"mappings": [
],
"count_active": 4,
"count_inactive": 1,
"count_total": 5
},
{
"object_type": "domain_list",
"limit": null,
"mappings": {
"domain": 30000
},
"count_active": null,
"count_inactive": null,
"count_total": null
},
{
"object_type": "creative",
"limit": 10000,
"mappings": [
],
"count_active": 32,
"count_inactive": 0,
"count_total": 32
},
{
"object_type": "campaign",
"limit": 10000,
"mappings": [
],
"count_active": 6,
"count_inactive": 6,
"count_total": 12
}
]
}
}
Visualización de los límites y el uso actual de las creatividades
$ curl -b cookies -c cookies 'https://api.appnexus.com/object-limit?object_type=creative'
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"object-limits": [
{
"object_type": "creative",
"limit": 10000,
"mappings": [
],
"count_active": 32,
"count_inactive": 0,
"count_total": 32
}
]
}
}
Límites predeterminados
Para obtener una lista de los límites de objetos predeterminados y las preguntas más frecuentes, consulte Restricciones de uso de API.
Eliminación de objetos
Cuando se aproxima o alcanza el límite de elementos de línea, campañas, publicadores, sitios o ubicaciones, puede usar informes como Network Advertiser Analytics y Network Publisher Analytics para identificar objetos que, por ejemplo, no se han modificado o utilizado en los últimos 30 días y, a continuación, eliminar esos objetos manualmente. En el caso de los elementos de línea y las campañas, también puede usar un filtro de cadena de consulta para buscar objetos en función de cuándo tuvieron impresiones por primera o última vez. Consulte Servicio de artículos de línea y Servicio de campaña para obtener más información.
Cuando se acerca o alcanza el límite para las creatividades, debe eliminar las creatividades no expiradas. Las creatividades no expiradas tienen el is_expired campo establecido en false. Tenga en cuenta que la eliminación de las creatividades expiradas no afectará al recuento de creatividades.