Как это работает

CityScreen Context запускает четыре потока. Всё остальное в продукте — это настройка одного из них или отчётность по одному из них.

Поток Направление Время

Поступление инвентаря

CMS → платформа

По расписанию, раз в час

Поступление креативов

Источник спроса → платформа → CMS

При отправке, а для некоторых интеграций ещё и опрос по расписанию

Аукцион

CMS → платформа → источники спроса → обратно

В реальном времени, на каждую возможность

Возврат данных о воспроизведении

CMS → платформа

По расписанию

Страница для тех, кому нужно знать, что платформа делает сама и когда.

Поступление инвентаря

Каталог в платформе не вводится вручную: платформа сама загружает его из CMS (системы управления контентом) оператора наружной рекламы и поддерживает в актуальном состоянии.

flow-inventory

  1. Платформа запрашивает у CMS каталог экранов и рекламных поверхностей каждый час. Сотрудник с ролью владельца или администратора может также запустить синхронизацию вручную.

  2. Экраны и рекламные поверхности, которые пришли, создаются или обновляются. Рекламные поверхности, о которых источник больше не сообщает, отключаются и остаются в каталоге. Запуск синхронизации, который не завершился, ничего не отключает.

  3. Показатели заполнения, которые называются занятостью, загружаются в том же часовом цикле.

  4. Источники спроса получают каталог, когда запрашивают его. Платформа никому не отправляет инвентарь; каталог забирают сами источники спроса.

Некоторые интеграции заменяют часовую загрузку импортом из таблицы, а одна позволяет включать и выключать рекламные поверхности вручную. Подробности, включая четыре поля, которые оператор может редактировать без риска перезаписи, описаны в разделах Синхронизация и Что можно редактировать.

Поступление креативов

Выигрыш в аукционе сам по себе не выводит креатив на экран. Сначала креатив должен быть принят и доставлен в CMS, и только после этого его можно показать.

flow-creative

  1. Источник спроса отправляет креатив в платформу, когда он у него появляется. Для некоторых интеграций платформа вместо этого сама опрашивает партнёра по расписанию, нет ли новых креативов.

  2. Если партнёра нет в списке автоматического одобрения организации, отправленный креатив проверяют сотрудники оператора. Каждая должность проверки, заданная в организации, фиксирует своё решение.

  3. После принятия платформа передаёт креатив в CMS вместе с его размерами и длительностью и с идентификаторами, которыми платформа позже назовёт этот креатив победителем.

  4. Когда CMS подтверждает, что файл у неё, кампания допускается к аукциону.

  5. При отклонении причина передаётся источнику спроса.

Креативы, которые приходят по пути automated guaranteed, идут по второму, отдельному потоку, который не создаёт запрос на модерацию. Оба описаны в разделе Одобрение креативов.

Аукцион

Это путь в реальном времени, и только он запускается на каждый момент эфирного времени. Он запускается для программатик-слота: воспроизведение классического слота CMS определяет сама, вообще не обращаясь к платформе.

flow-auction

  1. CMS отправляет платформе рекламный запрос: что играть на этой рекламной поверхности, с указанием времени воспроизведения, длительности слота и оценки аудитории. Запрос аутентифицируется токеном доступа организации.

  2. Запрос, у которого временная метка отличается от часов платформы больше чем на три минуты, отклоняется.

  3. Платформа загружает прайс-лист, который покрывает эту рекламную поверхность, рассчитывает минимальную цену (floor price) и предлагает возможность тем источникам спроса, которые названы в прайс-листе. Опрашиваются все в один и тот же момент.

  4. На ответ у каждого партнёра 1,5 секунды, а на весь обмен с ним, включая время обработки на стороне платформы, — 1,7 секунды. Партнёр, который не ответил за это время, в сравнение не попадает.

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

  6. Победителю сообщают о выигрыше раньше, чем платформа отвечает CMS. Если это уведомление не доставлено, платформа не возвращает победителя.

  7. В ответе CMS передаются идентификатор запроса, идентификатор креатива и цена. Ссылки на файл в нём никогда нет: файл у CMS уже есть, он пришёл в потоке креативов выше.

  8. CMS сообщает, состоялся ли показ.

Как выбирается победитель, что такое итоговая цена и что происходит, когда в эфире забронированная кампания, описано в разделе Аукцион.

Возврат данных о воспроизведении

Что реально вышло, платформа узнаёт сама, запрашивая данные постфактум. Она делает это регулярно, по расписанию, для каждого вида источника: показы обычного аукциона, показы кампаний automated guaranteed, показы private deal и показы внешних SSP.

flow-playout

В этой документации подтверждённый выход ролика называется показом. Контакт — это показатель аудитории, а показ — событие на экране, поэтому оценка аудитории, если она есть, хранится вместе с показом и не умножает их число.

Рекламный запрос, который так и не подтвердили, закрывается через два часа и помечается как неудачный.

Что считается, что нет и что делает подтверждение, которое пришло после этого срока, описано в разделах Отчётность и Поздние и потерянные показы.