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

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

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

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

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

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

Мы рекомендуем использовать реализацию OpenRTB от Google. Протокол Google RTB устарел. Узнать больше .

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

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

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

Open Bidding использует ту же структуру BidRequest , что и Авторизованные покупатели, но некоторые поля отправляются исключительно участникам Open Bidding. Дополнительную информацию о полях, специфичных для Open Bidding, которые отправляются в запросе ставки, см. в Руководстве по запросам .

Ответить предложением

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

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

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

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

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

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

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

Распространение google_query_id в запросах ставок

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

Распространение Third_party_buyer_token в ответах на запросы ставок

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

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

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

HTML5-креативы

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

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

Видеокреативы VAST

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

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

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

Специальные предложения

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

Поле Описание
Протокол OpenRTB:
BidResponse.seatbid[].bid[].dealid

Протокол Google:
BidResponse.ad[].adslot[].exchange_deal_id		 Идентификатор сделки из пространства имен биржи, связанный со ставкой и передаваемый издателям. Это произвольный текст UTF8, размер которого не должен превышать 64 байта.
Протокол OpenRTB:
BidResponse.seatbid[].bid[].ext.exchange_deal_type

Протокол Google:
BidResponse.ad[].adslot[].exchange_deal_type		 Перечисление, определяющее тип сделки. Об этом сообщается издателям и влияет на то, как сделка будет рассматриваться на аукционе. Возможные значения: 
OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;

Ниже приведен пример ответа на заявку OpenRTB для 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"
    }
  }
}

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

  • Сопоставление файлов cookie: сопоставление, инициированное покупателем или биржей. Подробнее .
  • Сопоставление пикселей: сопоставление, инициированное Google. Подробнее .
  • Cookie Match Assist: сопоставление с участниками аукциона по инициативе биржи. Подробнее .

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

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

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

Нажмите макросы

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

API

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

Вы можете обратиться к своему техническому менеджеру по работе с клиентами, чтобы настроить свою учетную запись для доступа к этим API и получить идентификатор учетной записи, необходимый для выполнения вызовов API. Для получения технической поддержки при использовании этих API вы можете обратиться в службу поддержки по адресу adxbuyerapi-support@google.com.

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

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

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