Budowanie reakcji

Gdy aplikacja przetworzy pytanie o stawkę od Google, musi utworzyć i wysłać odpowiedź. W tym przewodniku wyjaśniono, jak zakodować aplikację, aby wygenerować odpowiedź.

Utwórz wiadomość z odpowiedzią na stawkę

Authorized Buyers wysyła BidRequest jako treść komunikatu HTTP POST. Odpowiedź wysyłana przez aplikację musi mieć nagłówek Content-Type ustawiony na application/octet-stream, a treść wiadomości zawierająca bufor zserializowanego protokołu. Bufor protokołu to komunikat BidResponse zgodny z definicją w realtime-bidding.proto. W odpowiedzi na każdy typ BidRequest aplikacja musi zwracać możliwy do przeanalizowania element BidResponse. Czasy oczekiwania i odpowiedzi, których nie można przeanalizować, są uznawane za błędy. Google ogranicza licytujących z dużym odsetkiem błędów.

Jeśli nie chcesz ustalać stawki za wyświetlenie, możesz ustawić tylko pole processing_time_ms, a wszystkie pozostałe pola pozostawić puste. Źródło danych realtime-bidding.proto znajdziesz na stronie danych referencyjnych.

Identyfikator kreacji

BidResponse określa kreację w polu buyer_creative_id (maksymalnie 64 bajty). Nawet podobne kreacje muszą mieć unikalne wartości parametru buyer_creative_id, jeśli różnią się istotnymi cechami, takimi jak rozmiar, zadeklarowany adres URL, atrybuty kreacji i typy dostawców. Inaczej mówiąc, musisz przyznać różne identyfikatory kreacji w przypadku 2 reklam, które:

• Wyglądać lub zachowywać się inaczej.
• Renderuj na różnych obrazach.
• Renderuj je na różne sposoby (np. jedna reklama składa się z obrazu, a druga zawiera Flasha).

Podczas projektowania aplikacji opracuj systematyczny sposób generowania identyfikatorów, który będzie odpowiedni dla typów przesyłanych kreacji.

Oznaczenie reklamy

Atrybuty kreacji, które w pełni opisują cechy reklamy i jej ustawienia kierowania, musisz zadeklarować w polu BidResponse.Ad.attribute. Atrybuty, które trzeba zadeklarować (pełną listę obsługiwanych atrybutów znajdziesz na stronie buyer-declarable-creative-attributes.txt):

• 7 Tagging: IsTagged
  Reklama zawiera w sobie piksel lub obraz jednopikselowy służący do tworzenia listy identyfikatorów plików cookie do późniejszego remarketingu.
• 8 Remarketing: IsRemarketing
  Reklama jest kierowana na użytkowników na podstawie identyfikatora pliku cookie lub identyfikatora urządzenia, gdzie lista identyfikatorów plików cookie lub identyfikatorów urządzeń to zbiór konsumentów, którzy wcześniej weszli w interakcję z witryną należącą do kupującego lub przez niego reprezentowaną.
• 9 UserInterestTargeting: IsUserInterestTargeted
  Reklama jest kierowana na użytkowników na podstawie ich identyfikatora pliku cookie lub identyfikatora urządzenia, gdzie lista identyfikatorów plików cookie lub identyfikator urządzenia to zbiór konsumentów zdefiniowanych jako grupa o wspólnych zainteresowaniach.
• 30 InstreamVastVideoType: Vpaid
  Reklama do renderowania wymaga obsługi VPAID.
• 32 MraidType: MRAID
  Reklama wymaga do renderowania interfejsu API MRAID.

Dodatkowo obsługiwane są te atrybuty, ale ich deklaracja nie jest wymagana, ponieważ Authorized Buyers automatycznie je wykrywa i blokuje (lub zezwala na) kreacje na podstawie wykrytych wartości, a nie Twojej deklaracji. Więcej informacji o sposobie uzyskiwania opinii o wykrytych właściwościach kreacji znajdziesz w artykule Interfejs Kreacje API.

• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  Reklama wymaga obsługi Flasha.
• 50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
  Reklama nie wymaga Flasha do renderowania.
• 47 RichMediaCapabilityType: RichMediaCapabilitySSL
  Reklama może się renderować na stronie SSL. Pamiętaj, że w Authorized Buyers kreacje z różnymi zadeklarowanymi wartościami tego atrybutu są traktowane jako osobne (będą sprawdzane oddzielnie i mają inny stan zatwierdzenia). Dlatego jeśli ustalasz stawki zarówno dla wersji SSL, jak i niez SSL, musisz odpowiednio zadeklarować ten atrybut, aby to rozróżnienie zostało odpowiednio odzwierciedlone w AdX.

Pola Otwartego ustalania stawek

Odpowiedzi na stawkę wysyłane przez licytujących z giełd i sieci uczestniczących w Otwartym ustalaniu stawek są podobne do odpowiedzi z programu Authorized Buyers, które uczestniczą w standardowym określaniu stawek w czasie rzeczywistym. Klienci korzystający z Otwartego ustalania stawek mogą określić niewielką liczbę dodatkowych pól, a kilka dotychczasowych pól może mieć alternatywne zastosowania. Mogą to być m.in.:

Rekomendacje

• Włącz trwałe połączenia HTTPS na swoich serwerach (nazywane też „utrzymywaniem aktywności” lub „ponownym używaniem połączenia”). Ustaw limit czasu na co najmniej 10 sekund – wyższe wartości w wielu przypadkach są korzystne. Google weryfikuje to podczas wstępnych testów czasu oczekiwania Twojej aplikacji, ponieważ Authorized Buyers wysyła żądania bardzo często i musi uniknąć opóźnień, które wynikają z utworzenia osobnego połączenia TCP dla każdego żądania.

• Dołącz opcjonalny link monitorujący wyświetlenia, by śledzić wyrenderowanie wyświetlenia, a nie moment, w którym licytujący wygrał. Ze względu na spadek liczby wygranych i wyrenderowań zapewnia to dokładniejsze statystyki śledzenia.

• Zadbaj o to, aby kod licytującego nie był zależny od wycofanych pól, bo może to powodować błędy przy ustalaniu stawek.
• Dodaj BidResponse.Ad.width i BidResponse.Ad.height do: BidResponse. Żądanie BidResponse w żądaniu, które zawiera wiele rozmiarów reklam, musi zawierać wartości width i height. W przeciwnym razie zostanie ono usunięte z aukcji.
• Ogranicz rozmiar odpowiedzi do mniej niż 8K. Bardzo duże odpowiedzi mogą zwiększyć opóźnienie sieci i spowodować przekroczenie czasu oczekiwania.
• Postępuj zgodnie ze wskazówkami dotyczącymi ustalania stawek za zasoby reklamowe na iOS, które wymagają atrybucji SKAdNetwork.

Przykładowa odpowiedź na stawkę

Poniższe przykłady przedstawiają zrozumiałe dla człowieka próbki żądań Protobuf i JSON.

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 6496
    billing_id: 25059430769
    deal_id: 30183930
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_244584"
  advertiser_name: "Google"
  width: 300
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 6

{
  "id": "KO9b4i49863AW26d1Tl9q6",
  "seatbid": [
    {
      "bid": [
        {
          "id": "Zc2MS8m162f920x7944",
          "impid": "1",
          "price": 0.133555,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "w": 300,
          "h": 250,
          "crid": "test_creative_id_410013",
          "creativeType": "DISPLAY",
          "burl": "https://test.com/imp?id=123456",
          "cid": "37092002186",
          "adid": "test_creative_id_410013"
        }
      ],
      "seat": "8333:6953:689419"
    }
  ],
  "ext": {
    "pixels": "<script type='text/javascript'>var adContent = '';\nadContent += '<scr' + 'ipt type=\"text/javascript\" src=\"https://service.idsync.analytics.yahoo.com/sp/v0/pixels?pixelIds=58292,58301,58294&referrer=&limit=12&us_privacy=null&js=1&_origin=1&gdpr=0&euconsent=\"></scr' + 'ipt>' + '\\n';\ndocument.write(adContent);</script>"
  }
}

id: "kMr24Q2iIW45X66r58005i"
seatbid {
  bid {
    id: "ne1hrjHUhQ53A1rC721"
    impid: "1"
    price: 0.05813896656036377
    adid: "test_creative_id_744028"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "53026323592"
    crid: "test_creative_id_744028"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 53026323592
    }
  }
  seat: "7524:3385:491205"
}
bidid: "6T5lR3ZI-U4xrqc15-Q6RK-426A53024Mf4"
cur: "USD"

Ważne: wiadomości Protobuf przedstawione w przykładach są przedstawione tutaj jako tekst zrozumiały dla człowieka. Jednak nie w ten sposób wiadomości są przesyłane przewodowo. Jeśli używasz formatu Google lub OpenRTB Protobuf, akceptowane są tylko zserializowane wiadomości na żądanie odpowiedzi na stawkę.

Komunikat BidResponse możesz utworzyć i zserializować za pomocą tego kodu C++:

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

Wybierz kreację

Odpowiedź na stawkę określa kreację, która ma zostać wyświetlona, jeśli Twoja stawka wygrana. Stawka musi obejmować jeden z obsługiwanych formatów reklam (AMP, wideo, natywna). W tym przykładzie kreację określamy w polu html_snippet.

W zależności od formatu reklamy możesz też określić kreację, używając jednego z tych pól:

• Reklama wyrenderowana przez pakiet SDK
  • BidResponse.Ad.sdk_rendered_ad
• AMP
  • BidResponse.Ad.amp_ad_url
• Film
  • BidResponse.Ad.video_url lub
  • BidResponse.Ad.video_vast_xml
• Reklama natywna
  • BidResponse.Ad.native_ad

Określ reklamę hostowaną na Twoich serwerach, korzystając z fragmentu kodu HTML w polu html_snippet interfejsu BidResponse. Fragment kodu jest umieszczany w elemencie iframe wstawionym na stronie internetowej, dzięki czemu reklama jest pobierana i renderowana po wczytaniu strony. Musisz przygotować fragment kodu HTML w taki sposób, aby reklama (baner lub reklama pełnoekranowa) renderowała się prawidłowo w elemencie iframe i miewała odpowiedni rozmiar pod kątem boksu reklamowego, za pomocą którego ustalasz stawkę.

Poza tym rozmiar reklamy zadeklarowany w odpowiedzi na stawkę musi odpowiadać dokładnie jednej z kombinacji rozmiarów w pytaniu o stawkę, jeśli:

• Reklama to zwykły baner (nie wideo, natywna ani pełnoekranowa).
• Licytujący zadeklarował rozmiar w odpowiedzi na stawkę. Deklaracja rozmiaru jest wymagana, gdy żądanie zawiera więcej niż 1 rozmiar.
• Wyjątkiem są reklamy pełnoekranowe. Reklamy pełnoekranowe muszą mieć co najmniej 50% szerokości i wysokości co najmniej 40% wysokości ekranu.

Pole html_snippet obsługuje dowolny prawidłowy kod HTML, który renderuje się prawidłowo, ale pamiętaj o ograniczeniach związanych z określaniem pola buyer_creative_id w sekcji Tworzenie wiadomości na stawkę na stawkę. Można to wykorzystać na przykład do umieszczenia dodatkowych informacji w argumentach adresów URL pobieranych z Twoich serwerów w ramach renderowania reklamy. Dzięki temu możesz przesyłać dowolne dane o wyświetleniach z powrotem do Twoich serwerów.

Większość zasad dotyczących fragmentów kodu HTML zwracanych w odpowiedziach na pytania o stawkę jest taka sama jak w przypadku reklam firm zewnętrznych. Więcej informacji znajdziesz w artykułach Wytyczne programu Authorized Buyers, Wymagania dotyczące wyświetlania reklam firm zewnętrznych i Deklarowanie docelowych adresów URL w reklamach.

Określanie makr

Fragment kodu HTML definiujący kreację może zawierać jedną lub więcej specjalnych konstrukcji nazywanych makrami. W momencie wyświetlania reklam wartości są zastępowane makrami. Na przykład aplikacja do określania stawek przez klienta może użyć makra WINNING_PRICE do określenia, ile kosztowała reklama, jeśli wygra aukcję. Aby przeanalizować to makro, musisz wdrożyć aplikację, która odszyfrowuje potwierdzenia cen. Więcej informacji znajdziesz na stronie Odszyfrowywanie potwierdzenia ceny.

Określ makro jako część fragmentu kodu HTML w formacie %%MACRO%%, gdzie MACRO to jedno z obsługiwanych makr wymienionych w tabeli poniżej.

Google wymaga użycia w kreacji takiej reklamy makra CLICK_URL_UNESC lub CLICK_URL_ESC. Do śledzenia kliknięć Google używa makr CLICK_URL.

Aby użyć makra, umieść je w reklamie, tak aby adres URL był pobierany, gdy ktoś go kliknie. Zwracana wartość pobierania to przekierowanie do innego adresu URL dołączonego do atrybutu CLICK_URL.

<a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>

<a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>

<a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a>

<a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a>

<a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a>

<a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>

Zmiana znaczenia adresu URL w makrach ma następujący schemat:

• Znak spacji jest zastępowany znakiem plusa (+).
• Znaki alfanumeryczne (0–9, a–z, A–Z) i znaki z zestawu !()*,-./:_~ pozostają bez zmian.
• Pozostałe znaki są zastępowane wartością %XX, gdzie XX to liczba szesnastkowa reprezentująca znak.

Ograniczenia wprowadzone przez wydawcę

Wydawcy korzystają z BidRequest, aby ignorować ograniczenia dotyczące zezwalania na wyświetlanie reklam. Musisz egzekwować ograniczenia w tych polach:

• allowed_vendor_type
• excluded_attribute
• excluded_sensitive_category

Jedno pole określa dozwolone cechy reklamy, a drugie niedozwolone. Nigdy nie zwracaj reklam z niedozwoloną funkcją. W przypadku dozwolonych funkcji, takich jak typ dostawcy, zwracaj reklamę tylko wtedy, gdy typ dostawcy jest na liście allowed_vendor_type w elemencie BidRequest. Więcej informacji znajdziesz w komentarzach do tych pól w definicji bufora protokołu BidRequest.

Jeśli fragment kodu HTML jest zwrócony w metodzie BidResponse, musisz prawidłowo skonfigurować pola attribute, category i click_through_url w polu BidResponse. Jeśli reklama ma wiele odpowiednich wartości w tych polach, musisz uwzględnić każdą z nich. Więcej informacji znajdziesz w komentarzach do tych pól w definicji bufora protokołu BidResponse. Odpowiedzi, dla których te pola nie są ustawione, są odrzucane.

Możliwe wartości atrybutu BidRequest.excluded_attribute to (patrz plik publisher-excludable-creative-attributes.txt):

• 7 Tagging: IsTagged
  Reklamy są zabronione, jeśli zawierają piksel lub obraz jednopikselowy (beacon), którego celem jest generowanie listy identyfikatorów plików cookie przeznaczonych do remarketingu.
• 8 CookieTargeting: IsCookieTargeted
  Reklamy są niedozwolone, jeśli są kierowane na klientów na podstawie identyfikatora pliku cookie, gdzie lista identyfikatorów plików cookie reprezentuje zbiór konsumentów, którzy wcześniej weszli w interakcję z witryną należącą do kupującego lub przez niego reprezentowaną.
• 9 UserInterestTargeting: IsUserInterestTargeted
  Reklamy są niedozwolone, jeśli są kierowane na klientów na podstawie identyfikatora pliku cookie, gdzie lista identyfikatorów plików cookie reprezentuje zbiór konsumentów zdefiniowanych jako grupa o wspólnych zainteresowaniach.
• 21 CreativeType: Html
  Reklamy nie mogą używać pola html_snippet ani snippet_template w BidResponse.Ad.
• 22 CreativeType: VastVideo
  Reklamy nie mogą używać pola video_url w BidResponse.Ad.
• 30 InstreamVastVideoType: Vpaid
  Reklamy nie mogą wymagać obsługi VPAID do renderowania.
• 32 MraidType: MRAID
  Reklamy nie mogą wymagać do renderowania interfejsu MRAID API.
• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  Reklamy nie mogą wymagać obsługi Flasha.
• 39 RichMediaCapabilityType: RichMediaCapabilityHTML5
  Reklamy nie mogą wymagać do renderowania funkcji HTML5.
• 48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
  Reklamy nie mogą wysyłać żądań bez SSL.

Dlatego jeśli pole excluded_attribute zawiera wartość 7, nie należy zwracać reklam, które do tworzenia list używają piksela lub obrazu typu web-beacon. Pamiętaj, że jeśli tak jest w przypadku reklamy, musi ona ustawić wartość 7 w polu atrybutu BidResponse. Podobnie, jeśli pole excluded_attribute zawiera wartość 48, należy zwracać tylko te reklamy, które mogą być renderowane na stronie SSL (i odpowiednio zadeklaruj atrybut 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

Również pole excluded_sensitive_category w BidRequest wykorzystuje kody z pliku ad-sensitive-categories.txt dostępnego na stronie danych referencyjnych. Poniżej znajdziesz ich rozszerzone opisy:

• 3 Politics
  Obejmuje politykę lub kontrowersyjne tematy społeczne, nie obejmuje reklam agencji informacyjnych, które nie prezentują stronniczych poglądów.
• 4 Dating
  Zakaz ten obejmuje usługi i serwisy randkowe.
• 5 Religion
  Obejmuje reklamy religijne propagujące określone poglądy religijne lub nawołujące przeciw nim; nie obejmuje astrologii i duchowości niewyznaniowej.
• 7 Video Games (Casual & Online)
  Obejmuje gry wideo, gry online i gry do pobrania; nie obejmuje konsol do gier wideo.
• 8 Ringtones & Downloadables
  dodatki na telefony komórkowe, w tym dzwonki i inne gadżety do pobrania, takie jak wygaszacze ekranu i tapety na komputery stacjonarne oraz układy profilu i grafiki do sieci społecznościowych;
• 10 Get Rich Quick
  Plany obiecujące szybkie zarobki.
• 18 Weight Loss
  Obejmuje odchudzanie, diety oraz związane z nimi produkty i programy; nie obejmuje zdrowego żywienia ani ogólnych reklam dotyczących kondycji fizycznej.
• 19 Cosmetic Procedures & Body Modification
  Obejmuje zabiegi liftingu, sukcji, laserowe, usuwanie i przywracanie włosów, tatuaże i modyfikacje ciała.
• 23 Drugs & Supplements:
  Obejmuje leki, witaminy, suplementy oraz sprzedawców oferujących te produkty; nie obejmuje źródeł informacji o lekach.
• 24 Sexual & Reproductive Health
  Obejmuje reklamy produktów i usług związanych z funkcjami seksualnymi i płodnością; nie obejmuje reklam produktów i usług związanych z ciążą.
• 35 Social Casino Games
  Obejmuje symulowane gry hazardowe (w tym pokera, automaty do gry, bingo, loterie, zakłady sportowe, obstawianie gonitw, a także inne gry karciane i kasyna), w których nie można wygrać niczego wartościowego (np. pieniędzy ani nagród).
• 36 Significant Skin Exposure
  Obrazy w reklamach pokazujące ciało ludzkie, które od wysokości mostka do połowy uda nie jest niczym okryte lub widać na nich bieliznę, kostium kąpielowy, bieliznę lub inne przezroczyste ubrania albo elementy niebędące ubraniem, takie jak ręcznik lub prześcieradło.
• 37 Sensationalism
  Reklamy, które zachęcają użytkowników do kliknięcia, odwołując się do ich ciekawości. Często wykorzystują prowokacyjny przekaz wyrażony w przesadnym języku lub z przesadną grafiką. Obejmuje reklamy skupiające się na sensacyjnej tematyce (takiej jak aresztowania, śmierć czy rozwody celebrytów) lub ich treści szokujące.

Open Measurement

Obsługiwane obecnie formaty reklam to m.in. reklamy wideo, banery i reklamy pełnoekranowe. Więcej informacji o używaniu Open Measurement w odpowiedzi na stawkę zawierającą te formaty znajdziesz w artykule w Centrum pomocy pakietu Open Measurement SDK.

Przykładowe odpowiedzi na stawkę

W sekcjach poniżej znajdziesz przykładowe odpowiedzi na stawki w przypadku różnych typów reklam.

Baner aplikacji

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 68101
    billing_id: 86124453824
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 105
  buyer_creative_id: "test_creative_id_450011"
  width: 390
  height: 61
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 23

{
  "id": "4735YiDtCstD1Y445YHstT",
  "cur": "USD",
  "seatbid": [
    {
      "seat": "6670:8027:659779",
      "bid": [
        {
          "ext": {
            "third_party_buyer_token": "7Njk3e2s21E6Url23a30w4d4621Qh57u4w2L9uy4xq864V6lMf348aC72L767592sIPdJ84U2E2aU00jjVGF3wbjl25L019c7Z43eKVb09Sk5fRX72B33Q92f359l40M0t6jAseiJVp8"
          },
          "crid": "test_creative_id_109447",
          "exp": 900,
          "id": "M9mAq8768Nr7W048E6G",
          "price": 0.025286061000000002,
          "adomain": [
            "google.com"
          ],
          "w": 320,
          "impid": "1",
          "h": 50,
          "burl": "https://test.com/imp?id=123456",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "cid": "48666909902"
        }
      ]
    }
  ]
}

id: "AA1796z4iC270863f4w9n0"
seatbid {
  bid {
    id: "9hJvWOk2f3GF6Z0qIR6"
    impid: "1"
    price: 0.917419
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "38676986454"
    crid: "test_creative_id_589316"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 38676986454
    }
  }
  seat: "5890:4144:786042"
}
bidid: "3L6xM6aN-2c492E7J-IxrR-gA80g0xJb980"
cur: "USD"

Reklama pełnoekranowa w aplikacji

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 7510304
    billing_id: 70362152071
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_775966"
  advertiser_name: "Google"
  width: 344
  height: 566
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 16

{
  "id": "I61Sxs7d484326p4D83O5f",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9T39T8KnUivM9518KnH",
          "impid": "1",
          "price": 0.6353,
          "adid": "test_creative_id_288773",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "42824952399",
          "crid": "test_creative_id_288773",
          "w": 414,
          "h": 816,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "QyYKoxm0",
              "campaign": "87661657",
              "itunesitem": "434836425",
              "sourceapp": "240782188",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "j3kdO5nT3kl4X9488yr6h7N8I83Ck3n0fRQ1tidNAy13q29QBC67917Dw44w99BRx70a6z5i565lc64979x9G1a83d3gjiA0",
                  "timestamp": "1674986741687"
                },
                {
                  "fidelity": 0,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "H6opG1lxBHNi921C65Yq6972239i01goGrQb53xtq38Dlm9M0wU4256868fwy509762N5po8Ou2x3vb0JJX7432yLTv2X021",
                  "timestamp": "1674986741687"
                }
              ]
            },
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "6447:7558:568680"
    }
  ],
  "bidid": "4Jol9v45-xp0442M7-268b-9Ix24W30Q298"
}

id: "82WW59EKX928i315ws8Vf6"
seatbid {
  bid {
    id: "GzqINzH96g3ZX8g67FO"
    impid: "1"
    price: 0.011380645260214805
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "43834715105"
    crid: "test_creative_id_772436"
    cat: "IAB14"
    w: 360
    h: 640
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 43834715105
    }
  }
  seat: "1184:9545:274689"
}
cur: "USD"

Wideo pełnoekranowe aplikacji

ad {
  adslot {
    id: 1
    max_cpm_micros: 830000
    billing_id: 45806415189
    buyer_reporting_id: "T7f433l"
  }
  click_through_url: "google.com"
  attribute: 47
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_596030"
  width: 640
  height: 360
  event_notification_token: "token"
}
processing_time_ms: 9

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Natywna w aplikacji

ad {
  adslot {
    id: 1
    max_cpm_micros: 80000
    billing_id: 52511964331
    deal_id: 1
  }
  click_through_url: "google.com"
  attribute: 70
  buyer_creative_id: "test_creative_id_287513"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 1200
      height: 627
    }
    app_icon {
      url: "https://native.test.com/icon?id=123456"
      width: 100
      height: 100
    }
    star_rating: 4.800000190734863
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "3.0"
    network: "Ft98iS7c"
    campaign: 31947859
    itunesitem: "305656909"
    sourceapp: "531025541"
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "9bGR391q8KEUGg0N8aI5Vg90fgX731q67y2xtXH09k27A5UccmE83YT9833q4g72P3t01759F15J9ZVSx0984q9A2eHnM5fn"
    }
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "Hxr3FdOR2298951684ztq85X3GgF0gI1O3K7CuhAb6tC9g06fsvU1N1Uo7h7Ts38755801rVSB63o50cfk6q80N66vHr1u59"
    }
  }
  click_tracking_urls: "https://google.com/rtb/click?imp_id=4a4cb2c0-4012-4434-b37e-ed08095a1bc8"
  advertised_app_id: "APP_ID_OMITTED"
}
processing_time_ms: 57

{
  "id": "w68lr2H3Q9S8mAc18QP2wp",
  "seatbid": [
    {
      "bid": [
        {
          "id": "4VF8803Y5b4314j072f",
          "impid": "1",
          "price": 0.01575,
          "adm": "{\"ver\": \"1.2\", \"assets\": [{\"id\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\"}}, {\"id\": 4, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"w\": 100, \"h\": 100}}, {\"id\": 5, \"img\": {\"url\": \"https://native.test.com/icon?id=123456\", \"w\": 200, \"h\": 200}}, {\"id\": 7, \"data\": {\"value\": \"\\uc804\\uc124\\uc758 \\ub9cc\\ub819 \\uc2ac\\ub77c\\uc784\\uc774 \\ub418\\uc5b4\\ubcf4\\uae30\"}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
          "adid": "test_creative_id_546056",
          "adomain": [
            "google.com"
          ],
          "cid": "19851733647",
          "crid": "test_creative_id_546056",
          "cat": [
            "IAB9-25"
          ],
          "w": 1200,
          "h": 627,
          "ext": {
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "7859:5415:609992"
    }
  ],
  "bidid": "58nBZSP4-e3LCgFS8-C2Pz-01O0337Vr56A",
  "cur": "USD"
}

id: "a504l3y62599Xv09173V2Z"
seatbid {
  bid {
    id: "jP1Ok7b46T9p789v6R2"
    impid: "1"
    price: 0.1680304792439826
    adid: "test_creative_id_620230"
    adomain: "google.com"
    cid: "74994669337"
    crid: "test_creative_id_620230"
    w: 1200
    h: 627
    adm_native {
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/icon?id=123456"
          w: 128
          h: 128
        }
      }
      assets {
        id: 6
        data {
          value: "5"
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 74994669337
      skadn {
        version: "3.0"
        network: "46L6RQ79"
        campaign: "17432314"
        itunesitem: "782565581"
        nonce: "ecfc7b9a-f328-4719-bba5-fa14c0233615"
        sourceapp: "187789793"
        timestamp: ""
        signature: "169L03hq0qtDeIoj19lL880oO96P24du405y60U08H71302C5d5r315jus940016d208o6kFt2G14x4YK530KI683wI41bR4"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "12g8675BqX3x8jJ60Zt9LwlNQwfe20s6M6n4zwtJ4H5170DU991wfwi9hn108rX53bU872L60u2io288755x0RS9bsvAg68b"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "qAF324j0597P58JrYins8Lz01v7p41zfJ8JK6l2hoZ36z6RS1GE7FT0r8bAn6B93s77tv04k59fr4J173W992Wa3Ev40489R"
        }
      }
    }
  }
  seat: "6989:4819:604522"
}
bidid: "15ds1647-89y8715T-V0AX-6DL468ks81Q5"
cur: "USD"

Film internetowy

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

Baner w internecie mobilnym dla licytującego na giełdzie

id: "q39213i4x083QS49D4334b"
seatbid {
  bid {
    id: "T55L5u7y56cBy4x484B"
    impid: "1"
    price: 0.35
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "11573735693"
    crid: "test_creative_id_591839"
    w: 300
    h: 600
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 11573735693
      third_party_buyer_token: "w7KR11S30AAE1345q5aG7tz46OkB8u911zbR7HVMwk0E6zUx7Y0uo4cxz32kwa3bZ320H00QT5yYifRxY8z96r74bLedPf6Fb25Z4y0U7T3i3j9k587N2iFlZ5Kl20Z5vou8M5zFWAwa"
    }
  }
  seat: "8020:4047:162759"
}
bidid: "DQd2WoG7-96j6H89H-4uCI-1303QT599c50"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 170
}