Массовый запуск кампаний Unity Ads: что умеют xlsx-таблицы

Таблицы Bulk Campaign Management правят таргетинг, расписания, ставки по странам и ставки по сорсам сразу у многих кампаний. Двух вещей они не умеют: массово менять бюджеты и создавать новые кампании с Automated Bidding. Так написано на странице Unity про Bulk Campaign Management. Бюджеты можно менять через API, а как создавать кампании с Automated Bidding, прочитанные нами страницы не говорят.

Что такое Bulk Campaign Management

По описанию Unity, это способ создавать и править сразу несколько кампаний. Unity называет его альтернативой без кода для API управления кампаниями и пишет, что так быстрее и эффективнее, чем вести кампании по одной в дашборде User Acquisition. Работа идёт через три xlsx-файла: выгружаете, правите, загружаете обратно.

Файл	Что можно делать
Campaign Setups (app_campaign_setups.xlsx)	Добавлять новые кампании, править таргетинг и расписания, добавлять и править ссылки атрибуции, назначать и снимать креативные паки
Bids (app_bids_spreadsheet.xlsx)	Добавлять новые страны в таргетинг, вести ставки по странам у нескольких кампаний, убирать страны
Source Bids	Вести ставки по сорсам у нескольких кампаний

У Source Bids Unity на странице указывает то же имя файла, что и у Bids, app_bids_spreadsheet.xlsx. Поэтому при первой выгрузке проверьте, какой лист лежит в каком файле.

Что таблицы не умеют

Unity называет два прямых ограничения. Первое: сейчас нельзя массово править бюджеты кампаний и дневные бюджеты через таблицы. Второе: нельзя создать новую кампанию с Automated Bidding. Новые кампании через Campaign Setups добавлять можно, но не такие.

Отдельно про уже существующие кампании с Automated Bidding. Их можно выгрузить, загрузить и изменить, но только через выгрузки Bids и Source Bids. Остальные таблицы для них, судя по странице, не годятся.

Бюджеты после запуска приходится менять либо по одной кампании в дашборде, либо через API. Это главная причина, по которой таблицы редко закрывают весь цикл: поставить гео и ставки можно пачкой, а подкрутить дневной бюджет у всех сразу нельзя.

Где таблицы удобны

Таблицы хорошо работают на правках, которые касаются многих кампаний одинаково:

• добавить новую страну в таргетинг у всех кампаний апки или убрать её;
• пересчитать ставки по странам у нескольких кампаний: формулу в xlsx можно протянуть по всем строкам;
• сдвинуть расписание или заменить ссылку атрибуции у пачки кампаний;
• назначить или снять креативный пак у многих кампаний сразу;
• обновить сорс-ставки.

Про креативы есть оговорка. В списке возможностей таблиц есть назначение и снятие паков, а загрузки файлов крео там нет. Откуда берётся пак, страница не говорит; судя по списку, загрузка файлов идёт отдельно (наше прочтение). А загрузка в Unity ограничена: по странице новостей User Acquisition можно загружать 1 креатив в секунду и 30 креативов за 30 минут на каждую апку, и лимиты работают и в дашборде, и в Advertiser Public API. Как это считается на пачке, разобрано в статье про лимиты загрузки креативов.

Что проверить перед импортом

По странице Bulk Campaign Management, ставки в таблицах принимаются с точностью до трёх знаков после запятой. Проверка при импорте идёт по отформатированному значению. Если в ячейке лежит 0,0009, а формат показывает 0,001, применится 0,001. Округляйте формулой до импорта и сверяйте, что в ячейке лежит ровно то число, которое вы видите.

Где вы упираетесь

1. Бюджеты. Массовая правка таблицами недоступна ни для общего, ни для дневного бюджета.
2. Новые кампании с Automated Bidding. Каким путём создавать такую кампанию, страница не говорит.
3. Объём. Лимитов на число строк или кампаний в файле страница не называет, так что размер пачки проверяйте пробным импортом, а не по документации.
4. Пауза, архив, удаление. В списке возможностей таблиц таких действий нет, и страница про них молчит.

Таблицы и API

Для управления кампаниями из кода у Unity есть Advertiser Public API. По странице про API campaign management, он позволяет управлять кампаниями программно, а найти его можно в дашборде в разделе Settings > API management. Через него управляются приложения, кампании, ставки, сорс-ставки и ROAS-цели, бюджеты, креативы и креативные паки. Бюджеты в этом списке есть, в таблицах их нет.

Прежняя версия, Advertising Management API (/advertise/v1), заменена. Как пишет Unity на странице новостей, интеграции на старом API нужно переносить на Advertiser Public API. Подробнее об этом в статье про Advertiser Public API.

Доступ к API устроен через сервисный аккаунт. По странице Unity про поиск advertiser credentials, после создания ключа аккаунту надо назначить роль организации, а без роли любой запрос получит 403 и сообщение Invalid Credentials. Для кампаний нужна роль Advertise API на каждый ресурс, которым вы управляете: приложения, ставки, кампании (What’s new in User Acquisition).

	Таблицы	API
Код	не нужен	нужен
Правка бюджетов	нельзя	бюджеты входят в список управляемых ресурсов
Новая кампания с Automated Bidding	нельзя	в прочитанных страницах не сказано
Доступ	на странице не описан	ключ сервисного аккаунта и роли
Лимиты	по числу строк не названы	лимиты запросов не названы

Чего в доках нет

• Максимального числа строк, кампаний или размера файла.
• Пошагового импорта и экспорта. Он вынесен на отдельную страницу про шаблоны управления кампаниями, и мы её не читали.
• Пауз, архивации и удаления через таблицы: среди возможностей они не названы.
• Лимитов запросов к API и формата заголовка авторизации. Ни страница про API campaign management, ни страница get started, на которую она ссылается, значений лимитов не приводят.
• Ответа, умеет ли API создавать кампании с Automated Bidding. В прочитанных страницах этого нет.

Как это делается в DarkCore Ramet

В массовом запуске DarkCore Ramet апки и гео выбираются один раз, и на каждую пару создаётся кампания. Перед отправкой показывается превью, очередь отправляет кампании в темпе, который допускает Unity, а каждое изменение читается обратно из Unity, прежде чем считается выполненным, и записывается в журнал с автором. Массовая правка работает по кампаниям и кабинетам: можно поднять ставку на 10 %, поменять дневной бюджет или поставить паузу.