En savoir plus sur les packages sélectionnés

La curators.curatedPackages ressource vous permet de créer et de gérer par programmation des packages d'inventaire d'éditeur que vous gérez pour le compte de planificateurs média.

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

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 faisant l'objet d'une curation :

Contrôler qui peut accéder à vos packages faisant l'objet d'une curation

Vos packages faisant l'objet d'une curation ne sont accessibles qu'aux planificateurs média auxquels vous avez explicitement accordé l'accès à l'aide du CuratedPackage.accessSettings champ. Vous devez renseigner le champ accessSettings lors de la création du package faisant l'objet d'une curation.

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

Configurer l'inventaire ciblé par votre package faisant l'objet d'une curation

Vous pouvez utiliser le CuratedPackage.targeting champ pour spécifier l'inventaire ciblé par votre package faisant l'objet d'une curation. 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 CuratedPackage.targeting.includedDataSegments champ. Le champ includedDataSegments vous permet de cibler les segments de données que vous ou d'autres partenaires de curation 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 faisant l'objet d'une curation s'affiche dans la demande d'enchère correspondante.

L'exemple suivant crée un package faisant l'objet d'une curation 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 faisant l'objet d'une curation de l'exemple cible une impression, chaque ligne étant une impression distincte :

Type d'appareil ID des segments de données Le package faisant l'objet d'une curation cible-t-il ?
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

Signaler la valeur de votre package faisant l'objet d'une curation

Vous devez définir des frais de curation à l'aide du CuratedPackage.fee champ d'union lorsque vous créez un package faisant l'objet d'une curation. 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 faisant l'objet d'une curation et des frais de tous les segments de données ciblés applicables à l'impression.

Vous pouvez également signaler la valeur des impressions ciblées par votre package faisant l'objet d'une curation en définissant le CuratedPackage.floorPriceCpm champ, qui peut influencer le prix plancher spécifié pour les enchérisseurs dans les enchères en temps réel. Le prix plancher envoyé aux enchérisseurs correspond à la valeur la plus élevée lorsque vous comparez 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 prix plancher effectif envoyé dans la demande d'enchère pour le package faisant l'objet d'une curation :

Prix plancher de l'éditeur (CPM) Frais de curation totaux (CPM) Prix plancher du package faisant l'objet d'une curation (CPM) Prix plancher effectif (CPM)
7 $ 2 $ 10 $ 10 $
4 $ 1 $ 4 $ 5 $

Contrôler la diffusion de votre package faisant l'objet d'une curation

Un package faisant l'objet d'une curation peut avoir l'un des états suivants :

  • ACTIVE : le package faisant l'objet d'une curation est actif. Les planificateurs média abonnés peuvent recevoir des demandes d'enchères en temps réel contenant l'ID du package faisant l'objet d'une curation pour l'inventaire ciblé.
  • INACTIVE : le package faisant l'objet d'une curation est inactif. L'ID du package faisant l'objet d'une curation 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 :