Импорт показов

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

Что нужно заранее

Ключ API с правом write:plays, созданный администратором организации оператора. См. Аутентификация и ключи API.
Каждая строка называет конструкцию вашей организации и согласование, которое ее покрывает.

Отправка пакета

curl -X POST 'https://app.tanba-ooh.kz/api/v1/plays/import' \
  -H 'Authorization: Bearer tnbk_EXAMPLE_secret' \
  -H 'Content-Type: text/csv' \
  --data-binary @plays.csv

Тело это JSON ({"rows": [...]}) или CSV со строкой заголовков, UTF-8, запятая или точка с запятой, не больше 5 МБ или 50 000 строк.

structure_code,approval_number,hour,plays,source_ref
ALM-0012,TNB-2026-000123,2026-10-06T14:00:00+05:00,118,cms-main
ALM-0012,TNB-2026-000123,2026-10-06T15:00:00+05:00,120,cms-main

Колонка	Значение
`structure_code` или `structure_id`	Конструкция; укажите одно из двух
`approval_number`	Согласование, которое действовало
`hour`	Целый час в формате ISO 8601. Без смещения читается как время Asia/Almaty
`plays`	Сколько раз материал показан в этот час
`source_ref`	Необязательное имя вашего источника, до 100 символов

Разбор ответа

Строки оцениваются по одной. В ответе каждая строка помечена как accepted или refused, а для отказа дан код причины. Принятые строки сохраняются, даже если другие строки пакета отклонены. Исправьте отклоненные строки и отправьте заново только их.

Повторная отправка строки

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

Чем являются импортированные показы

Импортированные показы не служат доказательством. Они хранятся отдельно от показов, о которых сообщают плееры, никогда не тарифицируются и никогда не определяют событие контроля. Каждую ночь платформа сравнивает их с показами из отчетов плееров. Если отчеты плееров и ваш импорт расходятся больше чем на 10 %, для конструкции открывается событие import_mismatch. Сравнение можно прочитать в операционном отчете.

Коды причин

Полный список приведен на странице справочника «Импорт показов».