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) w celu wybrania najlepszej reklamy 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 prowadzenia aukcji z danymi kontekstowymi, a zabezpieczona lista odbiorców – do przeprowadzenia aukcji z danymi z różnych witryn.
Zanim zaczniesz, zapoznaj się z podstawowymi informacjami na temat określania stawek przez kod w nagłówku w dokumentacji Prebid.js.
Definicje
W tabelach poniżej opisujemy niektóre terminy używane w tym dokumencie.
Aukcje
Kupione na aukcji | Definicja |
---|---|
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 powstaje kilka równoległych aukcji komponentów, z których następna reklama o najwyższej ocenie 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 przedstawia 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 sprzedawca należący do komponentu bierze udział w aukcjach komponentów równolegle. Najwyżej oceniane reklamy z każdej aukcji komponentu są przekazywane do aukcji najwyższego poziomu. |
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 systemu licytującego przez kod w nagłówku, zasoby reklamowe sprzedawane bezpośrednio itp., aby określić reklamę, która zapewni 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ę dla 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 przeprowadza się aukcje kontekstowe, a dopiero potem aukcja 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. Dostosowana stawka wygrywająca aukcję kontekstową może następnie zostać uwzględniona w aukcji Protected Audience API jako minimalna stawka. Na etapie punktacji sprzedawca najwyższego poziomu może obniżyć stawki w aukcjach komponentów poniżej ceny minimalnej, przypisując mu wynik zerowy podczas obliczania wyniku trafności. Jeśli stawka w aukcji z żadnego komponentu w ramach Protected Audience API nie przekracza ceny minimalnej, 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 przekroczył on cenę minimalną, a użytkownikowi jest wyświetlana zwycięska reklama w ramach Protected Audience API.
W tym przykładzie konfiguracji aukcji sekwencyjnej na stronie mogą być przeprowadzane 3 główne aukcje:
- Aukcja kontekstowa według biblioteki określania stawek przez kod w nagłówku
- Aukcja kontekstowa prowadzona przez serwer reklam wydawcy
- Aukcja w ramach Protected Audience API.
![Użytkownik](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/PhfNzJgX2G439XmkgsyD.png?authuser=6&hl=pl)
Szczegółowy opis schematu ogólnego:
- Przed aukcją użytkownik jest dodawany do grupy zainteresowań w witrynie reklamodawcy.
- 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. W ramach tego kroku kupujący mogą dostarczać sygnały, a sprzedawcy – konfiguracje aukcji składowe 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.
- Odpowiedzi na stawkę zebrane przez Prebid.js są wysyłane do serwera reklam wydawcy na potrzeby aukcji kontekstowej po stronie serwera.
- 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 po stronie klienta serwera reklam wydawcy.
- Dostosowana stawka od zwycięzcy aukcji kontekstowej wraz z sygnałami kupującego (
perBuyerSignals
) i konfiguracją aukcji komponentu sprzedawcy zebraną przez Prebid.js może zostać przekazana do aukcji Protected Audience API przez bibliotekę klienta serwera reklam wydawcy. - 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 składowej ze stawką zwycięską w ramach aukcji kontekstowej. Jeśli stawka komponentu jest niższa niż kontekstowa stawka w aukcji, sprzedawca najwyższego poziomu zwraca wynik trafności wynoszący 0. Jeśli wszystkie stawki mają wartość 0, wywołanie
runAdAuction()
zwraca wartość null, co oznacza, że powinna zostać wyrenderowana reklama zwycięska na aukcji kontekstowej. - Biblioteka klienta po stronie klienta wydawcy renderuje zwycięską reklamę w ramach Protected Audience API lub reklamę kontekstową na podstawie treści zwróconych w wywołaniu funkcji
runAdAuction()
. - Zwycięska reklama jest wyświetlana użytkownikowi.
Aukcje kontekstowe z Prebid.js i serwerem reklam wydawcy
![Aukcja kontekstowa jest inicjowana w witrynie wydawcy.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/s6skvEz9boQNm98BLtW7.png?authuser=6&hl=pl)
W przypadku konfiguracji aukcji 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 jest przekazywana 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 z flagą informującą, ż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. Na etapie zbierania odpowiedzi na stawkę kupujący i sprzedawcy mogą udostępnić składowe konfiguracje aukcji i sygnały kupujących (perBuyerSignals
) do wykorzystania w kolejnych aukcjach w ramach Protected Audience API, jeśli chcą wziąć w nich udział.
Ten komponent aukcji zostanie ostatecznie przekazany na kolejną aukcję w ramach Protected Audience API.
- Kontekstowe inicjowanie aukcji – użytkownik odwiedza stronę wydawcy.
- Strona wydawcy wczytuje bibliotekę klienta po stronie klienta wydawcy i definiuje boksy reklamowe.
- Strona wydawcy wczytuje Prebid i rozpoczyna aukcję kontekstową określania stawek przez kod w nagłówku.
- Aukcja kontekstowa sprzedawcy A (prowadzona równolegle z aukcją kontekstową sprzedawcy B). Prebid.js wysyła pytanie o stawkę do sprzedawcy A.
- Sprzedawca A pobiera od kupujących odpowiedzi na stawki i sygnały perBuyerSignal.
- Sprzedawca A przeprowadza aukcję kontekstową.
- Sprzedawca A tworzy konfigurację komponentu aukcji z uwzględnieniem
perBuyerSignals
. - Sprzedawca A w odpowiedzi na żądanie Prebid.js przekazuje zwycięską stawkę i jej składową konfigurację aukcji.
- Aukcja kontekstowa sprzedawcy B (organizowana równolegle z aukcją kontekstową sprzedawcy A). Prebid.js wysyła pytanie o stawkę do sprzedawcy B.
- Sprzedawca B pobiera odpowiedzi na pytania o stawkę i
perBuyerSignals
od kupujących. - Sprzedawca B przeprowadza aukcję kontekstową.
- Sprzedawca B tworzy konfigurację aukcji komponentu z uwzględnieniem wartości perBuyerSignals.
- Sprzedawca B w odpowiedzi na żądanie Prebid.js przekazuje zwycięską stawkę i jej składową konfigurację aukcji.
- Aukcja kontekstowa serwera reklam wydawcy Odpowiedzi na stawkę zebrane przez Prebid.js są wysyłane do serwera reklam wydawcy na potrzeby aukcji kontekstowej.
- Składowe konfiguracje aukcji z sygnałami kupujących są udostępniane bibliotece po stronie klienta serwera reklam wydawcy.
- Serwer reklam wydawcy przeprowadza aukcję kontekstową, aby określić najlepszą reklamę spośród kampanii w sprzedaży bezpośredniej, stawek zautomatyzowanych, stawek kontekstowych w Prebid i innych zasobach reklamowych.
- Serwer reklam wydawcy zwraca dostosowaną zwycięską stawkę.
Rozważ użycie reklam kontekstowych w ramach żądań reklamy w ramach Protected Audience API
![Biblioteka klienta serwera reklam wydawcy renderuje reklamę, która została wybrana między aukcją kontekstową a aukcją Protected Audience API.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/tMwANg0vcHve1toQ8ggq.png?authuser=6&hl=pl)
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 stawkę skorygowaną, która wygrała aukcję kontekstową, konfiguracje aukcji komponentów i sygnały od kupujących uczestniczących w aukcji chronionych odbiorców. Kontekstową stawkę w ramach aukcji można przekazać do konfiguracji aukcji jako sygnał do uzyskania punktów na aukcji najwyższego poziomu.
- Przeglądarka pobiera skrypt oceny od sprzedawcy wraz z zaufanymi sygnałami punktowymi dla każdej reklamy.
- Przeglądarka uruchamia logikę oceny sprzedawcy najwyższego poziomu w przypadku każdej zwycięskiej stawki we wszystkich aukcjach składowych. W skrypcie
scoreAd()
sprzedawcy najwyższego poziomu funkcja logiczna uzyskuje dostęp do zwycięskiej stawki dopasowanej do kontekstu aukcji, która mogła zostać przekazana w konfiguracji aukcji jakosellerSignals
. Skrypt może porównać zwycięską stawkę kontekstową z ceną komponentu w ramach Protected Audience API i zwrócić wynik atrakcyjności na poziomie 0, jeśli cena kontekstowa jest wyższa. W przeciwnym razie skrypt oblicza wynik atrakcyjności, prawdopodobnie na podstawie stawki za komponent w ramach Protected Audience API. - Przeglądarka wybiera reklamę o najwyższym wskaźniku trafności według logiki punktowej sprzedawcy najwyższego poziomu.
- Jeśli wygra aukcję Protected Audience, aukcja w ramach Protected Audience zwraca obiekt
FencedFrameConfig
lub nieprzezroczysty identyfikator URN do biblioteki klienta serwera reklam wydawcy. - Biblioteka po stronie klienta ustawia atrybut
config
objętej ramki na obiektFencedFrameConfig
lub ustawia atrybutsrc
elementu iframe na nieprzejrzystą wartość URN zwycięskiej reklamy Protected Audience API. - Przeglądarka pobiera od kupującego reklamę, która wygrała aukcję w ramach Protected Audience API.
- Przeglądarka wyświetla reklamę użytkownikowi.
- Jeśli wygra aukcja kontekstowa, aukcja w ramach Protected Audience API zwraca
null
. - Przeglądarka ustawia atrybut
src
elementu iframe dla zwycięskiej reklamy kontekstowej. - Przeglądarka pobiera od kupującego reklamę, która wygrała aukcję kontekstową.
- Przeglądarka wyświetla reklamę użytkownikowi.