Licitadores: servicio de límite de objetos

Artículo
05/17/2024

Xandr limita el número de creatividades no expiradas 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 y el número de destinos determinados que se pueden usar en un único perfil. 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. Una creatividad expira cuando no se ha servido ni se ha modificado en los últimos 14 días (el día 15, se actualiza como Expirado).

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.adnxs.com/object-limit	Vea los límites y el uso actual de todos los tipos de objeto.
`GET`	https://api.adnxs.com/object-limit?object_type=OBJECT_TYPE	Vea el límite y el uso actual de un tipo de objeto específico. Propina: Están disponibles los siguientes tipos de objeto: `creative`, `profile`y `domain_list`.

Campos JSON

Campo	Tipo	Description
`count_active`	Entero	Número actual de objetos activos. En el caso de las creatividades, este recuento no incluye las creatividades expiradas.
`count_inactive`	Entero	Número actual de objetos inactivos, sin incluir los objetos eliminados. En el caso de las creatividades, este recuento no incluye las creatividades expiradas.
`count_total`	Entero	Número total actual de objetos activos e inactivos. En el caso de las creatividades, este recuento no incluye las creatividades expiradas.
`limit`	Entero	Número máximo de objetos permitidos por el licitador. 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 y `"domain_list"` . 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. Para obtener más información, vea "Límites de asignación" a continuación.
`object_type`	enumeración	Tipo de objeto. Valores posibles: `"creative"`, `"profile"`o `"domain_list"`. Nota: Para `"profile"` y `"domain_list"`, los `limit`campos , `count_active`, `count_inactive`y `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 se rellena solo para los "profile" tipos de objeto y "domain_list" . Enumera los límites de los objetos dentro de cada perfil y lista de dominios.

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	Obsoleto.
`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 Xandr 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_group_targets`	Entero	Número máximo de grupos de segmentos 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.
`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.

Ejemplos

Visualización de los límites y el uso actual de todos los tipos de objetos

$ curl -b cookies -c cookies 'https://api.adnxs.com/object-limit'
{
    "response": {
        "status": "OK",
        "count": null,
        "start_element": null,
        "num_elements": null,
        "object-limits": [
            {
                "object_type": "profile",
                "limit": null,
                "mapping_limits": {
                    "inventory_source_targets": 500,
                    "content_category_targets": 300,
                    "platform_content_category_targets": 300,
                    "postal_code_targets": 4000,
                    "segment_targets": 400,
                    "publisher_targets": 300,
                    "site_targets": 100,
                    "placement_targets": 250,
                    "segment_group_targets": 400
                },
                "count_active": null,
                "count_inactive": null,
                "count_total": null
            },
            {
                "object_type": "domain_list",
                "limit": null,
                "mapping_limits": {
                    "domains": 30000
                },
                "count_active": null,
                "count_inactive": null,
                "count_total": null
            },
            {
                "object_type": "creative",
                "limit": 16000,
                "mapping_limits": [
                ],
                "count_active": 0,
                "count_inactive": 0,
                "count_total": 0
            }
        ],
        "dbg": {
        ...
        }
    }
}

Visualización de los límites y el uso actual de las creatividades

$ curl -b cookies -c cookies 'https://api.adnxs.com/object-limit?object_type=creative'
{
    "response": {
        "status": "OK",
        "count": null,
        "start_element": null,
        "num_elements": null,
        "object-limits": [
            {
                "object_type": "creative",
                "limit": 16000,
                "mapping_limits": [
                ],
                "count_active": 0,
                "count_inactive": 0,
                "count_total": 0
            }
        ],
        "dbg": {
            ...
        }
    }
}

Preguntas frecuentes

Para obtener una lista de las preguntas más frecuentes sobre los límites de objetos, consulte Límites de objetos - Preguntas más frecuentes.

Eliminación de objetos

Cuando se aproxima al límite para las listas de dominios o el destino de perfil, debe quitar objetos inactivos, no usados o innecesarios.

Para quitar dominios de una lista de dominios, realice una PUT llamada a Domain List Service, actualizando la domains matriz.
Para obtener información sobre cómo quitar un destino de un perfil, consulte Perfiles de licitadores mejorados.

Cuando se acerca el límite para las creatividades, debe quitar las creatividades no expiradas. Las creatividades no expiradas tienen el is_expired campo establecido en false.

Nota:

La eliminación de las creatividades expiradas no afectará al recuento de creatividades.

Para quitar una creatividad, realice una DELETE llamada al Servicio creativo.

Compartir a través de