Scopri di più sui pacchetti curati

La curators.curatedPackages risorsa ti consente di creare e gestire in modo programmatico i pacchetti di inventario dei publisher che selezioni per conto dei media planner.

I pacchetti selezionati ti consentono di raggruppare l'inventario selezionato che soddisfa criteri di targeting specifici, come tipi di dispositivi, area geografica e segmenti di dati, e di assegnare una commissione di selezione che viene addebitata quando gli acquirenti vincono le impressioni scelte come target dal pacchetto selezionato.

Comprendere i concetti chiave

Prima di iniziare l'integrazione, esamina i campi e le impostazioni che definiscono il funzionamento dei pacchetti selezionati:

Controllare chi può accedere ai pacchetti selezionati

I pacchetti selezionati sono accessibili solo ai media planner a cui hai concesso esplicitamente l'accesso utilizzando il CuratedPackage.accessSettings campo. Devi compilare il campo accessSettings quando viene creato il pacchetto selezionato.

Puoi utilizzare il mediaPlanners.list metodo per visualizzare un elenco di media planner idonei a essere specificati in nel CuratedPackage.accessSettings.allowlistedMediaPlanners campo.

Configurare l'inventario scelto come target dal pacchetto selezionato

Puoi utilizzare il CuratedPackage.targeting campo per specificare l'inventario scelto come target dal pacchetto selezionato. Il campo targeting viene compilato con l'oggetto PackageTargeting, che supporta criteri di targeting come tipo di dispositivo, formato della creatività, e località geografica.

Puoi anche specificare un targeting personalizzato con il CuratedPackage.targeting.includedDataSegments campo. Il campo includedDataSegments ti consente di scegliere come target i segmenti di dati gestiti da te o da altri partner di selezione.

Comprendere la logica di targeting

I valori nei campi ripetuti vengono elaborati utilizzando un OR logico, il che significa che un'impressione applicabile a uno qualsiasi dei valori specificati è una corrispondenza. Ogni campo viene elaborato utilizzando un AND logico, il che significa che tutti i campi specificati devono corrispondere a una determinata impressione affinché il pacchetto selezionato venga visualizzato nella richiesta di offerta corrispondente.

L'esempio seguente crea un pacchetto selezionato con un campo CuratedPackage.targeting compilato per scegliere come target una combinazione di tipi di dispositivi e segmenti di dati:

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

La tabella seguente mostra se il pacchetto selezionato nell'esempio sceglie come target un'impressione, dove ogni riga è un'impressione distinta:

Tipo di dispositivo ID segmento di dati Il pacchetto selezionato sceglie come target?
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

Indicare il valore del pacchetto selezionato

Quando crei un pacchetto selezionato, devi impostare una commissione di selezione utilizzando il CuratedPackage.fee campo di unione e puoi compilare solo uno dei tipi di commissione supportati dall'CuratedPackageoggetto, ad esempio il feeCpm campo. La commissione di selezione totale per una determinata impressione è la somma della commissione del pacchetto selezionato e delle commissioni di tutti i segmenti di dati scelti come target applicabili all'impressione.

Puoi anche indicare il valore delle impressioni scelte come target dal pacchetto selezionato impostando il CuratedPackage.floorPriceCpm campo, che può influenzare il prezzo minimo specificato per gli offerenti nelle offerte in tempo reale. Il prezzo minimo inviato agli offerenti è il valore più alto quando si confronta il prezzo minimo specificato nel campo floorPriceCpm e la somma del prezzo minimo del publisher e della commissione di selezione totale.

La tabella seguente fornisce esempi di come viene calcolato il prezzo minimo effettivo inviato nella richiesta di offerta per il pacchetto selezionato:

Prezzo minimo del publisher (CPM) Commissione di selezione totale (CPM) Prezzo minimo del pacchetto selezionato (CPM) Prezzo minimo effettivo (CPM)
$7 $2 $10 $10
$4 $1 $4 $5

Controllare la pubblicazione del pacchetto selezionato

Un pacchetto selezionato può avere uno dei seguenti stati:

  • ACTIVE: il pacchetto selezionato è attivo. I media planner abbonati possono ricevere richieste di offerta di offerte in tempo reale che contengono l'ID del pacchetto selezionato per l'inventario scelto come target.
  • INACTIVE: il pacchetto selezionato è inattivo. L'ID del pacchetto selezionato non viene visualizzato nelle richieste di offerta di offerte in tempo reale, nemmeno per i media planner abbonati.

Passaggi successivi

Per saperne di più sui flussi di lavoro che puoi eseguire con la risorsa curatedPackages, consulta i seguenti contenuti: