Yield Management Bias service

Artículo
07/05/2024

El servicio Yield Management Bias se usa para crear y actualizar sesgos dentro de un perfil de administración de rendimiento existente. Los sesgos son una manera de modificar las ofertas de ciertos compradores o grupos de compradores para que parezcan más altos o inferiores de lo que realmente son para la ejecución de una subasta.

API de REST

Http (método)	Endpoint	Description
`POST`	- https://api.appnexus.com/ym-bias?ym_profile_id=YM_PROFILE_ID - https://api.appnexus.com/ym-bias?ym_profile_code=YM_PROFILE_CODE (JSON ym-bias)	Agregue un sesgo.
`PUT`	- https://api.appnexus.com/ym-bias?id=YM_BIAS_ID - https://api.appnexus.com/ym-bias?code=YM_BIAS_CODE (JSON ym-bias)	Modificar un sesgo existente.
`GET`	- https://api.appnexus.com/ym-bias?ym_profile_id=YM_PROFILE_ID - https://api.appnexus.com/ym-bias?ym_profile_code=YM_PROFILE_CODE	Ver todos los sesgos asociados a un perfil de administración de rendimiento determinado.
`GET`	- https://api.appnexus.com/ym-bias?id=YM_BIAS_ID - https://api.appnexus.com/ym-bias?code=YM_BIAS_CODE	Ver un sesgo específico.
`GET`	https://api.appnexus.com/ym-bias?id=1,2,3	Vea varios sesgos por identificador mediante una lista separada por comas.

Campos JSON

Campo	Tipo	Descripción
`id`	Entero	Identificador único de un sesgo de administración de rendimiento. Predeterminado: Número incrementado automáticamente (es decir, 123). Obligatorio activado:`PUT`
`code`	string	Código personalizado opcional que se usa para hacer referencia a un sesgo de administración de rendimiento. Predeterminado:`NULL`
`name`	string	Nombre que se usa para describir un sesgo de administración del rendimiento. Predeterminado:`None` Obligatorio activado:`POST`
`description`	string	Descripción opcional de cómo se usa el sesgo de administración del rendimiento. Predeterminado:`NULL`
`ym_profile_id`	Entero	Identificador del perfil de administración de rendimiento al que está asociado el sesgo 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:`NULL` Obligatorio activado:`POST`
`profile_id`	Entero	Se usa un opcional `profile_id` para determinar cuándo aplicar un sesgo. Un perfil es un conjunto genérico de reglas para el inventario de destino y ciertos sesgos 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 sesgo. El valor puede estar entre `1`-`10` donde la prioridad `10` se trata como el valor de prioridad más alto. Predeterminado:`5`
`members`	matriz de objetos	Se trata de una matriz que especifica los miembros a los que se debe aplicar el sesgo de administración de rendimiento. Para obtener más información, consulte la matriz members a continuación. Predeterminado:`NULL`
`buyer_groups`	matriz de objetos	Se trata de una matriz que especifica los grupos de compradores a los que se debe aplicar el sesgo de administración del rendimiento. Para obtener más información, consulte la matriz de grupos de compradores a continuación. Predeterminado:`NULL`

Matriz Members

Campo	Tipo	Descripción
`id`	Entero	Este es el identificador del miembro comprador (tal como se encuentra en el servicio de miembro de la plataforma) para el que se debe aplicar el sesgo. Predeterminado:`None` Obligatorio en:`POST` , `PUT`
`name`	matriz	Este es el nombre del miembro comprador. Predeterminado: N/A
`type`	enumeración (`'percent'`,`'cpm'`)	Esto determina qué valor se va a usar para el sesgo, representado como un porcentaje o un CPM plano. Predeterminado:`"percent"` Obligatorio en:`POST` , `PUT`
`bias_pct`	double	Este es el porcentaje por el que debe ajustarse el miembro comprador. Si `bias_pct = 5`es , la oferta neta se incrementará un 5 %. Predeterminado:`0.00` Obligatorio En:`POST`, `PUT` (si `type` es `'percent'`).
`bias_cpm`	double	Este es el aumento o disminución de CPM por el que debe ajustarse el miembro comprador. Predeterminado:`NULL` Obligatorio En:`POST`, `PUT` (si `type` es `'cpm'`).

Matriz de grupos de compradores

Parámetro	Tipo	Descripción
`id`	Entero	Este es el identificador del grupo de compradores para el que se debe aplicar el sesgo. Predeterminado:`None` Obligatorio en:`POST` , `PUT`
`name`	matriz	Este es el nombre del grupo de compradores. Predeterminado: N/A
`type`	enumeración (`'percent'`,`'cpm'`)	Esto determina qué valor se va a usar para el sesgo, representado como un porcentaje o un CPM plano. Predeterminado:`"percent"` Obligatorio en:`POST` , `PUT`
`bias_pct`	double	Este es el porcentaje por el que debe ajustarse el miembro comprador. Si `bias_pct = 5`es , la oferta neta se incrementará un 5 %. Predeterminado:`0.00` Obligatorio En:`POST`, `PUT` (si `type` es `'percent'`).
`bias_cpm`	double	Este es el aumento o disminución de CPM por el que debe ajustarse el miembro comprador. Predeterminado:`NULL` Obligatorio En:`POST`, `PUT` (si `type` es `'cpm'`).

Ejemplos

Ver un sesgo específico

$ curl -b cookies -c cookies  "https://api.appnexus.com/ym-bias?id=1234"
{
    "ym-bias": {
        "member_id": 3,
        "id": 124,
        "name": "Canada Bias",
        "description": "This rule will used to set the bias for a set of demand attributes across Canadian inventory.",
        "profile_id": 1241,
        "priority": 5,
        "ym_profile_id": 1234
        "members": [
                    {
                        "id": 100,
                        "name": "eBay",
                        "type": "percent",
                        "bias_pct": 10
                    },
                    {
                        "id": 256,
                        "name": "MiG",
                        "type": "cpm",
                        "bias_cpm": -0.25
                    }
                ],
        "buyer_groups": [
                    {
                        "id": 120,
                        "name": "Third Party Ad Networks",
                        "type": "percent",
                        "bias_pct": -5
                    },
                    {
                        "id": 153,
                        "name": "Value Ad Networks",
                        "type": "cpm",
                        "bias_cpm": 0.50
                    }
                ]
    }
}

Ver todos los sesgos asociados a un perfil de administración de rendimiento determinado

Nota:

El primer sesgo de la matriz siguiente no está asociado a {{members}} o {{buyer_groups}}, sino a ( {{profile_id}} para obtener más información, consulte los campos JSON anteriores).

$ curl -b cookies "https://api.appnexus.com/ym-bias?ym_profile_id=123"
{
 "response": {
  "status": "OK",
  "ym-biases": [
   {
    "priority": 10,
    "member_id": 999,
    "members": null,
    "name": "Low Frequency Bias",
    "last_modified": "2011-02-22 19:26:32",
    "code": null,
    "id": 4,
    "description": null,
    "profile_id": 456,
    "ym_profile_id": 123,
    "buyer_groups": null
   },
   {
    "priority": 5,
    "member_id": 999,
    "members": [
               {
        "id": 890,
        "name": "The one I'm biased slightly against",
        "type": "percent",
        "bias_pct": -5
           }
    ],
    "name": "A secret bias only I can see",
    "last_modified": "2011-07-05 23:32:46",
    "code": null,
    "id": 1575,
    "description": null,
    "profile_id": null,
    "ym_profile_id": 123,
    "buyer_groups": null
   }
  ],
  "start_element": null,
  "count": 2,
  "num_elements": null
 }
}

Compartir a través de