Создайте ответ

После того как ваше приложение обработает запрос ставки от Google, оно должно создать и отправить ответ. В этом руководстве объясняется, как написать код приложения для создания ответа.

Создать сообщение BidResponse

Авторизованные покупатели отправляют BidRequest в виде тела сообщения HTTP POST . В ответе, отправляемом вашим приложением, заголовок Content-Type должен иметь значение application/octet-stream , а тело сообщения должно состоять из сериализованного буфера протокола. Буфер протокола — это сообщение BidResponse , определенное в realtime-bidding.proto . Ваше приложение должно возвращать разборчивый BidResponse в ответ на каждый BidRequest . Тайм-ауты и ответы, которые не могут быть проанализированы, считаются ошибками, и Google ограничивает участников торгов с высоким уровнем ошибок.

Если вы не хотите делать ставки на показ, вы можете установить только поле processing_time_ms и оставить все остальные поля пустыми. Вы можете получить realtime-bidding.proto на странице справочных данных .

Идентификатор объявления

Ваш BidResponse указывает креатив через поле buyer_creative_id (не более 64 байт). Даже похожие объявления должны иметь уникальные значения для buyer_creative_id , если они отличаются какими-либо заметными характеристиками, включая, помимо прочего, размер, заявленный URL-адрес, атрибуты объявлений и типы поставщиков. Другими словами, вы должны присвоить разные идентификаторы объявления любым двум объявлениям, которые:

• Выглядеть или вести себя по-другому.
• Рендерим разные изображения.
• Рендеринг разными способами (например, одно объявление состоит из изображения, а другое содержит Flash).

При разработке приложения вы должны выбрать систематический способ создания идентификаторов, который подходит для типов объявлений, которые вы планируете отправлять.

Атрибуты объявления

Вы должны объявить атрибуты объявления, которые полностью описывают характеристики объявления и его таргетинг в BidResponse.Ad.attribute . Атрибуты, которые должны быть объявлены (см. также полный список поддерживаемых атрибутов на странице customer-declarable-creative-attributes.txt ):

• 7 Tagging: IsTagged
  Объявление содержит в себе пиксель или веб-маяк для создания списка идентификаторов файлов cookie для последующего ремаркетинга.
• 8 Remarketing: IsRemarketing
  Объявление нацелено на потребителей на основе их идентификаторов файлов cookie или идентификаторов устройств, где список идентификаторов файлов cookie или идентификаторов устройств представляет собой набор потребителей, которые ранее взаимодействовали с сайтом, принадлежащим покупателю или представленным им.
• 9 UserInterestTargeting: IsUserInterestTargeted
  Объявление нацелено на потребителей на основе их идентификатора файла cookie или идентификатора устройства, где список идентификаторов файлов cookie или идентификатора устройства представляет набор потребителей, определенных покупателем как группа общих интересов.
• 30 InstreamVastVideoType: Vpaid
  Для отображения объявления требуется поддержка VPAID.
• 32 MraidType: MRAID
  Для отображения объявления требуется API MRAID.

Кроме того, поддерживаются следующие атрибуты, но их объявление не требуется, поскольку авторизованные покупатели автоматически обнаруживают их и блокируют (или разрешают) ваши креативы на основе обнаруженных значений, а не вашего объявления. См. API Creatives , чтобы узнать, как получить отзыв об обнаруженных свойствах ваших объявлений.

• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  Для отображения объявления требуется поддержка Flash.
• 50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
  Объявлению не требуется Flash для отображения.
• 47 RichMediaCapabilityType: RichMediaCapabilitySSL
  Объявление может отображаться на странице SSL. Обратите внимание, что авторизованные покупатели рассматривают креативы с разными объявленными значениями этого атрибута как разные (они будут проверяться отдельно и иметь разные статусы одобрения). Поэтому, если вы делаете ставки как с версиями SSL, так и без SSL одного и того же объявления, вы должны объявить этот атрибут соответствующим образом, чтобы это различие правильно отражалось в Ad Exchange.

Открытые поля торгов

Ответы на заявки, отправленные участниками торгов на бирже и в сети, участвующими в открытых торгах, аналогичны ответам Авторизованных покупателей, участвующих в стандартных торгах в реальном времени. Клиенты Open Bidding могут указать небольшое количество дополнительных полей, а несколько существующих полей могут иметь альтернативное использование. К ним относятся следующие:

OpenRTB	Авторизованные покупатели	Подробности
BidResponse.imp[].pmp.deals[].id	BidResponse.ad[].adslot[].exchange_deal_id	Идентификатор сделки из пространства имен биржи, который связан с этой ставкой и сообщается издателям. Примечание. В настоящее время это поле отправляется только участникам закрытого бета-тестирования.
BidResponse.seatbid[].bid[].ext.exchange_deal_type	BidResponse.ad[].adslot[].exchange_deal_type	Тип сделки, сообщаемый издателям, влияющий на ее обработку на аукционе. Примечание. В настоящее время это поле отправляется только участникам закрытого бета-тестирования.
BidResponse.seatbid[].bid[].ext.third_party_buyer_token	BidResponse.ad[].adslot[].third_party_buyer_token	Токен, используемый для идентификации информации о конечном покупателе третьей стороны, если биржа в качестве участника открытых торгов является посредником. Это получено от стороннего покупателя и должно быть передано в Google без изменений в ответе на предложение.

Рекомендации

• Включите постоянные соединения HTTPS (также известные как «поддержка активности» или «повторное использование соединения») на ваших серверах. Установите тайм-аут как минимум на 10 секунд — во многих случаях выгоднее использовать более высокие значения. Google проверяет это во время первоначальных тестов вашего приложения на задержку, потому что авторизованные покупатели отправляют запросы с высокой скоростью и должны избегать дополнительных задержек, связанных с установлением отдельного TCP-соединения для каждого запроса.

• Включите необязательный URL-адрес отслеживания показов, чтобы отслеживать, когда происходит показ, а не когда выигрывает участник торгов. Из-за разницы между выигрышами и рендерингом это дает более точную статистику отслеживания.

  Примечание. При использовании OpenRTB 2.5 или более поздней версии стандартным полем для этого является BidResponse.seatbid[].bid[].burl .
• Следите за тем, чтобы код участника назначения ставок не зависел от устаревших полей , что может привести к сбою ваших ставок с ошибками.
• Включите BidResponse.Ad.width и BidResponse.Ad.height в свой BidResponse . Ответ BidResponse на запрос, который включает несколько размеров объявлений, должен включать значения width и height , иначе он будет исключен из аукциона.
• Ограничьте размер ответа до 8K. Очень большие ответы могут увеличить задержку в сети и вызвать тайм-ауты.
• Следуйте рекомендациям по ставкам на инвентарь iOS, для которых требуется атрибуция SKAdNetwork .

Пример ответа на запрос ставки

В следующих примерах представлены удобочитаемые образцы запросов Protobuf и JSON.

Google

Покажи мне пример

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

OpenRTB JSON

Покажи мне пример

{
  "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>"
  }
}

OpenRTB Protobuf

Покажи мне пример

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"

Важно: Сообщения Protobuf, изображенные в примерах, представлены здесь в виде удобочитаемого текста. Однако это не то, как сообщения отправляются по сети. При использовании формата Google или OpenRTB Protobuf принимаются только сериализованные сообщения BidResponse.

Вы можете создать и сериализовать сообщение BidResponse , используя следующий код 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
}

Укажите объявление

В ответе на вашу ставку указывается объявление, которое будет показано, если ваша ставка выиграет. Ваша ставка должна включать один из поддерживаемых форматов объявлений (AMP, видео, нативные). В этом примере мы указываем креатив с помощью поля html_snippet .

Кроме того, вы можете указать свое объявление, используя одно из следующих полей в зависимости от формата объявления:

• Объявление, отображаемое SDK
  • BidResponse.Ad.sdk_rendered_ad
• AMP
  • BidResponse.Ad.amp_ad_url
• видео
  • BidResponse.Ad.video_url или
  • BidResponse.Ad.video_vast_xml
• Родной
  • BidResponse.Ad.native_ad

Укажите объявление, размещенное на вашем собственном сервере (серверах), с помощью фрагмента HTML в поле html_snippet BidResponse . Фрагмент заключен в iFrame, вставленный на веб-страницу, в результате чего объявление извлекается и отображается при загрузке страницы. Вы должны создать фрагмент HTML таким образом, чтобы объявление (баннер или межстраничное объявление) правильно отображалось внутри iFrame и имело размер, подходящий для рекламного места, на которое вы делаете ставку.

Кроме того, размер объявления, указанный в ответе на запрос ставки, должен точно совпадать с одной из комбинаций размеров в запросе ставки, когда:

• Объявление представляет собой обычный баннер (не видео, нативное или межстраничное).
• Участник торгов объявил размер в ответе на заявку. Объявление размера требуется всякий раз, когда в запросе присутствует более одного размера.
• Исключение сделано для межстраничных объявлений. Ширина межстраничных объявлений должна составлять не менее 50 % ширины экрана, а высота — не менее 40 % высоты экрана.

Поле html_snippet поддерживает любой действительный код HTML, который отображается правильно, но помните об ограничениях на указание поля buyer_creative_id в разделе сообщения Create BidResponse . Одним из способов использования этого является добавление дополнительной информации в аргументы URL-адресов, которые извлекаются с ваших серверов в рамках рендеринга рекламы. Это позволяет вам передавать произвольные данные о показе обратно на ваши собственные серверы.

Большинство политик для фрагментов HTML, возвращаемых в ответах на запросы ставок, такие же, как и для сторонних объявлений. Дополнительную информацию см. в разделах «Руководство по программе авторизованных покупателей» , «Требования к показу сторонних объявлений » и «Объявление URL перехода по клику в объявлениях» .

Указать макросы

Фрагмент HTML, определяющий объявление, может включать одну или несколько специальных конструкций, называемых макросами. Во время показа рекламы значения заменяются макросами. Например, ваше клиентское приложение для ставок может использовать макрос WINNING_PRICE , чтобы определить, сколько оно заплатило за объявление, если оно выиграет аукцион. Чтобы разобрать этот макрос, вам нужно будет реализовать приложение, которое расшифровывает подтверждения цены. Дополнительную информацию см. на странице «Расшифровка подтверждений цен» .

Укажите макрос как часть фрагмента HTML в формате %%MACRO%% , где MACRO — это один из поддерживаемых макросов, перечисленных в таблице ниже.

Примечание. Для ответов на ставки объявлений AMP ( amp_ad_url ) поддерживаются только макросы WINNING_PRICE и WINNING_PRICE_ESC .

Google требует, чтобы вы использовали макрос CLICK_URL_UNESC или CLICK_URL_ESC в креативе стороннего объявления. Google использует макросы CLICK_URL для отслеживания кликов.

Чтобы использовать макрос, включите его в объявление, чтобы URL-адрес извлекался, когда кто-то нажимает на него. Возвращаемое значение выборки — это перенаправление на другой URL-адрес, который вы добавляете к CLICK_URL .

Примечание. В дополнение к этим макросам DoubleClick мы также поддерживаем макросы OpenRTB. Дополнительные сведения о макросах OpenRTB см. в спецификации OpenRTB .

макрос	Описание
ADVERTISING_IDENTIFIER	Позволяет покупателям получать iOS IDFA или рекламный идентификатор Android при обработке показов. Дополнительные сведения см. в разделе Расшифровка идентификаторов рекламодателя .
CACHEBUSTER	Строковое представление случайного четырехбайтового целого числа без знака.
CLICK_URL_UNESC	Неэкранированный URL-адрес клика для объявления. Во фрагменте экранированная версия URL-адреса стороннего клика должна следовать непосредственно за макросом. Например, если URL-адрес стороннего клика — http://my.adserver.com/some/path/handleclick?click=clk , следующий код можно использовать с версией 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> URL-адрес сначала зарегистрирует клик в Google, а затем перенаправит на сторонний URL-адрес клика.
CLICK_URL_ESC	Экранированный URL клика для объявления. Используйте это вместо CLICK_URL_UNESC если вам нужно сначала передать значение через другой сервер, который затем вернет перенаправление. Например, следующий код можно использовать во фрагменте HTML: <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> Это зарегистрирует клик на my.adserver.com , который затем будет отвечать за перенаправление на URL-адрес, переданный в параметре google_click_url . Это предполагает, что my.adserver.com не экранирует параметр google_click_url . Вы можете добавить URL-адрес с двойным экранированием после %%CLICK_URL_ESC%% . После того, как my.adserver.com выполнит неэкранирование, к google_click_url будет добавлена ​​версия URL с одним экранированием. Когда google_click_url извлекается, он снова отключается, а затем перенаправляется.
CLICK_URL_ESC_ESC	URL-адрес объявления с двойным экранированием. Используйте это вместо CLICK_URL_UNESC если вам нужно сначала передать значение через другой сервер, который затем вернет перенаправление. Например, следующий код можно использовать во фрагменте HTML: <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>
SCHEME	Расширено до http: если запрос ставки не требует SSL или до https: если запрос ставки требует SSL.
SITE	Домен с экранированием URL-адреса URL-адреса контента или анонимный идентификатор для анонимного инвентаря.
SITE_URL	Устарело. Заменен макросом SITE, который обеспечивает идентичную функциональность.
TZ_OFFSET	Смещение часового пояса.
VERIFICATION	Различные значения для производства и при сканировании креатива в конвейере проверки. Формат: %%?VERIFICATION:true-val:false-val%% , где для true-val и false-val можно использовать любые значения, кроме макросов, включая пустые строки. Для Open Bidding мы рекомендуем биржам использовать этот макрос; как только они это сделают, платформам на стороне спроса не нужно вносить изменения. Например, если креатив должен включать %%?VERIFICATION:-1:5000%% , то замена текста будет 5000 при показе и -1 при проверке. Это поможет различать эти два набора пингов.
WINNING_PRICE	Закодированная стоимость показа (то есть CPI, а не CPM) в микросекундах валюты аккаунта. Например, выигрышная цена за тысячу показов в размере 5 долларов США соответствует 5 000 000 микросекунд CPM или 5 000 микросекунд CPI. Расшифрованное значение WINNING_PRICE в этом случае будет 5000. Цена выигрыша указана в CPI.
WINNING_PRICE_ESC	WINNING_PRICE с экранированием URL.

Экранирование URL в макросах использует следующую схему:

• Символ пробела заменяется знаком плюс ( + ).
• Буквенно-цифровые символы (0-9, az, AZ) и символы из набора !()*,-./:_~ остаются без изменений.
• Все остальные символы заменяются на %XX , где XX — шестнадцатеричное число, представляющее символ.

Ограничения издателя

Издатели используют BidRequest для передачи ограничений на разрешенную рекламу. Вы должны применить ограничения в этих полях:

• allowed_vendor_type
• excluded_attribute
• excluded_sensitive_category

В одном поле указаны разрешенные функции объявления, а в другом — запрещенные. Никогда не возвращайте объявление с запрещенной функцией. Для разрешенных функций, таких как тип поставщика, возвращайте объявление только в том случае, если его тип поставщика находится в списке allowed_vendor_type в BidRequest . Дополнительные сведения см. в комментариях к этим полям в определении буфера протокола BidRequest .

Если в BidResponse возвращается фрагмент HTML, необходимо точно указать attribute , category и поля click_through_url в BidResponse . Если в объявлении есть несколько применимых значений для этих полей, вы должны указать каждое значение. Дополнительные сведения см. в комментариях к этим полям в определении буфера протокола BidResponse . Ответы, для которых не заданы эти поля, отбрасываются.

Возможные значения BidRequest.excluded_attribute (см . publisher-excludable-creative-attributes.txt ):

• 7 Tagging: IsTagged
  Объявления запрещены, если они содержат пиксель или веб-маяк с целью создания списка идентификаторов файлов cookie для последующего ремаркетинга.
• 8 CookieTargeting: IsCookieTargeted
  Объявления запрещены, если они ориентированы на потребителей на основе их идентификаторов файлов cookie, где список идентификаторов файлов cookie представляет собой набор потребителей, которые ранее взаимодействовали с сайтом, принадлежащим покупателю или представленным им.
• 9 UserInterestTargeting: IsUserInterestTargeted
  Объявления запрещены, если они нацелены на потребителей на основе их идентификаторов файлов cookie, где список идентификаторов файлов cookie представляет собой набор потребителей, определенных покупателем как группа с общими интересами.
• 21 CreativeType: Html
  В объявлениях запрещено использовать поля html_snippet или snippet_template в BidResponse.Ad .
• 22 CreativeType: VastVideo
  В объявлениях запрещено использовать поле video_url в BidResponse.Ad .
• 30 InstreamVastVideoType: Vpaid
  Объявления не могут требовать поддержки VPAID для отображения.
• 32 MraidType: MRAID
  Объявления не могут требовать отображения MRAID API.
• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  Объявления не могут требовать поддержки Flash для отображения.
• 39 RichMediaCapabilityType: RichMediaCapabilityHTML5
  Объявления не могут требовать отображения функций HTML5.
• 48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
  Объявлениям запрещено делать запросы без SSL.

Поэтому, если поле excluded_attribute содержит значение 7, то не следует возвращать объявление, использующее пиксель или веб-маяк для создания списка. Обратите внимание, что если объявление делает это, то оно должно установить значение 7 в поле атрибута BidResponse . Точно так же, если поле excluded_attribute содержит значение 48, вам следует возвращать только те объявления, которые могут отображаться на странице SSL (и, соответственно, объявлять атрибут 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

Также поле excluded_sensitive_category в BidRequest использует коды из файла ad-sensitive-categories.txt доступного на странице справочных данных . Вот расширенные описания некоторых из этих кодов:

• 3 Politics
  Включает политику или спорные социальные вопросы; не включает рекламу новостных организаций, которые обычно не связаны с какой-либо пристрастной точкой зрения на проблемы.
• 4 Dating
  Включает службы знакомств и онлайн-сообщества знакомств.
• 5 Religion
  Включает религиозную рекламу и рекламу, пропагандирующую религиозные взгляды или против них; не включает астрологию или внеконфессиональную духовность.
• 7 Video Games (Casual & Online)
  Включает видеоигры, онлайн-игры и загружаемые игры; не включает игровые приставки.
• 8 Ringtones & Downloadables
  Мобильные надстройки, включая рингтоны и другие загружаемые полезные функции, такие как заставки и обои для настольных ПК, макеты профилей и графика для социальных сетей.
• 10 Get Rich Quick
  Схемы, обещающие быстрый заработок.
• 18 Weight Loss
  Включает снижение веса, диету и сопутствующие продукты и программы; не включает в себя рекламу здорового питания или общей рекламы фитнеса.
• 19 Cosmetic Procedures & Body Modification
  Включает подтяжки, отсосы, лазеры, удаление и восстановление волос, татуировки и модификацию тела.
• 23 Drugs & Supplements:
  Включает в себя фармацевтические препараты, витамины, добавки и соответствующие розничные магазины; не включает ресурсы, предоставляющие информацию о наркотиках.
• 24 Sexual & Reproductive Health
  Включает рекламу сексуальной функции и фертильности; не включает обычные ресурсы беременности.
• 35 Social Casino Games
  Включает симулированные азартные игры (включая, помимо прочего, покер, игровые автоматы, бинго, лотереи, ставки на спорт, ставки на скачки, а также другие карточные игры и игры в казино), в которых нет возможности выиграть что-либо ценное (например, деньги или призы).
• 36 Significant Skin Exposure
  Рекламные изображения, на которых любая часть человеческого тела от грудины до середины бедра не одета; или тело одето в нижнее белье, купальники, нижнее белье или другую прозрачную одежду или предметы, не относящиеся к одежде, такие как полотенце или простыня.
• 37 Sensationalism
  Объявления, целью которых является побудить пользователей нажать на них, взывая к их любопытству, часто с использованием тизерного сообщения с преувеличенным языком или изображениями. Включает рекламу, посвященную сенсационным темам (например, арестам знаменитостей, смерти или разводам) или нацеленную на шокирующую ценность.

Открытое измерение

Open Measurement позволяет указать сторонних поставщиков, которые предоставляют услуги независимого измерения и проверки для рекламы, показываемой в средах мобильных приложений.

Поддерживаемые форматы объявлений в настоящее время включают видео, баннеры и межстраничные объявления. Дополнительные сведения о том, как использовать Open Measurement в ответе на заявку, содержащем эти форматы, см. в статье Справочного центра Open Measurement SDK .

Примеры ответов на ставки

В следующих разделах показаны примеры ответов на ставки для различных типов объявлений.

Баннер приложения

Google

Покажи мне пример

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

OpenRTB JSON

Покажи мне пример

{
  "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"
        }
      ]
    }
  ]
}

OpenRTB Protobuf

Покажи мне пример

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"

Межстраничное приложение

Google

Покажи мне пример

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

OpenRTB JSON

Покажи мне пример

{
  "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"
}

OpenRTB Protobuf

Покажи мне пример

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"

Межстраничное видео в приложении

Google

Покажи мне пример

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

OpenRTB Protobuf

Покажи мне пример

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"

Нативное приложение

Google

Покажи мне пример

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

OpenRTB JSON

Покажи мне пример

{
  "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"
}

OpenRTB Protobuf

Покажи мне пример

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"

Веб-видео

Google

Покажи мне пример

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

Мобильный веб-баннер для аукциона на бирже

OpenRTB Protobuf

Покажи мне пример

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
}