Unity Service account — інструкція Legends

Перед початком

Що саме ми створюємо

Service account — технічний обліковий запис для Stats API. Не створюйте новий особистий Unity-профіль і не видавайте зайвих прав. Якщо кнопки New немає, зверніться до Owner або Manager потрібної організації.

Правильний контекст

Увійдіть у Unity Cloud і виберіть Organization

Відкрийте cloud.unity.com. У верхньому перемикачі перевірте, що обрана саме та Organization, витрати якої потрібно синхронізувати.

Stats API

Перейдіть до API management

Відкрийте User Acquisition → Settings → API management → Stats API v2.0 → Service account. У деяких версіях інтерфейсу User Acquisition може бути згруповано в розділі Growth.

Новий доступ

Натисніть New

Створюємо новий Service account для інтеграції Legends. Якщо кнопки немає, не змінюйте ролі самостійно — попросіть Owner або Manager організації створити account або надати необхідний доступ.

Ідентифікація

Вкажіть Name і Description

Дайте акаунту зрозумілу назву, наприклад для інтеграції витрат Legends, додайте короткий опис і натисніть Create. Не вставляйте ключі або інші секрети в назву чи опис.

Мінімальні права

Відкрийте Manage organization roles

Після створення Service account відкрийте керування ролями. Не вмикайте загальні Admin або write-права: для читання статистики вони не потрібні.

Одна роль

Залиште лише Advertise Stats API Viewer

У категорії User Acquisition (або Growth) знайдіть Advertise і виберіть тільки Advertise Stats API Viewer, потім натисніть Save. Не обирайте Admin, write-ролі або MMP Viewer.

API key

Натисніть Add key

Поверніться до Service account і натисніть Add key. Новий ключ має використовуватися тільки для цього підключення.

Показується один раз

Скопіюйте Key ID і Secret key

Збережіть обидва значення одразу: Secret key повторно не показується. Не вставляйте Authorization header у бот. У бот потрібно надсилати тільки два рядки:

ВАШ_KEY_ID
ВАШ_SECRET_KEY

Фінальне підключення

Скопіюйте Organization core ID і додайте акаунт у бот

У User Acquisition → Settings → Organization скопіюйте саме Organization core ID — це не Organization UUID.

У приватному чаті бота відкрийте ⚙️ Витрати Unity → Додати акаунт.
Введіть назву акаунта.
Вставте Organization core ID.
Підтвердьте валюту USD.
Надішліть Key ID і Secret key одним текстовим повідомленням у два рядки.

Безпека

Ключі — тільки в приватному credential-кроці

Telegram-боти не мають наскрізного шифрування. Бот одразу видаляє повідомлення з ключами; якщо видалити його не вдалося, credentials не зберігаються. Не надсилайте скриншоти з Secret key, не вставляйте ключі в URL, назви, описи або Authorization header.

Після перевірки

Що робить автосинхронізація

Після збереження credentials виконайте перевірку акаунта. Режим Auto ON вмикається окремою кнопкою. Спенд синхронізується щогодини за поточну та попередню календарну добу UTC з фінансовими guards перед будь-яким записом.