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 zazwyczaj dywersyfikują źródła ofert reklamowych, aby zoptymalizować przychody, i korzystają z usług wielu firm (np. serwerów reklam wydawców, platform dostawców i platform DSP), aby wybrać najlepszą reklamę dla danego boksu reklamowego na stronie. Określanie stawek przez kod w nagłówku umożliwia wydawcom ustalanie stawek dla boksu reklamowego z różnych źródeł ofert reklamowych. W przypadku sekwencyjnej konfiguracji aukcji bibliotekę określania stawek przez kod w nagłówku może służyć do przeprowadzania aukcji z danymi kontekstowymi, a funkcja Protected Audience API służy do przeprowadzania aukcji z danymi z różnych witryn.

Zanim zaczniesz, zapoznaj się z podstawami interfejsu API na stronie Protected Audience API i określaniu stawek przez kod w nagłówku w dokumentacji Prebid.js.

Definicje

Aukcje

Aukcja Definicja
Aukcja kontekstowa Aukcja reklam wykorzystująca dane dostępne w kontekście miejsca, w którym odbywa się aukcja. W ramach aukcji kontekstowej może brać udział wiele aukcji, np. aukcje z określaniem stawek przez kod w nagłówku i aukcje po stronie serwera.
aukcja z Protected Audience API Aukcja reklam polegająca na licytowaniu grupy zainteresowań utworzonej w innej witrynie.
Aukcja w ramach Protected Audience API dla wielu sprzedawców Dwupoziomowa aukcja z użyciem Protected Audience API, która najpierw obejmuje wiele równoległych aukcji z komponentami, a następnie najwyżej oceniona reklama trafia na ostateczną aukcję najwyższego poziomu.
Aukcja najwyższego poziomu Końcowa aukcja reklam w ramach aukcji z użyciem Protected Audience API z udziałem wielu sprzedawców, która podaje ocenę dla zwycięzcy aukcji komponentu z aukcjami komponentów.
Aukcja komponentów Zagnieżdżona aukcja w ramach aukcji z użyciem Protected Audience z udziałem wielu sprzedawców, w której każdy sprzedający komponenty prowadzi równolegle aukcje składowe. Najwyżej oceniane reklamy z każdej aukcji komponentów są przekazywane do aukcji najwyższego poziomu.
Sekwencyjna konfiguracja aukcji Konfiguracja aukcji reklam, która integruje aukcje kontekstowe z aukcją z użyciem Protected Audience API, aby wyłonić zwycięzcę 2 aukcji.

Uczestnicy

Uczestnik Definicja
Reklamodawca Firma, która chce umieścić reklamę i tworzy kreację.
Wydawca Firma, która dostarcza zasoby reklamowe na aukcję.
Osoba odpowiadająca za zakupy Strona, która bierze udział w aukcji i kupuje przestrzeń reklamową od sprzedawcy. Zwykle jest to platforma DSP.
Serwer reklam wydawcy Usługa używana przez wydawców do zarządzania reklamami i wybierania ich wyświetlanych w witrynie. Serwer reklam wydawcy może łączyć własne wyniki aukcji, odpowiedzi licytującego określającego stawki przez kod w nagłówku, zasoby reklamowe sprzedawane bezpośrednio i inne zasoby, aby określić reklamę, która przyniesie wydawcy największe przychody.

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

Sekwencyjna konfiguracja aukcji

W przypadku sekwencyjnej konfiguracji aukcji najpierw przeprowadzana jest aukcja kontekstowa, a potem aukcja z Protected Audience API. Taka konfiguracja umożliwia wydawcom maksymalizację potencjału zarobkowego przez przeprowadzanie aukcji z użyciem danych kontekstowych dostępnych na stronie oraz prowadzenie aukcji z danymi z różnych witryn w bezpiecznym środowisku w celu ochrony użytkowników. prywatności.

Biblioteka określania stawek przez kod w nagłówku może zostać uruchomiona na stronie jako pierwsza w celu zbierania stawek na potrzeby aukcji kontekstowej serwera reklam wydawcy. Dostosowana zwycięska stawka z aukcji kontekstowej może być następnie dołączona do aukcji z użyciem Protected Audience API jako stawka minimalna. Na etapie punktacji sprzedawca najwyższego poziomu może obniżyć wysokość stawek na aukcji poniżej minimalnej stawki, przypisując mu wynik zerowy przy obliczaniu wyniku docelowego. Jeśli żadna stawka aukcji komponentu Protected Audience API nie będzie wyższa niż minimalna stawka, użytkownikowi zostanie wyświetlona zwycięska reklama kontekstowa z aukcji. Jeśli aukcja z użyciem Protected Audience API wyłoni zwycięzcę, oznacza to, że przewyższa ona minimalną stawkę, a zwycięska reklama z Protected Audience API jest wyświetlana użytkownikowi.

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

Użytkownik jest dodawany do grupy zainteresowań w witrynie reklamodawcy, zanim w witrynie wydawcy zostanie przeprowadzona aukcja z użyciem Protected Audience API, a następnie biblioteka po stronie klienta serwera reklam wydawcy wybiera zwycięzcę spośród tych 2 aukcji.
Omówienie aukcji z użyciem Protected Audience API obejmującej wielu sprzedawców i aukcję kontekstową z określaniem stawek przez kod w nagłówku.

Szczegółowy opis wykresu przeglądu:

  1. Przed aukcją użytkownik zostaje dodany do grupy zainteresowań w witrynie reklamodawcy.
  2. Gdy użytkownik wejdzie później na stronę wydawcy, Prebid.js przeprowadza aukcję kontekstową, aby zebrać odpowiedzi na pytania o stawkę od licytujących przez kod w nagłówku. Na tym etapie kupujący mogą dostarczać sygnały, a sprzedawcy – dostarczać konfiguracje aukcji komponentów do wykorzystania w kolejnych aukcjach z Protected Audience API. Prebid.js zawiera moduł do propagowania tych sygnałów i konfiguracji na aukcji z 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ć własne wyniki aukcji, określanie stawek przez kod w nagłówku, zasoby reklamowe sprzedawane bezpośrednio i inne zasoby, aby określić reklamę, która przyniesie wydawcy największe przychody. Zwycięska reklama jest zwracana do biblioteki po stronie klienta na serwerze reklam wydawcy.
  5. Dostosowana stawka pozyskana od zwycięzcy aukcji kontekstowej razem z sygnałami kupującego (perBuyerSignals) i konfiguracjami aukcji komponentów sprzedawcy zebrane przez Prebid.js mogą być przekazywane na aukcję z Protected Audience API przez bibliotekę klienta po stronie klienta serwera reklam wydawcy.
  6. Aukcja z użyciem Protected Audience API obejmująca wielu sprzedawców jest przeprowadzana przez sprzedawcę najwyższego poziomu. Na etapie oceny sprzedawcy najwyższego poziomu sprzedawca może porównać każdą zwycięską stawkę w aukcji każdego komponentu z dostosowaną kontekstową ceną zwycięskiej stawki na aukcji. Jeśli stawka komponentu jest niższa niż stawka kontekstowa stawki aukcyjnej, sprzedawca najwyższego poziomu zwraca wynik docelowej wartości 0. Jeśli wszystkie stawki mają wartość 0, wywołanie runAdAuction() zwraca wartość null, co oznacza, że należy wyrenderować zwycięską reklamę kontekstową z aukcji.
  7. Biblioteka po stronie klienta serwera reklam wydawcy renderuje zwycięską reklamę z Protected Audience API lub reklamę kontekstową na podstawie danych zwróconych przez wywołanie runAdAuction().
  8. Użytkownikowi wyświetli się zwycięska reklama.

Przed aukcją

Użytkownik został dodany do grupy zainteresowań w witrynie reklamodawcy
Sekwencja czasowa grupy zainteresowań na stronie reklamodawcy.

Gdy użytkownik odwiedzi stronę reklamodawcy, kupujący i reklamodawca mogą przed aukcją określić grupę zainteresowań, do której należy 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 otwiera witrynę reklamodawcy.
  2. Witryna reklamodawcy wczytuje w późniejszym czasie skrypt każdego kupującego uczestniczącego w aukcji.
  3. Skrypt kupującego zawiera wywołanie joinAdInterestGroup() zachęcające do dodania użytkownika do grupy zainteresowań kupującego.

Aukcje kontekstowe z Prebid.js i serwerem reklam wydawcy

Rozpoczyna się aukcja kontekstowa w witrynie wydawcy.
Kontekstowa sekwencja czasu aukcji na stronie wydawcy.

W przypadku konfiguracji sekwencyjnej wszystkie aukcje kontekstowe są przeprowadzane przed rozpoczęciem aukcji z Protected Audience API. W konfiguracji opisanej w tym dokumencie przeprowadzamy aukcję kontekstową z określaniem stawek przez kod w nagłówku za pomocą Prebid.js, która przekazuje informacje do aukcji po stronie serwera przez serwer reklam wydawcy.

Wydawca najpierw inicjuje aukcję kontekstową z określaniem stawek przez kod w nagłówku, wywołując Prebid.js z flagą, która informuje, że po jej zakończeniu zostanie przeprowadzona aukcja z Protected Audience API. Następnie Prebid.js zbiera odpowiedzi na stawkę i wysyła je do serwera reklam wydawcy, aby przeprowadzić aukcję kontekstową po stronie serwera. Na etapie zbierania odpowiedzi na stawkę kupujący i sprzedawcy mogą przesłać konfiguracje aukcji i informacje o kupujących sygnałów (perBuyerSignals), które będą wykorzystywane w kolejnej aukcji z użyciem Protected Audience API, jeśli zechcą wziąć w niej udział. Ta konfiguracja aukcji komponentu zostanie ostatecznie przekazana na kolejną aukcję z Protected Audience API.

  1. Kontekstowe inicjowanie aukcji
    Użytkownik odwiedza stronę wydawcy.
  2. Strona wydawcy wczytuje bibliotekę po stronie klienta serwera reklam wydawcy i definiuje boksy reklamowe.
  3. Strona wydawcy wczytuje wstępne ustalanie stawek i rozpoczyna aukcję kontekstową określania stawek przez kod w nagłówku.
  4. Aukcja kontekstowa sprzedawcy A
    (działa równolegle do aukcji kontekstowej 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ę aukcji komponentu, używając parametru perBuyerSignals.
  8. Sprzedawca A w odpowiedzi na żądanie Prebid.js podaje zwycięską stawkę i jej składową konfigurację aukcji.
  9. Aukcja kontekstowa sprzedawcy B
    (działa równolegle z aukcją kontekstową sprzedawców A)
    Prebid.js wysyła pytanie o stawkę do sprzedawcy B.
  10. Sprzedawca B pobiera odpowiedzi na stawkę i perBuyerSignals od kupujących.
  11. Sprzedawca B przeprowadza aukcję kontekstową.
  12. Sprzedawca B tworzy konfigurację aukcji komponentu, korzystając z elementu perBuyerSignals.
  13. Sprzedawca B w odpowiedzi na żądanie Prebid.js podaje 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 i przeprowadzają aukcję kontekstową.
  15. Konfiguracja aukcji komponentu z kupującymi sygnały są udostępniane bibliotece po stronie klienta serwera reklam wydawcy;
  16. Serwer reklam wydawcy przeprowadza aukcję kontekstową, aby znaleźć najlepszą reklamę między kampaniami sprzedaży bezpośredniej, stawkami automatycznymi, stawkami kontekstowymi Prebid i innymi zasobami reklamowymi.
  17. Serwer reklam wydawcy zwraca skorygowaną zwycięską stawkę.

Aukcja z użyciem Protected Audience API dla wielu sprzedawców

Aukcja z użyciem Protected Audience API wybiera reklamę o najwyższej wynikach ze stawek przesłanych w aukcjach składowych
Kolejność wyświetlania aukcji z użyciem 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 przekazywać sprzedawcy najwyższego poziomu, czyli zwycięskiej aukcji kontekstowej z dostosowaną stawką, konfiguracje aukcji komponentów oraz sygnały od kupujących biorących udział w aukcji Protected Audience API. Kontekstowa stawka w ramach aukcji może być przekazywana do konfiguracji aukcji jako sygnał do osiągnięcia wyniku w aukcji najwyższego poziomu.

Aukcje składowe są prowadzone równolegle. W każdej z nich przeglądarka generuje stawki na podstawie logiki ustalania stawek każdego kupującego, który bierze w niej udział, ustala stawki za każdą z nich, korzystając z logiki punktowej sprzedawcy danego komponentu, a następnie zwraca najwyżej ocenioną reklamę do aukcji najwyższego poziomu.

  1. Witryna wydawcy wczytuje skrypt sprzedawcy najwyższego poziomu.
  2. Biblioteka reklam po stronie klienta wydawcy udostępnia kontekstową cenę stawki aukcji, konfiguracje aukcji komponentów z sygnałami od kupujących do sprzedawcy najwyższego poziomu. Cenę stawki reklamy, która wygra aukcję kontekstową, można przekazać do konfiguracji aukcji jako sygnały sprzedawcy (ta stawka staje się dostępna w funkcji scoreAd() sprzedawcy na najwyższym poziomie).
  3. Sprzedawca najwyższego poziomu rozpoczyna aukcję z Protected Audience API, wywołując metodę runAdAuction().
  4. Aukcja komponentu sprzedawcy A
    (działa równolegle do aukcji 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 i zaufane sygnały ustalania stawek z lokalizacji określonych w grupach zainteresowań kupujących biorących udział w aukcji komponentów.
  6. Przeglądarka generuje stawki, wykonując logikę generowania stawek przez każdego kupującego.
  7. Przeglądarka pobiera skrypt punktacji i zaufane sygnały punktacji każdej reklamy od Sprzedawcy A.
  8. Przeglądarka wykonuje dla każdej stawki punktację określoną przez sprzedawcę A.
  9. Przeglądarka wybiera reklamę z najwyższym wynikiem punktu widzenia sprzedawcy A.
  10. Aukcja komponentu sprzedawcy B
    (działa równolegle do aukcji komponentów sprzedawcy A)
    Przeglądarka odczytuje grupy zainteresowań użytkownika dla wszystkich kupujących, którzy biorą udział w aukcji komponentów sprzedawcy B.
  11. Przeglądarka pobiera skrypty i zaufane sygnały ustalania stawek z lokalizacji określonych w grupach zainteresowań kupujących biorących udział w aukcji komponentów.
  12. Przeglądarka generuje stawki, wykonując logikę generowania stawek przez każdego kupującego.
  13. Przeglądarka pobiera skrypt punktacji i zaufane sygnały punktacji każdej reklamy od Sprzedawcy B.
  14. Przeglądarka wykonuje w przypadku każdej stawki mechanizm punktacji sprzedawcy B.
  15. Przeglądarka wybiera reklamę z najwyższym wynikiem podanym przez logikę punktową Sprzedawcy B.

Ocena aukcji i renderowanie reklam na najwyższym poziomie

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

Po przeprowadzeniu aukcji komponentów z poprzedniej sekcji przeglądarka uruchamia logikę punktacji sprzedawcy najwyższego poziomu w przypadku zwycięskiej reklamy z każdej aukcji. W funkcji scoreAd() sprzedawcy na najwyższym poziomie cena stawki dostosowana do kontekstu na podstawie aukcji może być dostępna jako sellerSignals, a logika wyników może porównywać tę kontekstową stawkę w ramach aukcji ze zwycięskim kosztem aukcji z użyciem Protected Audience API.

Jeśli zwycięska stawka aukcji kontekstowej jest wyższa niż zwycięska stawka aukcji komponentu, funkcja scoreAd() może zwrócić wynik docelowej wartości 0. Jeśli nie ma reklam z wynikiem pożądanego wyższym niż 0, oznacza to, że zwycięska reklama w aukcji kontekstowej jest cenniejsza niż którakolwiek ze zwycięskich reklam w aukcji komponentu, a funkcja runAdAuction() zwraca wartość null.

Jeśli aukcja z użyciem Protected Audience API nie wyłoni zwycięzcy i zwraca wartość null, biblioteka po stronie klienta serwera reklam wydawcy może wyrenderować zwycięzcę aukcji kontekstowej w elemencie iframe. Jeśli aukcja z użyciem Protected Audience API wygra aukcję kontekstową i zwróci obiekt FencedFrameConfig lub nieprzezroczysty numer URN, zwycięska reklama z aukcji z Protected Audience API może zostać wyrenderowana w ramce chronionej lub w elemencie iframe.

  1. Ocena reklam w ramach aukcji najwyższego poziomu
    Przeglądarka pobiera skrypt punktacji od sprzedawcy najwyższego poziomu wraz z zaufanymi sygnałami punktacyjnymi każdej reklamy.
  2. Przeglądarka wykonuje logikę punktową sprzedawcy najwyższego poziomu dla każdej zwycięskiej stawki we wszystkich aukcjach częściowych. W skrypcie scoreAd() sprzedawcy najwyższego poziomu mechanizm ten ma dostęp do dostosowanej kontekstowo ceny zwycięskiej stawki z aukcji, która mogła zostać przekazana jako sellerSignals w konfiguracji aukcji. Skrypt może porównać zwycięską stawkę kontekstową ze stawką za komponent z użyciem Protected Audience API i zwrócić wynik atrakcyjności 0, jeśli cena kontekstowa jest wyższa. W przeciwnym razie skrypt oblicza wynik przydatności, prawdopodobnie na podstawie stawki komponentu z Protected Audience API.
  3. Przeglądarka wybiera reklamę o najwyższym wyniku oceny docelowej według zasad oceniania sprzedawcy najwyższego poziomu.
  4. W przypadku wygranej aukcji Protected Audience
    Aukcja z Protected Audience API zwraca obiekt FencedFrameConfig lub nieprzezroczysty numer URN do biblioteki po stronie klienta na serwerze reklam wydawcy.
  5. Biblioteka po stronie klienta ustawia atrybut config ramki zabezpieczonej na obiekt FencedFrameConfig lub ustawia atrybut src elementu iframe na nieprzezroczysty numer URN zwycięskiej reklamy z Protected Audience API.
  6. Przeglądarka pobiera zwycięską reklamę w ramach aukcji z użyciem Protected Audience API od kupującego.
  7. Przeglądarka renderuje reklamę użytkownikowi.
  8. Jeśli wygra aukcja kontekstowa
    Aukcja z użyciem Protected Audience API zwróci null.
  9. Przeglądarka ustawia atrybut src w elemencie iframe na zwycięską reklamę kontekstową.
  10. Przeglądarka pobiera od kupującego zwycięską reklamę kontekstową w ramach aukcji.
  11. Przeglądarka renderuje reklamę użytkownikowi.

Angażuj odbiorców 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.