Servicio Yield Management Floor
El servicio Yield Management Floor se usa para crear y actualizar pisos dentro de un perfil de administración de rendimiento existente.
Un piso se puede considerar como el precio mínimo que una red o editor desea recibir por un creativo. Sin embargo, hay sutilezas.
Advertencia
La configuración del piso reemplaza a los precios de reserva establecidos a través del Servicio de colocación.
Ejemplo: Tiene un ajuste de suelo suave, pero no un piso duro, y ha establecido un precio de reserva en el nivel de ubicación . Sin embargo, dado que usa herramientas de administración de rendimiento , se omitirá la configuración del precio de reserva. Debes ponerla aquí a través de un piso duro.
API de REST
Campos JSON
| Campo | Tipo | Descripción |
|---|---|---|
member_id |
Entero | Identificador único del miembro con el que está asociado el suelo. Predeterminado: NULLObligatorio On: PUT, en la cadena de consulta. |
id |
Entero | Identificador único de una planta de administración de rendimiento. Predeterminado: Número incrementado automáticamente (es decir, 123). Obligatorio activado: PUT |
name |
string | Nombre que se usa para describir una planta de administración de rendimiento. Predeterminado: NoneObligatorio activado: POST |
code |
string | Código personalizado opcional que se usa para hacer referencia a una planta de administración de rendimiento. Predeterminado: NULL |
description |
string | La descripción opcional de cómo se usa la planta de administración de rendimiento. Predeterminado: NULL |
hard_floor |
double | El piso de CPM utilizado como el precio de reserva dura que se va a aplicar. Predeterminado: NoneObligatorio activado: POST |
soft_floor |
double | El piso de CPM utilizado como reserva blanda, definido como el precio más bajo al que se producirá la reducción del precio. Debe ser mayor o igual que el piso duro si se establece. Este valor se omite si floor_optimization_enabled es true.Predeterminado: NULL |
default_calculation_type |
enumeración | Si el piso debe aplicarse a la gross oferta o net . Valores posibles: gross o net. Un default_calculation_type de net es un piso aplicado al costo de medios pagado al publicador.Predeterminado: gross |
profile_id |
Entero | Se usa un opcional profile_id para determinar cuándo se debe aplicar un suelo. Un perfil es un conjunto genérico de reglas para el inventario de destino y determinados pisos solo se pueden aplicar a determinados segmentos del inventario. Para obtener más información, consulte El servicio de perfiles.Predeterminado: NULL |
priority |
Entero | El campo de prioridad (opcional) se usa para crear una jerarquía de cómo se debe aplicar el suelo. El valor puede estar entre 1-10, donde priority 10 se trata como el valor de prioridad más alto.Predeterminado: 5 |
ym_profile_id |
Entero | Identificador del perfil de administración de rendimiento al que está asociada la planta de administración de rendimiento. Para obtener más información, consulte El servicio de perfil de administración de rendimiento. Nota: Este identificador no se puede cambiar una vez establecido. Predeterminado: NULLObligatorio activado: POST |
floor_application_target |
enumeración | Tipo de pujas a las que se aplica el piso de precios. Posibles valores: - external_only: el piso de precios solo se aplica a las ofertas externas (los miembros compradores y los miembros vendedores son diferentes). Use esta opción si prefiere proporcionar una impresión de aprendizaje administrada disponible que servir un valor predeterminado, incluso si esto significa superar el porcentaje máximo de volumen diario para learn (max_learn_pct campo en el servicio de publicador).- external_non_preferred: el precio mínimo se aplica a las ofertas externas (el miembro comprador y el miembro vendedor son diferentes) o cuando la impresión es una impresión de aprendizaje administrada disponible que supera el porcentaje máximo de volumen diario para aprender. Use esta opción si prefiere proporcionar un valor predeterminado que proporcionar una impresión de aprendizaje administrada disponible que superaría el porcentaje máximo de volumen diario para aprender.- all: el precio mínimo se aplica a todas las ofertas excepto a las impresiones de aprendizaje administradas dentro del porcentaje máximo de volumen diario para aprender.Predeterminado: all |
apply_floor_to_direct |
Booleano | Eliminado. Use floor_application_target en su lugar. |
allow_tag_reserve_override |
Booleano | Si truees , permita que un precio de reserva enviado a través de la cadena de consulta de etiqueta de anuncio invalide el piso duro existente. El piso solo se reemplazará si el precio de reserva suministrado por etiqueta es mayor que el precio del piso.Predeterminado: false |
floor_optimization_enabled |
Booleano | Si truees , los pisos blandos se ignoran y los pisos para subir y bajar dependiendo de las condiciones del mercado, pero nunca permitir que la cantidad vaya por debajo del piso duro.Predeterminado: false |
members |
matriz | Miembros a los que se debe aplicar la planta de administración de rendimiento. Si se establece a la izquierda en NULL, la planta se aplicará a todos los miembros. Para obtener más información, consulte Miembros a continuación.Predeterminado: NULL |
brands |
matriz | Las marcas a las que se debe aplicar la planta de gestión del rendimiento. Para obtener más información, consulte Marcas a continuación. Predeterminado: NULL |
categories |
matriz | Las marcas o categorías creativas a las que se debe aplicar esta planta de gestión del rendimiento. Para obtener más información, vea Categorías a continuación. Predeterminado: NULL |
allowed_media_types |
matriz | Los tipos de medios a los que se debe aplicar esta planta de administración de rendimiento. Para obtener más información, vea Tipos de medios a continuación. Predeterminado: NULL |
allowed_media_subtypes |
matriz | Subtipos de medios a los que se debe aplicar esta planta de administración de rendimiento. Para obtener más información, vea Subtipos multimedia a continuación. Predeterminado: NULL |
Members
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | El identificador del miembro comprador (como se encuentra en el Servicio de miembros de la plataforma) para el que se debe aplicar el piso. Obligatorio activado: POST/PUT |
name |
string | Nombre del miembro comprador. Este campo es de solo lectura. |
Marcas
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | El identificador de la marca del creativo (tal como se encuentra en el Servicio de marca) para el que se debe aplicar el piso. Obligatorio activado: POST/PUT |
name |
string | Nombre de la marca. Este campo es de solo lectura. |
Categories
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | El identificador de la marca o la categoría creativa (como se describe en el Servicio de categoría) al que se debe aplicar este piso. Obligatorio activado: POST/PUT |
name |
string | Nombre de la marca o categoría creativa. Este campo es de solo lectura. |
Tipos de medios
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | Identificador del tipo de medio (como se describe en el servicio de tipo de medios) al que se debe aplicar este nivel. Obligatorio activado: POST/PUT |
name |
string | Nombre del tipo de medio. Este campo es de solo lectura. |
Subtipos multimedia
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | Identificador del subtipo de medios (como se describe en el servicio de subtipos de medios) al que se debe aplicar este nivel. Obligatorio activado: POST/PUT |
name |
string | Nombre del subtipo multimedia. Este campo es de solo lectura. |
Ejemplos
Visualización de un piso específico
$ curl -b cookies -c cookies "https://api.appnexus.com/ym-floor?id=1234"
{
"ym-floor": {
"member_id": 3,
"id": 1234,
"name": "Germany Floor",
"description": "This rule will used to set the floor for a set of demand attributes across Germany inventory.",
"hard_floor": 1.20,
"soft_floor": null,
"default_calculation_type": "gross",
"apply_floor_to_direct": true,
"floor_application_target": "all",
"profile_id": 1542,
"priority": 6,
"ym_profile_id": 1234,
"members": [{
"id": 100,
"name": "eBay"
}, {
"id": 256,
"name": "MiG"
}],
"brands": [{
"id": 102,
"name": "Netflix"
}, {
"id": 256,
"name": "Blockbuster"
}],
"categories": [{
"id": 2,
"name": "Apparel"
}, {
"id": 8,
"name": "Dating"
}],
"allowed_media_types": [{
"id": 1,
"name": "Banner"
}, {
"id": 4,
"name": "Video"
}],
"allowed_media_subtypes": [{
"id": 1,
"name": "Standard Banner"
}, {
"id": 8,
"name": "30-second VAST"
}]
}
}
Visualización de todos los pisos asociados a un perfil de administración de rendimiento
Observe que los siguientes pisos tienen como destino opcional {{profile_id}} en lugar de a través de la {{members}} matriz. Para obtener más información, consulte los campos JSON anteriores.
$ curl -b cookies "https://api.appnexus.com/ym-floor?ym_profile_id=9999"
{
"response": {
"start_element": null,
"count": 2,
"ym-floors": [{
"priority": 5,
"last_modified": "2011-11-03 23:04:24",
"soft_floor": 0.23999999999999999,
"member_id": 123,
"name": "Placement 60 + Size 300x250 Floor",
"floor_application_target": "all",
"default_calculation_type": "gross",
"brands": null,
"ym_profile_id": 9999,
"code": "Tattooed Bikers Galore",
"hard_floor": 0,
"id": 555,
"description": null,
"profile_id": 23,
"members": null,
"categories": null,
"allowed_media_types": null,
"allowed_media_subtypes": null
}, {
"priority": 5,
"last_modified": "2011-11-04 01:18:35",
"soft_floor": 0.050000000000000003,
"member_id": 1,
"name": "Placement+Size 728x90 Floor",
"floor_application_target": "all",
"default_calculation_type": "gross",
"brands": null,
"ym_profile_id": 9999,
"code": "Tattooed Bikers Knit and Sew",
"hard_floor": 0,
"id": 4,
"description": null,
"profile_id": 9,
"members": null,
"categories": null,
"allowed_media_types": null,
"allowed_media_subtypes": null
}],
"status": "OK",
"num_elements": null
}
}