Нативная реклама — это реклама, отформатированная с учетом окружающего контента и визуального дизайна, что повышает вероятность ее просмотра и нажатия пользователями. Нативные рекламные ресурсы доступны в мобильных приложениях, а также на настольных и мобильных веб-сайтах. Дополнительную информацию о нативной рекламе см. в разделе Обзор нативной рекламы .
Нативные объявления поддерживаются как для Авторизованных покупателей, так и для Open Bidding.
Вот рабочий процесс для нативной рекламы:
- В Google поступает запрос на нативную рекламу. Вызов указывает один или оба следующих шаблона нативных объявлений, каждый из которых определяет предпочтительные нативные поля.
- Google отправляет покупателям запрос ставки RTB, содержащий список запрашиваемых полей.
- Заинтересованные покупатели отвечают, заполняя запрошенные поля.
- Google проводит аукцион, чтобы выбрать победившую ставку, и отправляет предоставленные покупателем креативные ресурсы издателю.
- Издатель объединяет ресурсы в нативное объявление и стилизует их в соответствии с дизайном сайта.
Форматы сообщений
Google поддерживает спецификацию OpenRTB как в JSON, так и в Protobuf.
Для нативной рекламы OpenRTB Protobuf следующие поля отличаются от спецификации :
| JSON | Тип JSON | Протобуф | Тип протобуфа |
|---|---|---|---|
BidRequest.imp[].native.request | string | BidRequest.imp[].native.request_native | NativeRequest |
BidResponse.seatbid[].bid[].adm | string | BidResponse.seatbid[].bid[].adm_native | NativeResponse |
Поля OpenRTB Protobuf представляют собой сообщения Protobuf, а не строки.
Если вы используете реализацию OpenRTB Protobuf, ваша конечная точка получает запросы ставок, содержащие BidRequest.imp.native.request_native а не BidRequest.imp.native.request . Кроме того, ваша конечная точка должна возвращать ответы на запросы ставок, которые заполняются BidResponse.seatbid.bid.adm_native а не BidResponse.seatbid.bid.adm , в противном случае они будут отфильтрованы с аукциона.
Если вы используете SDK покупателя для показа нативной рекламы, вам необходимо включить type изображения в declared_ad при отправке креативов на проверку .
Шаблоны нативных объявлений
Шаблоны нативных объявлений описывают компоненты нативной рекламы и определяют содержимое и структуру NativeRequest OpenRTB или NativeAdTemplate устаревшего протокола Google RTB в запросе ставки. Google поддерживает два наиболее распространенных шаблона нативных объявлений для невидео и видеообъявлений:
- Шаблон объявления, ориентированного на установку приложения . Продвигайте и стимулируйте установки мобильных приложений.
- Шаблон содержательной рекламы . Более общая комбинация текста и изображений для брендовой или веб-рекламы.
- Шаблон видеообъявления, ориентированного на установку приложения
- Шаблон объявления с видеоконтентом
Существуют и другие шаблоны, которые могут иметь другой набор требований к полям, измерениям и размерам.
Шаблон объявления, ориентированного на установку приложения
Обязательные и рекомендуемые поля
В следующих таблицах показаны поля с метками «Обязательно» или «Рекомендовано» . Применяются следующие правила:
- Поля с пометкой «Обязательно» обязательны для заполнения участником торгов.
- Поля с пометкой «Рекомендовано» не являются обязательными для участника торгов, и издатель может отображать или не отображать их, если они есть (например, звездный рейтинг).
- Призыв к действию (CTA) всегда помечается как «Рекомендуемый», поскольку назначается значение по умолчанию, если он не отправлен участником торгов, но он всегда будет отображаться в случае отправки.
В следующей таблице перечислены поля шаблона объявления, ориентированного на установку приложения. Мобильные приложения используют эти поля для создания нативной рекламы, ориентированной на установку приложения.
| Поле | Описание | Требуется или рекомендуется? | Всегда отображается? | Рекомендуемый размер изображения/максимальное количество символов | Пример |
|---|---|---|---|---|---|
| Заголовок | Название приложения | Необходимый | Да | 25 символов | Флуд-это! |
| Изображение | Скриншот из приложения или другое подходящее изображение. | Необходимый | Нет | 1200 x 627 пикселей или 600 x 600 пикселей в зависимости от соотношения сторон, требуемого издателем. | <Скриншот из игры Flood-It!> |
| Тело | Основной текст приложения | Необходимый | Нет | 90 символов | Обманчиво просто + дразняще сложно = восхитительно затягивает! |
| Значок приложения | Значок приложения | Необходимый | Нет | 128 х 128 пикселей | <Флуд-это! значок приложения> |
| Призыв к действию | Предпочтительное действие пользователя | Рекомендуется | Да | 15 символов | Установить |
| Звездный рейтинг | Количество звезд (0–5), обозначающих рейтинг приложения в магазине приложений. | Рекомендуется | Нет | 0–5 | 4,5 |
| Цена | Стоимость приложения | Рекомендуется | Нет | 15 символов | Бесплатно |
Примечания о длине текста
Если покупатель отправляет текстовый ресурс (например, основной текст), длина которого превышает рекомендуемое максимальное количество символов, текст может быть обрезан Google или издателем. Обратите внимание, что пределы усечения в два раза меньше на китайском, японском и корейском языках. Например, ограничение на заголовок составляет 90 для английского языка и 45 для китайского.
Примечания о размере изображения
Издателям разрешено:
- Обрезайте основное изображение симметрично до 20 % по одному измерению (высоте или ширине).
- Масштабируйте изображение, не меняя его соотношение сторон.
- Изображения, соотношение сторон которых существенно отличается от тех, которые подразумеваются высотой и шириной, могут быть отфильтрованы.
Шаблон контентного объявления
В следующей таблице перечислены поля шаблона объявления в контенте. Издатели используют эти поля для создания объявлений с собственным контентом.
| Поле | Описание | Требуется или рекомендуется? | Всегда отображается? | Рекомендуемый размер изображения/максимальное количество символов * | Пример |
|---|---|---|---|---|---|
| Заголовок | Заголовок объявления | Необходимый | Да | 25 символов | Самые низкие ставки по ипотеке |
| Изображение | Основное изображение объявления | Необходимый | Нет | 1200 x 627 пикселей или 600 x 600 пикселей в зависимости от соотношения сторон, требуемого издателем. | <Основное изображение объявления> |
| Тело | Содержание объявления | Необходимый | Нет | 90 символов | Ваш дом, милый дом в Бруклине – дешевле и быстрее, чем вы думаете! |
| Логотип | Логотип рекламодателя или другое подходящее небольшое изображение. | Рекомендуется | Нет | 128 х 128 пикселей | <Логотип NY Mortgage Inc.> |
| Призыв к действию | Предпочтительное действие пользователя | Рекомендуется | Нет | 15 символов | Получить предложение |
| Рекламодатель | Текст, идентифицирующий рекламодателя или бренд. | Необходимый | Нет | 25 символов | Нью-Йоркская ипотека Inc. |
Шаблон видеообъявления, ориентированного на установку приложения
| Поле | Описание | Требуется или рекомендуется? | Всегда отображается? | Рекомендуемый размер изображения/максимальное количество символов * | Пример |
|---|---|---|---|---|---|
| Видео | Видеоответ VAST, содержащий все необходимые ресурсы для воспроизведения видеорекламы. | Необходимый | Нет | - | URL-адрес VAST XML, содержащий Flood-It! Видеореклама |
| Заголовок | Название приложения | Необходимый | Да | 25 символов | Флуд-это! |
| Изображение | Изображение (миниатюра), отображаемое в плеере перед нажатием на видеообъявление или во время его загрузки. | Необходимый | Нет | Соотношение сторон должно соответствовать видео (например: 1280 x 720 для видео 16 x 9, 4 x 3 для видео 640 x 480). | Скриншот из игры Flood-It! Или из видео |
| Тело | Основной текст приложения | Необходимый | Нет | 90 символов | Обманчиво просто + мучительно сложно = восхитительно затягивает! |
| Значок приложения | Значок приложения | Необходимый | Нет | 128 х 128 пикселей | Флуд-это! значок приложения |
| Призыв к действию | Предпочтительное действие пользователя | Необходимый | Да | 15 символов | Установить |
| Звездный рейтинг | Количество звезд (0–5), обозначающих рейтинг приложения в магазине приложений. | Рекомендуется | Нет | 0–5 | 4,5 |
| Цена | Стоимость приложения | Рекомендуется | Нет | 15 символов | Бесплатно |
Ограничения
Видео . Все видео должны быть в виде URL-адреса VAST или тега VAST. Необработанный видеофайл, такой как WebM, MP4 и т. д., указать невозможно .
Длина текста . Если покупатель указывает в ответе текстовый ресурс, например
bodyответа, Google или издатель могут обрезать его и сделать его многоточием. Обратите внимание, что пределы усечения в два раза меньше в китайском, японском и корейском языках. Например, ограничение на заголовок составляет 90 на английском языке и 45 на китайском.Размер изображения : Издателям разрешено:
- Обрезайте основное изображение симметрично до 20 % по одному измерению (высоте или ширине).
- Масштабируйте изображение, не меняя его соотношение сторон.
Пример объявления, ориентированного на установку приложения
Шаблон объявления с видеоконтентом
| Поле | Описание | Требуется или рекомендуется? | Всегда отображается? | Рекомендуемый размер изображения/максимальное количество символов * | Пример |
|---|---|---|---|---|---|
| Видео | Видеоответ VAST, содержащий все необходимые ресурсы для воспроизведения видеорекламы. | Необходимый | Да | - | URL-адрес VAST XML, содержащий Flood-It! Видеообъявление |
| Заголовок | Заголовок объявления | Необходимый | Да | 25 символов | Самые низкие ставки по ипотеке |
| Изображение | Изображение (миниатюра), отображаемое в плеере перед нажатием на видеообъявление или во время его загрузки. | Необходимый | Нет | Соотношение сторон должно соответствовать видео (например: 1280 x 720 для видео 16 x 9, 4 x 3 для видео 640 x 480). | Скриншот из видео |
| Тело | Содержание объявления | Необходимый | Нет | 90 символов | Ваш дом, милый дом в Бруклине – дешевле и быстрее, чем вы думаете! |
| Логотип | Логотип рекламодателя или другое подходящее небольшое изображение. | Рекомендуется | Нет | 128 х 128 пикселей | Логотип NY Mortgage Inc. |
| Призыв к действию | Предпочтительное действие пользователя | Необходимый | Нет | 15 символов | Получить предложение |
| Рекламодатель | Текст, идентифицирующий рекламодателя или бренд | Необходимый | Нет | 25 символов | Нью-Йоркская ипотека Inc. |
Мета-поля
Следующие метаполя являются общими для всех поддерживаемых шаблонов объявлений:
| Протокол Google RTB | OpenRTB- эквивалент | Описание |
|---|---|---|
NativeAd.click_link_url | Link.url | URL-адрес, который будет вызываться браузером, когда пользователь нажимает на объявление. Может быть первым шагом в цепочке перенаправлений, которая в конечном итоге ведет на целевую страницу. Для нативной рекламы мы рекомендуем использовать click_link_url в качестве поля, чтобы указать пункт назначения, куда в конечном итоге перейдет пользователь. Это поле необходимо использовать в случае динамических целевых страниц. |
Ad.click_through_url | Bid.adomain | Должен быть установлен, если участник торгов намерен подать заявку. Это набор целевых URL-адресов для фрагмента, включая URL-адреса, на которые пользователь перейдет, если щелкнет отображаемое объявление, а также любые URL-адреса, видимые в отображаемом объявлении. Не включайте промежуточные вызовы рекламного сервера, не связанные с конечной целевой страницей. Ответ на запрос BidResponse, который возвращает фрагмент или видеообъявление, но не декларирует отсутствие В случае неродной рекламы она не используется для отслеживания кликов или каких-либо других рекламных функций; он используется только как объявление целевого URL. Для нативной рекламы, если |
NativeAd.click_tracking_urls | Link.clicktrackers | Необязательный. Дополнительные URL-адреса, которые позволяют рекламодателям отслеживать клики пользователей по объявлению. |
Ad.ad_choices_destination_url | BidExt.ad_choices_destination_url | Ссылка на рекламные настройки или страницу отказа. Если он присутствует, к нативному объявлению добавляется стандартный значок «Выбор рекламы» и связывается с этим URL-адресом. Это поддерживается для нативных объявлений, но не является частью нативного сообщения в ответе на заявку. |
Ad.impression_tracking_url | NativeResponse.imptrackers | Нативный показ следует отслеживать с помощью impression_tracking_url в прототипе назначения ставок в режиме реального времени Авторизованных покупателей или с помощью нативных имтрекеров в OpenRTB. |
Обязательные и рекомендуемые поля протокола Google RTB
required_fields и recommended_fields указываются издателем. Мы покажем, как преобразовать эти битовые поля, чтобы определить, является ли поле обязательным или рекомендуемым.
Битовое поле использует каждый бит двоичного значения для хранения утверждения «истина» или «ложь», что эквивалентно отправке множества логических сигналов, таких как is_logo_required или is_header_required , но все они упакованы вместе.
Пример
В этом примере мы будем использовать значение required_fields 1085 .
Сначала найдите эквивалентное двоичное значение : 10000111101
Получив двоичное значение, вы можете проверить биты, чтобы узнать, требуется ли поле (1) или нет (0).
В следующей таблице поля сопоставлены с их местами в двоичном значении. Считайте двоичный файл справа налево, при этом 1 бит соответствует самому правому месту двоичного значения.
| Поле | Размещение двоичных значений (справа налево) |
|---|---|
HEADLINE | 1 |
BODY | 2 |
CALL_TO_ACTION | 4 |
ADVERTISER | 8 |
IMAGE | 16 |
LOGO | 32 |
APP_ICON | 64 |
STAR_RATING | 128 |
PRICE | 256 |
STORE | 512 |
VIDEO | 1024 |
Если посмотреть на пример двоичного значения 10000111101 , то 1-бит (крайний правый) равен 1 , что означает необходимое значение. Согласно таблице 1 бит соответствует HEADLINE .
2-битный (второе значение справа) равен 0 что означает, что не требуется. 2-бит соответствует BODY .
Вот все интерпретируемые обязательные поля в нашем примере:
| Ценить | Описание | Необходимый? |
|---|---|---|
1 | VIDEO | Да |
0 | STORE | Нет |
0 | PRICE | Нет |
0 | STAR_RATING | Нет |
0 | APP_ICON | Нет |
1 | LOGO | Да |
1 | IMAGE | Да |
1 | ADVERTISER | Да |
1 | CALL_TO_ACTION | Да |
0 | BODY | Нет |
1 | HEADLINE | Да |
Представление шаблона нативного объявления в запросе ставки.
При получении запроса ставки, содержащего нативный инвентарь, он будет содержать шаблон нативного объявления в разных формах в зависимости от используемого протокола. Мы рекомендуем использовать OpenRTB, поскольку протокол Google устарел.
В OpenRTB шаблон нативного объявления описывается сообщением NativeRequest . В протоколе Google RTB это описывается с помощью NativeAdTemplate . В этих сообщениях содержится следующая информация о ресурсах нативной рекламы:
- Поля, которые являются обязательными или рекомендуемыми.
- Размеры изображений, логотипов и значков приложений.
- Характеристики стиля, в котором отображается объявление.
Идентификаторы активов OpenRTB
OpenRTB передает в запросе ставки массив ресурсов, которые описывают структуру нативного объявления, которое вы должны вернуть в ответе. Каждый актив в запросе будет иметь идентификатор, который необходимо указать для соответствующего актива в ответе. Пример того, как эти идентификаторы соотносятся между запросом и ответом, см. в образце собственного запроса ставки и образце ответа на встроенную ставку .
Представление нативной рекламы в ответе на запрос ставки
Делая ставки на собственный инвентарь, покупатель должен заполнить обязательные поля, указанные в запросе ставки. В OpenRTB это можно сделать с помощью BidResponse.seatbid.bid.adm_native при использовании Protobuf или BidResponse.seatbid.bid.adm для JSON. В устаревшем протоколе Google это делается с помощью поля BidResponse.ad.native_ad .
Примеры запросов ставок
Запросы ставок, не относящиеся к видео
Покажи мне пример
Сериализованный запросid: "l6210s8bS8Uc726V81B821" imp { id: "1" tagid: "3019814809" bidfloor: 0.06 bidfloorcur: "USD" secure: true native { ver: "1.2" request_native { ver: "1.2" assets { id: 1 required: true title { len: 25 } } assets { id: 2 required: true data { type: DESC len: 90 } } assets { id: 3 data { type: CTATEXT len: 15 } } assets { id: 4 required: true img { type: MAIN wmin: 1200 hmin: 627 } } assets { id: 5 img { type: LOGO wmin: 100 hmin: 100 } } eventtrackers { event: IMPRESSION methods: IMG } privacy: true [com.google.doubleclick.native_ext] { style_id: 497439 style_height: 1 style_width: 1 style_layout_type: FLUID } } } exp: 3600 metric { type: "click_through_rate" value: 0.0006697923527099192 vendor: "EXCHANGE" } metric { type: "viewability" value: 0.05 vendor: "EXCHANGE" } [com.google.doubleclick.imp] { billing_id: 50577321529 dfp_ad_unit_code: "/3711494/google/test" ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED buyer_generated_request_data { data: "Test Data" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } open_bidding { is_open_bidding: true } creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN } auction_environment: SERVER_SIDE_AUCTION ae: SERVER_SIDE_AUCTION } } site { page: "https://www.google.com" publisher { id: "pub-1111111111111111" [com.google.doubleclick.publisher] { country: "FR" } } content { livestream: false language: "fr" } [com.google.doubleclick.site] { amp: DIALECT_HTML page_visibility: VISIBILITY_STATE_VISIBLE inventorypartnerdomain: "" ntype: NAVIGATION_TYPE_NAVIGATE } } device { ua: "OMITTED" geo { lat: 0.0 lon: 0.0 country: "FRA" region: "FR-C" zip: "63120" type: IP utcoffset: 120 accuracy: 6948 [com.google.doubleclick.geo] { geo_criteria_id: 9112278 } } ipv6: "2a01:cb14:8183::" os: "Windows" devicetype: PERSONAL_COMPUTER lmt: false pxratio: 1.0 sua { browsers { brand: "Chromium" version: "130" version: "0" } browsers { brand: "Microsoft Edge" version: "130" version: "0" } platform { brand: "Windows" version: "15" version: "0" } mobile: false architecture: "x86" bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } } user { [com.google.doubleclick.user] { consented_providers_settings { consented_providers: 1712 consented_providers: 2316 additional_consent: "OMITTED" } consent: "OMITTED" eids { source: "OMITTED" uids { id: "12JD92JD8078S8J29SDOAKC0EF230337" } } } } at: FIRST_PRICE tmax: 350 cur: "USD" regs { gpp: "OMITTED" [com.google.doubleclick.regs] { gdpr: true } } source { schain { complete: true nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: true } ver: "1.0" } [com.google.doubleclick.source] { schain { complete: 1 nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: 1 } ver: "1.0" } } } [com.google.doubleclick.bid_request] { google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v" fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE }
Покажи мне пример
{ "id": "l6210s8bS8Uc726V81B821", "imp": [ { "id": "1", "tagid": "3019814809", "bidfloor": 0.06, "bidfloorcur": "USD", "secure": 1, "native": { "ver": "1.2", "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}" }, "exp": 3600, "metric": [ { "type": "click_through_rate", "value": 0.0006697923527099192, "vendor": "EXCHANGE" }, { "type": "viewability", "value": 0.05, "vendor": "EXCHANGE" } ], "ext": { "billing_id": [ "50577321529" ], "dfp_ad_unit_code": "/3711494/google/test", "ampad": 3, "buyer_generated_request_data": [ { "data": "Test Data" } ], "excluded_creatives": [ { "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID" }, { "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID" } ], "open_bidding": { "is_open_bidding": 1 }, "creative_enforcement_settings": { "policy_enforcement": 1, "publisher_blocks_enforcement": 2 }, "auction_environment": 0, "ae": 0 } } ], "site": { "page": "https://www.google.com", "publisher": { "id": "pub-1111111111111111", "ext": { "country": "FR" } }, "content": { "livestream": 0, "language": "fr" }, "ext": { "amp": 0, "page_visibility": 1, "inventorypartnerdomain": "OMITTED", "ntype": 1 } }, "device": { "ua": "OMITTED", "geo": { "lat": 0.0, "lon": 0.0, "country": "FRA", "region": "FR-C", "zip": "63120", "type": 2, "utcoffset": 120, "accuracy": 6948, "ext": { "geo_criteria_id": 9112278 } }, "ipv6": "2a01:cb14:8183::", "os": "Windows", "devicetype": 2, "lmt": 0, "pxratio": 1.0, "sua": { "browsers": [ { "brand": "Chromium", "version": [ "130", "0" ] }, { "brand": "Microsoft Edge", "version": [ "130", "0" ] } ], "platform": { "brand": "Windows", "version": [ "15", "0" ] }, "mobile": 0, "architecture": "x86", "bitness": "64", "source": 2 } }, "user": { "ext": { "consented_providers_settings": { "consented_providers": [ "1712", "2316" ], "additional_consent": "OMITTED" }, "consent": "OMITTED", "eids": [ { "source": "OMITTED", "uids": [ { "id": "12JD92JD8078S8J29SDOAKC0EF230337" } ] } ] } }, "at": 1, "tmax": 350, "cur": [ "USD" ], "regs": { "gpp": "OMITTED", "ext": { "gdpr": 1 } }, "source": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" }, "ext": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" } } }, "ext": { "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v", "fcap_scope": 1 } }
Покажи мне пример
Сериализованный запросid: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx" ip: "\300\250" user_agent: "OMITTED" url: "https://www.google.com" detected_language: "it" adslot { id: 1 excluded_attribute: 14 excluded_attribute: 32 allowed_vendor_type: 42 allowed_vendor_type: 144 excluded_sensitive_category: 36 excluded_sensitive_category: 19 matching_ad_data { billing_id: 74792558829 billing_id: 11204117851 minimum_cpm_micros: 390000 } matching_ad_data { billing_id: 44428418146 billing_id: 91112044263 minimum_cpm_micros: 110000 } slot_visibility: BELOW_THE_FOLD excluded_product_category: 10366 excluded_product_category: 11504 ad_block_key: 8767661977 publisher_settings_list_id: 7807286827624818876 publisher_settings_list_id: 8186380472781289268 allowed_restricted_category: 32 allowed_restricted_category: 33 excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } iframing_state: UNKNOWN_IFRAME_STATE viewability: 6 allowed_restricted_category_for_deals: 32 allowed_restricted_category_for_deals: 33 click_through_rate: 0.0010397299 allowed_ad_types: ALLOWED_AD_TYPE_NATIVE is_amp_page: DIALECT_HTML amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED secure_signals { data: "Test Data: bw44G12BFZ" source: "OMITTED" } consented_providers_settings { tcf_consent_string: "OMITTED" additional_consent_string: "OMITTED" } regs_gdpr: true native_ad_template { required_fields: 17 recommended_fields: 0 headline_max_safe_length: 90 body_max_safe_length: 90 call_to_action_max_safe_length: 15 advertiser_max_safe_length: 25 image_width: 1200 image_height: 627 style_id: 749853 style_layout_type: FLUID style_height: 1 style_width: 1 } creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES } auction_environment: SERVER_SIDE_AUCTION impression_expiration_seconds: 3600 supported_auction_environment: SERVER_SIDE_AUCTION } is_test: false timezone_offset: 120 geo_criteria_id: 1008463 bid_response_feedback { request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301" creative_status_code: 1 event_notification_token: "token" buyer_creative_id: "test_creative_id_744913" minimum_bid_to_win: 220000 feedback_type: BID_FEEDBACK } bid_response_feedback { request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G" creative_status_code: 80 event_notification_token: "token" buyer_creative_id: "test_creative_id_744913" minimum_bid_to_win: 3450000 feedback_type: BID_FEEDBACK } publisher_type: PUBLISHER_OWNED_AND_OPERATED device { device_type: PERSONAL_COMPUTER platform: "Windows" screen_pixel_ratio_millis: 1000 limit_ad_tracking: false } publisher_country: "IT" publisher_id: "pub-1111111111111111" response_deadline_ms: 350 google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6" auction_type: FIRST_PRICE geo { lat: 0.0 lon: 0.0 country: "ITA" region: "IT-MI" city: "Milan" utcoffset: 120 accuracy: 6821 } user_agent_data { platform { brand: "Windows" version: "10" version: "0" } mobile: false architecture: "x86" browsers { brand: "Chromium" version: "128" version: "0" } browsers { brand: "Not;A=Brand" version: "24" version: "0" } bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } page_visibility: VISIBILITY_STATE_VISIBLE supply_chain { complete: true nodes { advertising_system_identifier: "testdomain.com" seller_identifier: "pub-1111111111111111" handles_payment: true } version: "1.0" } frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE privacy_treatments { allow_user_data_collection: true } inventory_partner_domain: "OMITTED"
Запросы ставок для видео
{ id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123", ip: "\0338\355", google_user_id: "CAESEJ1ur2l94_8ruuu", cookie_version: 1, cookie_age_seconds: 5184000, hosted_match_data: "W9ABDAAAAGR67nl0", user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36", publisher_country: "IN", geo_criteria_id: 1007796, timezone_offset: 330, publisher_id: "pub-2230723027927371", seller_network_id: 989, url: "https://m.example.com", detected_language: [en], google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q", auction_type: "SECOND_PRICE", device: { device_type: "HIGHEND_PHONE", platform: "android", brand: "coolpad", model: "cp8298_i00", os_version: { major: 5, minor: 1 }, carrier_id: 70210, screen_width: 360, screen_height: 640, screen_pixel_ratio_millis: 2000 }, mobile: { is_app: false, is_mobile_web_optimized: true, DEPRECATED_platform: "android", DEPRECATED_mobile_device_type: "HIGHEND_PHONE", DEPRECATED_brand: "coolpad", DEPRECATED_model: "cp8298_i00", DEPRECATED_os_version: { os_version_major: 5, os_version_minor: 1 }, DEPRECATED_screen_width: 360, DEPRECATED_screen_height: 640, DEPRECATED_carrier_id: 70210, DEPRECATED_device_pixel_ratio_millis: 2000 }, publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED", adslot: [{ id: 1, ad_block_key: 2882274820, width: [300,250], height: [250,250], excluded_attribute: [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22], allowed_vendor_type: [42,144,575,698,704,743,776,785,793,797,808,828,832,885], excluded_sensitive_category: [36,27,19,4,23,30,10,3,31,5,8,37,18], excluded_product_category: [10031,11669,13423,13525,13566,13589,13612,13740], excluded_creatives: [{ buyer_creative_id: "1234567.1234567890-ssl" }], matching_ad_data: [{ billing_id: [6629616415,51386650457], minimum_cpm_micros: 1380000, direct_deal: [{ direct_deal_id: 410401, fixed_cpm_micros: 1360000, deal_type: "PREFERRED_DEAL", publisher_blocks_overridden: true },{ direct_deal_id: 240644, fixed_cpm_micros: 1500000, deal_type: "PREFERRED_DEAL", publisher_blocks_overridden: true }] },{ billing_id: [1234567890], minimum_cpm_micros: 1380000 }], publisher_settings_list_id: [12109930661871909476,11138951146123409010], slot_visibility: "BELOW_THE_FOLD", viewability: 30, click_through_rate: 0.0010072842, iframing_state: "UNKNOWN_IFRAME_STATE", native_ad_template: [{ required_fields: 1065, recommended_fields: 4, headline_max_safe_length: 25, body_max_safe_length: 90, call_to_action_max_safe_length: 15, advertiser_max_safe_length: 25, logo_width: 100, logo_height: 100, style_id: 199892, style_height: 250, style_width: 300 }], sticky_settings: { }, renderer: "GOOGLE", is_amp_page: "DIALECT_HTML", amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED", allowed_ad_types: [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE], session_depth: 1, internal_data: { } }], response_deadline_ms: 122, is_test: false }
Пример ответов на запросы ставок
Ответы на запросы ставок, не относящиеся к видео
Покажи мне пример
Сериализованный ответid: "22i22S9494PQl819H7Ld5K" seatbid { bid { id: "2GTnPXOn76gg1C6574T" impid: "1" price: 0.24 adid: "test_creative_id_713312" adomain: "google.com" crid: "test_creative_id_713312" exp: 300 language: "xx" adm_native { ver: "1.2" assets { id: 1 title { text: "Luxury Mars Cruises" } } assets { id: 2 data { value: "Visit the planet in a luxury spaceship." } } assets { id: 3 data { value: "Book today" } } assets { id: 4 img { url: "https://native.test.com/image?id=123456" w: 1200 h: 627 } } assets { id: 5 img { url: "https://native.test.com/logo?id=123456" w: 1200 h: 1200 } } 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" } eventtrackers { event: IMPRESSION method: IMG url: "https://test.com/event?id=123456" } privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED" } [com.google.doubleclick.bid] { event_notification_token { payload: "token" } billing_id: 50577321529 third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7" } } seat: "5249:9218:332606" } cur: "USD"
Покажи мне пример
{ "id": "22i22S9494PQl819H7Ld5K", "seatbid": [ { "bid": [ { "id": "2GTnPXOn76gg1C6574T", "impid": "1", "price": 0.24, "adid": "test_creative_id_713312", "adomain": [ "google.com" ], "crid": "test_creative_id_713312", "exp": 300, "language": "xx", "ext": { "event_notification_token": { "payload": "token" }, "billing_id": "50577321529", "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7" }, "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\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}" } ], "seat": "5249:9218:332606" } ], "cur": "USD" }
Покажи мне пример
Сериализованный ответad { adslot { id: 1 max_cpm_micros: 110734 min_cpm_micros: 0 billing_id: 74792558829 deal_id: 0 } click_through_url: "google.com" attribute: 47 attribute: 8 buyer_creative_id: "test_creative_id_907643" 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\254 225" 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" dsa_transparency { buyer_render: true } } processing_time_ms: 27
Видеоответы на ставки
bid_response { ad { ... click_through_url: "https://www.exampleDomain.com" impression_tracking_url: "https://my_impression_tracking_url.com/" ad_choices_destination_url: "https://my_ad_choices_destination_url.com/" ... native_ad { headline: "Lowest mortgage rates" video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast" call_to_action: "Get a quote" advertiser: "NY Mortgage Inc." image { url: "https://www.example.net/mypromoimage.png" width: 1200 height: 700 } logo { url: "https://www.example.net/mylogo.png" width: 200 height: 200 } click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1" click_tracking_urls: "https://my_click_tracking_url.com/" } } }