Konfigurowanie integracji z Otwartym ustalaniem stawek

Otwarte ustalanie stawek umożliwia giełdom i innym kupującym korzystanie z infrastruktury Google do określania stawek w czasie rzeczywistym w celu licytowania zasobów reklamowych Google Ad Managera i AdMob.

Aby uczestniczyć w Otwartym ustalaniu stawek, skonfiguruj integrację z określaniem stawek w czasie rzeczywistym dostosowaną do Twojego przypadku użycia Otwartego ustalania stawek i wyślij punkty końcowe systemu licytującego do menedżera konta Google w celu ich przetestowania i sprawdzenia, czy integracja działa prawidłowo. To jednorazowa operacja.

Ograniczanie integracji do wybranych wydawców

Integracja Otwartego ustalania stawek może pozostać w „trybie prywatnym”, dopóki nie będziesz gotowy(-a) na przyjmowanie żądań od dowolnego wydawcy. W trybie prywatnym możesz współpracować z zespołem ds. konta, aby nawiązywać kontakt z wybranymi wydawcami. Możesz pozostać w tym trybie, dopóki nie będziesz gotowy(-a) na zwiększenie skali. Gdy wyjdziesz z trybu prywatnego, Twoje konto będzie widoczne dla wszystkich wydawców.

Obsługiwane protokoły i kodowanie

Możesz używać OpenRTB w formatach JSON lub Protobuf. Więcej informacji

Implementacja OpenRTB w Google

Implementacja OpenRTB od Google nie obsługuje wszystkich funkcji opisanych w specyfikacji OpenRTB i zawiera rozszerzenia dotyczące funkcji Authorized Buyers i otwartego ustalania stawek. Więcej informacji znajdziesz w przewodniku OpenRTB.

Obsługa przychodzących pytań o stawkę

Otwarte ustalanie stawek korzysta z tej samej BidRequeststruktury co Authorized Buyers, ale niektóre pola są wysyłane wyłącznie do uczestników Otwartego ustalania stawek. Więcej informacji o polach specyficznych dla Otwartego ustalania stawek, które są wysyłane w żądaniu stawki, znajdziesz w Przewodniku po żądaniach.

Odpowiadanie za pomocą stawki

Otwarte ustalanie stawek korzysta też ze struktury BidResponse podobnej do struktury Authorized Buyers, ale niektóre pola są wysyłane tylko do uczestników Otwartego ustalania stawek. Więcej informacji o polach związanych z Otwartym ustalaniem stawek, na które możesz odpowiadać, znajdziesz w przewodniku po odpowiedziach.

W zależności od preferowanego formatu reklamy, w przypadku którego chcesz ustalać stawki, struktura odpowiedzi może się znacznie różnić. Zapoznaj się z tymi przewodnikami, które pomogą Ci skonfigurować aplikację licytującego, aby odpowiadała stawkami za popularne formaty reklam:

Śledzenie wyświetleń w celu zmniejszenia rozbieżności

Zdecydowanie zalecamy używanie opcjonalnego pola BidResponse.seatbid.bid.ext.impression_tracking_url, aby pobierać dane na poziomie wyświetlenia dotyczące tego, kiedy Google rejestruje zdarzenia podlegające rozliczeniu, za które będziesz obciążany(-a).

Rozstrzyganie rozbieżności w popycie w Google (beta)

Ta funkcja ma na celu zapewnienie, że liczba wyświetleń, za które pobierana jest opłata od platformy wymiany, jest zgodna z liczbą wyświetleń, za które płaci Google Display & Video 360 (DV360).

Dzięki dokładnemu identyfikowaniu wyświetleń DV360, które zostały wyświetlone w ramach Open Bidding, Google może korygować spam reklamowy i niezgodności w zdarzeniach podlegających rozliczeniu, aby mieć pewność, że nie obciążymy Cię opłatą za wyświetlenia, za które nie otrzymasz płatności.

Przekazywanie parametru google_query_id w pytaniach o stawkę

Aby liczba prawidłowych wyświetleń była zgodna w przypadku źródeł ofert reklamowych Google, parametr google_query_id musi być propagowany w niezmienionej postaci z żądań Otwartego ustalania stawek na platformy źródeł ofert reklamowych Google. Jest to warunek wstępny rozstrzygania rozbieżności w Otwartym ustalaniu stawek. Obecna oczekiwana długość google_query_id wynosi około 64 bajtów.

Przekazywanie parametru third_party_buyer_token w odpowiedziach na stawkę

Jeśli platforma reklamowa Google wygra wewnętrzną aukcję usługi reklamowej, pole third_party_buyer_token musi zostać przekazane w niezmienionej postaci w odpowiedzi na pytanie o stawkę w ramach wyświetlenia w Otwartym ustalaniu stawek. Umożliwia to platformom wydawców Google ustalenie, że wygrywająca stawka od partnera korzystającego z Otwartego ustalania stawek jest stawką w imieniu zasobów reklamowych Google za tę samą możliwość wyświetlenia reklamy. Obecna maksymalna długość tego pola to 150 bajtów.

Przekazywanie w odpowiedziach na stawki znaczników kreacji Google w niezmienionej postaci

Aby zapewnić, że rozbieżności będą dotyczyć stawek z popytu Google, giełda musi przekazywać znaczniki kreacji Google bez żadnych otoczek (tagów skryptów, elementów iframe ani otoczek VAST). W ramach rozwiązywania rozbieżności Google może unieważnić wyświetlenia w ramach otwartego aukcjonowania, które nie zostały zliczone przez platformy popytu Google, i nie wystawić za nie faktury. Google będzie okresowo sprawdzać tagi kreacji, aby potwierdzić, że stawki z parametrem third_party_buyer_token zostały przesłane w imieniu popytu Google, a nie innego kupującego.

Kreacje HTML5

Giełda musi przesyłać kod HTML Google w niezmienionej postaci, z zastosowaniem zwykle używanych makr giełdy i opcjonalnie z dodatkowymi pikselami śledzącymi lub skryptami, które giełda zwykle dodaje.

Google nie może zastosować rozwiązania problemu z rozbieżnościami, jeśli platforma wymiany opakowuje kreację HTML Google w tag (script, iframe lub inne techniki), który następnie wczytuje lub renderuje kod HTML Google.

Kreacje wideo VAST

Aby kwalifikować się do rozwiązania problemu z rozbieżnościami, giełda musi używać jednej z tych metod do wypełniania pola VASTTagURI w odpowiedziach XML VAST:

  1. Wymiana może zachować wartość elementu VASTTagURI w ramach dokumentu XML VAST zwracanego przez Google w polu BidResponse.seatbid.bid.adm w niezmienionej postaci, z zastosowaniem makr specyficznych dla wymiany, które zwykle są używane.
  2. DV360 może wypełniać pole BidResponse.seatbid.bid.adm.nurl adresem URL dokumentu VAST w odpowiedziach na pytania o stawkę wysyłane do giełdy. Wymiana może następnie przekazać tę wartość za pomocą tagu VASTTagURI, a makra specyficzne dla wymiany zostaną w razie potrzeby rozwinięte w normalny sposób.

W razie potrzeby platforma może określić dodatkowe narzędzia do śledzenia zdarzeń i błędów VAST w dokumencie XML VAST.

Okazje

Giełdy uczestniczące w Otwartym ustalaniu stawek mogą korzystać z umów preferencyjnych (PD) i aukcji prywatnych (PA) w ramach Otwartego ustalania stawek. Identyfikator i typ umowy muszą być określone w ten sposób:

Pole Opis
BidResponse.seatbid.bid.dealid Identyfikator umowy z przestrzeni nazw giełdy powiązany ze stawką i przekazywany wydawcom. Jest to dowolny tekst w formacie UTF8, który nie może przekraczać 64 bajtów.
BidResponse.seatbid.bid.ext.exchange_deal_type Wyliczenie określające typ umowy. Informacja ta jest przekazywana wydawcom i wpływa na sposób traktowania transakcji na aukcji. Możliwe wartości:
OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;

Oto przykładowa odpowiedź na stawkę w przypadku PD/PA.

id: "ECHO_BIDREQUEST_ID"
seatbid {
  bid {
    id: "BID_ID"
    impid: "1"
    price: 1.23
    adm: "AD_TAG"
    adomain: "DECLARED_LANDING_PAGE_URL"
    cid: "BILLING_ID"
    crid: "CREATIVE_ID"
    dealid: "DEAL_ID"
    w: 300
    h: 250
    [com.google.doubleclick.bid] {
      impression_tracking_url: "IMPRESSION_TRACKING_URL"
      exchange_deal_type: "DEAL_TYPE"
    }
  }
}

Aby wypełnić hostowane przez Google tabele dopasowań, uczestnicy Otwartego ustalania stawek mogą użyć dowolnej z tych opcji, która najlepiej odpowiada ich potrzebom:

  • Dopasowywanie plików cookie: dopasowywanie zainicjowane przez kupującego lub giełdę. Więcej informacji
  • Dopasowywanie pikseli: dopasowywanie inicjowane przez Google. Więcej informacji
  • Cookie Match Assist: dopasowywanie zainicjowane przez giełdę z jej oferentami. Więcej informacji

Zarządzanie opóźnieniem

Aby oszacować opóźnienie, z jakim punkty końcowe Twojego podmiotu ustalającego stawki będą odpowiadać na przychodzące żądania stawek, skorzystaj z lokalizacji handlowych podanych w Przewodniku po peeringu.

Duże giełdy, które otrzymują dużą liczbę żądań stawek, powinny rozważyć zawarcie z Google umowy o wzajemnym połączeniu, aby zmniejszyć czas oczekiwania i jego zmienność. Więcej informacji o peeringu

Makra kliknięć

Zalecamy wdrożenie makr kliknięć. Umożliwią one generowanie raportów zawierających kliknięcia i pochodne od nich dane dotyczące Twojego konta i wydawców, z którymi współpracujesz. Więcej informacji

Interfejsy API

Klienci korzystający z Otwartego ustalania stawek mogą używać interfejsów API REST usługi Authorized Buyers, aby uzyskiwać dostęp do danych, które mogą być przydatne do rozwiązywania problemów. Obecnie dostępne są tylko te zasoby interfejsu API:

Aby skonfigurować konto pod kątem dostępu do tych interfejsów API i uzyskać identyfikator konta potrzebny do wykonywania wywołań interfejsu API, skontaktuj się z Technicznym menedżerem konta. Aby uzyskać pomoc techniczną dotyczącą korzystania z tych interfejsów API, możesz skontaktować się z zespołem pomocy pod adresem adxbuyerapi-support@google.com.

Dodatkowe materiały

Przykładowe pytania o stawkę i odpowiedzi na nie

Przykłady pytań o stawkę i odpowiedzi na nie dla wszystkich obsługiwanych protokołów znajdziesz w przewodnikach Pytanie i Odpowiedź.