Руководство. Создание объектов

• Для чего используется
• Почему стоит попробовать
• Порядок действий
• Список объектов, доступных для создания

Для взаимодействия с Яндекс Директ, необходимо настроить коннектор.

1. Рабочий файл

Нажмите на ссылку «Скачать рабочий файл».

Файл имеет название «создание данных». Это своеобразный контейнер, который нужно заполнить данными. Direct Kit считает данные, проверит их и отправит через API в кабинет Яндекс Директ.

В рабочем файле 6 вкладок, каждая соответствует уровню данных, с которым можно работать. Список объектов, доступных для создания на каждом уровне.

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

Некоторые столбцы обязательны для заполнения. Если их не заполнить, при попытке отправить данные в кабинет получите уведомление об ошибке.

2. Создание объекта

Логика простая: выбрать вкладку в рабочем файле и, исходя из задачи, создать тот или иной объект.

В качестве примера создадим несколько ТГ-объявлений:

• — В группу «5487741110» добавляем два ТГ-объявления, с расширениями (идентификаторы профиля организации и видео-дополнения, а также картинкой).

В конце работы «сохраните» рабочий файл.

3. Добавление файла

Нажмите кнопку «Добавить файл» и загрузите в Direct Kit рабочий файл.

Важно! Следите за тем, чтобы в рабочем файле содержались только те данные, которые нужно обработать в рамках текущей задачи.

4. Отправка данных

Нажмите кнопку «Отправить данные» и ожидайте завершения.

Во время отправки данных, в блоке «Контроль исполнения» отображаются:

• — Результат валидации данных. Если файл не прошел валидацию, получите уведомление с указанием листа и столбца, в котором обнаружены ошибки.
• — Статус выполнения операции (успешно или нет).
• — Количество потраченных/оставшихся API-баллов.
• — Затраченное на отправку данных время.

5. Проверка отчета

В качестве ответа Яндекс Директ возвращает отчет о результатах выполнения операции.

Если все в порядке, в блоке «Контроль исполнения» появится уведомление об успешно выполненной операции, а в отчете будет только столбец «Id», который содержит идентификаторы созданных объектов. Их будет ровно столько, сколько создано объектов.

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

Отчет готов для экспорта, когда кнопка «Скачать отчет» окрасится в зеленый цвет.

Файл имеет название такого вида: «отчет — создание — логин». Вместо «логин» подтягивается логин кабинета, указанный в настройках коннектора.