Więcej informacji o wybranych pakietach

curators.curatedPackages Ten zasób umożliwia automatyczne tworzenie pakietów zasobów reklamowych wydawców, które są wybierane w imieniu planistów mediów, i zarządzanie nimi.

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

Podstawowe zagadnienia

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

Określanie, kto może korzystać z wybranych pakietów

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

Aby wyświetlić listę media planneró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 pakiet wyselekcjonowany

W polu CuratedPackage.targeting możesz określić asortyment, na który kierowany jest pakiet wybrany przez Ciebie. Pole targeting jest wypełnione obiektem PackageTargeting, który obsługuje kryteria kierowania, takie jak typ urządzenia, format kreacji i położenie geograficzne.

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

Omówienie logiki kierowania

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

W tym przykładzie tworzymy wyselekcjonowany pakiet z wypełnionym polem CuratedPackage.targeting, aby kierować reklamy 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 wyselekcjonowany pakiet z przykładu kieruje reklamy na wyświetlenie. Każdy wiersz to osobne wyświetlenie:

Typ urządzenia Identyfikatory segmentów danych Czy kierowanie jest ustawione na wybrany pakiet?
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 wyselekcjonowanego pakietu

Podczas tworzenia wyselekcjonowanego pakietu musisz ustawić opłatę za selekcję za pomocą pola union CuratedPackage.fee i możesz wypełnić tylko jeden z typów opłat obsługiwanych przez obiekt CuratedPackage, np. pole feeCpm. Całkowita opłata za wybór w przypadku danego wyświetlenia to suma opłaty za wybrany pakiet i opłat za wszystkie kierowane segmenty danych, które mają zastosowanie do tego wyświetlenia.

Możesz też sygnalizować wartość wyświetleń, na które kierowany jest Twój pakiet wyselekcjonowany, ustawiając pole CuratedPackage.floorPriceCpm, co może wpłynąć na cenę minimalną określoną dla licytujących w ramach określania stawek w czasie rzeczywistym. Cena minimalna wysyłana do licytujących to wyższa wartość w porównaniu z ceną minimalną podaną w polu floorPriceCpm oraz sumą ceny minimalnej wydawcy i całkowitej opłaty za selekcję.

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

Cena minimalna wydawcy (CPM) Łączna opłata za selekcję (CPM) Cena minimalna wyselekcjonowanego pakietu (CPM) Efektywna cena minimalna (CPM)
7 USD 2 PLN 10 HKD 10 HKD
4 USD 3 zł 4 USD 5 HKD

Kontrolowanie wyświetlania wybranego pakietu

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

  • ACTIVE: wyselekcjonowany pakiet jest aktywny. Subskrybujący media plannerzy mogą otrzymywać pytania o stawkę w określaniu stawek w czasie rzeczywistym, które zawierają identyfikator wyselekcjonowanego pakietu dla docelowych zasobów reklamowych.
  • INACTIVE: Wybrany pakiet jest nieaktywny. Identyfikator wyselekcjonowanego pakietu nie pojawia się w żądaniach określania stawek w czasie rzeczywistym, nawet w przypadku subskrybowanych planistów mediów.

Dalsze kroki

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