SSP - Banner - Request

Эта страница документации описывает структуру запроса к эндпоинту, который наша SSP-платформа отправляет покупателям рекламы (DSP) для участия в аукционе за показ баннерной рекламы.

Запрос (Bid Request) - это ключевое сообщение в процессе программатик-закупки, содержащее всю необходимую информацию о:

• Рекламном инвентаре: доступные места (imp), их размеры, минимальная цена (bidfloor).

• Контексте: сайт, категория контента, данные об устройстве пользователя.

• Пользователе: идентификатор для таргетинга.

• Условиях аукциона: валюта, блокировки и др.

Пример запроса (Bid Request)

Наглядный пример JSON-запроса выглядит следующим образом.

{
    "id": "CghSUi1tcy5oYhD7x6imBhjMzflDIKjnhb8C",
    "cur": [
        "RUB"
    ],
    "badv": [ "apple.com", "go-text.me", "heywire.com" ],
    "source": {
        "fd": 1,
        "ext": {
            "network": "ms.hb"
        }
    },
    "tmax": 100,
    "imp": [
        {
            "id": "0",
            "metric": [
                {
                    "type": "viewability",
                    "value": 0.65
                }
            ],
            "banner": {
                "format": [
                    { "w": 728, "h": 90 },
                    { "w": 300, "h": 90 },
                    { "w": 560, "h": 90 },
                    { "w": 468, "h": 60 }
                ]
            },
            "tagid": "1652",
            "bidfloor": 1.15,
            "bidfloorcur": "RUB",
            "ext": {
                "placementid": "30005",
                "hbblockid": "n10"
            }
        },
        {
            "id": "1",
            "metric": [
                {
                    "type": "viewability",
                    "value": 0.85
                }
            ],
            "banner": {
                "format": [
                    { "w": 728, "h": 90 },
                    { "w": 728, "h": 280 }
                ]
            },
            "tagid": "1655",
            "bidfloor": 2.15,
            "bidfloorcur": "RUB",
            "ext": {
                "placementid": "30008",
                "hbblockid": "n40"
            }
        }
    ],
    "bcat": ["IAB12"],
    "site": {
        "id": "747",
        "name": "ixbt",
        "domain": "ixbt.com",
        "page": "https://www.ixbt.com/home/delonghi-ecam-220-30-sb-review.html",
        "cat": [
            "IAB19-18"
        ],
        "publisher": {
            "id": "273000228"
        },
        "ext": {
            "network": "ixbt"
        }
    },
    "device": {
        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like gecko) Chrome/63.0.3239.132 Safari/537.36",
        "ip": "81.163.28.82"
    },
    "user": {
      "eids":[{"source":"RTK","uids":["ba259169dcd89028"]}],
      "id": "3d276c2c-111b-11ee-86e0-002590c0647c",
      "buyeruid": ""
    }
}

IAB-категория площадки

Для обеспечения единого стандарта классификации контента все площадки в нашей системе распределяются по категориям IAB. Чтобы упростить процесс настройки кампаний — как для таргетинга, так и для исключений — мы приводим пояснения к наиболее востребованным категориям IAB. Так, например, категория IAB1-5 закреплена за онлайн-кинотеатрами и видеосервисами. Используя её, можно целенаправленно показывать рекламу зрителям фильмов и сериалов или, наоборот, исключить такой трафик из своих кампаний.