Ausgewählte Pakete

Die curators.curatedPackages Ressource ermöglicht Ihnen die programmatische Erstellung und Verwaltung von Paketen mit Publisher- Inventar, die Sie im Namen von Mediaplanern kuratieren.

Mit kuratierten Paketen können Sie ausgewähltes Inventar gruppieren, das bestimmte Targeting-Kriterien erfüllt, z. B. Gerätetypen, geografische Angaben und Datensegmente. Außerdem können Sie eine Kuratorgebühr festlegen, die erhoben wird, wenn Käufer Impressionen gewinnen, die auf das kuratierte Paket ausgerichtet sind.

Schlüsselkonzepte

Bevor Sie mit der Integration beginnen, sollten Sie sich die Felder und Einstellungen ansehen, die die Funktionsweise von kuratierten Paketen definieren:

Festlegen, wer auf Ihre kuratierten Pakete zugreifen kann

Ihre kuratierten Pakete sind nur für Mediaplaner zugänglich, denen Sie mit dem CuratedPackage.accessSettings Feld explizit Zugriff gewährt haben. Sie müssen das Feld accessSettings beim Erstellen des kuratierten Pakets ausfüllen.

Mit der mediaPlanners.list Methode können Sie eine Liste der Mediaplaner aufrufen, die im Feld CuratedPackage.accessSettings.allowlistedMediaPlanners angegeben werden können.

Inventar konfigurieren, auf das Ihr kuratiertes Paket ausgerichtet ist

Mit dem CuratedPackage.targeting Feld können Sie das Inventar angeben, auf das Ihr kuratiertes Paket ausgerichtet ist. Das targeting Feld wird mit dem PackageTargeting Objekt gefüllt, das Targeting-Kriterien wie Gerätetyp, Creative-Format, und geografische Angaben unterstützt.

Sie können auch benutzerdefiniertes Targeting mit dem CuratedPackage.targeting.includedDataSegments Feld angeben. Mit dem includedDataSegments Feld können Sie auf Datensegmente ausrichten, die Sie oder andere Kuratierungspartner verwalten.

Targeting-Logik

Werte in wiederholten Feldern werden mit einem logischen OR verarbeitet. Das bedeutet, dass eine Impression, die auf einen der angegebenen Werte zutrifft, eine Übereinstimmung ist. Jedes Feld wird mit einem logischen AND verarbeitet. Das bedeutet, dass alle angegebenen Felder mit einer bestimmten Impression übereinstimmen müssen, damit das kuratierte Paket in der entsprechenden Gebotsanfrage angezeigt wird.

Im folgenden Beispiel wird ein kuratiertes Paket mit einem Feld CuratedPackage.targeting erstellt, das auf eine Kombination aus Gerätetypen und Datensegmenten ausgerichtet ist:

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

In der folgenden Tabelle sehen Sie, ob das kuratierte Paket aus dem Beispiel auf eine Impression ausgerichtet ist. Jede Zeile steht für eine andere Impression:

Gerätetyp Datensegment-IDs Ist das kuratierte Paket auf diese Impression ausgerichtet?
DEVICE_TYPE_PERSONAL_COMPUTER 8765, 8172 Ja
DEVICE_TYPE_PHONE 8172, 4321 Ja
DEVICE_TYPE_PHONE 9182 Nein
DEVICE_TYPE_CONNECTED_TV 4321, 9182 Nein

Wert Ihres kuratierten Pakets angeben

Sie müssen beim Erstellen eines kuratierten Pakets eine Kuratorgebühr mit dem CuratedPackage.fee Union-Feld festlegen. Dabei können Sie nur einen der Gebührentypen angeben, die vom CuratedPackage Objekt unterstützt werden, z. B. das feeCpm Feld. Die gesamte Kuratorgebühr für eine bestimmte Impression ist die Summe der Gebühr für das kuratierte Paket und der Gebühren für alle Targeting-Datensegmente, die auf die Impression zutreffen.

Sie können auch den Wert von Impressionen angeben, auf die Ihr kuratiertes Paket ausgerichtet ist indem Sie das CuratedPackage.floorPriceCpm Feld festlegen. Dies kann den Mindestpreis beeinflussen, der Bietern in Echtzeitgebotsauktionen mitgeteilt wird. Der an Bieter gesendete Mindestpreis ist der höhere Wert beim Vergleich des Mindestpreises, den Sie im Feld floorPriceCpm angeben, und der Summe aus dem Mindestpreis des Publishers und der gesamten Kuratorgebühr.

In der folgenden Tabelle finden Sie Beispiele für die Berechnung des effektiven Mindestpreises, der in der Gebotsanfrage für das kuratierte Paket gesendet wird:

Mindestpreis des Publishers (CPM) Gesamte Kuratorgebühr (CPM) Mindestpreis des kuratierten Pakets (CPM) Effektiver Mindestpreis (CPM)
7 € 2 € 10 € 10 €
4 € 1 € 4 € 5 €

Auslieferung Ihres kuratierten Pakets steuern

Ein kuratiertes Paket kann einen der folgenden Status haben:

  • ACTIVE:Das kuratierte Paket ist aktiv. Abonnierte Mediaplaner können Gebotsanfragen für Echtzeitgebotsauktionen erhalten, die die ID des kuratierten Pakets für das Targeting-Inventar enthalten.
  • INACTIVE:Das kuratierte Paket ist inaktiv. Die ID des kuratierten Pakets wird nicht in Gebotsanfragen für Echtzeitgebotsauktionen angezeigt, auch nicht für abonnierte Mediaplaner.

Nächste Schritte

Weitere Informationen zu Workflows, die Sie mit der Ressource curatedPackages ausführen können, finden Sie in den folgenden Artikeln: