Konfigurowanie integracji z Otwartym ustalaniem stawek

Otwarte ustalanie stawek umożliwia giełdom i innym kupującym korzystanie z infrastruktury określania stawek w czasie rzeczywistym Google w celu określania stawek za zasoby reklamowe Google Ad Managera i AdMob.

Aby korzystać z Otwartego ustalania 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.

Ogranicz integrację do wybranych wydawców

Integracja z Otwartym ustalaniem stawek może pozostać w „trybie prywatnym” do momentu, gdy będziesz gotowy/a do przyjmowania żądań od dowolnego wydawcy. W trybie prywatnym możesz współpracować z zespołem ds. konta, aby nawiązać kontakt z wybranymi wydawcami. Możesz pozostać w tym stanie, dopóki nie będziesz gotowy do zwiększenia skali. Gdy zamkniesz tryb prywatny, Twoje konto będzie widoczne dla wszystkich wydawców.

Obsługiwane protokoły i kodowanie

Format OpenRTB może być w formacie JSON lub Protobuf. Więcej informacji

Implementacja Google OpenRTB

Implementacja OpenRTB przez Google nie obsługuje wszystkich funkcji określonych w specyfikacji OpenRTB. Dodaje natomiast rozszerzenia dotyczące funkcji specyficznych dla 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 struktury BidRequest co Authorized Buyers, ale niektóre pola są wysyłane wyłącznie do uczestników Otwartego ustalania stawek. Aby dowiedzieć się więcej o polach dotyczących Otwartego ustalania stawek, które są wysyłane w żądaniu stawki, zapoznaj się z przewodnikiem po żądaniach.

Odpowiedź z stawką

Otwarte ustalanie stawek korzysta też z struktury BidResponse podobnej do tej w programie Authorized Buyers, z kilkoma polami przeznaczonymi wyłącznie dla uczestników Otwartego ustalania stawek. Aby dowiedzieć się więcej o polach dotyczących Otwartego ustalania stawek, w których możesz udzielić odpowiedzi, zapoznaj się z przewodnikiem po odpowiedziach.

Uwaga: żądania dotyczące stawek wysyłane do uczestników Otwartego ustalania stawek powinny otrzymać odpowiedź w ciągu 300–1000 ms (w zależności od formatu zasobów reklamowych). Aby określić wymagania dotyczące konkretnego żądania, sprawdź pole BidRequest.tmax.

W zależności od preferowanego formatu reklamy, w którym chcesz ustalać stawki, struktura odpowiedzi może się znacznie różnić. Zapoznaj się z tymi przewodnikami, aby skonfigurować aplikację pod kątem określania stawek dla typowych formatów reklam:

• Reklamy pełnoekranowe
• Reklama wideo
• Reklamy wideo OpenRTB
• reklamy natywne,
• Natywne reklamy wideo
• Reklamy w pakiecie SDK kupującego

Śledź wyświetlenia, aby zmniejszyć rozbieżności

Zdecydowanie zalecamy używanie opcjonalnego pola BidResponse.seatbid.bid.ext.impression_tracking_url do pobierania danych na poziomie wyświetlenia dotyczących rejestrowania przez Google zdarzeń podlegających opłacie, za które zostaniesz obciążony.

Rozwiązywanie rozbieżności w ofercie reklamowej Google (beta)

Ta funkcja ma na celu zapewnienie zgodności liczby wyświetleń, za które naliczane są opłaty w wymianie, z liczbą wyświetleń, za które Google Display & Video 360 (DV360) płaci.

Dzięki dokładnemu identyfikowaniu wyświetleń DV360, które zostały wygenerowane przez Open Bidding, Google może uwzględniać rozbieżności dotyczące spamu reklamowego i zdarzeń podlegających rozliczeniu, aby nie naliczać opłat za wyświetlenia, za które nie płacisz.

Propagowanie parametru google_query_id w pytaniach o stawkę

Aby zapewnić zgodność liczby prawidłowych wyświetleń w przypadku źródeł ofert reklamowych Google, google_query_id musi być propagowany bez zmian z pytań o otwarte ustalanie stawek do platform popytu Google. Jest to warunek wstępny rozstrzygania rozbieżności w przypadku Otwartego ustalania 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ę giełdy, pole third_party_buyer_token musi zostać przekazane bez zmian w odpowiedzi na pytanie o stawkę i z powrotem do wyświetlenia w ramach Otwartego ustalania stawek. Dzięki temu platformy wydawców Google mogą ustalić, że wygrana stawka od partnera korzystającego z otwartego ustalania stawek jest stawką w imieniu zasobów reklamowych Google w przypadku tej samej możliwości wyświetlenia. Obecnie maksymalna długość tego pola wynosi 150 bajtów.

Przekazywanie znaczników kreacji Google w odpowiedziach na stawki

Aby zapewnić, że rozwiązywanie rozbieżności będzie dotyczyć stawek z popytu Google, giełda musi propagować znaczniki kreacji Google bez żadnych opakowań (tagów skryptów, ramek iframe ani opakowań VAST). Ze względu na rozwiązanie rozbieżności Google może unieważnić i nie wystawić faktury za wyświetlenia z otwartej aukcji, które nie zostały policzone przez platformy popytu Google. Google będzie okresowo sprawdzać znaczniki kreacji, aby potwierdzić, że stawki z third_party_buyer_token zostały przesłane w imieniu zapotrzebowania Google, a nie innego kupującego.

Kreacje HTML5

Wymagana jest wymiana, która przesyła znaczniki HTML Google w postaci oryginalnej, z wykorzystaniem makrospecyficznych rozszerzeń makro, które zwykle mają zastosowanie, oraz opcjonalnie dodatkowych pikseli śledzenia lub skryptów, które zwykle dodaje wymiana.

Google nie może zastosować rozwiązania rozbieżności, jeśli giełda owija kreację HTML Google w tag (script, iframe lub inne techniki), który następnie wczytuje lub renderuje kod HTML Google.

spełnia wymagania techniczne,

W tym przykładzie kod HTML kreacji Google (DV360) z odpowiedzi na stawkę jest przekazywany bez zmian, poprzedzony i dołączony kodem HTML specyficznym dla giełdy.

<!-- START exchange-specific HTML header -->
<iframe src="https://exchange.example.com/impression?…" width="0" height="0" frameborder="0" scrolling="no" style="display:none;" marginheight="0" marginwidth="0"></iframe>
<!-- END exchange-specific HTML header -->
<!-- START HTML code as returned by Google in the bid response -->
<DIV STYLE="position: absolute; left: 0px; top: 0px; visibility: hidden;"><IMG SRC="https://pagead2.googlesyndication.com/pagead/gen_204?id=xbid&dbm_b=…" BORDER=0 WIDTH=1 HEIGHT=1 ALT="" STYLE="display:none"></DIV><iframe title="Blank" src="https://googleads.g.doubleclick.net/xbbe/pixel?d=…" style="display:none" aria-hidden="true"></iframe><div><div style="position:relative; display:inline-block;"><div class="GoogleActiveViewClass" id="DfaVisibilityIdentifier_…"><script>var url = 'https://googleads.g.doubleclick.net/dbm/ad?…';document.write('<script src="' + (window.rfl ? window.rfl(url) : url) + '"></s' + 'cript>');</script>…
<!-- END HTML code as returned by Google in the bid response -->
<!-- START exchange-specific HTML footer -->
<img src='https://exchange.example.com/track?…' width='0' height='0' style='display:none;'>
<!-- END exchange-specific HTML footer -->

Nie spełnia wymagań technicznych

W tym przykładzie kod HTML zwracany przez Google jest zaciemniony w odpowiedzi na stawkę przesłanej przez giełdę i nie pojawia się w niej dosłownie. Kod HTML dostarczony przez Google może zostać wyrenderowany przez kod towarzyszący udostępniony przez Exchange w przeglądarce.

<!-- START exchange ad tag that encodes / renders Google creative in the browser -->
<!-- Google creatives markup from the bid response (adm) is not present verbatim -->
<span class="ad"><script type='text/javascript' src='https://exchange.example.com/ad?p=%%WINNING_PRICE%%&m=n_ybbRoVpsLlXSo8gVHRn-W0tynBt-Hoe8t8m0qwKhLFiaF-0gB0U4w-5pjeB8IMIkg7PcRri5iCIjBMMKDqg
…'></script></span>
<!-- END exchange ad tag that encodes / renders Google creative in the browser -->

Kreacje wideo VAST

Aby kwalifikować się do rozwiązania rozbieżności, giełda musi wypełnić element VASTTagURI w odpowiedziach XML VAST, korzystając z jednego z tych rozwiązań:

1. Wymiana może zachować wartość elementu VASTTagURI w ramach dokumentu XML VAST zwróconego przez Google w polu BidResponse.seatbid.bid.adm w postaci oryginalnej, z wykorzystaniem rozszerzeń makro specyficznych dla danej wymiany, które są zwykle stosowane.
2. DV360 może wypełnić pole BidResponse.seatbid.bid.adm.nurl adresem URL dokumentu VAST w odpowiedziach na pytania o stawkę wysyłanych do giełdy. Następnie giełda może przekazać tę wartość za pomocą tagu VASTTagURI, a makro specyficzne dla giełdy zostanie rozwinięte w zwykły sposób.

W razie potrzeby giełda może w dokumencie XML VAST określić dodatkowe lokalizatory zdarzeń i błędów VAST.

spełnia wymagania techniczne,

W tym przykładzie URI kreacji VAST z odpowiedzi na zapytanie o stawkę (DV360) jest przekazywany bez zmian, a giełda dodaje do niego swoje konkretne śledzenie zdarzeń i błędów VAST.

<!-- START exchange VAST tag referencing Google creative -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="123456789"><Wrapper>

<!-- Google VAST URI from the bid response is present verbatim -->
<AdSystem>XBid</AdSystem><VASTAdTagURI><![CDATA[https://bid.g.doubleclick.net/dbm/vast?…]]></VASTAdTagURI>

<!-- START Exchange-specific event trackers -->

<Error><![CDATA[https://video.exchange.example.com/vast_error?error=[ERRORCODE]&…]]></Error><Impression><![CDATA[https://video.exchange.example.com/impression?price=%%WINNING_PRICE%%&…]]></Impression><Creatives><Creative id="1234567890" sequence="1"><Linear><TrackingEvents><Tracking event="creativeView"><![CDATA[https://video.exchange.example.com/track/view?…]]></Tracking><Tracking event="start"><![CDATA[https://video.exchange.example.com/track/start?…]]></Tracking><Tracking event="midpoint"><![CDATA[https://video.exchange.example.com/track/midpoint?…]]></Tracking></TrackingEvents><VideoClicks><ClickTracking><![CDATA[https://video.exchange.example.com/click?…]]></ClickTracking></VideoClicks>

<!-- END Exchange-specific event trackers -->

</Linear></Creative></Creatives></Wrapper></Ad></VAST>

<!-- END exchange VAST tag referencing Google creative -->

Nie spełnia wymagań technicznych

W tym przykładzie kod VAST lub identyfikator URI zwracany przez Google nie pojawia się w niezmienionej postaci w odpowiedzi na stawkę. Zamiast tego używane jest opakowanie VAST specyficzne dla giełdy. Kod VAST udostępniony przez Google może być ładowany przez element opakowania VAST udostępniony przez giełdę (zdefiniowany w elemencie VASTAdTagURIhttps://video.exchange.example.com/creative?…) po załadowaniu reklamy przez pakiet SDK.

<!-- START exchange VAST tag that encodes or loads Google VAST creative subsequently -->
<!-- Google VAST URI or VAST document from the bid response is not present verbatim -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="1234567890"><Wrapper><AdSystem version="0.1">VideoExchange</AdSystem><VASTAdTagURI><![CDATA[https://video.exchange.example.com/creative?…]]></VASTAdTagURI><Error><![CDATA[https://video.exchange.example.com/error?ec=[ERRORCODE]]]></Error><Impression><![CDATA[https://video.exchange.example.com/imp?…]]></Impression><Creatives><Creative></Creative></Creatives></Wrapper></Ad></VAST>
<!-- END exchange VAST tag that encodes or loads Google VAST creative subsequently -->

Okazje

Giełdy uczestniczące w Otwartym ustalaniu stawek mogą używać umów preferencyjnych (PD) i aukcji prywatnych (PA) z Otwartym ustalaniem stawek. Identyfikator i typ umowy należy podać w ten sposób:

Pole	Opis
BidResponse.seatbid.bid.dealid	Identyfikator umowy z przestrzeni nazw giełdy powiązany ze stawką i zgłaszany wydawcom. Jest to dowolny tekst w formacie UTF-8 o długości nieprzekraczającej 64 bajtów.
BidResponse.seatbid.bid.ext.exchange_deal_type	Typ enum określający typ umowy. Jest ona przekazywana wydawcom i ma wpływ na to, jak oferta jest traktowana w aukcji. Możliwe wartości: OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

Poniżej znajduje się przykładowa odpowiedź na żądanie stawki 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"
    }
  }
}

Dopasowywanie plików cookie

Aby wypełnić tabele odpowiedników hostowane przez Google, uczestnicy Otwartego ustalania stawek mogą skorzystać z 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 Pixela: dopasowywanie inicjowane przez Google. Więcej informacji
• Cookie Match Assist: dopasowywanie inicjowane przez giełdę do jej oferentów. Więcej informacji

Uwaga: uczestnicy Otwartego ustalania stawek nie mogą obecnie tworzyć, wypełniać ani kierować reklam na listy użytkowników.

Zarządzanie opóźnieniem

Aby oszacować opóźnienie, jakie wystąpi po stronie licytujących, gdy będą one odpowiadać na przychodzące żądania stawek, należy użyć lokalizacji handlowych podanych w przewodniku na temat peeringu.

Zasoby reklamowe są zwykle wysyłane przez najbliższe miejsce handlu, ale nie jest to gwarantowane. Jedynym sposobem na zagwarantowanie dostępu do wszystkich wyświetleń jest posiadanie punktów końcowych licytujących we wszystkich lokalizacjach handlowych.

Duże giełdy, które otrzymują dużą liczbę żądań stawek, powinny rozważyć zawarcie umowy o peeringu z Google w celu zmniejszenia opóźnień i ich zmienności. Więcej informacji o peeringu

Makra kliknięć

Zalecamy wdrożenie makr kliknięć. Dzięki nim możesz generować raporty obejmujące dane o kliknięciach i wynikające z nich dane na swoim koncie oraz na kontach 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 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:

• Raport skuteczności w wersji 1.4
• Rozwiązywanie problemów z RTB w wersji 2beta1

Aby skonfigurować konto na potrzeby dostępu do tych interfejsów API i uzyskać identyfikator konta potrzebny do wywoływania interfejsów API, skontaktuj się z opiekunem klienta w Google. Aby uzyskać pomoc techniczną dotyczącą korzystania z tych interfejsów API, skontaktuj się z adresem [e-mail].

Dodatkowe materiały

• Sprawdzone metody zarządzania połączeniami
• Korzystanie z makr adresów URL stawek
• Odszyfrowywanie potwierdzenia ceny, jeśli używasz makra WINNING_PRICE
• Rekomendacje i sprawdzone metody dotyczące testowania

Przykładowe pytania o stawkę i ich odpowiedzi

Przykłady żądań o stawkę i odpowiedzi dla wszystkich obsługiwanych protokołów znajdziesz w instrukcjach dotyczących żądań i odpowiedzi.