Настройка интеграции Open Bidding

Open Bidding позволяет биржам и другим покупателям использовать инфраструктуру торгов Google в режиме реального времени для размещения ставок на инвентаре Google Ad Manager и AdMob.

Чтобы принять участие в Open Bidding, настройте интеграцию с торгами в режиме реального времени, адаптированную под ваш сценарий использования Open Bidding, и отправьте конечные точки участников торгов своему менеджеру аккаунта Google для тестирования, чтобы убедиться в корректной работе интеграции. Это однократная процедура.

Ограничьте интеграцию избранными издателями

Ваша интеграция с Open Bidding может оставаться в «приватном режиме», пока вы не будете готовы принимать запросы от любого издателя. В этом режиме вы можете работать с командой по работе с аккаунтами, чтобы связаться с избранными издателями, и оставаться в этом режиме до тех пор, пока не будете готовы к масштабированию. После выхода из приватного режима ваша учётная запись будет видна всем издателям.

Поддерживаемые протоколы и кодировки

OpenRTB можно использовать в форматах JSON или Protobuf. Подробнее .

Реализация Google OpenRTB

Реализация OpenRTB от Google поддерживает не все функции, представленные в спецификации OpenRTB, а лишь добавляет расширения для авторизованных покупателей и функции, специфичные для Open Bidding. Подробнее см. в руководстве OpenRTB .

Обработка входящих запросов на ставки

Open Bidding использует ту же структуру BidRequest что и Authorized Buyers, но некоторые поля отправляются исключительно участникам Open Bidding. Подробнее о полях, отправляемых в запросе на ставку для Open Bidding, см. в Руководстве по запросам .

Ответить с ставкой

Open Bidding также использует структуру BidResponse похожую на структуру Authorized Buyers, с некоторыми эксклюзивными полями, отправляемыми участникам Open Bidding. Подробнее о полях, которые можно использовать в Open Bidding, см. в Руководстве по ответам .

Примечание: запросы на ставки, отправленные участникам открытых торгов, должны получать ответ в течение 300–1000 мс, в зависимости от формата инвентаря. Чтобы определить конкретные требования для конкретного запроса, проверьте поле BidRequest.tmax .

В зависимости от предпочитаемого формата рекламы, который вы планируете использовать для ставок, структура ответа может существенно различаться. Ознакомьтесь со следующими руководствами, которые помогут вам настроить приложение для ставок для ответов на ставки распространённых форматов рекламы:

• Интерстициальная реклама
• Видеореклама
• Видеореклама OpenRTB
• Нативная реклама
• Нативная видеореклама
• Реклама SDK покупателя

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

Настоятельно рекомендуется использовать необязательное поле BidResponse.seatbid.bid.ext.impression_tracking_url для получения данных на уровне показов о том, когда Google регистрирует платные события, за которые с вас будет взиматься плата.

Разрешение несоответствий спроса Google (бета)

Эта функция направлена ​​на обеспечение того, чтобы количество показов, за которые взимается плата, соответствовало количеству показов, оплачиваемых Google Display & Video 360 (DV360).

Точно идентифицируя показы DV360, обслуживаемые Open Bidding, Google может затем скорректировать рекламный спам и расхождения в платных событиях, чтобы гарантировать, что вам не будут выставлены счета за показы, за которые вы не получаете оплату.

Распространять google_query_id в запросах ставок

Чтобы гарантировать соответствие количества действительных показов по всему запросу Google, значение google_query_id должно передаваться из запросов Open Bidding на платформы Google Demand в том виде, в котором оно есть. Это необходимое условие для устранения расхождений в Open Bidding. Ожидаемая длина значения google_query_id в настоящее время составляет около 64 байт.

Распространять third_party_buyer_token в ответах на заявки

В случае победы платформы спроса Google на внутреннем аукционе биржи поле third_party_buyer_token должно быть передано обратно в том виде, в каком оно содержится в ответе на заявку, через показ Open Bidding. Это позволяет платформам издателей Google определить, что победившая заявка от партнёра Open Bidding является заявкой от имени Google на ту же возможность показа. Ожидается, что в настоящее время максимальная длина этого поля составит 150 байт.

Передавать разметку креативов Google как есть в ответах на заявки

Чтобы гарантировать, что разрешение расхождений применяется к заявкам от Google Demand, биржа должна распространять разметку креативов Google без каких-либо оболочек (тегов скриптов, iframe или оболочек VAST). В связи с разрешением расхождений Google может аннулировать и не выставлять счета за показы Open Bidding, которые не были учтены платформами Google Demand. Google будет периодически проверять разметку креативов, чтобы убедиться, что заявки с third_party_buyer_token были поданы от имени Google Demand, а не от имени какого-либо другого покупателя.

HTML5-креативы

Биржа должна предоставить разметку Google HTML «как есть » с макрорасширениями, которые обычно применяются для данной биржи, а также, при необходимости, с дополнительными пикселями отслеживания или скриптами, которые обычно добавляет биржа.

Google не сможет применить разрешение несоответствий, если биржа помещает креатив Google HTML в тег ( script , iframe или другие методы), который впоследствии загружает или отображает код Google HTML.

Соответствует техническим требованиям

В этом примере HTML-код креатива Google (DV360) из ответа на заявку передается дословно , добавляется в начало и конец HTML-кода, специфичного для биржи.

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

Не соответствует техническим требованиям

В этом примере HTML-код креатива, возвращаемый Google, запутан в ответе на заявку, предоставленном биржей, и не отображается в ответе дословно . HTML-код, предоставленный Google, может быть отображен в браузере с помощью оболочки, предоставляемой биржей.

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

Видеообъявления VAST

Чтобы иметь право на разрешение несоответствий, биржа должна использовать один из следующих подходов для заполнения VASTTagURI в ответах VAST XML:

1. Биржа может сохранить значение элемента VASTTagURI как часть XML-документа VAST, возвращаемого Google в поле BidResponse.seatbid.bid.adm , как есть , с макрорасширениями, специфичными для биржи, которые обычно применяются.
2. DV360 может заполнять поле BidResponse.seatbid.bid.adm.nurl URL-адресом документа VAST в ответах на заявки, отправляемых бирже. Биржа затем может передавать это значение с тегом VASTTagURI , при этом специфичные для биржи макросы будут расширяться по мере необходимости.

При необходимости биржа может указать дополнительные средства отслеживания событий и ошибок VAST в документе VAST XML.

Соответствует техническим требованиям

В этом примере креативный VAST URI Google (DV360) из ответа на заявку передается дословно , а биржа добавляет свои конкретные события VAST и средства отслеживания ошибок.

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

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

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

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

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

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

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

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

Не соответствует техническим требованиям

В этом примере код VAST креатива или URI, возвращаемый Google , не отображается дословно в ответе на запрос ставки , а вместо этого используется оболочка VAST, специфичная для биржи. Код VAST, предоставленный Google, может быть загружен оболочкой VAST, предоставляемой биржей (как определено в элементе VASTAdTagURI , https://video.exchange.example.com/creative?… ) при загрузке объявления SDK.

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

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

Сделки

Биржи, участвующие в открытых торгах, могут использовать приоритетные сделки (PD) и частные аукционы (PA) с открытыми торгами. Идентификатор и тип сделки должны быть указаны следующим образом:

Поле	Описание
BidResponse.seatbid.bid.dealid	Идентификатор сделки из пространства имён биржи, связанный с заявкой и сообщаемый издателям. Это произвольный текст в кодировке UTF-8, длина которого не должна превышать 64 байта.
BidResponse.seatbid.bid.ext.exchange_deal_type	Перечисление, определяющее тип сделки. Информация передается издателям и влияет на обработку сделки на аукционе. Возможные значения: OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

Ниже приведен пример ответа на заявку на PD/PA.

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

Сопоставление файлов cookie

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

• Сопоставление файлов cookie: сопоставление, инициированное покупателем или биржей Узнать больше .
• Pixel Matching: сопоставление, инициированное Google Узнать больше .
• Cookie Match Assist: сопоставление, инициированное биржей, с ее участниками торгов Узнать больше .

Примечание: в настоящее время участники открытых торгов не могут создавать, заполнять или нацеливать списки пользователей.

Управление задержкой

Вам следует использовать торговые местоположения, указанные в Руководстве по пирингу, чтобы оценить задержку, которую будут иметь конечные точки ваших участников торгов при ответе на входящие запросы ставок.

Инвентарь обычно отправляется через ближайшую торговую площадку, но это не гарантировано. Единственный способ гарантировать доступ ко всем показам — это наличие конечных точек участников торгов во всех торговых площадках.

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

Макросы кликов

Мы рекомендуем вам внедрить макросы кликов. Это позволит создавать отчёты, включающие клики и метрики, полученные по кликам, для вашего аккаунта и издателей, с которыми вы работаете. Подробнее .

API-интерфейсы

Клиенты Open Bidding могут использовать REST API авторизованных покупателей для доступа к данным, которые могут быть полезны для устранения неполадок. В настоящее время доступны только следующие ресурсы API:

• Отчет о производительности v1.4
• Устранение неполадок RTB v2beta1

Вы можете обратиться к своему техническому менеджеру по работе с клиентами, чтобы настроить доступ к этим API и получить идентификатор учётной записи, необходимый для выполнения вызовов API. За технической поддержкой по использованию этих API обращайтесь по адресу [e-mail].

Дополнительные ресурсы

• Лучшие практики управления соединениями
• Использование макросов URL-адресов ставок
• Расшифровка подтверждений цен при использовании макроса WINNING_PRICE
• Рекомендации по тестированию и передовой опыт

Примеры запросов и ответов на предложения

Образцы запросов и ответов на заявки для всех поддерживаемых протоколов можно найти в руководствах по запросам и ответам .