Irakurri ingelesez

Partekatu honen bidez:

Licitadores: servicio de límite de objetos

  • Artikulua

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, profiley 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 limitcampos , count_active, count_inactivey 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.

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.

Oharra

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

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