Konfiguracja aukcji sekwencyjnej z określaniem stawek przez kod w nagłówku i aukcją dla wielu sprzedawców w ramach programu Protected Audience API

Wydawcy zwykle dywersyfikują źródła żądań reklamy, aby optymalizować skuteczność pod kątem przychodów i wywołać wiele firm (np. serwery reklam wydawców, platformy dostawców i platformy DSP), aby znaleźć najlepszą reklamę dla danego boksu reklamowego na stronie. Określanie stawek przez kod w nagłówku umożliwia wydawcom przechwytywanie stawek za boks reklamowy z różnych źródeł ofert reklamowych. W przypadku konfiguracji sekwencyjnej biblioteka określania stawek przez kod w nagłówku może służyć do przeprowadzania aukcji z wykorzystaniem danych kontekstowych, a funkcja Protected Audience API używa do przeprowadzania aukcji z danymi z różnych witryn.

Zanim zaczniesz, zapoznaj się z podstawami interfejsu API na stronie Protected Audience API oraz w sekcji dotyczącej określania stawek przez kod w nagłówku (w dokumentacji Prebid.js).

Definicje

Aukcje

Aukcja Definicja
Aukcja kontekstowa Aukcja reklam, która wykorzystuje dane dostępne w kontekście miejsca przeprowadzania aukcji. Aukcja kontekstowa może obejmować wiele aukcji, np. określanie stawek przez kod w nagłówku i aukcje po stronie serwera.
Aukcja w ramach Protected Audience API Aukcja reklam, która polega na licytowaniu grupy zainteresowań utworzonej w innej witrynie.
Aukcja w ramach Protected Audience API przez wielu sprzedawców Dwupoziomowa aukcja w ramach Protected Audience API, w ramach której najpierw bierze się kilka równoległych aukcji komponentów, z których najczęściej wybierana reklama jest przesyłana na ostatnią aukcję najwyższego poziomu.
Aukcja najwyższego poziomu Końcowa aukcja reklam w ramach aukcji obejmującej wielu sprzedawców w ramach Protected Audience API, która podaje wynik dla zwycięzców aukcji komponentów w ramach aukcji komponentów.
Aukcja komponentów Zagnieżdżona aukcja w ramach aukcji obejmującej wielu sprzedawców w ramach Protected Audience API, w której każdy z nich prowadzi równolegle swoje aukcje składowe. Najwyżej oceniane reklamy z każdej aukcji składowej są przekazywane do aukcji najwyższego poziomu.
Konfiguracja aukcji sekwencyjnej Konfiguracja aukcji reklam, która łączy aukcje kontekstowe z aukcją w ramach Protected Audience API i określa zwycięzcę między 2 aukcjami.

uczestników

Uczestnik Definicja
Reklamodawca Firma, która chce miejsce docelowe reklamy i tworzy kreację.
Wydawca Firma, która dostarcza zasoby reklamowe na aukcji.
Osoba odpowiadająca za zakupy Firma, która licytuje na aukcji, kupując przestrzeń reklamową od sprzedawcy. Zwykle jest to platforma DSP.
Serwer reklam wydawcy Usługa używana przez wydawców do zarządzania reklamami i ich wybierania, które mają być renderowane w witrynie. Serwer reklam wydawcy może łączyć wyniki aukcji, odpowiedzi licytującego przez kod w nagłówku, zasoby reklamowe sprzedawane bezpośrednio i inne, aby określić reklamę, która przyniesie wydawcy największe przychody.

Serwer reklam wydawcy może udostępniać po stronie klienta bibliotekę do interakcji z serwerem.
Sprzedawca najwyższego poziomu Strona, która wywołuje (czyli tworzy) aukcję wielu sprzedawców w ramach Protected Audience API i bierze udział w aukcji najwyższego poziomu.
Sprzedawca komponentów Firma, która przeprowadza aukcję składową w ramach aukcji wielu sprzedawców w ramach Protected Audience API, aby sprzedać kupującym przestrzeń reklamową wydawcy. Zwykle jest to platforma dostawców reklam (SSP).

Konfiguracja aukcji sekwencyjnej

W przypadku konfiguracji sekwencyjnej najpierw odbywają się aukcje kontekstowe, a dopiero potem aukcje w ramach Protected Audience API. Taka konfiguracja umożliwia wydawcom maksymalizację potencjału zarobkowego przez przeprowadzanie aukcji z wykorzystaniem danych kontekstowych dostępnych na stronie, a także przeprowadzanie aukcji z danymi z różnych witryn w bezpiecznym środowisku, chroniącym prywatność użytkowników.

Na stronie można najpierw uruchomić bibliotekę określania stawek przez kod w nagłówku, aby zbierać stawki dla aukcji kontekstowych serwera reklam wydawcy. Następnie dostosowana wygrywająca stawka w aukcji kontekstowej może zostać uwzględniona w aukcji Protected Audience API jako stawka minimalna. Na etapie punktacji sprzedawca najwyższego poziomu może obniżyć stawki składowe aukcji poniżej ceny minimalnej, przypisując mu wynik zerowy podczas obliczania wyniku trafności. Jeśli stawka w aukcji z komponentu w ramach Protected Audience API nie przekracza ceny minimalnej stawki, użytkownikowi renderowana jest reklama zwycięska na aukcji kontekstowej. Jeśli zwycięzca aukcji w ramach Protected Audience API zwróci zwycięzcę, oznacza to, że test przekroczył stawkę minimalną, a użytkownikowi zostaje wyrenderowana zwycięska reklama w ramach Protected Audience API.

W tym przykładzie konfiguracji aukcji sekwencyjnej na stronie mogą być przeprowadzane 3 duże aukcje: 1) aukcja kontekstowa z użyciem biblioteki określania stawek przez kod w nagłówku, 2) aukcja kontekstowa przez serwer reklam wydawcy, 3) aukcja w ramach Protected Audience API.

Użytkownik jest dodawany do grupy zainteresowań w witrynie reklamodawcy przed przeprowadzeniem w witrynie wydawcy aukcji kontekstowej i aukcji Protected Audience. Następnie biblioteka po stronie klienta serwera reklam wydawcy wybiera zwycięzcę spośród tych 2 aukcji.
Omówienie aukcji w ramach Protected Audience API dla wielu sprzedawców z aukcją kontekstową określania stawek przez kod w nagłówku.

Szczegółowy opis schematu ogólnego:

  1. Przed aukcją użytkownik jest dodawany do grupy zainteresowań w witrynie reklamodawcy.
  2. Gdy użytkownik później wejdzie na stronę wydawcy, Prebid.js uruchamia aukcję kontekstową, aby zebrać odpowiedzi na pytania o stawkę od licytujących przez kod w nagłówku. Na tym etapie kupujący mogą podać sygnały, a sprzedawcy – komponenty konfiguracji aukcji do wykorzystania w kolejnej aukcji Protected Audience API. Prebid.js udostępnia moduł do rozpowszechniania tych sygnałów i konfiguracji na aukcji Protected Audience API.
  3. Odpowiedzi na stawkę zebrane przez Prebid.js są wysyłane do serwera reklam wydawcy na potrzeby aukcji kontekstowej po stronie serwera.
  4. Serwer reklam wydawcy może łączyć wyniki aukcji, wyniki określania stawek przez kod w nagłówku, zasoby reklamowe sprzedawane bezpośrednio itp., aby określić reklamę, która przyniesie wydawcy największe przychody. Zwycięska reklama jest zwracana do biblioteki klienta na serwerze reklam wydawcy.
  5. Dostosowana stawka od zwycięzcy aukcji kontekstowej, a także sygnały kupującego (perBuyerSignals) i składowe konfiguracje aukcji sprzedawcy zebrane przez Prebid.js mogą zostać przekazane do aukcji Protected Audience API przez bibliotekę klienta serwera reklam wydawcy.
  6. W ramach Protected Audience API aukcja wielu sprzedawców jest przeprowadzana przez sprzedawcę najwyższego poziomu. Na etapie punktacji sprzedawcy najwyższego poziomu może on porównać każdą stawkę ze zwycięską stawką na aukcji w ramach określania cen zwycięskich stawek na aukcji kontekstowej. Jeśli stawka komponentu jest niższa niż stawka kontekstowa w ramach aukcji, sprzedawca najwyższego poziomu zwraca wynik trafności w wysokości 0. Jeśli wszystkie stawki mają wartość 0, wywołanie runAdAuction() zwraca wartość null, która oznacza, że powinna zostać wyrenderowana reklama zwycięska na aukcji kontekstowej.
  7. Biblioteka klienta po stronie klienta wydawcy renderuje zwycięską reklamę Protected Audience lub reklamę kontekstową na podstawie treści zwróconych przez wywołanie runAdAuction().
  8. Zwycięska reklama jest wyświetlana użytkownikowi.

Przed aukcją

Dodanie użytkownika do grupy zainteresowań w witrynie reklamodawcy
Sekwencja czasowa grupy zainteresowań na stronie reklamodawcy.

Gdy przed aukcją użytkownik odwiedza stronę reklamodawcy, kupujący i reklamodawca mogą określić grupę zainteresowań, do której należy ten użytkownik, i dodać dane kontekstowe z witryny reklamodawcy oraz dane własne, które posłużą jako sygnały do późniejszej aukcji.

  1. Użytkownik przechodzi do witryny reklamodawcy.
  2. Witryna reklamodawcy wczytuje skrypt od każdego kupującego uczestniczącego w aukcji w późniejszym czasie.
  3. Skrypt kupującego zawiera wywołanie joinAdInterestGroup() mające na celu dodanie użytkownika do grupy zainteresowań kupującego.

Aukcje kontekstowe z Prebid.js i serwerem reklam wydawcy

Aukcja kontekstowa jest inicjowana w witrynie wydawcy.
Kontekstowa sekwencja czasu aukcji na stronie wydawcy.

W przypadku konfiguracji sekwencyjnej wszystkie aukcje kontekstowe są przeprowadzane przed aukcją w ramach Protected Audience API. W ramach konfiguracji opisanej w tym dokumencie przeprowadzamy aukcję kontekstową z określaniem stawek przez kod w nagłówku przy użyciu Prebid.js, która trafia do aukcji po stronie serwera przez serwer reklam wydawcy.

Wydawca najpierw inicjuje aukcję kontekstową określania stawek przez kod w nagłówku, wywołując Prebid.js za pomocą flagi informującej o tym, że później odbywa się aukcja w ramach Protected Audience API. Następnie Prebid.js zbiera odpowiedzi na stawkę i wysyła je do serwera reklam wydawcy, gdzie przeprowadza aukcję kontekstową po stronie serwera. Podczas zbierania odpowiedzi na stawkę kupujący i sprzedawcy mogą udostępnić składowe konfiguracje aukcji i sygnały kupujących (perBuyerSignals) do wykorzystania w kolejnej aukcji Protected Audience API, jeśli chcą wziąć udział. Ten komponent aukcji zostanie ostatecznie przekazany na kolejną aukcję w ramach Protected Audience API.

  1. Kontekstowe inicjowanie aukcji
    Użytkownik odwiedza stronę wydawcy.
  2. Strona wydawcy wczytuje bibliotekę klienta serwera reklam wydawcy i definiuje boksy reklamowe.
  3. Strona wydawcy wczytuje Prebid i rozpoczyna aukcję kontekstową z określaniem stawek przez kod w nagłówku.
  4. Aukcja kontekstowa sprzedawcy A
    (równoległa z aukcją kontekstową sprzedawcy B)
    Prebid.js wysyła pytanie o stawkę do sprzedawcy A.
  5. Sprzedawca A pobiera odpowiedzi na stawkę i perBuyerSignals od kupujących.
  6. Sprzedawca A przeprowadza aukcję kontekstową.
  7. Sprzedawca A tworzy konfigurację komponentu aukcji z uwzględnieniem perBuyerSignals.
  8. Sprzedawca A w odpowiedzi na żądanie Prebid.js przekazuje zwycięską stawkę i jej składową konfigurację aukcji.
  9. Aukcja kontekstowa Sprzedawcy B
    (prowadzi się równolegle z aukcją kontekstową sprzedawcy A)
    Prebid.js wysyła pytanie o stawkę do sprzedawcy B.
  10. Sprzedawca B pobiera odpowiedzi na pytania o stawkę i perBuyerSignals od kupujących.
  11. Sprzedawca B przeprowadza aukcję kontekstową.
  12. Sprzedawca B tworzy konfigurację aukcji komponentu z uwzględnieniem perBuyerSignals.
  13. Sprzedawca B w odpowiedzi na żądanie Prebid.js przekazuje zwycięską stawkę i jej składową konfigurację aukcji.
  14. Aukcja kontekstowa serwera reklam wydawcy
    Odpowiedzi na stawkę zebrane przez Prebid.js są wysyłane do serwera reklam wydawcy na potrzeby aukcji kontekstowej.
  15. Konfiguracje aukcji składowych z sygnałami kupujących są udostępniane bibliotece po stronie klienta serwera reklam wydawcy.
  16. Serwer reklam wydawcy przeprowadza aukcję kontekstową, aby wybrać najlepszą reklamę spośród kampanii w sprzedaży bezpośredniej, stawek zautomatyzowanych, stawek kontekstowych w Prebid i innych zasobach reklamowych.
  17. Serwer reklam wydawcy zwraca dostosowaną zwycięską stawkę.

Aukcja w ramach Protected Audience API przez wielu sprzedawców

Aukcja w ramach Protected Audience API przez wielu sprzedawców wybiera reklamę o najwyższej ocenie spośród stawek przesłanych przez aukcje komponentów
Sekwencja czasu aukcji w ramach Protected Audience API na stronie wydawcy.

Na tym etapie aukcje kontekstowe już się zakończyły, a biblioteka po stronie klienta serwera reklam wydawcy może przekazać do sprzedawcy najwyższego poziomu dostosowanie stawki wygrywającej aukcję kontekstową, składowe konfiguracje aukcji i sygnały od kupujących uczestniczących w aukcji Protected Audience. Kontekstową cenę w ramach aukcji jako cenę minimalną można przekazać do konfiguracji aukcji jako sygnał do uzyskania wyniku na aukcji najwyższego poziomu.

Aukcje składowe są prowadzone równolegle. W każdej aukcji składowej przeglądarka generuje stawki na podstawie logiki ustalania stawek każdego kupującego, który bierze udział w tej aukcji składowej, przyznaje punkty każdej stawce zgodnie z logiką punktową sprzedawcy, a następnie zwraca reklamę o najwyższej ocenie na aukcję najwyższego poziomu.

  1. Witryna wydawcy wczytuje skrypt sprzedawcy najwyższego poziomu.
  2. Biblioteka klienta po stronie klienta wydawcy udostępnia kontekstową stawkę w ramach aukcji, a także komponenty konfiguracji aukcji z sygnałami od kupujących do sprzedawcy najwyższego poziomu. Cena stawki reklamy, która wygrała aukcję kontekstową, może zostać przekazana do konfiguracji aukcji jako sygnały sprzedawcy (ta stawka stanie się dostępna w funkcji scoreAd() sprzedawcy najwyższego poziomu).
  3. Sprzedawca najwyższego poziomu rozpoczyna aukcję Protected Audience API, wywołując runAdAuction().
  4. Aukcja komponentu sprzedawcy A
    (prowadzona równolegle z aukcją komponentów sprzedawcy B)
    Przeglądarka odczytuje grupy zainteresowań użytkownika dla wszystkich kupujących, którzy biorą udział w aukcji komponentów sprzedawcy A.
  5. Przeglądarka pobiera skrypty ustalania stawek i zaufane sygnały ustalania stawek z lokalizacji określonych w grupach zainteresowań kupujących, którzy biorą udział w aukcji składowej.
  6. Przeglądarka generuje stawki, wykonując logikę generowania stawek poszczególnych kupujących.
  7. Przeglądarka pobiera skrypt punktacji i zaufane sygnały punktacji w przypadku każdej reklamy od sprzedawcy A.
  8. W przypadku każdej stawki przeglądarka uruchamia logikę oceny sprzedawcy A.
  9. Przeglądarka wybiera reklamę z najwyższym wynikiem określonym przez zasady punktacji sprzedawcy A.
  10. Aukcja komponentu sprzedawcy B
    (realizowana równolegle z aukcją komponentów sprzedawcy A)
    Przeglądarka odczytuje grupy zainteresowań użytkownika w przypadku wszystkich kupujących, którzy biorą udział w aukcji komponentów sprzedawcy B.
  11. Przeglądarka pobiera skrypty ustalania stawek i zaufane sygnały ustalania stawek z lokalizacji określonych w grupach zainteresowań kupujących, którzy biorą udział w aukcji składowej.
  12. Przeglądarka generuje stawki, wykonując logikę generowania stawek poszczególnych kupujących.
  13. Przeglądarka pobiera skrypt punktacji i zaufane sygnały punktacji w przypadku każdej reklamy od sprzedawcy B.
  14. W przypadku każdej stawki przeglądarka uruchamia logikę oceny sprzedawcy B.
  15. Przeglądarka wybiera reklamę z najwyższym wynikiem określonym przez zasady punktacji Sprzedawcy B.

Ocena aukcji i renderowanie reklam na najwyższym poziomie

Biblioteka klienta serwera reklam wydawcy renderuje reklamę, która została wybrana między aukcją kontekstową a aukcją Protected Audience API.
Sekwencja renderowania reklam na stronie wydawcy.

Po przeprowadzeniu aukcji komponentów z poprzedniej sekcji przeglądarka uruchomi logikę oceny sprzedawcy najwyższego poziomu w przypadku każdej z zwycięskiej reklamy na aukcji komponentu. W funkcji scoreAd() sprzedawcy najwyższego poziomu cena stawki dostosowanej do kontekstu aukcji może być dostępna jako sellerSignals. Logika punktowa może porównać tę stawkę w ramach aukcji kontekstowej ze stawką zwycięskiej stawki, która pochodzi z komponentu Protected Audience.

Jeśli zwycięska stawka w aukcji kontekstowej jest wyższa niż stawka zwycięska w aukcji składowej, funkcja scoreAd() może zwrócić wynik zainteresowania o wartości 0. Jeśli nie ma reklam o wskaźniku celu wyższym niż 0, oznacza to, że zwycięska reklama w aukcji kontekstowej jest cenniejsza niż jakakolwiek reklama zwycięskia na aukcji, a funkcja runAdAuction() zwraca wartość null.

Jeśli aukcja w ramach Protected Audience API nie ma zwycięzcy i zwraca wartość null, biblioteka klienta serwera reklam wydawcy może wyrenderować zwycięzcę aukcji kontekstowej w element iframe. Jeśli aukcja w ramach Protected Audience wygrywa z aukcją kontekstową i zwraca obiekt FencedFrameConfig lub nieprzezroczysty identyfikator URN, zwycięska reklama z aukcji w ramach Protected Audience API może zostać wyrenderowana w ramce ogrodzonej lub w elemencie iframe.

  1. Ocena reklamy na aukcji najwyższego poziomu
    Przeglądarka pobiera skrypt oceny od sprzedawcy najwyższego poziomu wraz z zaufanymi sygnałami punktowymi dla każdej reklamy.
  2. Przeglądarka wykonuje logikę punktacji sprzedawcy najwyższego poziomu w przypadku każdej zwycięskiej stawki we wszystkich aukcjach komponentów. W skrypcie scoreAd() sprzedawcy najwyższego poziomu funkcja logiczna ma dostęp do zwycięskiej stawki dopasowanej do kontekstu aukcji, która mogła zostać przekazana w konfiguracji aukcji jako sellerSignals. Skrypt może porównać zwycięską stawkę kontekstową ze stawką komponentową w ramach Protected Audience API i zwrócić uwagę na wartość 0, jeśli cena kontekstowa jest wyższa. W przeciwnym razie skrypt oblicza wynik trafności, prawdopodobnie na podstawie stawki komponentu w ramach Protected Audience API.
  3. Przeglądarka wybiera reklamę o najwyższym wskaźniku atrakcyjności zgodnie z logiką punktową sprzedawcy najwyższego poziomu.
  4. Jeśli wygra aukcję Protected Audience
    Aukcja w ramach Protected Audience API zwraca obiekt FencedFrameConfig lub nieprzezroczysty identyfikator URN do biblioteki klienta serwera reklam wydawcy.
  5. Biblioteka po stronie klienta ustawia atrybut config objętej ramki na obiekt FencedFrameConfig lub ustawia atrybut src elementu iframe na nieprzezroczysty identyfikator URN zwycięskiej reklamy w ramach Protected Audience API.
  6. Przeglądarka pobiera od kupującego reklamę, która wygrała aukcję w ramach Protected Audience API.
  7. Przeglądarka wyświetla reklamę użytkownikowi.
  8. Jeśli wygra aukcja kontekstowa
    Aukcja w ramach Protected Audience API zwraca null.
  9. Przeglądarka ustawia atrybut src elementu iframe dla zwycięskiej reklamy kontekstowej.
  10. Przeglądarka pobiera od kupującego reklamę, która wygrała aukcję kontekstową.
  11. Przeglądarka wyświetla reklamę użytkownikowi.

Angażuj i dziel się opiniami

Co dalej?

Chcemy wspólnie z Tobą rozmawiać, aby mieć pewność, że stworzyliśmy interfejs API dla wszystkich użytkowników.

Omów interfejs API

Podobnie jak inne interfejsy API Piaskownicy prywatności, ten interfejs API jest udokumentowany i omawiany publicznie.

Eksperymentuj z interfejsem API

Możesz eksperymentować i uczestniczyć w rozmowach na temat interfejsu Protected Audience API.