Más información sobre los paquetes seleccionados

El recurso curators.curatedPackages te permite crear y administrar de forma programática paquetes de inventario de publicadores que selecciones en nombre de los planificadores de medios.

Los paquetes seleccionados te permiten agrupar inventario seleccionado que cumple con criterios de segmentación específicos, como tipos de dispositivos, ubicación geográfica y segmentos de datos, y asignar una comisión de selección que se cobra cuando los compradores ganan impresiones segmentadas por el paquete seleccionado.

Comprende los conceptos clave

Antes de comenzar la integración, revisa los campos y la configuración que definen cómo operan los paquetes seleccionados:

Controla quién puede acceder a tus paquetes seleccionados

Solo los planificadores de medios a los que les otorgaste acceso explícitamente a través del campo CuratedPackage.accessSettings pueden acceder a tus paquetes seleccionados. Debes propagar el campo accessSettings cuando se cree el paquete seleccionado.

Puedes usar el método mediaPlanners.list para ver una lista de los planificadores de medios que se pueden especificar en el campo CuratedPackage.accessSettings.allowlistedMediaPlanners.

Configura el inventario al que se segmenta tu paquete seleccionado

Puedes usar el campo CuratedPackage.targeting para especificar el inventario al que se segmenta tu paquete seleccionado. El campo targeting se completa con el objeto PackageTargeting, que admite criterios de segmentación como el tipo de dispositivo, el formato de creatividad y la ubicación geográfica.

También puedes especificar una segmentación personalizada con el campo CuratedPackage.targeting.includedDataSegments. El campo includedDataSegments te permite segmentar tus campañas para llegar a segmentos de datos que tú u otros socios de selección administran.

Comprende la lógica de la segmentación

Los valores de los campos repetidos se procesan con un OR lógico, lo que significa que una impresión que se aplica a cualquiera de los valores especificados es una coincidencia. Cada campo se procesa con un AND lógico, lo que significa que todos los campos especificados deben coincidir con una impresión determinada para que el paquete seleccionado aparezca en la solicitud de oferta correspondiente.

En el siguiente ejemplo, se crea un paquete seleccionado con un campo CuratedPackage.targeting completado para segmentar una combinación de tipos de dispositivos y segmentos de datos:

{
  "includedDeviceTypes": [
    "DEVICE_TYPE_PHONE",
    "DEVICE_TYPE_PERSONAL_COMPUTER"
  ],
  "includedDataSegments": [
    "curators/123456/dataSegments/8765",
    "curators/123456/dataSegments/8172"
  ]
}

En la siguiente tabla, se muestra si el paquete seleccionado del ejemplo segmenta una impresión, en la que cada fila es una impresión distinta:

Tipo de dispositivo IDs de segmentos de datos ¿El paquete seleccionado se segmenta?
DEVICE_TYPE_PERSONAL_COMPUTER 8765, 8172 Sí
DEVICE_TYPE_PHONE 8172, 4321 Sí
DEVICE_TYPE_PHONE 9182 No
DEVICE_TYPE_CONNECTED_TV 4321, 9182 No

Indica el valor de tu paquete seleccionado

Debes establecer una comisión de curación con el campo de unión CuratedPackage.fee cuando crees un paquete curado y solo puedes completar uno de los tipos de comisión admitidos por el objeto CuratedPackage, por ejemplo, el campo feeCpm. La comisión total de curación para una impresión determinada es la suma de la comisión del paquete curado y las comisiones de los segmentos de datos segmentados que se aplican a la impresión.

También puedes indicar el valor de las impresiones para las que se segmenta tu paquete seleccionado configurando el campo CuratedPackage.floorPriceCpm, que puede influir en el precio mínimo especificado para los ofertantes en la licitación en tiempo real. El precio mínimo que se envía a los ofertantes es el valor más alto cuando se compara el precio mínimo que especificas en el campo floorPriceCpm y la suma del precio mínimo del publicador y la tarifa de curación total.

En la siguiente tabla, se proporcionan ejemplos de cómo se calcula el precio mínimo efectivo que se envía en la solicitud de oferta para el paquete seleccionado:

Precio mínimo del publicador (CPM) Tarifa total de curación (CPM) Precio mínimo del paquete seleccionado (CPM) Mínimo efectivo (CPM)
USD 7 $2 $10 $10
$4 USD 1 $4 $5

Controla la publicación de tu paquete seleccionado

Un paquete seleccionado puede tener uno de los siguientes estados:

  • ACTIVE: El paquete seleccionado está activo. Los planificadores de medios suscritos pueden recibir solicitudes de licitación en tiempo real que contienen el ID del paquete seleccionado para el inventario segmentado.
  • INACTIVE: El paquete seleccionado está inactivo. El ID del paquete seleccionado no aparece en las solicitudes de oferta de licitación en tiempo real, ni siquiera para los planificadores de medios suscritos.

Próximos pasos

Para obtener más información sobre los flujos de trabajo que puedes realizar con el recurso curatedPackages, consulta el siguiente contenido: