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

Нативные объявления

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

Нативные объявления поддерживаются как в сервисе "Авторизованные покупатели", так и в Open Bidding.

Вот рабочий процесс для нативных объявлений:

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

Форматы сообщений

Google поддерживает спецификацию OpenRTB в форматах JSON и Protobuf.

Для нативных объявлений OpenRTB Protobuf следующие поля отличаются от спецификации:

JSON	Тип JSON	Protobuf	Тип Protocol Buffers
`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. В противном случае ответ будет отфильтрован и не попадет на аукцион.

При назначении ставки, включающей нативное объявление, конечная точка назначения ставок должна указывать обязательные и дополнительные объекты, которые вы хотите включить в поле BidResponse.seatbid.bid.{adm/adm_native}.assets. Объекты, отправленные в ответе, должны включать соответствующее значение id, указанное в запросе ставки. id используется для структурирования шаблона и различения похожих типов объектов, таких как основные изображения и значки. В примере ниже показано, как объекты NativeRequest и NativeResponse заполняются в форматах OpenRTB и JSON.

OpenRTB JSON (обработанный)

NativeRequest

{
  "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,
      "required": 1,
      "img": {
        "type": 1,
        "wmin": 100,
        "hmin": 100
      }
    },
    {
      "id": 6,
      "data": {
        "type": 3,
        "len": 5
      }
    },
    {
      "id": 7,
      "data": {
        "type": 6
      }
    }
  ],
  "eventtrackers": [
    {
      "event": 1,
      "methods": [
        1
      ]
    }
  ]
}

NativeResponse

{
  "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
      }
    }
  ],
  "link": {
    "url": "https://www.google.com",
    "clicktrackers": [
      "https://native.test.com/click?id=123456"
    ]
  },
  "imptrackers": [
    "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
  ]
}

OpenRTB Protobuf

NativeRequest

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
    required: true
    img {
      type: ICON
      wmin: 100
      hmin: 100
    }
  }
  assets {
    id: 6
    data {
      type: RATING
      len: 5
    }
  }
  assets {
    id: 7
    data {
      type: PRICE
    }
  }
  eventtrackers {
    event: IMPRESSION
    methods: IMG
  }
}

NativeResponse

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

Если вы используете SDK покупателя для отрисовки нативных объявлений, то при отправке креативов на проверку необходимо включить изображение type в declared_ad.

Шаблоны нативных объявлений

Шаблоны нативных объявлений описывают компоненты нативного объявления и определяют содержимое и структуру объекта NativeRequest в запросе ставки. Google поддерживает два наиболее распространенных шаблона нативных объявлений (для видео и других форматов):

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

Другие шаблоны могут иметь другие требования к полям, параметрам и размерам.

Шаблон объявления, ориентированного на установку приложения

Обязательные и рекомендуемые поля

В таблицах ниже поля помечены как обязательные или рекомендуемые. При этом учитывайте следующие требования:

Поля, помеченные как Обязательно, должны быть заполнены участником аукциона.
Поля, помеченные как Рекомендуемые, не являются обязательными для покупателя, и издатель может не показывать их, даже если они заполнены (например, оценка).
Призыв к действию всегда помечается как рекомендуемый, поскольку если он не отправлен системой назначения ставок, то назначается по умолчанию. Если же он отправлен, то будет показан.

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

Поле	Описание	Обязательный или рекомендуемый?	Всегда ли показывается?	Рекомендуемый размер изображения/максимальное количество символов	Пример
Заголовок	Название приложения.	Обязательно	Да	25 символов	Flood-It!
Изображение	скриншот из приложения или другое подходящее изображение;	Обязательно	Нет	1200 x 627 или 600 x 600 пикселей в зависимости от соотношения сторон,которое требуется издателю.	<Скриншот игры Flood-It!>
Body	Основной текст приложения	Обязательно	Нет	90 символов	Простая на первый взгляд, но сложная на деле игра, от которой невозможно оторваться.
Значок приложения	Значок приложения	Обязательно	Нет	128 x 128 пкс	<Значок приложения Flood-it!>
Призыв к действию	Предпочтительное действие пользователя	Рекомендуется	Да	15 символов	Установить
Оценка	Количество звезд (от 0 до 5), обозначающее рейтинг приложения в магазине приложений.	Рекомендуется	Нет	0–5	4,5
Цена	стоимость приложения;	Рекомендуется	Нет	15 символов	Бесплатно

Примечания о длине текста

Если покупатель отправляет текстовый объект (например, основной текст), длина которого превышает рекомендуемое максимальное количество символов, Google или издатель могут сократить текст и заменить усеченную часть многоточием. Учтите, что ограничение для параметра "Может быть обрезано после" в текстах на китайском, корейском и японском языках вдвое меньше. Например, ограничение для заголовка на английском языке составляет 90 символов, а на китайском – 45 символов.

Примечания о размере изображений

Издателям разрешено:

Симметрично обрезать края, оставив не менее 80 % исходного изображения, только в одном измерении (по ширине или высоте).
Измените размер изображения, не меняя соотношение сторон.
Изображения, соотношение сторон которых существенно отличается от заданного, могут быть отфильтрованы.

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

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

Поле	Описание	Обязательный или рекомендуемый?	Всегда ли показывается?	Рекомендуемый размер изображения/максимальное количество символов *	Пример
Заголовок	Заголовок объявления	Обязательно	Да	25 символов	Самые низкие ставки по ипотеке
Изображение	Основное изображение для объявления	Обязательно	Нет	1200 x 627 или 600 x 600 пикселей в зависимости от соотношения сторон,которое требуется издателю.	<Основное изображение объявления>
Body	Содержание объявления	Обязательно	Нет	90 символов	Ваш дом в Бруклине – дешевле и быстрее, чем вы думаете!
Логотип	Логотип рекламодателя или другое небольшое изображение.	Рекомендуется	Нет	128 x 128 пкс	<NY Mortgage Inc.'s logo>
Призыв к действию	Предпочтительное действие пользователя	Рекомендуется	Нет	15 символов	Цены
Рекламодатель	Текст, идентифицирующий рекламодателя или бренд	Обязательно	Нет	25 символов	NY Mortgage Inc.

Шаблон видеообъявления, ориентированного на установку приложения

Поле	Описание	Обязательный или рекомендуемый?	Всегда ли показывается?	Рекомендуемый размер изображения/максимальное количество символов*	Пример
Видео	Ответ VAST со всеми объектами, необходимыми для воспроизведения видеообъявления.	Обязательно	Нет	-	URL XML-файла VAST, содержащего Flood-It! Видеообъявление
Заголовок	Название приложения.	Обязательно	Да	25 символов	Flood-It!
Изображение	Обычное или уменьшенное изображение, которое появляется в проигрывателе, прежде чем пользователь нажмет на видеообъявление или пока оно загружается.	Обязательно	Нет	Такое изображение должно иметь то же соотношение сторон, что и видео, например 16:9 для видео размером 1280 x 720 и 4:3 для формата 640 x 480.	Скриншот игры Flood-It! или из видео.
Body	Основной текст приложения	Обязательно	Нет	90 символов	Простая, но увлекательная игра, от которой невозможно оторваться.
Значок приложения	Значок приложения	Обязательно	Нет	128 x 128 пкс	Значок приложения Flood-it!
Призыв к действию	Предпочтительное действие пользователя	Обязательно	Да	15 символов	Установить
Оценка	Количество звезд (от 0 до 5), обозначающее рейтинг приложения в магазине приложений.	Рекомендуется	Нет	0–5	4,5
Цена	стоимость приложения;	Рекомендуется	Нет	15 символов	Бесплатно

Ограничения

Видео. Все видео должны быть в формате URL VAST или тега VAST. Нельзя указывать необработанные видеофайлы, например WebM, MP4 и т. д.
Длина текста. Если покупатель указывает в ответе текстовый объект, например body, Google или издатель может сократить текст и заменить усеченную часть многоточием. Учтите, что ограничение для параметра "Может быть обрезано после" в текстах на китайском, корейском и японском языках вдвое меньше. Например, ограничение для заголовка на английском языке составляет 90 символов, а на китайском – 45 символов.
Размер изображения. Издателям разрешено:
- Симметрично обрезать края, оставив не менее 80 % исходного изображения, только в одном измерении (по ширине или высоте).
- Измените размер изображения, не меняя соотношение сторон.

Пример объявления, ориентированного на установку приложения

Шаблон видеообъявления в контенте

Поле	Описание	Обязательный или рекомендуемый?	Всегда ли показывается?	Рекомендуемый размер изображения/максимальное количество символов*	Пример
Видео	Ответ VAST со всеми объектами, необходимыми для воспроизведения видеообъявления.	Обязательно	Да	-	URL XML-файла VAST, содержащего Flood-It! Видеообъявление
Заголовок	Заголовок объявления	Обязательно	Да	25 символов	Самые низкие ставки по ипотеке
Изображение	Обычное или уменьшенное изображение, которое появляется в проигрывателе, прежде чем пользователь нажмет на видеообъявление или пока оно загружается.	Обязательно	Нет	Такое изображение должно иметь то же соотношение сторон, что и видео, например 16:9 для видео размером 1280 x 720 и 4:3 для формата 640 x 480.	Скриншот из видео
Body	Содержание объявления	Обязательно	Нет	90 символов	Ваш дом в Бруклине – дешевле и быстрее, чем вы думаете!
Логотип	Логотип рекламодателя или другое небольшое изображение.	Рекомендуется	Нет	128 x 128 пкс	Логотип NY Mortgage Inc.
Призыв к действию	Предпочтительное действие пользователя	Обязательно	Нет	15 символов	Цены
Рекламодатель	Текст, идентифицирующий рекламодателя или бренд	Обязательно	Нет	25 символов	NY Mortgage Inc.

Метаполя

Следующие метаполя являются общими для всех поддерживаемых шаблонов объявлений:

Поле	Описание
`BidResponse.seatbid.bid.{adm/adm_native}.link.url`	URL конечной целевой страницы, на которую будет перенаправлен пользователь после нажатия на объявление. Это поле обязательно для динамических целевых страниц.
`BidResponse.seatbid.bid.{adm/adm_native}.link.clicktrackers`	Необязательное поле. Дополнительные URL, позволяющие рекламодателям отслеживать клики пользователей по объявлению.
`BidResponse.seatbid.bid.{adm/adm_native}.privacy`	Ссылка на страницу с рекламными предпочтениями или возможностью отказаться от нее. Если он указан, то стандартный значок "Выбор рекламы" будет добавлен в нативный креатив и связан с этим URL.
`BidResponse.seatbid.bid.{adm/adm_native}.eventtrackers`	Отслеживание показов можно выполнять, включив в ответ на запрос нативного объявления объект `eventtrackers`, в котором для параметра `event` задано значение `IMPRESSION`.

Представление шаблона нативного объявления в запросе ставки

Запрос ставки, содержащий нативный инвентарь, будет включать шаблон нативного объявления, представленный сообщением NativeRequest OpenRTB. В нем содержится следующая информация о нативном рекламном инвентаре:

Объекты, которые являются необязательными или обязательными.
Размеры изображений, логотипов и значков приложений.
Спецификации стиля, в котором показывается объявление.

Примечание. В случае с BidRequest.imp.native.{request/request_native}.ext.style_layout_type значение PIXEL указывает на то, что нативный блок имеет фиксированный размер, а FLUID – что он масштабируется, заполняя ширину столбца, в котором находится, и корректирует высоту, чтобы сохранить соотношение сторон. Если задан параметр FLUID, высота и ширина могут быть равны 1 x 1.

Обязательные и необязательные объекты

Обязательные и необязательные объекты для показа нативного объявления перечислены в BidRequest.imp.native.{request/request_native}.assets. В нем описываются компоненты нативного объявления, такие как заголовок, основной текст или логотип. Каждый объект, включенный в запрос, имеет отдельный id и заполняет required как True для тех, которые должны быть включены в ответ на запрос ставки.

Представление нативного объявления в ответе на запрос ставки

При назначении ставок на нативный инвентарь необходимо включить объект NativeResponse, заполненный обязательными объектами, указанными в запросе ставки. Также можно включить любые указанные необязательные объекты. Их можно включить в ответ на запрос ставки с помощью BidResponse.seatbid.bid.{adm/adm_native}.assets. Если вы заполняете поле assets в ответе, то в каждом из них должно быть указано значение id, соответствующее объекту из запроса ставки.

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

OpenRTB Protobuf

Показать пример

Сериализованный запрос

id: "a7gs668pOD71593174WD18"
imp {
  id: "1"
  tagid: "7726142771"
  bidfloor: 3.0
  bidfloorcur: "JPY"
  secure: true
  native {
    ver: "1.2"
    battr: VIDEO_IN_BANNER_AUTO_PLAY
    battr: VIDEO_IN_BANNER_USER_INITIATED
    request_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          len: 50
        }
      }
      assets {
        id: 2
        required: true
        data {
          type: DESC
          len: 150
        }
      }
      assets {
        id: 3
        data {
          type: CTATEXT
          len: 15
        }
      }
      assets {
        id: 4
        required: true
        data {
          type: SPONSORED
          len: 25
        }
      }
      assets {
        id: 5
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      assets {
        id: 6
        img {
          type: ICON
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
      [com.google.doubleclick.native_ext] {
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
        pos: BELOW_THE_FOLD
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0013161331880837679
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.19
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 38603336997
    billing_id: 47507501249
    publisher_settings_list_id: 9289903210874537962
    publisher_settings_list_id: 6708162754299115972
    allowed_vendor_type: 0
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    adlocx: 1181
    adlocy: 4033
    iframeorigin: IFRAME_ORIGIN_CROSS_DOMAIN
  }
}
site {
  pagecat: "IAB11"
  pagecat: "IAB12"
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "KR"
    }
  }
  content {
    language: "ko"
  }
  cattax: IAB_CONTENT_1_0
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  ip: "210.103.83.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "KOR"
    region: "KR-26"
    city: "Busan"
    type: IP
    utcoffset: 540
    accuracy: 3076
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9196748
    }
  }
  language: "ko"
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  w: 1920
  h: 1080
  pxratio: 1.0
  sua {
    browsers {
      brand: "Microsoft Edge"
      version: "155"
      version: "0"
    }
    browsers {
      brand: "Chromium"
      version: "155"
      version: "0"
    }
    platform {
      brand: "Windows"
      version: "19"
      version: "0"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
  [com.google.doubleclick.device] {
    memory: 16384
    scrollposx: 0
    scrollposy: 0
  }
}
user {
  id: "t2V4X1j21X7dPujU0hCi1F3464d"
  buyeruid: "65y1395x4H34c41A2LY13OqR7mx7a94x"
  customdata: "q0ayp134g2DrY7aXW8oXi438hAH196W654gJK5L8304N5d9Y"
  [com.google.doubleclick.user] {
    idage: 18144000
  }
}
at: FIRST_PRICE
tmax: 350
cur: "GBP"
cur: "BRL"
bcat: "4"
bcat: "5"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zL23dM-K888C926iz54pL02I4wa4sXX04N9233701g8h787afvX78G815DcjFi573537"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_BROWSER
  privacy_treatments {
    allow_user_data_collection: true
  }
}

OpenRTB JSON

Показать пример

{
  "id": "a7gs668pOD71593174WD18",
  "imp": [
    {
      "id": "1",
      "tagid": "7726142771",
      "bidfloor": 3.0,
      "bidfloorcur": "JPY",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "battr": [
          6,
          7
        ],
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":50}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":150}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"data\":{\"type\":1,\"len\":25}},{\"id\":5,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":6,\"img\":{\"type\":1}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_height\":1,\"style_width\":1,\"style_layout_type\":1,\"pos\":3}}"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0013161331880837679,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.19,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "38603336997",
          "47507501249"
        ],
        "publisher_settings_list_id": [
          "9289903210874537962",
          "6708162754299115972"
        ],
        "allowed_vendor_type": [
          0
        ],
        "ampad": 3,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 1,
          "publisher_blocks_enforcement": 1
        },
        "adlocx": 1181,
        "adlocy": 4033,
        "iframeorigin": 2
      }
    }
  ],
  "site": {
    "pagecat": [
      "IAB11",
      "IAB12"
    ],
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "KR"
      }
    },
    "content": {
      "language": "ko"
    },
    "cattax": 1,
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "ip": "210.103.83.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "KOR",
      "region": "KR-26",
      "city": "Busan",
      "type": 2,
      "utcoffset": 540,
      "accuracy": 3076,
      "ext": {
        "geo_criteria_id": 9196748
      }
    },
    "language": "ko",
    "os": "Windows",
    "devicetype": 2,
    "w": 1920,
    "h": 1080,
    "pxratio": 1.0,
    "sua": {
      "browsers": [
        {
          "brand": "Microsoft Edge",
          "version": [
            "155",
            "0"
          ]
        },
        {
          "brand": "Chromium",
          "version": [
            "155",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Windows",
        "version": [
          "19",
          "0"
        ]
      },
      "mobile": 0,
      "architecture": "x86",
      "bitness": "64",
      "source": 2
    },
    "ext": {
      "memory": 16384,
      "scrollposx": 0,
      "scrollposy": 0
    }
  },
  "user": {
    "id": "t2V4X1j21X7dPujU0hCi1F3464d",
    "buyeruid": "65y1395x4H34c41A2LY13OqR7mx7a94x",
    "customdata": "q0ayp134g2DrY7aXW8oXi438hAH196W654gJK5L8304N5d9Y",
    "ext": {
      "idage": 18144000
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "GBP",
    "BRL"
  ],
  "bcat": [
    "4",
    "5"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    }
  },
  "cattax": 500,
  "ext": {
    "google_query_id": "ANy-zL23dM-K888C926iz54pL02I4wa4sXX04N9233701g8h787afvX78G815DcjFi573537",
    "fcap_scope": 2,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

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

OpenRTB Protobuf

Показать пример

Сериализованный ответ

id: "DRwnt322cRi7u1T634W122"
seatbid {
  bid {
    id: "701eVj9OsVYY150G028"
    impid: "1"
    price: 3.01774001121521
    crid: "test_creative_id_168019"
    dealid: "0"
    adm_native {
      ver: "1.2"
      assets {
        id: 5
        img {
          url: "https://native.test.com/image?id=123456"
          w: 800
          h: 800
          type: MAIN
        }
      }
      assets {
        id: 4
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      ad_choices_destination_url: "https://test.com/preferences"
      event_notification_token {
        payload: "token"
      }
      billing_id: 38603336997
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 40
}

OpenRTB JSON

Показать пример

{
  "id": "DRwnt322cRi7u1T634W122",
  "seatbid": [
    {
      "bid": [
        {
          "id": "701eVj9OsVYY150G028",
          "impid": "1",
          "price": 3.01774001121521,
          "crid": "test_creative_id_168019",
          "dealid": "0",
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ],
            "ad_choices_destination_url": "https://test.com/preferences",
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "38603336997",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          },
          "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":5,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":800,\"h\":800,\"type\":3}},{\"id\":4,\"data\":{\"value\":\"Galactic Luxury Cruises\",\"type\":1}},{\"id\":3,\"data\":{\"value\":\"Book today\",\"type\":12}},{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\",\"type\":2}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]}}"
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 40
  }
}

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

Форматы сообщений

OpenRTB JSON (обработанный)

OpenRTB Protobuf

Шаблоны нативных объявлений

Шаблон объявления, ориентированного на установку приложения

Обязательные и рекомендуемые поля

Примечания о длине текста

Примечания о размере изображений

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

Шаблон видеообъявления, ориентированного на установку приложения

Ограничения

Пример объявления, ориентированного на установку приложения

Шаблон видеообъявления в контенте

Метаполя

Представление шаблона нативного объявления в запросе ставки

Обязательные и необязательные объекты

Представление нативного объявления в ответе на запрос ставки

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

OpenRTB Protobuf

Показать пример

OpenRTB JSON

Показать пример

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

OpenRTB Protobuf

Показать пример

OpenRTB JSON

Показать пример

Нативные объявления