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 seleccionas 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 funcionan los paquetes seleccionados:

Controla quién puede acceder a tus paquetes seleccionados

Los paquetes seleccionados solo son accesibles para los planificadores de medios a los que les otorgaste acceso de forma explícita con el CuratedPackage.accessSettings campo. Debes propagar el campo accessSettings cuando se crea el paquete seleccionado.

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

Configura el inventario al que se segmenta tu paquete seleccionado

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

También puedes especificar una segmentación personalizada con el CuratedPackage.targeting.includedDataSegments campo. El campo includedDataSegments te permite segmentar los segmentos de datos que tú u otros socios selectores administran.

Comprende la lógica de 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 propagado 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 se segmenta a una impresión, en la que cada fila es una impresión distinta:

Tipo de dispositivo IDs de segmentos de datos ¿Se segmenta el paquete seleccionado?
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 selección con el CuratedPackage.fee campo de unión cuando crees un paquete seleccionado y solo puedes propagar uno de los tipos de comisión admitidos por el CuratedPackage objeto, por ejemplo, el feeCpm campo. La comisión de selección total para una impresión determinada es la suma de la comisión del paquete seleccionado 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 a las que se segmenta tu paquete seleccionado si estableces el CuratedPackage.floorPriceCpm campo, 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 comisión de selecció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) Comisión de selección total (CPM) Precio mínimo del paquete seleccionado (CPM) Precio mínimo efectivo (CPM)
USD 7 USD 2 USD 10 USD 10
USD 4 USD 1 USD 4 USD 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 oferta de Licitación en tiempo real que contengan 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, incluso 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, revisa el siguiente contenido: