Структурированные файлы данных (SDF) — это файлы CSV специального формата. Они позволяют массово извлекать, создавать и редактировать ресурсы в Display & Video 360. Вносите изменения в ресурсы одновременно, загружая, редактируя и затем повторно загружая файлы SDF.
Пользовательский интерфейс Display & Video 360 поддерживает загрузку и выгрузку файлов SDF . API Display & Video 360 поддерживает загрузку файлов SDF .
Форматы
В SDF используется один из двух базовых форматов: Standard и QA :
- Вы можете скачивать и загружать файлы стандартного формата. Данные в этих файлах могут содержать числовые идентификаторы для обеспечения точности при загрузке. Для интерпретации данных может потребоваться справочная информация.
- Вы можете загрузить файлы в формате QA . Эти файлы содержат те же данные, что и файлы стандартного формата, но используют более удобочитаемые значения. Например, в некоторых столбцах вместо идентификаторов могут использоваться отображаемые имена. Столбцы, специфичные для этого формата, используют суффикс «Qa».
Типы файлов
SDF поддерживает семь типов ресурсов. Каждый тип ресурса имеет свой собственный тип файла со своей собственной структурой столбцов. Поддерживаемые типы ресурсов:
- Кампания
- Заказ на размещение
- Позиция
- Группа объявлений
- Объявление
- Источник инвентаризации
- Медиапродукт
Формат QA поддерживаются только файлами типов «Позиция объявления» и «Группа объявлений» .
Новые версии SDF выпускаются регулярно , а более ранние версии объявляются устаревшими . В новых версиях обновляется структура столбцов типов файлов. При необходимости, при запуске новой версии SDF будет включено руководство по миграции .
Ошибки загрузки
При загрузке файлов SDF могут возникать два типа ошибок: ошибки генерации файлов и пропущенные ресурсы.
Ошибки генерации файлов
Генерация SDF может завершиться с ошибкой. Если генерация завершается с ошибкой при использовании API Display & Video 360 , в поле error объекта Status . Объект Status будет содержать сообщение с подробным описанием причины ошибки.
Подробнее об этих ошибках можно прочитать на нашей странице «Руководство по ошибкам и предупреждениям» .
Пропущенные ошибки
Файлы SDF не поддерживают все подтипы ресурсов. Если ресурс не может быть включен в файл SDF, в загружаемый файл будет включен файл "Skipped" (например, SDF-LineItems-Skipped.csv ). Этот файл имеет двухколоночную структуру. В первой колонке указан пропущенный ресурс. Во второй колонке объясняется, почему он был исключен.
Загрузка файла
Загружайте файлы SDF с помощью пользовательского интерфейса Display & Video 360 для создания новых или обновления существующих ресурсов.
Выполните следующие шаги, чтобы свести к минимуму ошибки при обновлении или создании ресурсов с использованием SDF:
- Загружайте файлы SDF, используя API или пользовательский интерфейс Display & Video 360 .
- Внесите изменения в существующие записи файла, чтобы обновить имеющиеся ресурсы.
- Добавьте записи в файл для создания новых ресурсов.
- Удалите все записи, которые не являются новыми или обновленными. Это уменьшит размер файла и исключит вероятность непреднамеренных обновлений.
- Загрузите файл в интерфейсе Display & Video 360.
После загрузки и обработки SDF-файла становится доступен для скачивания ZIP-архив SDF-ResultFile.zip . Этот ZIP архив может содержать два возможных файла:
-
SDF-{ResourceType}-Updated-ResultFile.csv, в котором перечислены успешно обновленные или созданные ресурсы. -
SDF-{ResourceType}-Failed-ResultFile.csv, в котором перечислены неудачные операции и соответствующие сообщения об ошибках.
ZIP архив может содержать один или оба файла.