Масовий запуск кампаній 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 влаштований через service account. За сторінкою Unity про пошук advertiser credentials, після створення ключа акаунту треба призначити роль організації, а без ролі будь-який запит отримає 403 і повідомлення Invalid Credentials. Для кампаній потрібна роль Advertise API на кожен ресурс, яким ви керуєте: апки, ставки, кампанії (What’s new in User Acquisition).

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

Чого в доках немає

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

Як це робиться в DarkCore Ramet

У масовому запуску DarkCore Ramet апки й гео обираєте один раз, і на кожну пару створюється кампанія. Перед надсиланням показується превʼю, черга відправляє кампанії в темпі, який допускає Unity, а кожна зміна читається назад із Unity, перш ніж вважатися виконаною, і потрапляє в журнал з автором. Масове редагування працює по кампаніях і кабінетах: можна підняти ставку на 10 %, змінити денний бюджет або поставити паузу.