ORD - for SSP

Общее описание процесса передачи идентификатора в SSP.

BidRequest

Формат запроса

"bidRequest": {
		"regs": {
			"ext": {
				"nroa": {
					"ado_id": "amberdata",
					"platform_id": "123456"
				}
			}
		}
	}

BidResponse

Формат ответа

"bidResponse": {
		"seatbid": [{
			"bid": [{
				"ext": {
					"nroa": {
						"erid": "efr23i",
						"contract": {
							"client": {
								"inn": "7728474136",
								"name": "%D0%9E%D0%9E%D0%9E%20%22%D0%A0%D0%BE%D0%BC%D0%B0%D1%88%D0%BA%D0%B0%22%20"
							},
							"contractor": {
								"inn": "7728474137"
							},
							"number": "%D0%A0%D0%B0%D0%BC%D0%BE%D1%87%D0%BD%D0%BE%D0%B5%20%D1%81%D0%BE%D0%B3%D0%BB%D0%B0%D1%88%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BE%20%D0%BF%D0%BE%D1%81%D1%82%D0%B0%D0%B2%D0%BA%D0%B0%D1%85%20%D0%B4%D0%BB%D1%8F%20%D0%BE%D0%B1%D0%B5%D1%81%D0%BF%D0%B5%D1%87%D0%B5%D0%BD%D0%B8%D1%8F%20%D0%BC%D0%B5%D0%B4%D0%B8%D0%B0-%D0%BF%D0%BB%D0%B0%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F%20%D0%B8%20%D0%B7%D0%B0%D0%BA%D1%83%D0%BF%D0%BE%D0%BA",
							"date": "2022-09-01"
						},
						"ordContracts": [{
							"id": "4537",
							"ado_id": "amberdata"
						}, {
							"id": "3272",
							"ado_id": "mts"
						}]
					}
				}
			}]
		}]
	}

Описание полей

BidRequest

Атрибут

Тип

Описание

nroa

object

Родительский объект для расширения

ado_id

string

Название ОРД из списка известных

platform_id

string

Идентификатор платформы (сайт/приложение) в ОРД

BidResponse

Атрибут

Тип

Описание

nroa

object

Родительский объект для расширения

nroa.erid

string

ЕРИД

nroa.contract

object

Объект описывающий изначальный контракт

nroa.contract.client

object

Объект описывающий клиента

nroa.contract.client.inn

string

ИНН изначального рекламодателя

nroa.contract.client.name

string

URLEncode от наименования юр. лица рекламодателя

nroa.contract.contractor

object

Объект описывающий исполнителя изначального контракта

nroa.contract.contractor.inn

string

ИНН исполнителя изначального контракта

nroa.contract.number

string

URLEncode от номера изначального контракта

nroa.contract.date

string

Дата заключени изначального контракта в формате YYYY-MM-DD

nroa.ordContracts

object array

Массив объектов с договорами

nroa.ordContracts[].id

string

ID договора полученый от ОРД

nroa.ordContracts[].ado_id

string

Название ОРД из списка известных

  1. В bidRequest добавляется информация о платформе (сайт/приложение) и ОРД, в которой она зарегистрирована. Путь bidRequest->regs->ext->nroa

  2. В bidResponse добавляется информация о ERID и договорах, которые заключены с рекламодателем, с указанием ОРД, в которой добавлен этот договор. Путь bidResponse ->seatbid->bid->ext->nroa

  3. Новый договор, добавляется как последний элемент в массив ordContracts

  4. ord_id, id передаются в текстовом виде.

Аббревиатура

Параметр

Название

ОРД

ADO

Ad Data operator

NROA

National Register of Online Ad

Список известных на данный момент ОРД

  • Amberdata
  • MTS
  • Beeline
  • Yandex
  • Ozon
  • Sber
  • VK