Урок 5. Как включить Песочницу

В этом уроке мы расскажем, как научиться работать с Директом через API без риска запустить реальную рекламную кампанию с настоящим бюджетом.

Что такое Песочница

Песочница — это тестовая среда для отладки приложений, взаимодействующих с API Директа. В Песочнице вы можете выполнять запросы, получать ответы, наблюдать изменение статуса кампаний и объявлений. При этом в Песочнице вы работаете только с тестовыми данными, и ваши действия не повлияют на настоящие рекламные кампании. Тестовые объявления нигде не показываются, тестовый бюджет не влияет на ваш реальный счет в Директе, а статистический отчет будет содержать псевдослучайные данные.

Запросы вашего приложения в Песочницу должны соответствовать тому же формату, что и запросы к реальным данным. В Песочнице используются реальные OAuth-токены. Единственное отличие запросов в Песочницу от запросов к реальным данным — это адреса.

Песочница не имеет веб-интерфейса, поэтому посмотреть тестовых клиентов и тестовые рекламные кампании в интерфейсе нельзя. Работать с Песочницей вы можете только через вызовы методов API.

Подключение

Чтобы Песочница в вашем аккаунте заработала, включите ее:

В веб-интерфейсе Директа откройте раздел API и перейдите на вкладку Песочница.
Нажмите Начать пользоваться Песочницей.
Выберите роль: «Клиент» (прямой рекламодатель) или «Агентство» (рекламное агентство со своими клиентами). Укажите валюту тестового аккаунта. Установите флажок Создать тестовые кампании.
Нажмите кнопку Продолжить.
В зависимости от выбранной роли, в Песочнице будут сразу же созданы три тестовые кампании или три тестовых клиента. На одну из кампаний зачислят виртуальные денежные средства.

Особенности работы с Песочницей

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

Задание

Включите Песочницу с ролью «Клиент» — с созданием рублевого клиентского аккаунта с готовыми тестовыми кампаниями.

Выполнить задание

Что дальше

Итак, вы выполнили все подготовительные этапы и готовы начать работать с API Директа. В следующем уроке мы сделаем первый запрос к API.

Полезные ссылки

Вкладка Песочница в интерфейсе Директа
Документация: Песочница