Przeprowadzanie aukcji w przeglądarce z jednym sprzedawcą

Ten dokument zawiera ogólny opis prowadzenia aukcji z dane z Protected Audience API dla pojedynczego sprzedawcy używane w bieżącej iteracji Protected Audience API. Aukcja z jednym sprzedawcą może być w ramach bardziej złożonej aukcji, w której bierze udział kilku sprzedawców. W tym aukcja z jednym sprzedawcą jest nazywana „aukcją składową”, może przekazywać kandydujące reklamy do „aukcji najwyższego poziomu” z kilkoma sprzedawcami udział w konwersji.

Przeczytaj przewodnik dla programistów, aby poznać cały cykl życia interfejsu Protected Audience API. i zapoznaj się z wyjaśnieniem na temat interfejsu Protected Audience API, aby dowiedzieć się więcej. jak sprzedawcy przeprowadzają aukcje na urządzeniu.

6 etapów aukcji reklam w ramach Protected Audience API

6 etapów aukcji reklam w ramach Protected Audience API
Ten schemat przedstawia każdy etap aukcji reklam w ramach Protected Audience API.
  1. Użytkownik odwiedza witrynę, w której wyświetlane są reklamy.
  2. Kod sprzedawcy wykonuje kod navigator.runAdAuction(). Wskazuje on, przestrzeń reklamową jest na sprzedaż i kto może ustalać stawki. Sprzedawcy muszą też dodać skrypt , który zdobywa punkty dla każdej stawki, scoreAd().
  3. Kod zaproszonego kupującego jest uruchamiany, by wygenerować stawkę, adres URL odpowiedniej reklamy kreacji i innych danych. Skrypt określania stawek może wysyłać zapytania o dane w czasie rzeczywistym, np. pozostały budżet kampanii Usługa kluczy-wartości.
  4. Kod sprzedawcy podaje ocenę w przypadku każdej stawki i wybiera zwycięzcę. Ta logika wykorzystuje wartość stawki i inne dane zwracają atrakcyjność stawki. Reklamy bezkonkurencyjne zwycięzca wyszukiwania kontekstowego jest odrzucany. Sprzedawca może użyć własnej Usługa kluczy-wartości na potrzeby danych w czasie rzeczywistym.
  5. Zwycięska reklama jest zwracana jako wartość nieprzezroczysta, która wyświetla się w chroniona ramka. Zarówno sprzedawca, jak i wydawca nie będzie mógł wyświetlić tej wartości.
  6. Aukcja jest zgłaszana sprzedawcy i zwycięskiemu kupującym.

Aukcja może się rozpocząć, gdy użytkownik wejdzie na stronę, na której wyświetla się reklama. Aukcje mogą być przeprowadzane z wyprzedzeniem, by kreacja była gotowa, gdy reklama boks reklamowy.

Sprzedawcy inicjują aukcję reklam i oceniają reklamy kandydujące za pomocą własnych reguł jako funkcja scoreAd() i odpowiada za raportowanie wyników zarówno do siebie, jak i na kupującego. Sprzedawcy mogą też egzekwuj reguły wydawców i filtruj je pod kątem jakości reklamy, używając ich scoreAd() .

Sprzedawca może wskazać:

  • wydawców treści, którzy hostują treści reklamowe w swojej witrynie;
  • platformy dostawców reklam (SSP), które współpracują z wydawcą reklam i świadczą inne usługi;
  • skrypty zewnętrzne działające w imieniu wydawców, umożliwiające udział w aukcjach reklam.

Wymagania wstępne do uruchomienia aukcji

Aby przeprowadzić aukcję, sprzedawca potrzebuje zdefiniowanych 2 funkcji JavaScriptu:

  • scoreAd(), otrzymując ocenę kandydacką do wyświetlenia reklamy.
  • reportResult(), który zajmuje się raportowaniem sprzedawcy wyników aukcji.

Te skrypty muszą być udostępniane z jednego punktu końcowego należącego do sprzedawcy.

scoreAd()

Sprzedawca musi zdefiniować funkcję scoreAd(), która jest obsługiwana z punktu końcowego należące do użytkowników. Punkt końcowy jest określony w konfiguracji aukcji jako decisionLogicUrl Funkcja scoreAd() ma taki podpis:

scoreAd(
  adMetadata,
  bid,
  auctionConfig,
  trustedScoringSignals,
  browserSignals,
  directFromSellerSignals)

Parametry scoreAd():

  • adMetaData, czyli dowolne metadane kreacji reklamy, które są podane przez kupującego. To jest serializowalny obiekt JSON, będą musieli zdefiniować i uzgodnić strukturę.
  • bid: wartość liczbowa określająca stawkę.
  • auctionConfig – konfiguracja aukcji używana do jej przeprowadzania.
  • trustedScoringSignals, czyli sygnały odczytywane w czasie aukcji z tagu serwer kluczy/wartości sprzedawcy. Platforma będzie używać renderUrl atrybutu jako klucz do wyszukiwania.
  • browserSignals, czyli obiekt utworzony przez przeglądarkę, w tym znane przeglądarce informacje oraz które skrypt aukcji sprzedawcy może które chcesz zweryfikować.
  • directFromSellerSignals to obiekt, który może zawierać te pola: ** sellerSignals: podobny do auctionConfig.sellerSignals, ale zaliczony przy użyciu Mechanizm directFromSellerSignals. ** auctionSignals: podobny do auctionConfig.auctionSignals, ale zaliczony przy użyciu Mechanizm directFromSellerSignals.

Oto przykład właściwości browserSignals. Pamiętaj, że parametr renderUrl reklama kandydująca jest dostępna z użyciem tych sygnałów:

{ 'topWindowHostname': 'www.example-publisher.com',
  'interestGroupOwner': 'https://www.example-buyer.com',
  'renderURL': 'https://cdn.com/render_url_of_bid',
  'renderSize': {width: 100, height: 200}, /* if specified in the bid */
  'adComponents': ['https://cdn.com/ad_component_of_bid',
                   'https://cdn.com/next_ad_component_of_bid',
                   ...],
  'biddingDurationMsec': 12,
  'bidCurrency': 'USD', /* bidCurrency returned by generateBid, or '???' if none */
  'dataVersion': 1, /* Data-Version value from the trusted scoring signals server's response */
}

reportResult()

Sprzedawca musi zdefiniować funkcję reportResult() obsługiwaną z i punktu końcowego należącego do sieci. Punkt końcowy jest określony w konfiguracji aukcji. jak decisionLogicUrl. Funkcja reportResult() ma te elementy podpis:

reportResult(auctionConfig, browserSignals) {
  ...
  return signalsForWinner;
}

Parametry reportResult():

  • auctionConfig – konfiguracja aukcji używana do jej przeprowadzania.
  • browserSignals, czyli obiekt utworzony przez przeglądarkę, w tym znane przeglądarce informacje oraz które skrypt aukcji sprzedawcy może które chcesz zweryfikować. To ten sam obiekt przekazywany do funkcji scoreAds().

reportResult() zwraca wartość signalsForWinner, która jest dowolnym obiektem JSON która jest przekazywana do funkcji raportowania zwycięskiego kupującego. Powinny one zawierać wszelkie istotne informacje, jakie sprzedawca może udostępnić na temat aukcji przeprowadzonej przez kupującego na potrzeby raportowania.

Przeprowadzanie aukcji interfejsu Protected Audience API

Aby przeprowadzić aukcję, sprzedawca musi wykonać 4 główne kroki. Pamiętaj, że te zakładamy, że sprzedawca ma skonfigurowany punkt końcowy tak, aby zwracać wymagany kod JavaScript wspomniane w tym przewodniku.

  1. Skonfiguruj aukcję. Ten krok obejmuje utworzenie obiektu auctionConfig. Umożliwia to sprzedawcy określenie, którzy kupujący powinni uczestniczyć w a także sygnały, które mogą być istotne podczas ustalania stawek generowanie lub punktację reklamy.
  2. Aby uruchomić aukcję, wywołaj funkcję navigator.runAdAuction() i przekaż wartość konfiguracji utworzonej w poprzednim kroku. Inicjuje to łańcuch kupujących generowanie stawek, a następnie punktację. W efekcie tego etapu które mogą się wyświetlić, by wyświetlić reklamę.
  3. Wyrenderuj zwycięską reklamę w zabezpieczonej ramce lub elemencie iframe.
  4. Zgłosić wynik aukcji. Jest też funkcja, navigator.sendReportTo(), rozpocznie się raportowanie. Sprzedawca zawsze otrzymasz raport z wynikami aukcji. Tylko kupujący, który wygrał aukcję otrzyma raport. Używana jest właściwość reportResult() sprzedawcy opisana wcześniej. w tym przewodniku, aby przesyłać raporty do serwera.