Perfiles mejorados del licitador
Los perfiles de licitador filtran el tráfico y permiten a los licitadores aplicar reglas de negocio en los objetos. Esto es para garantizar que se reciben o no tipos específicos de tráfico. Xandr se asociará con usted y proporcionará las herramientas adecuadas para asegurarse de que tiene un perfil que se adapte a sus necesidades empresariales.
Cambios de alto nivel
Para obtener una lista de los cambios de los perfiles heredados al pujador mejorado actual, visite el registro de cambios.
- Una impresión solo necesita satisfacer el requisito de uno de los perfiles para poder pasar.
- Ya no hay una jerarquía primaria o secundaria.
- Para obtener más información sobre el cambio en la jerarquía, consulte aquí: Segmentación de jerarquía y tipo de anuncio para perfiles de licitadores mejorados.
- Se han agregado el filtrado y la segmentación de tipos de anuncio.
- Ahora podrá bloquear o dirigirse a nativo, banner, vídeo, audio
- Para obtener más información sobre la segmentación por tipo de anuncio, consulte aquí: Segmentación de jerarquía y tipo de anuncio para perfiles de licitadores mejorados.
- Eliminación del porcentaje de acceso directo.
- Ahora puede establecer límites de QPS por controlador de dominio.
- Para obtener más información sobre cómo establecer un límite de QPS, consulte aquí: Servicio de instancia del licitador.
- Adición de la selección de destino de Exchange
- Hemos agrupado nuestro inventario en grupos fáciles de entender
- Para obtener más información sobre los intercambios, consulte aquí: Servicio Exchange
API de REST
| Https (método) | Endpoint | Description |
|---|---|---|
| POST | https://api.adnxs.com/bidder-profile/BIDDER_ID |
Adición de un nuevo perfil |
| PUT | https://api.adnxs.com/bidder-profile/BIDDER_ID/PROFILE_ID |
Modificación de un perfil existente |
| GET | https://api.adnxs.com/bidder-profile/BIDDER_ID |
Para ver todos los perfiles adjuntos al postor |
| GET | https://api.adnxs.com/bidder-profile/BIDDER_ID/PROFILE_ID |
Para ver un perfil específico adjunto al postor |
Campos JSON
| Campo | Tipo | Description |
|---|---|---|
id |
Entero | Identificador del perfil del licitador. Se trata de un campo de solo lectura. |
bidder_id |
Entero | El identificador del licitador. Se trata de un campo de solo lectura. |
code |
string | Identificador alternativo para el perfil del licitador, específico del postor. |
description |
string | Descripción del perfil del licitador. |
active |
Booleano | Indica si el perfil se ha activado. Si es false, este perfil no afecta al tráfico enviado al licitador. |
targeting |
object | Las reglas de selección de destino de este perfil de licitador. Para obtener más información, consulte Orientación a continuación. |
user_not_in_segment_action |
enumeración | Si se establece en include: las impresiones de todos los usuarios se envían al licitador.Si se establece en exclud: solo se envían las impresiones en las que el usuario existe en un segmento propiedad o compartido con el pujador. Las restricciones de QPS se aplicarán a este campo. El licitador no tiene que indicar explícitamente el segmento en las acciones del segmento.Nota: Este campo quedará en desuso en favor de unknown_users_action. |
unknown_users_action |
enumeración | Si se establece en include: las impresiones de todos los usuarios se envían al licitador.Si se establece excludeen : solo se envían las impresiones en las que el usuario tiene asignado un identificador interno en la cookie Xandr. La asignación se produce cuando el licitador llama a la función setuid. |
non_audited_url_action |
enumeración | Si se establece en exclude, se excluirá todo el inventario que Xandr no haya auditado. De lo contrario, se incluirá todo el inventario. |
Orientación
El objeto de destino contiene los campos siguientes.
| Campo | Tipo | Descripción |
|---|---|---|
exchanges |
object | Intercambios y vendedores incluidos o excluidos por este perfil. Para obtener más información, vea Exchanges below (Intercambios a continuación). |
countries |
object | Países incluidos o excluidos por este perfil. Para obtener más información, consulte Países a continuación. |
domain_lists |
object | Listas de dominio incluidas o excluidas por este perfil. Para obtener más información, consulte Listas de dominio a continuación. |
ad_types |
object | Los tipos de anuncios (por ejemplo, Banner, Vídeo) incluidos o excluidos por este perfil. Para obtener más información, consulta Tipos de anuncios a continuación. |
supply_types |
object | Los tipos de suministro (por ejemplo, Escritorio, Aplicación móvil) incluidos o excluidos por este perfil. Para obtener más información, vea Tipos de suministro a continuación. |
inventory_attributes |
Objetos | Atributos de inventario incluidos o excluidos por este perfil. Para obtener más información, consulte Atributos de inventario a continuación. |
Intercambios
El objeto exchanges contiene los campos siguientes.
| Campo | Tipo | Description | Valores posibles |
|---|---|---|---|
action |
enumeración | Indica si los intercambios de la matriz de destinos (a continuación) se incluyen o excluyen. | include, exclude |
targets |
matriz de objetos | Lista de intercambios incluidos o excluidos por el perfil. Consulte la documentación del servicio Exchange para obtener más información sobre los intercambios. |
{"id": 1}, {"id": 2}, {"id": 3} |
excluded_members |
matriz de objetos | Lista de vendedores que el postor quiere excluir. Consulte platform member service (Servicio de miembros de la plataforma) para obtener una lista de los miembros de destino. | {"id": 181}, {"id": 459} |
included_members |
matriz de objetos | Lista de vendedores que el postor quiere incluir. Consulte platform member service (Servicio de miembros de la plataforma) para obtener una lista de los miembros de destino. Nota: Los vendedores que pertenecen al suministro directo de Xandr (Exchange 1) no se pueden incluir individualmente. Consulte la documentación del servicio Exchange para obtener más información. |
{"id": 181}, {"id": 459} |
Países
El objeto countries contiene los siguientes campos.
| Campo | Tipo | Description | Valores posibles |
|---|---|---|---|
action |
enumeración | Indica si los países de la matriz de destinos (a continuación) se incluyen o excluyen. | include, exclude |
targets |
matriz de objetos | Lista de países incluidos o excluidos por el perfil. Consulte el Servicio de país para obtener una lista de países de destino. | {"id": 233}, {"id": 80} |
Listas de dominios
El objeto de lista de dominios contiene los campos siguientes.
| Campo | Tipo | Description | Valores posibles |
|---|---|---|---|
action |
enumeración | Indica si las listas de dominios de la matriz de destinos (a continuación) están en listas de permitidos o listas de bloqueo. | include, exclude |
targets |
matriz de objetos | Lista de listas de dominio incluidas o excluidas por el perfil. El tipo de lista de dominios no afecta a cómo se aplica la segmentación; use la acción para configurar listas de permitidos o listas de bloqueo. Consulte Domain List Service para obtener una lista de listas de dominios de destino. | {"id": 12345}, {"id": 34567} |
Tipos de anuncios
El objeto de tipos de anuncio contiene los siguientes campos. Para obtener más información sobre los tipos de anuncios: jerarquía y segmentación de tipos de anuncio para perfiles de licitadores mejorados
| Campo | Tipo | Description | Valores posibles |
|---|---|---|---|
banner |
object | Indica si las impresiones aptas para banners están destinadas. Se pueden configurar tamaños de anuncios específicos. Si no está configurado explícitamente, se supone que se incluirá. Para obtener más información, consulte Banner a continuación. | {"id": 12345}, {"id": 34567} |
video |
object | Indica si las impresiones aptas para vídeo están destinadas. Si no está configurado explícitamente, se supone que se incluirá. Para obtener más información, vea Vídeo a continuación. | |
native |
object | Indica si las impresiones aptas para nativos están destinadas. Si no está configurado explícitamente, se supone que se incluirá. Para obtener más información, vea Nativo a continuación. | |
audio |
object | Indica si las impresiones aptas para audio están destinadas. Si no está configurado explícitamente, se supone que se incluirá. Para obtener más información, consulte Audio a continuación. |
Banner
El objeto banner contiene los campos siguientes.
| Campo | Tipo | Description | Valores posibles |
|---|---|---|---|
action |
enumeración | Indica si se incluyen o excluyen las impresiones aptas para banners. | include, exclude |
sizes |
matriz de objetos | Lista de tamaños de anuncios de banner incluidos en la segmentación. Los tamaños creativos no se pueden excluir. | {"width": 300, "height": 250}, {"width": 728, "height": 90} |
Vídeo
El objeto de vídeo contiene los campos siguientes.
| Campo | Tipo | Description | Valores posibles |
|---|---|---|---|
action |
enumeración | Indica si se incluyen o excluyen las impresiones aptas para vídeo. | include, exclude |
Nativa
El objeto nativo contiene los campos siguientes.
| Campo | Tipo | Description | Valores posibles |
|---|---|---|---|
action |
enumeración | Indica si se incluyen o excluyen las impresiones aptas para nativos. | include, exclude |
Audio
El objeto de audio contiene los campos siguientes.
| Campo | Tipo | Description | Valores posibles |
|---|---|---|---|
action |
enumeración | Indica si se incluyen o excluyen las impresiones aptas para audio. | include, exclude |
Tipos de suministro
El objeto de tipos de suministro contiene los campos siguientes.
| Campo | Tipo | Description | Valores posibles |
|---|---|---|---|
action |
enumeración | Indica si los tipos de suministro de la matriz de destinos (a continuación) se incluyen o excluyen. | include, exclude |
targets |
matriz de cadenas | Lista de tipos de suministro incluidos o excluidos por el perfil. | mobile_app, mobile_web, web |
Atributos de inventario
El objeto de atributos de inventario contiene los campos siguientes.
| Campo | Tipo | Description | Valores posibles |
|---|---|---|---|
action |
enumeración | Indica si se incluyen los atributos de inventario de la matriz de destinos (a continuación). | include |
targets |
matriz de objetos | Lista de atributos de inventario incluidos o excluidos por el perfil. Consulte el Servicio de atributos de inventario para obtener una lista de los atributos de inventario de destino. El inventario sin un atributo de inventario asignado siempre tiene como destino. |
{"id": 2}, {"id": 16} |
Ejemplos
Aquí encontrará ejemplos de API adicionales: Casos de uso de API para perfiles de licitadores mejorados que realizan una llamada GET en la API:
Intercambios
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [{
"id": 00,
"bidder_id": 00,
"code": null,
"description": null,
"targeting": {
"exchanges": {
"action": "include",
"targets": [{
"id": 1,
"name": "Direct"
}],
"excluded_members": [{
"id": 5,
"billing_name": "Supply_source"
}],
"included_members": [{
"id": 7,
"billing_name": "Supply_source_two"
}]
}
},
"last_activity": "2018-07-24 17:05:00",
"created_on": "2018-07-20 18:16:19",
"active": true
}]
}
}
Países
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [
{
"id": 00,
"bidder_id": 0,
"code": "my_code",
"description": "EMEA Profile",
"targeting": {
"countries": {
"action": "include",
"targets": [
{
"id": 18,
"name": "Australia",
"code": "AU",
"active": true
},
{
"id": 41,
"name": "Canada",
"code": "CA",
"active": true
},
{
"id": 105,
"name": "Ireland",
"code": "IE",
"active": true
},
{
"id": 173,
"name": "New Zealand",
"code": "NZ",
"active": true
},
{
"id": 80,
"name": "United Kingdom",
"code": "GB",
"active": true
},
{
"id": 233,
"name": "United States",
"code": "US",
"active": true
}
]
},
"last_activity": "2018-07-24 19:47:54",
"created_on": "2018-07-24 19:47:49",
"active": true,
"user_not_in_segment_action": "include"
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
Listas de dominios
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [
{
"id": 00,
"bidder_id": 00,
"code": null,
"description": null,
"targeting": {
"domain_lists": {
"action": "exclude",
"targets": [
{
"id": 140000,
"name": "Additional Block List",
"description": "Block list",
"type": "black"
},
{
"id": 800000,
"name": "Domain list (blocklist)",
"description": "Domain list (blocklist)",
"type": "black"
}
]
},
"last_activity": "2018-07-24 17:05:31",
"created_on": "2018-07-20 18:21:00",
"active": true
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
Tipos de anuncios
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [
{
"id": 00,
"bidder_id": 000,
"code": "Company_test",
"description": "Company Parent Test",
"targeting": {
"ad_types": {
"banner": {
"action": "include",
"sizes": [{
"width": 200,
"height": 200
}, {
"width": 50,
"height": 50
}]
},
"video": {
"action": "exclude"
"sizes": [{
"width": 200,
"height": 200
}, {
"width": 50,
"height": 50
}]
}, },
"audio": {
"action": "exclude"
},
"native": {
"action": "include"
}
}
},
"last_activity": "2018-07-24 19:47:54",
"created_on": "2018-07-24 19:47:49",
"active": true,
"non_audited_url_action": "include"
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
Tipos de suministro
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"bidder_profiles":
[
{
"id": 00,
"bidder_id": 000,
"code": "my_code",
"description": "Company Profile",
"targeting": {
"supply_types": {
"action": "include",
"targets": [
"web",
"mobile_web",
"mobile_app"
]
},
}
}
},
"last_activity": "2018-07-24 19:47:54",
"created_on": "2018-07-24 19:47:49",
"active": true,
"non_audited_url_action": "include"
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
Atributos de inventario
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [
{
"id": 00,
"bidder_id": 00,
"code": null,
"description": null,
"targeting": {
"inventory_attributes": {
"targets": [{
{
"id": 00,
"name": "Streaming Media",
"deleted": false
}]
}
},
"last_activity": "2018-07-24 19:47:54",
"created_on": "2018-07-24 19:47:49",
"active": true,
"non_audited_url_action": "include"
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
Acción de usuarios desconocidos
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [
{
"id": 00,
"bidder_id": 00,
"code": null,
"description": null,
"targeting": {
"inventory_attributes": {
"targets": [{
{
"id": 00,
"name": "Streaming Media",
"deleted": false
}],
"action": "include"
}
},
"last_activity": "2018-07-24 19:47:54",
"created_on": "2018-07-24 19:47:49",
"active": true,
"unknown_users_action": "include"
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
Acción de dirección URL no auditada
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"bidder_profiles": [
{
"id": 00,
"bidder_id": 00,
"code": null,
"description": null,
"targeting": {
"inventory_attributes": {
"targets": [{
"id": 00,
"name": "Streaming Media",
"deleted": false
}],
"action": "include"
}
},
"last_activity": "2018-07-24 19:47:54",
"created_on": "2018-07-24 19:47:49",
"active": true,
"non_audited_url_action": "include"
}
],
"dbg": {
"warnings": [
],
"version": "1.18.701",
"output_term": "bidder_profiles"
}
}
}
Temas relacionados
- Servicio Exchange
- Segmentación de jerarquía y tipo de anuncio para perfiles de pujador mejorados
- Casos de uso de API para perfiles de licitador mejorados
- Preguntas más frecuentes (P+F) sobre perfiles mejorados del licitador
- Registro de cambios para perfiles de licitador mejorados
- Guía de migración del perfil del licitador