En savoir plus sur les packages sélectionnés

La ressource curators.curatedPackages vous permet de créer et de gérer de manière programmatique des packages d'inventaire d'éditeur que vous organisez pour les responsables de la planification média.

Les packages curatés vous permettent de regrouper un inventaire sélectionné qui répond à des critères de ciblage spécifiques (types d'appareils, zone géographique et segments de données, par exemple) et d'attribuer des frais de curation qui sont facturés lorsque les acheteurs remportent des impressions ciblées par le package curaté.

Comprendre les concepts clés

Avant de commencer votre intégration, examinez les champs et les paramètres qui définissent le fonctionnement des packages sélectionnés :

Contrôler qui peut accéder à vos packages sélectionnés

Vos packages sélectionnés ne sont accessibles qu'aux planificateurs média auxquels vous avez explicitement accordé l'accès à l'aide du champ CuratedPackage.accessSettings. Vous devez renseigner le champ accessSettings lorsque le package sélectionné est créé.

Vous pouvez utiliser la méthode mediaPlanners.list pour afficher la liste des responsables média pouvant être spécifiés dans le champ CuratedPackage.accessSettings.allowlistedMediaPlanners.

Configurer l'inventaire ciblé par votre package préparé

Vous pouvez utiliser le champ CuratedPackage.targeting pour spécifier l'inventaire ciblé par votre package sélectionné. Le champ targeting est renseigné avec l'objet PackageTargeting, qui accepte les critères de ciblage tels que le type d'appareil, le format de la création et l'emplacement géographique.

Vous pouvez également spécifier un ciblage personnalisé avec le champ CuratedPackage.targeting.includedDataSegments. Le champ includedDataSegments vous permet de cibler des segments de données que vous ou d'autres curateurs partenaires gérez.

Comprendre la logique de ciblage

Les valeurs des champs répétés sont traitées à l'aide d'un OR logique, ce qui signifie qu'une impression applicable à l'une des valeurs spécifiées correspond. Chaque champ est traité à l'aide d'un AND logique, ce qui signifie que tous les champs spécifiés doivent correspondre à une impression donnée pour que le package sélectionné apparaisse dans la demande d'enchère correspondante.

L'exemple suivant crée un package organisé avec un champ CuratedPackage.targeting renseigné pour cibler une combinaison de types d'appareils et de segments de données :

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

Le tableau suivant indique si le package sélectionné de l'exemple cible une impression, où chaque ligne correspond à une impression distincte :

Type d'appareil ID des segments de données La sélection ciblée s'applique-t-elle au package ?
DEVICE_TYPE_PERSONAL_COMPUTER 8765, 8172 Oui
DEVICE_TYPE_PHONE 8172, 4321 Oui
DEVICE_TYPE_PHONE 9182 Non
DEVICE_TYPE_CONNECTED_TV 4321, 9182 Non

Mettez en avant la valeur de votre package sélectionné

Vous devez définir des frais de curation à l'aide du champ d'union CuratedPackage.fee lorsque vous créez un package sélectionné. Vous ne pouvez renseigner qu'un seul des types de frais acceptés par l'objet CuratedPackage, par exemple le champ feeCpm. Les frais de curation totaux pour une impression donnée correspondent à la somme des frais du package curaté et des frais de tous les segments de données ciblés applicables à l'impression.

Vous pouvez également indiquer la valeur des impressions ciblées par votre package sélectionné en définissant le champ CuratedPackage.floorPriceCpm. Cela peut avoir une incidence sur le prix plancher spécifié aux enchérisseurs dans les enchères en temps réel. Le prix plancher envoyé aux enchérisseurs correspond à la valeur la plus élevée entre le prix plancher que vous spécifiez dans le champ floorPriceCpm et la somme du prix plancher de l'éditeur et des frais de curation totaux.

Le tableau suivant fournit des exemples de calcul du plancher effectif envoyé dans la demande d'enchère pour le package sélectionné :

Plancher de l'éditeur (CPM) Frais de curation totaux (CPM) Plancher du package sélectionné (CPM) Plancher effectif (CPM)
7 $ 2 € 10 $ 10 $
4 € 1 € 4 € 5 $

Contrôler la diffusion de votre sélection

Un package sélectionné peut avoir l'un des états suivants :

  • ACTIVE : le package sélectionné est actif. Les responsables de la planification média abonnés peuvent recevoir des demandes d'enchères en temps réel contenant l'ID du package sélectionné pour l'inventaire ciblé.
  • INACTIVE : le package sélectionné est inactif. L'ID du package sélectionné n'apparaît pas dans les demandes d'enchères en temps réel, même pour les planificateurs média abonnés.

Étapes suivantes

Pour en savoir plus sur les workflows que vous pouvez effectuer avec la ressource curatedPackages, consultez les contenus suivants :