Budowanie reakcji

Gdy aplikacja przetworzy pytanie o stawkę od Google, musi utworzyć i wysyłanie odpowiedzi. Ten przewodnik wyjaśnia, jak pisać kod aplikacji na potrzeby kompilacji odpowiedź.

Utwórz wiadomość na temat stawki

Authorized Buyers wysyła parametr BidRequest jako treść wiadomości POST HTTP. Odpowiedź wysyłana przez aplikację musi zawierać nagłówek Content-Type został ustawiony na application/octet-stream i treści wiadomości składającej się z bufora zserializowanego protokołu. Protokół bufor to komunikat BidResponse zgodny z definicją realtime-bidding.proto Aplikacja musi zwracać plik, który można przeanalizować BidResponse w odpowiedzi na każde BidRequest. tymczasowe zawieszenie użytkownika a odpowiedzi, których nie można przeanalizować, są uznawane za błędy, a Google ogranicza licytujących z wysokim odsetkiem błędów.

Jeśli nie chcesz ustalać stawki za wyświetlenie, możesz ustawić parametr processing_time_ms bez zmian i pozostaw wszystkie pozostałe pola puste. realtime-bidding.proto możesz uzyskać z danych referencyjnych.

Identyfikator kreacji

BidResponse określa kreację w tagu Pole buyer_creative_id (maks. 64 bajty). Nawet podobne kreacje musi mieć unikalne wartości dla buyer_creative_id, jeśli różnią się w żadnych istotnych cech, takich jak rozmiar, zadeklarowany adres URL, atrybutów kreacji i typów dostawców. Innymi słowy, musisz określić różne wartości, do dwóch dowolnych reklam, które:

• wyglądają lub zachowuj się inaczej;
• Renderuj na różnych obrazach.
• renderowanie w różny sposób (np. jedna reklama składa się z obrazu, a drugi – Flash).

Projektując aplikację, należy wybrać systematyczny sposób generowanie identyfikatorów dopasowanych do rodzajów planowanych kreacji do przesłania.

Oznaczenie reklamy

Musisz zadeklarować atrybuty kreacji, które w pełni opisują i jego kierowanie w przypadku: BidResponse.Ad.attribute. wymagane atrybuty to (zobacz też pełną listę obsługiwanych atrybutów atrybutów w buyer-declarable-creative-attributes.txt):

• 7 Tagging: IsTagged
  Reklama zawiera piksel lub obraz typu beacon, który umożliwia tworzenie listę identyfikatorów plików cookie używanych w późniejszym 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ń reprezentuje zbiór konsumentów, weszli wcześniej 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 identyfikatora pliku cookie lub identyfikatora urządzenia, gdzie lista identyfikatorów plików cookie lub identyfikator urządzenia reprezentuje zbiór konsumentów, to grupa o wspólnych zainteresowaniach.
• 30 InstreamVastVideoType: Vpaid
  Do renderowania reklama wymaga obsługi VPAID.
• 32 MraidType: MRAID
  Do renderowania reklama wymaga interfejsu MRAID API.

Dodatkowo obsługiwane są poniższe atrybuty, ale ich deklaracja to nie są wymagane, ponieważ Authorized Buyers automatycznie je wykrywa i blokuje (lub na podstawie wykrytych wartości, a nie Twojej deklaracji. Zobacz Interfejs Creative API , gdzie znajdziesz wyjaśnienie, jak uzyskać opinię na temat wykrytych właściwości za pomocą kreacji.

• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  Reklama wymaga obsługi Flasha.
• 50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
  Reklama nie wymaga Flasha.
• 47 RichMediaCapabilityType: RichMediaCapabilitySSL
  Reklama może być renderowana na stronie z protokołem SSL. Pamiętaj, że Authorized Buyers traktuje kreacje z różnymi zadeklarowanymi wartościami tego atrybutu jako odmiennymi (zostaną one sprawdzone oddzielnie i mają różny stan zatwierdzenia). Dlatego, jeśli stosujesz zarówno protokoły SSL, jak i innej kreacji niż SSL, musisz odpowiednio zadeklarować ten atrybut. by w AdX odzwierciedlić to rozróżnienie.

Pola Otwartego ustalania stawek

Odpowiedzi na stawkę wysyłane przez licytujących z giełd i sieci uczestniczących w otwarciu Określanie stawek jest podobne do tych w Authorized Buyers, którzy uczestniczą w standardowym określania stawek w czasie rzeczywistym. Klienci korzystający z Otwartego ustalania stawek mogą określić niewielką liczbę dodatkowych pól, a kilka z istniejących pól może mieć alternatywne zastosowania. Te należy uwzględnić następujące elementy:

OpenRTB	Authorized Buyers.	Szczegóły
BidResponse.imp[].pmp.deals[].id	BidResponse.ad[].adslot[].exchange_deal_id	Identyfikator umowy z przestrzeni nazw giełdy powiązanej z tym i raportowana wydawcom. Uwaga: to pole jest obecnie wysyłane tylko do zamkniętych testów beta uczestników.
BidResponse.seatbid[].bid[].ext.exchange_deal_type	BidResponse.ad[].adslot[].exchange_deal_type	typ umowy zgłaszanej wydawcom, który ma wpływ na sposób realizacji umowy; traktowanych w aukcji. Uwaga: to pole jest obecnie wysyłane tylko do zamkniętych testów beta uczestników.
BidResponse.seatbid[].bid[].ext.third_party_buyer_token	BidResponse.ad[].adslot[].third_party_buyer_token	Token używany do identyfikowania informacji o kupującym zewnętrznym, jeśli jest giełdą pośredniczącą w uczestnictwie w Otwartym ustalaniu stawek. Dane te uzyskuje się z zewnętrznego kupującego i musi zostać przekazany do Google bez zmian w stawce .

Rekomendacje

• Włącz stałe połączenia HTTPS (zwane też „utrzymaniem aktywności” lub „ponowne użycie połączenia”) na Twoich serwerach. Ustaw limit czasu na 10 sekund w – wyższe wartości są w wielu przypadkach korzystne. Google weryfikuje podczas wstępnych testów czasu oczekiwania aplikacji, ponieważ Usługa Authorized Buyers często wysyła żądania i musi unikać narzut czasu oczekiwania związanego z nawiązaniem oddzielnego połączenia TCP dla każdego użytkownika.

• Dołącz opcjonalny link monitorujący wyświetlenia, aby śledzić, kiedy tag a nie w chwili wygranej przez licytującego. Z powodu porzuceń między wygranymi a renderowaniem, zapewnia to dokładniejsze śledzenie statystyk.

  Uwaga: jeśli używasz OpenRTB 2.5 lub nowszego, pole standardowe w przypadku tej wartości: BidResponse.seatbid[].bid[].burl.
• Pamiętaj, że kod licytującego nie musi być zależny od wycofanych pól. co może spowodować błędy w ustalaniu stawek.
• Uwzględnij BidResponse.Ad.width i BidResponse.Ad.height na liście: BidResponse. O BidResponse w żądaniu dotyczącym wielu rozmiarów reklam musi zawierać wartości width i height, w przeciwnym razie zostanie on zostały usunięte z aukcji.
• Ogranicz rozmiar odpowiedzi do mniej niż 8K. Bardzo duże odpowiedzi mogą zwiększyć i powodują przekroczenie czasu oczekiwania.
• Przestrzegaj wytycznych dotyczących stawki za zasoby reklamowe na iOS, które wymagają atrybucji SKAdNetwork.

Przykładowa odpowiedź na pytanie o stawkę

Poniższe przykłady przedstawiają czytelne dla człowieka próbki Protobuf i Żądania JSON.

Google

Pokaż przykład

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: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

Plik JSON OpenRTB

Pokaż przykład

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "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": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

Bufor protokołu OpenRTB

Pokaż przykład

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    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: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

Ważne: wiadomości Protobuf przedstawione w próbki są przedstawione tutaj jako tekst zrozumiały dla człowieka. Nie jest to jednak wiadomości są wysyłane przewodowo. Korzystanie z protokołu Google lub OpenRTB , akceptujemy tylko zserializowane wiadomości na temat odpowiedzi na stawkę.

Możesz utworzyć i zserializować wiadomość BidResponse za pomocą polecenia ten kod w 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
}

Określ kreację

Odpowiedź na stawkę określa kreację, która zostanie wyświetlona, gdy Twoja stawka wygra. Twoja stawka musi zawierać jeden z obsługiwanych formatów reklam (AMP, wideo, natywne). W tym podajemy kreację w polu html_snippet.

Możesz też określić kreację za pomocą jednej z metod następujące pola, w zależności od formatu reklamy:

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

Określ reklamę, która jest hostowana na Twoich serwerach, za pomocą fragmentu kodu HTML w w polu html_snippet tabeli BidResponse. jest umieszczony w elemencie iframe wstawionym na stronę, w wyniku czego reklama pobierania i renderowania podczas wczytywania strony. Musisz stworzyć kod HTML by reklama (baner lub reklama pełnoekranowa) wyświetlała się prawidłowo wewnątrz iframe i odpowiednim rozmiarze dla boksu reklamowego, dla którego określasz stawkę.

Dodatkowo rozmiar reklamy zadeklarowany w odpowiedzi na stawkę musi odpowiadać dokładnie 1 kombinacji rozmiarów w pytaniu o stawkę, gdy:

• Reklama to zwykły baner (nie wideo, natywna ani pełnoekranowa).
• Licytujący zadeklarował rozmiar w odpowiedzi na stawkę. Obecna deklaracja rozmiaru wymagane, jeśli w żądaniu występuje więcej niż jeden rozmiar.
• Wyjątkiem są reklamy pełnoekranowe. Szerokość reklamy pełnoekranowej musi wynosić co najmniej 50% szerokości ekranu i wysokości co najmniej 40% wysokość ekranu.

Pole html_snippet obsługuje dowolny prawidłowy kod HTML, który renderuje się poprawnie, ale należy pamiętać o ograniczeniach buyer_creative_id w sekcji Utwórz wiadomość z odpowiedzią na stawkę. Jeden można wykorzystać dodatkowe informacje w argumentach adresów URL, które są pobierane z serwerów w ramach renderowania reklamy. Dzięki temu możesz dowolne dane o wyświetleniu z powrotem na Twoje serwery.

Większość zasad dotyczących fragmentów kodu HTML zwracanych w odpowiedziach na pytania o stawkę jest taka sama jak dla reklam innych firm. Zobacz Authorized Buyers Wytyczne programu, Wymagania dla firm zewnętrznych wyświetlanie reklam i Zadeklaruj, docelowych adresów URL w reklamach.

Określ makra

Fragment kodu HTML definiujący kreację może zawierać co najmniej jeden element specjalny konstrukcje nazywane makrami. W momencie wyświetlenia reklamy wartości są zastępowane prefiksami . Na przykład aplikacja do określania stawek klienta może używać WINNING_PRICE, aby określić, ile zapłacił za reklamę, jeśli wygra aukcję. Aby przeanalizować to makro, musisz zaimplementować parametr która odszyfrowuje potwierdzenia cen. Zapoznaj się z ceną odszyfrowywania z potwierdzeniami, aby dowiedzieć się więcej.

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

Uwaga: tylko w przypadku odpowiedzi na stawkę za reklamę AMP (amp_ad_url) Makra WINNING_PRICE i WINNING_PRICE_ESC są

Google wymaga używania atrybutu CLICK_URL_UNESC lub CLICK_URL_ESC w kreacji wyświetlanej przez firmę zewnętrzną reklama. Google używa makr CLICK_URL do śledzenia kliknięć.

Aby użyć makra, umieść je w reklamie, tak by adres URL był pobierany podczas ktoś ją kliknie. Wartość zwrócona przez pobranie jest przekierowaniem do innego, URL dołączany do CLICK_URL.

Uwaga: oprócz tych makr DoubleClick obsługujemy też Makra OpenRTB. Zobacz OpenRTB specyfikacji, aby dowiedzieć się więcej o makrach OpenRTB.

Makro	Opis
ADVERTISING_IDENTIFIER	Umożliwia kupującym otrzymanie identyfikatora IDFA na iOS lub identyfikatora wyświetlania reklam na Androidzie podczas renderowania. Przeczytaj sekcję Odszyfrowywanie identyfikatorów reklamodawcy. .
CACHEBUSTER	Ciąg znaków reprezentujący losową, nieoznaczoną, 4-bajtową liczbę całkowitą.
CLICK_URL_UNESC	URL kliknięcia reklamy bez zmiany znaczenia. We fragmencie kodu znajduje się klikany URL firmy zewnętrznej powinien bezpośrednio występować po makrze. Jeśli na przykład klikany URL firmy zewnętrznej to http://my.adserver.com/some/path/handleclick?click=clk, poniższego kodu można użyć z wersją trzeciego parametru z jedną zmianą znaczenia klikany URL strony po wywołaniu makra: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> W momencie wyświetlania reklamy rozwijamy się do postaci: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> Adres URL najpierw rejestruje kliknięcie w Google, a następnie przekierowuje użytkownika do klikanego adresu URL firmy zewnętrznej.
CLICK_URL_ESC	URL kliknięcia reklamy ze zmianą znaczenia. Użyj tego zamiast CLICK_URL_UNESC, jeśli musisz najpierw przekazać wartość przez inny serwer, który zwróci przekierowanie. We fragmencie HTML można na przykład wykorzystać ten kod: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> W momencie wyświetlania reklamy rozwijamy się do postaci: <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> Spowoduje to zarejestrowanie kliknięcia przez operatora my.adserver.com, który odpowiada za przekierowanie do adresu URL przekazanego w metodzie google_click_url. Zakładamy przy tym, że my.adserver.com cofa znaczenie obiektu google_click_url . Możesz dołączyć adres URL z podwójną zmianą znaczenia po %%CLICK_URL_ESC%% Po cofnięciu zmiany znaczenia my.adserver.com, który pozostawia wersję adresu URL z pojedynczą zmianą znaczenia jest dołączony do google_click_url. Gdy Pole google_click_url zostało pobrane, cofnie ucieczkę jeszcze raz, a potem .
CLICK_URL_ESC_ESC	Adres URL reklamy z podwójną zmianą znaczenia. Użyj tego zamiast CLICK_URL_UNESC, jeśli musisz najpierw przekazać wartość przez inny serwer, który zwróci przekierowanie. We fragmencie HTML można na przykład wykorzystać ten kod: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> W momencie wyświetlania reklamy rozwijamy się do postaci: <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>
SCHEME	Rozwinięta do http:, jeśli pytanie o stawkę nie wymaga SSL lub https:, jeśli pytanie o stawkę wymaga protokołu SSL.
SITE	Domena ze zmianą znaczenia w adresie URL adresu URL treści lub anonimowy identyfikator w przypadku anonimowych zasobów reklamowych.
SITE_URL	Rola wycofana. Zastąpione makrem SITE, które działa identycznie.
TZ_OFFSET	Przesunięcie strefy czasowej.
VERIFICATION	Różne wartości na potrzeby produkcji i skanowania kreacji podczas weryfikacji potoku. Format to: %%?VERIFICATION:true-val:false-val%%, gdzie dowolny wartości oprócz makr można używać w parametrach true-val i false-val, także puste ciągi. W przypadku Otwartego ustalania stawek zalecamy korzystanie z tego makra: Gdy to zrobią, platformy DSP nie będą musiały wprowadzać zmian. Jeśli na przykład kreacja ma zawierać tag %%?VERIFICATION:-1:5000%% wtedy zastąpieniem tekstu będzie to 5000 przy wyświetlaniu, a -1 w procesu weryfikacji. Ma to pomóc rozróżnić te dwa zestawy pingów.
WINNING_PRICE	Zakodowany koszt wyświetlenia (czyli CPI, a nie CPM) w w walucie konta. Przykład: zwycięski CPM wynosi 5 zł. odpowiada CPM na poziomie 5 000 000 mikro, czyli 5000 mikro, czyli CPI. Zdekodowany wartość WINNING_PRICE w tym przypadku wyniesie 5000. Zwycięska cena jest podana w CPI.
WINNING_PRICE_ESC	WINNING_PRICE ze zmianą znaczenia w adresie URL.

Zmiana znaczenia adresu URL w makrach korzysta z tego schematu:

• Spacja jest zastąpiona znakiem plusa (+).
• Znaki alfanumeryczne (0–9, a–z, A–Z) oraz znaki z zestawu !()*,-./:_~ pozostają niezmienione.
• Pozostałe znaki są zastępowane przez %XX, gdzie XX to szesnastkowy system liczbowy. liczba reprezentująca znak.

Ograniczenia dotyczące wydawców

Wydawcy używają BidRequest, aby kontrolować, jakie reklamy mogą się wyświetlać na dane mobilne. Musisz egzekwować ograniczenia w tych polach:

• allowed_vendor_type
• excluded_attribute
• excluded_sensitive_category

Jedno pole określa dozwolone cechy reklamy, a drugie niedozwolone funkcje. Nigdy nie zwracaj reklam z niedozwoloną funkcją. Dozwolone takich jak typ dostawcy, zwraca reklamę tylko wtedy, gdy jego typ dostawcy to Lista allowed_vendor_type w: BidRequest. Zobacz komentarze do tych pól w buforze protokołu BidRequest .

Jeśli fragment kodu HTML zostanie zwrócony w języku BidResponse, wymagane do dokładnego ustawiania parametrów attribute, category, i click_through_url w polu BidResponse. Jeśli reklama ma wiele wartości w tych polach, musisz uwzględnianie wszystkich wartości. Wyświetl komentarze do tych pól w sekcji Definicja bufora protokołu BidResponse, aby uzyskać więcej informacji. Odpowiedzi, w przypadku których nie ustawiono tych pól, są odrzucane.

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

• 7 Tagging: IsTagged
  Reklamy są niedozwolone, jeśli zawierają piksel lub obraz typu beacon dla tworzenia listy identyfikatorów plików cookie do późniejszego ponownego marketingu.
• 8 CookieTargeting: IsCookieTargeted
  Reklamy są niedozwolone, jeśli są kierowane na klientów w oparciu o ich identyfikator pliku cookie, gdzie znajduje się lista identyfikatorów plików cookie grupa klientó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 w oparciu o ich identyfikator pliku cookie, gdzie znajduje się lista identyfikatorów plików cookie zbiór konsumentów zdefiniowanych przez kupującego jako grupa o wspólnym zainteresowaniach.
• 21 CreativeType: Html
  html_snippet i snippet_template nie mogą być używane w reklamach polu 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ć interfejsu MRAID API do renderowania.
• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  Reklamy nie mogą wymagać obsługi formatu Flash.
• 39 RichMediaCapabilityType: RichMediaCapabilityHTML5
  Reklamy nie mogą wymagać funkcji HTML5 do renderowania.
• 48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
  Reklamy nie mogą wysyłać żądań bez protokołu SSL.

Dlatego, jeśli pole excluded_attribute zawiera wartość 7, nie zwracaj reklam, w których jest używany piksel lub obraz typu beacon podczas tworzenia listy. W takiej sytuacji reklama musi ustawić wartość 7 w argumencie polu atrybutu BidResponse. I podobnie, jeśli pole excluded_attribute zawiera wartość 48, zwracaj tylko reklamy, które można wyświetlić na stronie SSL (a odpowiednio zadeklarować atrybut 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

Również pole excluded_sensitive_category w tabeli BidRequest używa kodów z ad-sensitive-categories.txt dostępny na stronie dane referencyjne. Oto rozszerzone opisy niektórych z tych kodów:

• 3 Politics
  obejmuje politykę lub kontrowersyjne tematy społeczne; nie obejmuje reklam organizacji medialnych, które nie prezentują stronniczych poglądów.
• 4 Dating
  Obejmuje usługi i portale randkowe.
• 5 Religion
  obejmuje reklamy religijne propagujące określone poglądy religijne lub nawołujące przeciw nim; nie obejmuje astrologii ani 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 do telefonów komórkowych, w tym dzwonki i inne gadżety do pobrania, takie jak wygaszacze ekranu i tapety na komputery 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 powiązane produkty i programy; nie obejmuje zdrowego żywienia ani ogólnych reklam dotyczących kondycji fizycznej.
• 19 Cosmetic Procedures & Body Modification
  Zabiegi liftingu, sukcji, laserowe, usuwanie i przywracanie włosów, tatuaże i modyfikacje ciała.
• 23 Drugs & Supplements:
  Zakaz obejmuje farmaceutyki, 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 seksualnością i płodnością; nie obejmuje zwykłych materiałów związanych z ciążą.
• 35 Social Casino Games
  Obejmuje symulacje gier hazardowych (takich jak poker, jednoręki bandyta, bingo, loterie, zakłady sportowe, obstawianie gonitw, a także inne gry karciane i kasynowe), w których nie można wygrać niczego, co ma jakąkolwiek wartość (tj. 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. ciało jest ubrane w bieliznę, stroje kąpielowe, bieliznę lub inną przezroczystą odzież albo jest ubrane w inne przedmioty, takie jak ręcznik lub pościel.
• 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 stylu lub z przesadną grafiką. Obejmuje reklamy, których głównym tematem jest sensacja (np. aresztowania, śmierć czy rozwody celebrytów) lub które mają szokować odbiorców.

Open Measurement

Open Measurement pozwala wskazać dostawców zewnętrznych, którzy świadczą niezależne usługi pomiarowe i usług weryfikacyjnych w przypadku reklam wyświetlanych w środowiskach aplikacji mobilnych.

Obsługiwane formaty reklam obecnie obejmują reklamy wideo, banery i reklamy pełnoekranowe. Więcej informacji na temat konfiguracji informacje o używaniu Open Measurement w odpowiedziach na stawkę z tymi formatami znajdziesz w Centrum pomocy SDK Open Measurement SDK. .

Przykładowe odpowiedzi na stawkę

W sekcjach poniżej znajdziesz przykładowe odpowiedzi na pytania o stawkę w przypadku różnych typów reklam.

Baner aplikacji

Google

Pokaż przykład

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: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

Plik JSON OpenRTB

Pokaż przykład

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "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": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

Bufor protokołu OpenRTB

Pokaż przykład

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    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: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

Reklama pełnoekranowa w aplikacji

Google

Pokaż przykład

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: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "4.0"
    network: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

Plik JSON OpenRTB

Pokaż przykład

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "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": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

Bufor protokołu OpenRTB

Pokaż przykład

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    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"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

Pełnoekranowa reklama wideo w aplikacji

Google

Pokaż przykład

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

Bufor protokołu OpenRTB

Pokaż przykład

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"

Reklama natywna w aplikacji

Google

Pokaż przykład

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  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: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254106.40"
    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"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 20

Plik JSON OpenRTB

Pokaż przykład

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

Bufor protokołu OpenRTB

Pokaż przykład

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

Film internetowy

Google

Pokaż przykład

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 dotyczący licytującego na giełdzie

Bufor protokołu OpenRTB

Pokaż przykład

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    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: "46483683815"
    crid: "test_creative_id_527097"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}