Руководство по интеграции OpenRTB DSP

Введение

Этот документ описывает все технические аспекты подключения DSP (Demand-Side Platforms) к платформе MGID SSP.

Для более детальной информации о real time bidding мы рекомендуем скачать итоговую спецификацию OpenRTB 2.5 по ссылке ниже:

OpenRTB-API-Specification-Version-2-5-FINAL.pdf

Информацию о реализации Native рекламы для RTB можно найти здесь:

https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-Native-Ads-Specification-1-1_2016.pdf

 

История изменений документа

Версия Список изменений Дата
1.0 Начальная версия 19.04.2018
1.01 Добавлены рекомендации по размеру ставки 25.04.2018
1.02 Добавлено описание поля BidResponse.bid.crid 27.04.2018
1.03 Добавлены макросы для imptrackers 31.08.2018
1.04 Добавлено поле site.cat 24.09.2018
1.05 Исправлены ошибки в описании параметра adm 05.10.2018
1.06 Добавлено поле pchain 08.10.2018
1.07 Поле BidResponse.bid.crid изменено на обязательное 16.10.2018
1.08 Добавлены поля BidResponse.banner, поле BidResponse.bid.burl а также примеры bid request и bid response для banner 17.10.2018
1.09 Добавлен родительский объект native в native bidrequest payload (BidRequest.imp[].native.request) 31.10.2018
1.10 Добавлен BidRequest.user.ext.pageview_number 15.11.2018
1.11 Добавлена поддержка макросов в BannerResponse.seatbid[].bid[].adm 16.11.2018
1.12 Добавлен BidRequest.device.os 26.12.2018
1.13 Добавлены примеры  bid request и bid response для native-push 11.01.2019

 

Общая информация

Платформа MGID SSP поддерживает протокол OpenRTB 2.5 banner и native 1.1. На стороне SSP поддерживаются претаргетинги по различным параметрам (детальнее в пункте 8)

Особенности

Ведение статистики:

  • основная статистика ведется на стороне SSP
  • списание средств происходит по выигрышу в аукционе
  • вызов NURL переданных в ответе происходит по выигрышу в аукционе, в случае отсутствия NURL'ов в ответах от DSP расхождения в статистике рассматриваться не будут
  • разбирательства в случае расхождений в статистиках проводятся в случае расхождения более чем на n % (по договору). Сравнение проводится по количеству выигранных мест (отправленных nurl).соответственно статистики сравниваются по количеству выигранных мест в аукционах

Объем отправляемых bid requests

SSP уменьшает RPS для DSP от которых много timeouts., При количестве timeouts count больше 5000 за 10 сек на каждый инстанс SSP полностью перестает отправлять bid requests запросы прекратятся вовсе.

 

Процесс интеграции

Стандартный процесс подключения новой DSP в системе MGID выглядит следующим образом:

  1. Клиент ознакамливается с данным документом, если нужно задает дополнительные уточняющие вопросы, подтверждает  готовность работы по описанной схеме
  2. Клиент предоставляет подготовленный эндпоинт
  3. Клиент пополняет счет в системе MGID
  4. Для проверки правильности технической интеграции проводятся тесты на малых объемах трафика (перед началом тестирования валидности запросов-ответов DSP должно сообщить о начале тестирования)
  5. Проводится сверка статистик выигранных показов SSP и DSP за время теста
  6. В случае расхождений MGID предоставляем список всех вызванных NURL'ов, чтобы DSP могла определить проблемное место и повторить пункты 4 и 6
  7. Клиент подтверждает готовность к запуску
  8. Проводится полноценный запуск на весь трафик, который клиент выбрал в претаргетинге.

BidRequest

Описание поддерживаемых параметров

bidrequest: объекты и параметры

Атрибут Тип Описание
id string; always Уникальный ID запроса
tmax integer; default 150 ms Максимальное время ожидания ответа от DSP
imp object array; always Массив объектов, состоящий из imp. Cм. "imp: объекты и параметры"
site object; always Подробная информация по сайту
device object; always Подробная информация об устройстве пользователя
at integer; default 2 Аукцион второй цены включен
user object; always Подробная информация о пользователе
cur string; array Массив разрешенных валют на торги по запросу этой заявки с использованием ISO-4217.
bcat string; array Заблокированные категории рекламодателей, использующих категории IAB
ext object Используется для расширения параметров запроса

source: параметры

Атрибут Тип Описание
pchain string;
recommended
Идентификатор платежа, содержащий встроенный синтаксис, описанный в протоколе TAG Payment ID Protocol v1.0.

device: параметры

Атрибут Тип Описание
dnt integer; always Параметр отслеживания. 0 = разрешено, 1 = запрещено
devicetype integer Тип устройства
geo.country string Код страны с помощью ISO-3166-1-alpha-3
language string Язык браузера с помощью ISO-639-1-alpha-2
js integer Поддержка JavaScript 0 = нет, 1 = да.
ua string; always Юзер агент браузера
ip string; always Ближайший IP адрес устройства. Может использоваться IPv4
os string Операционная система устройства

user: параметры

Атрибут Тип Описание
id string; always Идентификатор пользователя MGID
buyerid string; sometimes Идентификатор пользователя в системе партнера. Если нет кукиматчинга, то шлется пустым.
buyeruid string; sometimes Идентификатор пользователя в системе партнера. Если нет кукиматчинга, то шлется пустым.
ext object Используется для расширения параметров запроса

Примечание: buyerid equals buyeruid

user.ext: параметры

Атрибут Тип Описание
pageview_number integer Количество переходов пользователя в рамках одной сессии

ext: параметры

Атрибут Тип Описание
ad_types array; custom Кастомные категории на основе рейтинговой системы MPAA.
imgSizeId integer; custom Внутренне системный id размера картинки, размеры картинки также передаются в соответствующих полях hmin, wmin.
category integer; custom id категории сайта по внутренней классификации MGID.

site: параметры

Атрибут Тип Описание
id string; always ID сайта в системе MGID
name string;sometimes Подробная информация по сайту
ref string; sometimes URL-адрес реферера, который перешел по текущей странице.
domain string; sometimes Домен сайта
page string; sometimes URL страницы, с которой пришел запрос
cat string array; sometimes IAB категория сайта
publisher.id string; always Идентификатор паблишера в системе MGID
publisher.name string; sometimes Имя паблишера

imp: объекты и параметры

Атрибут Тип Описание
id string; always  Уникальный идентификатор представления
instl integer; default 0 Промежуточное объявление на весь экран, появляющееся до отображения целевого сайта. 1-включено, 0-выключено
native object; Обязателен, если предполагается показ Native Ad
banner object; Обязателен, если предполагается показ Banner Ad
bidfloor float; sometimes; default 0 Минимальная ставка показа в CPM.
secure integer Флаг, указывающий на использование HTTPS URL 0 = HTTP, 1 = HTTPS

Примечания: imp.bidfloor поле передаваемое в запросе - это сумма bidfloor'ов мест по информеру

native: объекты и параметры

Атрибут Тип Описание
request string; always Параметры запроса
ver string; always Версия спецификаций Native Ad, которой соответствует запрос
battr integer array Заблокированные атрибуты

Атрибут Тип Описание
id string Уникальный идентификатор баннера.
w integer Точная ширина в независимом от устройства пикселях (DIPS)
h integer Точная высота в независимом от устройства пикселях (DIPS)

request: параметры

Атрибут Тип Описание
ver optional; string Версия нативной разметки
layout recommended; integer ID макета
adunit recommended; integer ID рекламного блока
plcmtcnt optional; integer; default 1 Количество одинаковых размещений в этом шаблоне.
plcmttype optional; integer Формат рекламного блока.
assets required; array of objects Массив объектов. Каждая ставка должна соответствовать заданным условиям в данном массиве.

assets: параметры

Атрибут Тип Описание
id required; int Уникальный ID ассетa
required optional; int; default 0 1 если asset обязателен (ставка не будет принята без его заполнения)
title optional; object Текстовый объект.
img optional; object Графический объект.
data optional; object Данные объекта для цен, рейтингов и т.д.

Примечание: Каждый asset может состоять только из одного объекта title|img|data

title: параметры

Атрибут Тип Описание
len required; integer Максимальная длина текста в элементе title.

img: параметры

Атрибут Тип Описание
type optional; integer Идентификатор изображения.
w optional; integer Ширина изображения в пикселях
wmin recommended; integer Минимальная ширина изображения в пикселях
h optional; integer Высота изображения в пикселях
hmin recommended; integer Минимальная высота изображения в пикселях
mimes optional; array of strings; default All types Cписок поддерживаемых типов содержимого MIME.

data: параметры

Атрибут Тип Описание
type required; integer Идентификатор типа элемента
len optional; integer Максимальное к-во символов объекта

Пример BidRequest

Native

{
   "id":"0b95904b-38e5-11e8-9ae2-141877676018",
   "tmax":150,
   "at":2,
   "device":{
      "dnt":0,
      "devicetype":2,
      "js":1,
      "ip":"36.76.94.171",
      "os":"iOS",
      "ua":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.94 Safari/537.36",
      "language":"en",
      "geo":{
         "country":"IDN"
      }
   },
   "user":{
      "id":"h6cOQQM5nUC0",
      "buyerid":"",
      "buyeruid":"",
      "ext":{
            "pageview_number": 2
       }
   },
   "ext":{
      "ad_types":[
         "pg",
         "r",
         "nc17",
         "nsfw"
      ],
      "imgSizeId":19,
      "category":101
   },
   "site":{
      "id":"5646077",
      "domain":"example.com",
      "page":"http://example.com/",
      "ref":"http://example.com/example?page=2",
      "name":"example.com",
      "cat":[ "IAB1" ],
      "publisher":{
         "id":"284527",
         "name":"example.com"
      }
   },
   "cur":[
      "USD",
      "RUB",
      "UAH"
   ],
   "bcat":[
      "IAB13",
      "IAB13-7",
      "IAB18",
      "IAB19"
   ],
   "imp":[
      {
         "id":"1",
         "bidfloor":0.09382198952879581,
         "instl":0,
         "secure":0,
         "native":{
            "request":"{\"native\":{\"ver\":\"1\",\"layout\":1,\"adunit\":2,\"plcmtcnt\":4,\"plcmttype\":2,\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":90}},{\"id\":2,\"required\":1,\"img\":{\"wmin\":492,\"hmin\":328,\"type\":3,\"mimes\":[\"image/jpeg\",\"image/png\"]}},{\"id\":3,\"required\":0,\"data\":{\"type\":2,\"len\":75}},{\"id\":4,\"required\":0,\"data\":{\"type\":6}},{\"id\":5,\"required\":0,\"data\":{\"type\":7}},{\"id\":6,\"required\":0,\"data\":{\"type\":11}}]}}\n",
            "ver":"1.2",
            "battr":[
               1,
               2,
               3,
               4,
               5,
               6,
               8,
               9,
               10,
               14
            ]
         }
      }
   ],
  "source":{ 
      "pchain":"d4c29acad76ce94f:5651930" 
   }
}

{
   "id":"9f6f2cd6-d12c-11e8-aa98-246e96c2aeb2",
   "tmax":150,
   "at":2,
   "device":{
      "dnt":0,
      "devicetype":2,
      "js":1,
      "ip":"113.160.142.178",
      "os":"iOS",
      "ua":"Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/69.0.3497.100 Safari/537.36",
      "language":"vi",
      "geo":{
         "country":"VNM"
      }
   },
    "user":{
      "id":"i6cUg3WiSxhh",
      "buyerid":"",
      "buyeruid":"",
      "gender":"",
      "yob":0,
      "ext":{
            "pageview_number": 2
       }
   },
   "ext":{
      "ad_types":[
         "pg",
         "r",
         "nc17",
         "nsfw"
      ],
      "imgSizeId":19,
      "category":145,
      "informerId":87107,
      "subid":"5651930_0"
   },
   "site":{
      "id":"5651930",
      "domain":"example.net",
      "page":"http://example.net/dantri.html",
      "ref":"https://www.google.com.vn/",
      "name":"example.net",
      "publisher":{
         "id":"189470",
         "name":"example.net"
      },
      "cat":[
         "IAB1"
      ]
   },
   "publisher":{

   },
   "cur":[
      "USD",
      "RUB",
      "UAH"
   ],
   "imp":[
      {
         "id":"1",
         "bidfloor":0.14011511111111108,
         "instl":0,
         "secure":1,
         "banner":{
            "id":"",
            "w":300,
            "h":250
         }
      }
   ],
   "source":{
      "pchain":"d4c29acad76ce94f:5651930"
   }
}

Native-push

{
  "id": "42cd21cb-f882-11e8-b79c-246e96c2aeb2",
  "tmax": 150,
  "at": 2,
  "device": {
    "dnt": 0,
    "devicetype": 4,
    "js": 1,
    "ip": "31.173.83.243",
    "ua": "Mozilla/5.0 (Linux; Android 8.0.0; SM-J330F) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.110 Mobile Safari/537.36",
    "language": "ru",
    "geo": {
      "country": "RUS"
    }
  },
  "user": {
    "id": "5b759b5c6a4278993c107fb8",
    "ext": {
      "pageview_number": 1
    }
  },
  "ext": {
    "ad_types": [
      "pg",
      "r",
      "nc17",
      "nsfw"
    ],
    "imgSizeId": 19,
    "category": 0,
    "informerId": 6650,
    "subid": "5714200_0"
  },
  "site": {
    "id": "5714200",
    "domain": "example.com",
    "name": "example.com",
    "publisher": {
      "id": "101924",
      "name": "example.com"
    }
  },
  "publisher": {
    
  },
  "cur": [
    "USD",
    "RUB",
    "UAH"
  ],
  "bcat": [
    "IAB23",
    "IAB24",
    "IAB25",
    "IAB26",
    "IAB9-5",
    "IAB9-7",
    "IAB9-30"
  ],
  "imp": [
    {
      "id": "1",
      "bidfloor": 0.008473298429319372,
      "instl": 0,
      "secure": 1,
      "native": {
        "request": "{\"ver\":\"1\",\"layout\":1,\"adunit\":2,\"plcmtcnt\":1,\"plcmttype\":4,\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":75}},{\"id\":2,\"required\":1,\"img\":{\"wmin\":492,\"hmin\":328,\"type\":3,\"mimes\":[\"image/jpeg\",\"image/png\"]}},{\"id\":3,\"required\":0,\"data\":{\"type\":2,\"len\":75}},{\"id\":4,\"required\":0,\"data\":{\"type\":6}},{\"id\":5,\"required\":0,\"data\":{\"type\":7}},{\"id\":6,\"required\":0,\"data\":{\"type\":11}}]}\n",
        "ver": "1.1",
        "battr": [
          1,
          2,
          3,
          4,
          5,
          6,
          8,
          9,
          10,
          14
        ]
      }
    }
  ],
  "source": {
    "pchain": "d4c29acad76ce94f:5714200"
  }
}

 

BidResponse

Описание поддерживаемых параметров

Object: BidResponse

Атрибут Тип Описание
id string; required ID bid request'a
seatbid object array Массив seatbid объектов
cur string; default "USD" Валюта ставки в ISO-4217

Object: SeatBid

Атрибут Тип Описание
bid object array; required Массив bid объектов (ставок).
group integer; default 0 0 = можно выиграть в индивидуальном порядке; 1 = должны быть выиграны или проиграны только группой

Примечание: ставки со значением "group" 1 не принимаются

Object: Bid

Атрибут Тип Описание
id string; required Идентификатор ставки
impid string; required ID объекта Imp в соответствующем запросе ставки
price float; required Предложенная цена, выражается как CPM
nurl string; highly recommended URL уведомления о выигрыше. Дополнительное средство для разметки рекламных объявлений. Макросы могут быть включены как в URL-адрес, так и в необязательную возвращенную разметку. Поддерживаемые макросы:

  • ${AUCTION_PRICE}
  • ${AUCTION_ID}
  • ${AUCTION_BID_ID}
  • ${AUCTION_PLACE_NUMBER}
  • ${AUCTION_CURRENCY}
burl string; highly recommended URL уведомления о выигрыше. Дополнительное средство для разметки рекламных объявлений. Макросы могут быть включены как в URL-адрес, так и в необязательную возвращенную разметку. Поддерживаемые макросы:

  • ${AUCTION_PRICE}
  • ${AUCTION_ID}
  • ${AUCTION_BID_ID}
  • ${AUCTION_PLACE_NUMBER}
  • ${AUCTION_CURRENCY}
adm string Cредство передачи рекламной разметки в случае выигрыша ставки
crid string; required ID креатива, который используется для проверки качества рекламы

Примечание: для участия в аукционе bid.price должен быть больше чем bidfloor разделенный на количество мест в рекламном блоке:

bid.price > imp.bidfloor / imp.native.request.plcmtcnt

Native Markup Response Object (seatbid.bid.adm)

Атрибут Тип Описание
ver optional string Версия используемой версии Native Markup.
assets required array of objects Список активных ассетов
link required object Целевая ссылка. Объект ссылки по умолчанию для объявления. Отдельные ассеты могут также иметь объект ссылки, который применяется, если ассет активирован (кликом).
imptrackers optional array of strings Массив отслеживания показов URL, ожидает 1x1 изображение или 204 ответ. Поддерживаемые макросы:

  • ${AUCTION_PRICE}
  • ${AUCTION_ID}
  • ${AUCTION_BID_ID}
  • ${AUCTION_PLACE_NUMBER}
  • ${AUCTION_CURRENCY}

Примечания: 

  • Должен быть валидным XHTML.
  • Поддерживаемые макросы:
    • ${AUCTION_PRICE}
    • ${AUCTION_ID}
    • ${AUCTION_BID_ID}
    • ${AUCTION_PLACE_NUMBER}
    • ${AUCTION_CURRENCY}

Пример BidResponse 

Native

{
    "id":"d76d6bc2-ccf1-4c13-a296-8830496d4c28",
    "cur":"USD",
    "seatbid":[
                {
                "group":0,
                "bid":[
                                  {
                            "id":"1",
                            "impid":"1",
                            "price":10,
               "nurl":"http://nurl",
                     "adm":"{\"native\":{\"imptrackers\":[],\"ver\":"1",\"link\":{\"url\":\"deeplink://deeplink/url/into/app1\"},\"assets\":[{\"id\":1,\"title\":{\"text\":\"titletext1\"}},{\"id\":2,\"data\":{\"value\":\"5\"},\"img\":{\"url\":\"http://cdn.mobad.com/ad1.png\",\"w\":64,\"h\":64}},{\"id\":3,\"data\":{\"value\":\"descriptiontext1\"}},{\"id\":4,\"data\":{\"value\":\"goodsprice\"}},{\"id\":5,\"data\":{\"value\":\"goodsoldprice\"}}]}}"                         
            },
                                  {
                            "id":"1",
                            "impid":"1",
                            "price":10,
               "nurl":"http://nurl",
                      "adm":"{\"native\":{\"imptrackers\":[],\"ver\":"1",\"link\":{\"url\":\"deeplink://deeplink/url/into/app2\"},\"assets\":[{\"id\":1,\"title\":{\"text\":\"titletext2\"}},{\"id\":2,\"data\":{\"value\":\"5\"},\"img\":{\"url\":\"http://cdn.mobad.com/ad2.png\",\"w\":64,\"h\":64}},{\"id\":3,\"data\":{\"value\":\"descriptiontext2\"}},{\"id\":4,\"data\":{\"value\":\"goodsprice\"}},{\"id\":5,\"data\":{\"value\":\"goodsoldprice\"}}]}}"                         
            },
                                  {
                            "id":"1",
                            "impid":"1",
                            "price":10,
               "nurl":"http://nurl",
                          "adm":"{\"native\":{\"imptrackers\":[],\"ver\":"1",\"link\":{\"url\":\"deeplink://deeplink/url/into/app3\"},\"assets\":[{\"id\":1,\"title\":{\"text\":\"titletext3\"}},{\"id\":2,\"data\":{\"value\":\"5\"},\"img\":{\"url\":\"http://cdn.mobad.com/ad3.png\",\"w\":64,\"h\":64}},{\"id\":3,\"data\":{\"value\":\"descriptiontext3\"}},{\"id\":4,\"data\":{\"value\":\"goodsprice\"}},{\"id\":5,\"data\":{\"value\":\"goodsoldprice\"}}]}}"                         
            }                   
         ]             
      }       
   ]
}

Здесь объект "adm" содержит зашифрованный json, который выглядит так (приведен только один объект "adm" как пример):

{
   "native":{
         "imptrackers":[

      ],
         "ver":"1",
         "link":{
               "url":"deeplink://deeplink/url/into/app1"            
      },
         "assets":[
                        {
                     "id":1,
                     "title":{
                           "text":"title text1"                        
            }                  
         },
                        {
                     "id":2,
                        "img":{
                           "url":"http: //cdn.mobad.com/ad1.png",
                           "w":64,
                           "h":64                        
            }                  
         },
                        {
                     "id":3,
                     "data":{
                           "value":"description text1"                        
            }                  
         },
                        {
                     "id":4,
                     "data":{
                           "value":"goods price"                        
            }                  
         },
                        {
                     "id":5,
                     "data":{
                           "value":"goods old price"                        
            }                  
         }            
      ]
   }
}

{
   "id":"fd0f730c-d12c-11e8-aa98-246e96c2aeb2",
   "bidid":"85a13a21362470440de13f5a5820834d",
   "seatbid":[
      {
         "bid":[
            {
               "id":"256e8e0df1f027c471901e6de3abe121",
               "w":300,
               "h":250,
               "impid":"1",
               "price":1.1271,
               "nurl":"http://us-e10.example.com/?action=nurl&auction=${AUCTION_PRICE}&uniq=17773f575597e2a523e",
               "adm":"<script type='text/javascript'>var site = '9db5e526900d'; </script>\r\n<script type='text/javascript' src=\"https://s3.example.com/6eda-4955-994c-992fb/general.js\"></script><img src='https://us-e-node14.example.com/?tpw=i&spr=1.28959&dp=39_e25f791c51cc62a99878ab368d54c9ab&t=bn&hash=967d0f6cd0aabb9ad3d1e8850d600e7b' border='0' width='1' height='1'><script async src='https://us.example.com/setck?p=b02fe53b2efd4bf0d8f581865a26d046'></script><img src=\"https://us-e10.example.com/?action=impression&auction=${AUCTION_PRICE}&uniq=17773f575597e2a523e\" border=\"0\" width=\"1\" height=\"1\">",
               "adomain":[
                  "example.com"
               ],
               "cat":[
                  "IAB1",
                  "IAB9"
               ],
               "attr":[
                  4
               ],
               "adid":"1017c9590a27",
               "iurl":"http://us-e10.example.com/?action=iurl_&uniq=1017c9590a27",
               "cid":"39_ccb3afd6f-992a-4165-81dc-fdb4f|291",
               "crid":"39_rcb3afd6f-992a-4165-81dc-fdb4f|291"
            }
         ],
         "seat":"291"
      }
   ],
   "cur":"USD"
}

Native-push

{
  "id": "42cd21cb-f882-11e8-b79c-246e96c2aeb2",
  "seatbid": [
    {
      "bid": [
        {
          "id": "42d03c38f88211e884a70242ac110003-1-1822",
          "impid": "1",
          "price": 0.09790000000000001,
          "adid": "50-3c24960c684a1504d06c81446a480ea1",
          "adm": "{\"native\":{\"assets\":[{\"id\":1,\"title\":{\"text\":\"titletext1"\"}},{\"id\":2,\"img\":{\"url\":\"https://example.com/t/?s=91&a=42d03c38f88211e884a70242ac11000\",\"type\":3,\"w\":492,\"h\":328}},{\"id\":3,\"data\":{\"value\":\"titletext2\"}},{\"id\":6,\"data\":{\"value\":\"titletext3\"}}],\"link\":{\"url\":\"https://example.com/c/?s=91&a=42d03c38f88211e884a70242ac110003&b=42d03c38\",\"clicktrackers\":[\"https://example.com/c/?cn=1&s=91&a=42d03c38f88211e884a70242ac\"]}}}",
          "adomain": [
            "example.com"
          ],
          "cid": "50-417",
          "crid": "50-3c24960c684a1504d06c81446a480ea1",
          "cat": [
            "IAB13"
          ],
          "burl": "http://example.com/w/?s=91&p=${AUCTION_PRICE}&a=42d03c38f88211e884a70242ac110003&b=42d03c38f88211e884a70242ac110003-1-1822",
          "lurl": "http://example.com/l/?s=91&p=${AUCTION_PRICE}&l=${AUCTION_LOSS}&a=42d03c38f88211e884a70242ac110003&b=42d03c38f88211e884a70242ac110003-1-1822",
          "language": "ru"
        }
      ],
      "seat": "50-24289"
    }
  ],
  "cur": "USD"
}

 

Настройки таргетинга ТРК

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

  • по гео (страны и регионы)
  • по типу устройств и операционной системе
  • по браузеру
  • по тематике рекламных площадок

Cookie matching

По умолчанию MGID SSP поддерживает хранение матчинга на стороне SSP и DSP инициацию. Для сматченых пользователей, будут отправлены и SSP UID, и DSP UID в полях bidRequest.user.id и bidRequest.user.buyeruid соответственно (подробнее в пункте 6) . В случае, если пользователь новый, будет отправлен только SSP UID (bidRequest.user.id).

Для DSP-initiated-матчинга SSP предоставляет URL вида

http(s)://cm.mgid.com/m?cdsp=XXXX&c=YYYY&adu=ZZZZ

где:

  • XXXX – ID пикселя в системе MGID (для получения ID обратитесь к тех. аккаунт менеджеру)
  • YYYY – идентификатор пользователя в системе партнера DSP (не должен содержать спецсимволов. Все специальные символы должны быть закодированы (urlencode))
  • ZZZZ –  URL матчинга может выполнить редирект на URL, заданный DSP. URL должен быть указан в urlencoded-виде в параметре. Устанавливается по предварительной договоренности по умолчанию отключен. Протокол adu должен соответствовать протоколу исходного запроса на матчинг.

Bidding recommendations

Для эффективного выкупа MGID рекомендует придерживаться следующих пунктов:

  1. Правильно настроить претаргетинг для того, чтобы получать запросы только об интересующих показах и не фильтровать лишние показы на стороне DSP.
  2. Учитывать, что bidfloor указан за весь показ. То есть, при расчете ставки за одно тизероместо необходимо делить bidfloor на plcmtcnt.
  3. Для увеличения вероятности выигрыша рекомендуется делать ставку на 20-30% выше bidfloor.
  4. Если DSP каким-то образом для подбора рекламы использует данные о пользователе, то обязательно необходимо настраивать cookie matching.
  5. MGID рекомендует анализировать и оптимизировать ставки, учитывая следующие параметры в bid request:
    1. site.id
    2. devicetype
    3. ua
    4. country
    5. user.ext.pageview_number

Appendix A  ext.ad_types

Тип Описание
PG Красивая релевантная картинка, релевантные и уместные тексты без перебора, "желтизны", сильных преувеличений.
R Допускается нерелевантный контент, картинки не очень приятного, не слишком эстетичного содержания, "желтые" тексты, преувеличение смысла.
NC17 Картинки самого неприятного содержания, болезни, неэстетичные сюжеты, близкий ракурс, много голого тела в информере. Тексты тут, как правило, второстепенны.
NSFW Картинки и тексты откровенно сексуального содержания.

Appendix B  ext.imgsizeid

imgsizeid width height
0 0 0
1 45 45
2 75 75
3 60 60
4 120 120
5 200 200
6 80 53
7 100 75
8 140 140
9 90 90
10 100 60
11 170 90
12 300 200
13 150 100
14 370 200
15 180 120
16 260 170
17 200 150
18 328 328
19 492 328
20 160 100
21 220 135
22 200 100
23 300 260

Appendix C  ext.category

category name
100 Книги и Литература
101 Комиксы
102 Чтение онлайн
103 Фильмы
104 Музыка
105 Игры
106 Авто-вело-мото
107 Бизнес и Финансы
108 Карьера
109 Образование
110 Здоровый Образ Жизни
111 Хобби и Развлечения
112 Искусство и Ремесла
113 Юмор
114 Для Дома и Дачи
115 Семья и Отношения
116 Дети и Родители
117 Психология и Отношения
118 Знакомства
119 Культура и Искусство
120 Еда и Напитки
121 Здоровье
122 Новости и Политика
123 Новости
124 Политика
125 Погода
126 Животный Мир
127 Религия и Духовность
128 Астрология
129 Наука
130 Спорт
131 Мода и Стиль
132 Красота
133 Тенденции Моды
134 Технологии
135 Компьютерная Техника
136 Программное Обеспечение
137 Интернет
138 Электроника
139 Хранение Данных
140 Туризм
141 Шоу-бизнес
142 Общество
143 Нестандартный Контент
144 Другое
145 Увлечения
146 Стиль Жизни
147 Товары и Услуги
148 Телевидение

Appendix D imp.native.request.plcmttype

plcmttype placement examples description
2 in article, header Внутри содержимого - на странице статьи или странице с изображением
3 sidebar Вне основного контента - например, в разделе объявлений на правом сайдбаре, в качестве размещения в стиле баннера рядом с контентом и т. д.
4 under article Виджет рекомендации, чаще всего представленный под содержимым статьи.

Appendix E Content Categories

category name
IAB1 Arts & Entertainment
IAB1-1 Books & Literature
IAB1-2 Celebrity Fan/Gossip
IAB1-3 Fine Art
IAB1-4 Humor
IAB1-5 Movies
IAB1-6 Music
IAB1-7 Television
IAB2 Automotive
IAB2-1 Auto Parts
IAB2-2 Auto Repair
IAB2-3 Buying/Selling Cars
IAB2-4 Car Culture
IAB2-5 Certified Pre-Owned
IAB2-6 Convertible
IAB2-7 Coupe
IAB2-8 Crossover
IAB2-9 Diesel
IAB2-10 Electric Vehicle
IAB2-11 Hatchback
IAB2-12 Hybrid
IAB2-13 Luxury
IAB2-14 Minivan
IAB2-15 Motorcycles
IAB2-16 Off-Road Vehicles
IAB2-17 Performance Vehicles
IAB2-18 Pickup
IAB2-19 Road-Side Assistance
IAB2-20 Sedan
IAB2-21 Trucks & Accessories
IAB2-22 Vintage Cars
IAB2-23 Wagon
IAB3 Business
IAB3-1 Advertising
IAB3-2 Agriculture
IAB3-3 Biotech/Biomedical
IAB3-4 Business Software
IAB3-5 Construction
IAB3-6 Forestry
IAB3-7 Government
IAB3-8 Green Solutions
IAB3-9 Human Resources
IAB3-10 Logistics
IAB3-11 Marketing
IAB3-12 Metals
IAB4 Careers
IAB4-1 Career Planning
IAB4-2 College
IAB4-3 Financial Aid
IAB4-4 Job Fairs
IAB4-5 Job Search
IAB4-6 Resume Writing/Advice
IAB4-7 Nursing
IAB4-8 Scholarships
IAB4-9 Telecommuting
IAB4-10 U.S. Military
IAB4-11 Career Advice
IAB5 Education
IAB5-1 7-12 Education
IAB5-2 Adult Education
IAB5-3 Art History
IAB5-4 College Administration
IAB5-5 College Life
IAB5-6 Distance Learning
IAB5-7 English as a 2nd Language
IAB5-8 Language Learning
IAB5-9 Graduate School
IAB5-10 Homeschooling
IAB5-11 Homework/Study Tips
IAB5-12 K-6 Educators
IAB5-13 Private School
IAB5-14 Special Education
IAB5-15 Studying Business
IAB6 Family & Parenting
IAB6-1 Adoption
IAB6-2 Babies & Toddlers
IAB6-3 Daycare/Pre School
IAB6-4 Family Internet
IAB6-5 Parenting - K-6 Kids
IAB6-6 Parenting teens
IAB6-7 Pregnancy
IAB6-8 Special Needs Kids
IAB6-9 Eldercare
IAB7 Health & Fitness
IAB7-1 Exercise
IAB7-2 ADD
IAB7-3 AIDS/HIV
IAB7-4 Allergies
IAB7-5 Alternative Medicine
IAB7-6 Arthritis
IAB7-7 Asthma
IAB7-8 Autism/PDD
IAB7-9 Bipolar Disorder
IAB7-10 Brain Tumor
IAB7-11 Cancer
IAB7-12 Cholesterol
IAB7-13 Chronic Fatigue Syndrome
IAB7-14 Chronic Pain
IAB7-15 Cold & Flu
IAB7-16 Deafness
IAB7-17 Dental Care
IAB7-18 Depression
IAB7-19 Dermatology
IAB7-20 Diabetes
IAB7-21 Epilepsy
IAB7-22 GERD/Acid Reflux
IAB7-23 Headaches/Migraines
IAB7-24 Heart Disease
IAB7-25 Herbs for Health
IAB7-26 Holistic Healing
IAB7-27 IBS/Crohn's Disease
IAB7-28 Incest/Abuse Support
IAB7-29 Incontinence
IAB7-30 Infertility
IAB7-31 Men's Health
IAB7-32 Nutrition
IAB7-33 Orthopedics
IAB7-34 Panic/Anxiety Disorders
IAB7-35 Pediatrics
IAB7-36 Physical Therapy
IAB7-37 Psychology/Psychiatry
IAB7-38 Senior Health
IAB7-39 Sexuality
IAB7-40 Sleep Disorders
IAB7-41 Smoking Cessation
IAB7-42 Substance Abuse
IAB7-43 Thyroid Disease
IAB7-44 Weight Loss
IAB7-45 Women's Health
IAB8 Food & Drink
IAB8-1 American Cuisine
IAB8-2 Barbecues & Grilling
IAB8-3 Cajun/Creole
IAB8-4 Chinese Cuisine
IAB8-5 Cocktails/Beer
IAB8-6 Coffee/Tea
IAB8-7 Cuisine-Specific
IAB8-8 Desserts & Baking
IAB8-9 Dining Out
IAB8-10 Food Allergies
IAB8-11 French Cuisine
IAB8-12 Health/Low-Fat Cooking
IAB8-13 Italian Cuisine
IAB8-14 Japanese Cuisine
IAB8-15 Mexican Cuisine
IAB8-16 Vegan
IAB8-17 Vegetarian
IAB8-18 Wine
IAB9 Hobbies & Interests
IAB9-1 Art/Technology
IAB9-2 Arts & Crafts
IAB9-3 Beadwork
IAB9-4 Bird-Watching
IAB9-5 Board Games/Puzzles
IAB9-6 Candle & Soap Making
IAB9-7 Card Games
IAB9-8 Chess
IAB9-9 Cigars
IAB9-10 Collecting
IAB9-11 Comic Books
IAB9-12 Drawing/Sketching
IAB9-13 Freelance Writing
IAB9-14 Genealogy
IAB9-15 Getting Published
IAB9-16 Guitar
IAB9-17 Home Recording
IAB9-18 Investors & Patents
IAB9-19 Jewelry Making
IAB9-20 Magic & Illusion
IAB9-21 Needlework
IAB9-22 Painting
IAB9-23 Photography
IAB9-24 Radio
IAB9-25 Roleplaying Games
IAB9-26 Sci-Fi & Fantasy
IAB9-27 Scrapbooking
IAB9-28 Screenwriting
IAB9-29 Stamps & Coins
IAB9-30 Video & Computer Games
IAB9-31 Woodworking
IAB10 Home & Garden
IAB10-1 Appliances
IAB10-2 Entertaining
IAB10-3 Environmental Safety
IAB10-4 Gardening
IAB10-5 Home Repair
IAB10-6 Home Theater
IAB10-7 Interior Decorating
IAB10-8 Landscaping
IAB10-9 Remodeling & Construction
IAB11 Law, Government, & Politics
IAB11-1 Immigration
IAB11-2 Legal Issues
IAB11-3 U.S. Government Resources
IAB11-4 Politics
IAB11-5 Commentary
IAB12 News
IAB12-1 International News
IAB12-2 National News
IAB12-3 Local News
IAB13 Personal Finance
IAB13-1 Beginning Investing
IAB13-2 Credit/Debt & Loans
IAB13-3 Financial News
IAB13-4 Financial Planning
IAB13-5 Hedge Fund
IAB13-6 Insurance
IAB13-7 Investing
IAB13-8 Mutual Funds
IAB13-9 Options
IAB13-10 Retirement Planning
IAB13-11 Stocks
IAB13-12 Tax Planning
IAB14 Society
IAB14-1 Dating
IAB14-2 Divorce Support
IAB14-3 Gay Life
IAB14-4 Marriage
IAB14-5 Senior Living
IAB14-6 Teens
IAB14-7 Weddings
IAB14-8 Ethnic Specific
IAB15 Science
IAB15-1 Astrology
IAB15-2 Biology
IAB15-3 Chemistry
IAB15-4 Geology
IAB15-5 Paranormal Phenomena
IAB15-6 Physics
IAB15-7 Space/Astronomy
IAB15-8 Geography
IAB15-9 Botany
IAB15-10 Weather
IAB16 Pets
IAB16-1 Aquariums
IAB16-2 Birds
IAB16-3 Cats
IAB16-4 Dogs
IAB16-5 Large Animals
IAB16-6 Reptiles
IAB16-7 Veterinary Medicine
IAB17 Sports
IAB17-1 Auto Racing
IAB17-2 Baseball
IAB17-3 Bicycling
IAB17-4 Bodybuilding
IAB17-5 Boxing
IAB17-6 Canoeing/Kayaking
IAB17-7 Cheerleading
IAB17-8 Climbing
IAB17-9 Cricket
IAB17-10 Figure Skating
IAB17-11 Fly Fishing
IAB17-12 Football
IAB17-13 Freshwater Fishing
IAB17-14 Game & Fish
IAB17-15 Golf
IAB17-16 Horse Racing
IAB17-17 Horses
IAB17-18 Hunting/Shooting
IAB17-19 Inline Skating
IAB17-20 Martial Arts
IAB17-21 Mountain Biking
IAB17-22 NASCAR Racing
IAB17-23 Olympics
IAB17-24 Paintball
IAB17-25 Power & Motorcycles
IAB17-26 Pro Basketball
IAB17-27 Pro Ice Hockey
IAB17-28 Rodeo
IAB17-29 Rugby
IAB17-30 Running/Jogging
IAB17-31 Sailing
IAB17-32 Saltwater Fishing
IAB17-33 Scuba Diving
IAB17-34 Skateboarding
IAB17-35 Skiing
IAB17-36 Snowboarding
IAB17-37 Surfing/Body-Boarding
IAB17-38 Swimming
IAB17-39 Table Tennis/Ping-Pong
IAB17-40 Tennis
IAB17-41 Volleyball
IAB17-42 Walking
IAB17-43 Waterski/Wakeboard
IAB17-44 World Soccer
IAB18 Style & Fashion
IAB18-1 Beauty
IAB18-2 Body Art
IAB18-3 Fashion
IAB18-4 Jewelry
IAB18-5 Clothing
IAB18-6 Accessories
IAB19 Technology & Computing
IAB19-1 3-D Graphics
IAB19-2 Animation
IAB19-3 Antivirus Software
IAB19-4 C/C++
IAB19-5 Cameras & Camcorders
IAB19-6 Cell Phones
IAB19-7 Computer Certification
IAB19-8 Computer Networking
IAB19-9 Computer Peripherals
IAB19-10 Computer Reviews
IAB19-11 Data Centers
IAB19-12 Databases
IAB19-13 Desktop Publishing
IAB19-14 Desktop Video
IAB19-15 Email
IAB19-16 Graphics Software
IAB19-17 Home Video/DVD
IAB19-18 Internet Technology
IAB19-19 Java
IAB19-20 JavaScript
IAB19-21 Mac Support
IAB19-22 MP3/MIDI
IAB19-23 Net Conferencing
IAB19-24 Net for Beginners
IAB19-25 Network Security
IAB19-26 Palmtops/PDAs
IAB19-27 PC Support
IAB19-28 Portable
IAB19-29 Entertainment
IAB19-30 Shareware/Freeware
IAB19-31 Unix
IAB19-32 Visual Basic
IAB19-33 Web Clip Art
IAB19-34 Web Design/HTML
IAB19-35 Web Search
IAB19-36 Windows
IAB20 Travel
IAB20-1 Adventure Travel
IAB20-2 Africa
IAB20-3 Air Travel
IAB20-4 Australia & New Zealand
IAB20-5 Bed & Breakfasts
IAB20-6 Budget Travel
IAB20-7 Business Travel
IAB20-8 By US Locale
IAB20-9 Camping
IAB20-10 Canada
IAB20-11 Caribbean
IAB20-12 Cruises
IAB20-13 Eastern Europe
IAB20-14 Europe
IAB20-15 France
IAB20-16 Greece
IAB20-17 Honeymoons/Getaways
IAB20-18 Hotels
IAB20-19 Italy
IAB20-20 Japan
IAB20-21 Mexico & Central America
IAB20-22 National Parks
IAB20-23 South America
IAB20-24 Spas
IAB20-25 Theme Parks
IAB20-26 Traveling with Kids
IAB20-27 United Kingdom
IAB21 Real Estate
IAB21-1 Apartments
IAB21-2 Architects
IAB21-3 Buying/Selling Homes
IAB22 Shopping
IAB22-1 Contests & Freebies
IAB22-2 Couponing
IAB22-3 Comparison
IAB22-4 Engines
IAB23 Religion & Spirituality
IAB23-1 Alternative Religions
IAB23-2 Atheism/Agnosticism
IAB23-3 Buddhism
IAB23-4 Catholicism
IAB23-5 Christianity
IAB23-6 Hinduism
IAB23-7 Islam
IAB23-8 Judaism
IAB23-9 Latter-Day Saints
IAB23-10 Pagan/Wiccan
IAB24 Uncategorized
IAB25 Non-Standard Content
IAB25-1 Unmoderated UGC
IAB25-2 Extreme Graphic/Explicit Violence
IAB25-3 Pornography
IAB25-4 Profane Content
IAB25-5 Hate Content
IAB25-6 Under Construction
IAB25-7 Incentivized
IAB26 Illegal Content
IAB26-1 Illegal Content
IAB26-2 Warez
IAB26-3 Spyware/Malware
IAB26-4 Copyright Infringement