Więcej informacji o wybranych pakietach

Zasób curators.curatedPackages umożliwia programowe tworzenie pakietów zasobów reklamowych wydawcy, które są wybierane przez Ciebie w imieniu planistów mediów, oraz zarządzanie nimi.

Wybrane pakiety umożliwiają grupowanie wybranych zasobów reklamowych, które spełniają określone kryteria kierowania, takie jak typy urządzeń, lokalizacja geograficzna i segmenty danych. Możesz też przypisać opłatę za wybór, która jest naliczana, gdy kupujący wygrywają wyświetlenia kierowane przez wybrany pakiet.

Omówienie najważniejszych pojęć

Zanim zaczniesz integrację, zapoznaj się z polami i ustawieniami, które określają sposób działania wybranych pakietów:

Kontrolowanie, kto ma dostęp do wybranych pakietów

Twoje wybrane pakiety są dostępne tylko dla planistów mediów którym wyraźnie przyznasz dostęp za pomocą CuratedPackage.accessSettings pola. Podczas tworzenia wybranego pakietu musisz wypełnić pole accessSettings.

Aby wyświetlić listę planistów mediów, których można określić w polu CuratedPackage.accessSettings.allowlistedMediaPlanners , możesz użyć metody mediaPlanners.list.

Konfigurowanie zasobów reklamowych, na które kierowany jest wybrany pakiet

Aby określić zasoby reklamowe, na które kierowany jest wybrany pakiet, możesz użyć pola CuratedPackage.targeting. Pole targeting jest wypełniane obiektem PackageTargeting, który obsługuje kryteria kierowania, takie jak typ urządzenia, format kreacji i lokalizacja geograficzna.

Możesz też określić niestandardowe kierowanie za pomocą pola CuratedPackage.targeting.includedDataSegments. Pole includedDataSegments umożliwia kierowanie na segmenty danych , którymi zarządzasz Ty lub inni partnerzy wyboru.

Omówienie logiki kierowania

Wartości w polach powtarzanych są przetwarzane za pomocą logicznego operatora OR, co oznacza, że wyświetlenie, które pasuje do dowolnej z określonych wartości, jest zgodne. Każde pole jest przetwarzane za pomocą logicznego operatora AND, co oznacza, że wszystkie określone pola muszą pasować do danego wyświetlenia, aby wybrany pakiet pojawił się w odpowiednim pytaniu o stawkę.

Ten przykład tworzy wybrany pakiet z polem CuratedPackage.targeting wypełnionym tak, aby kierować na kombinację typów urządzeń i segmentów danych:

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

W tabeli poniżej pokazano, czy wybrany pakiet z przykładu kieruje na wyświetlenie. Każdy wiersz to inne wyświetlenie:

Typ urządzenia Identyfikatory segmentów danych Czy wybrany pakiet kieruje?
DEVICE_TYPE_PERSONAL_COMPUTER 8765, 8172 Tak
DEVICE_TYPE_PHONE 8172, 4321 Tak
DEVICE_TYPE_PHONE 9182 Nie
DEVICE_TYPE_CONNECTED_TV 4321, 9182 Nie

Sygnalizowanie wartości wybranego pakietu

Podczas tworzenia wybranego pakietu musisz ustawić opłatę za wybór za pomocą pola CuratedPackage.fee . Możesz wypełnić tylko 1 z typów opłat obsługiwanych przez obiekt CuratedPackage, np. pole feeCpm . Łączna opłata za wybór w przypadku danego wyświetlenia jest sumą opłaty za wybrany pakiet i opłat za wszystkie kierowane segmenty danych, które mają zastosowanie do wyświetlenia.

Możesz też sygnalizować wartość wyświetleń, na które kierowany jest wybrany pakiet ustawiając pole CuratedPackage.floorPriceCpm , które może wpływać na cenę minimalną określoną dla licytujących w określaniu stawek w czasie rzeczywistym. Cena minimalna wysyłana do licytujących jest wyższą wartością w porównaniu z ceną minimalną określoną w polu floorPriceCpm oraz sumą ceny minimalnej wydawcy i łącznej opłaty za wybór.

W tabeli poniżej znajdziesz przykłady obliczania efektywnej ceny minimalnej wysyłanej w pytaniu o stawkę w przypadku wybranego pakietu:

Cena minimalna wydawcy (CPM) Łączna opłata za wybór (CPM) Cena minimalna wybranego pakietu (CPM) Efektywna cena minimalna (CPM)
7 PLN 2 PLN 10 PLN 10 PLN
4 PLN 1 PLN 4 PLN 5 PLN

Kontrolowanie wyświetlania wybranego pakietu

Wybrany pakiet może mieć jeden z tych stanów:

  • ACTIVE: wybrany pakiet jest aktywny. Subskrybowani planiści mediów mogą otrzymywać pytania o stawkę w określaniu stawek w czasie rzeczywistym, które zawierają identyfikator wybranego pakietu w przypadku kierowanych zasobów reklamowych.
  • INACTIVE: wybrany pakiet jest nieaktywny. Identyfikator wybranego pakietu nie pojawia się w pytaniach o stawkę w określaniu stawek w czasie rzeczywistym, nawet w przypadku subskrybowanych planistów mediów.

Dalsze kroki

Więcej informacji o działaniach, które możesz wykonywać za pomocą zasobu curatedPackages, znajdziesz w tych materiałach: