Scopri di più sui pacchetti curati

La risorsa curators.curatedPackages ti consente di creare e gestire in modo programmatico 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 del curatore che viene addebitata quando gli acquirenti vincono le impressioni targetizzate dal pacchetto selezionato.

Comprendere i concetti chiave

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

Controllare chi può accedere ai pacchetti curati

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

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

Configurare l'inventario a cui è destinato il pacchetto selezionato

Puoi utilizzare il campo CuratedPackage.targeting per specificare l'inventario a cui è destinato il pacchetto curato. Il campo targeting viene compilato con l'oggetto PackageTargeting, che supporta criteri di targeting come tipo di dispositivo, formato della creatività e posizione geografica.

Puoi anche specificare un targeting personalizzato con il campo CuratedPackage.targeting.includedDataSegments. Il campo includedDataSegments ti consente di scegliere come target segmenti di dati che gestisci tu o altri partner di selezione.

Comprendere la logica di targeting

I valori nei campi ripetuti vengono elaborati utilizzando un operatore logico OR, 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.

Il seguente esempio crea un pacchetto selezionato con un campo CuratedPackage.targeting compilato per scegliere come target una combinazione di tipi di dispositivo 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 dell'esempio ha come target un'impressione, dove ogni riga è un'impressione distinta:

Tipo di dispositivo ID segmento di dati Targeting del pacchetto selezionato?
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

Segnala il valore del tuo pacchetto selezionato

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

Puoi anche segnalare il valore delle impressioni a cui è destinato il pacchetto selezionato impostando il campo CuratedPackage.floorPriceCpm, che può influire sul prezzo iniziale specificato agli 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 dell'editore e della commissione di curatela totale.

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

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

Controllare la pubblicazione del pacchetto curato

Un pacchetto curato può avere uno dei seguenti stati:

  • ACTIVE: il pacchetto selezionato è attivo. I media planner iscritti possono ricevere richieste di offerta di offerte in tempo reale che contengono l'ID del pacchetto selezionato per l'inventario di destinazione.
  • 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 scoprire di più sui flussi di lavoro che puoi eseguire con la risorsa curatedPackages, consulta i seguenti contenuti: