Від підключення до першого валідного insight

Хто запускає синхронізації та автоматизації

Клієнту не потрібно налаштовувати cron, заходити на хостинг або запускати PHP-команди. Після збереження й успішної перевірки інтеграції її забирає центральний scheduler ECOMOS: реклама, CRM, доставка, Асистент, Telegram та дозволені бюджетні автоматизації запускаються для всіх активних workspace за спільним розкладом.

Стан останніх запусків видно у Статусі та Data Health. Якщо connection вимкнений, token відкликано або тест доступу не пройдено, scheduler безпечно пропускає джерело й показує причину в інтерфейсі.

Як заповнити CRM-ліди, CR, прогноз викупу та внесок

ECOMOS зіставляє CRM-замовлення з рекламою за точним зовнішнім ID кампанії. Це навмисно: розподіл за схожою назвою або лише за лендингом створив би неправдивий P&L.

1. Meta Ads: у полі URL parameters оголошення додай utm_source=meta&utm_medium=paid_social&utm_campaign={{campaign.id}}.
2. TikTok Ads: у URL parameters додай utm_source=tiktok&utm_medium=paid_social&utm_campaign=__CAMPAIGN_ID__.
3. Google Ads: у Final URL suffix додай utm_source=google&utm_medium=cpc&utm_campaign={campaignid}.
4. Перевір: відкрий тестовий URL із параметрами, створи тестове замовлення й після CRM sync переконайся, що у «Кампаніях» з’явилися CRM-ліди та UTM coverage вище 0%.

Лендинг зберігає UTM у first-party cookie до оформлення замовлення, а webhook оновлює їх і під час повторних подій CRM. Старі замовлення без UTM не розподіляються заднім числом, бо точну кампанію для них довести неможливо.

Як підключити Meta Ads

ECOMOS читає campaign spend, impressions, reach, clicks, lead actions, валюту та статуси кампаній через офіційний Meta Marketing API. Без окремого ввімкнення «Автоматизації бюджетів Meta» система нічого не змінює в рекламному кабінеті.

1. Підготуй доступ. Потрібна роль адміністратора Meta Business Portfolio, рекламний акаунт у цьому business і Meta developer app. У Meta for Developers створи Business app та додай продукт Marketing API.
2. Створи System User. У Meta Business Settings відкрий Users → System users, створи окремого користувача для ECOMOS і признач йому потрібні ad accounts. Для звітів достатньо доступу до перегляду результатів; для автоскейлу або нічного reset потрібне право керувати кампаніями.
3. Згенеруй token. У System user натисни Generate new token, обери свій app і дозвіл ads_read. Додай ads_management лише якщо плануєш увімкнути зміну бюджетів. Для чужих business assets Meta може вимагати Advanced Access та App Review.
4. Знайди Ad Account ID. У Ads Manager або Business Settings скопіюй числовий ID кожного рекламного акаунта. У ECOMOS можна вставити число або повний формат act_123456789012345; кілька акаунтів розділяй комами.
5. Заповни ECOMOS. Відкрий Налаштування → Інтеграції → Meta Ads, встав Access token, залиш API version v25.0, якщо підтримка не попросила інше, додай Ad account IDs, увімкни картку та натисни «Зберегти».
6. Перевір доступ. Натисни «Перевірити». ECOMOS звернеться саме до першого вказаного ad account і підтвердить його назву та валюту. Повідомлення лише про живий token без перевірки акаунта не вважається завершеним підключенням.
7. Звір дані. Після першого sync відкрий «Кампанії → Facebook» і порівняй spend, clicks і leads щонайменше для трьох кампаній за однаковий період і часовий пояс.

Не плутай: token із Events Manager для Conversions API або Pixel не читає Ads Insights. ECOMOS потрібен Marketing API token. Token маскується у UI та зберігається у зашифрованому tenant-конекторі; не надсилай його у листах чи скриншотах.

Meta Marketing API: Getting Started → · Access Token Debugger →

Як підключити TikTok Ads

ECOMOS читає spend, impressions, clicks, conversions, валюту, назви та статуси кампаній через TikTok API for Business. Поточна інтеграція TikTok є read-only і не змінює кампанії або бюджети.

1. Зареєструй developer account. Увійди на TikTok API for Business, зареєструйся як developer і створи app із Marketing API. Звичайного акаунта TikTok Ads Manager без API app недостатньо.
2. Отримай API-доступ. У developer app заповни дані компанії та use case для reporting, додай redirect URL і запроси потрібні Marketing API permissions. Якщо app ще не схвалений або немає developer-доступу, скористайся concierge onboarding — не вставляй у ECOMOS інші типи TikTok token.
3. Авторизуй advertiser. Запусти Marketing API authorization для потрібного рекламного акаунта. Після підтвердження TikTok поверне одноразовий auth_code; за офіційною документацією він чинний одну годину й використовується лише один раз.
4. Отримай access token. Обміняй auth_code разом з app_id і app secret через endpoint /oauth2/access_token/ або офіційний API Playground. У ECOMOS вставляється лише отриманий Marketing API access token — app secret тут не потрібен.
5. Знайди Advertiser ID. Скопіюй числовий ID з TikTok Ads Manager або отримай список авторизованих акаунтів через /oauth2/advertiser/get/. Кілька ID вводь через кому.
6. Заповни ECOMOS. Відкрий Налаштування → Інтеграції → TikTok Ads, встав Access token, залиш API version v1.3, додай Advertiser IDs, увімкни картку та натисни «Зберегти».
7. Перевір і звір. Натисни «Перевірити»: ECOMOS прочитає перший advertiser, його назву та валюту. Після sync відкрий «Кампанії → TikTok» і звір spend, clicks та conversions за однаковий період.

Не плутай: TikTok Login token, Events API/Pixel token, Spark Ads authorization code та Marketing API access token — різні credentials. ECOMOS потрібен останній. Token маскується у UI та зберігається у зашифрованому tenant-конекторі.

Офіційна авторизація TikTok Marketing API → · Authentication → · Про API for Business →

Як підключити Google Ads

Google Ads є повноцінним третім рекламним джерелом ECOMOS. Інтеграція імпортує добові campaign spend, impressions, clicks, primary conversions, валюту та статус кампанії. Вона не змінює ставки або бюджети Google Ads.

1. Google Ads Manager. Увійди у manager account (MCC), відкрий API Center, отримай Developer token і перевір його access level. Test Account Access не читає production-акаунти.
2. Google Cloud. Створи або обери проєкт і увімкни Google Ads API.
3. OAuth consent + client. Налаштуй consent screen, а в Credentials створи OAuth 2.0 Client ID типу Web application. Додай authorized redirect URI: https://app.beastbuy.uno/google-ads-oauth.php. Для тесту додай дозволених test users; для зовнішнього production-запуску пройди Google OAuth app verification.
4. ECOMOS. Відкрий Налаштування → Інтеграції → Google Ads. Заповни Developer token, OAuth Client ID/secret і client customer IDs; усі ID вводь як 10 цифр без дефісів.
5. MCC. Якщо client accounts доступні через manager account, додай його 10-значний ID у Manager customer ID. Для прямого доступу поле можна залишити порожнім.
6. Авторизація. Увімкни картку, збережи налаштування, натисни «Авторизувати Google» та підтвердь offline-доступ scope https://www.googleapis.com/auth/adwords.
7. Перевірка. Повернувшись у ECOMOS, натисни «Перевірити». Успіх означає, що API реально прочитав кожен указаний client customer ID, а не лише прийняв OAuth token.
8. Перша звірка. Дочекайся sync, відкрий «Кампанії → Google» і звір spend, clicks та primary conversions щонайменше для трьох кампаній за однаковий період.

Безпека: Client secret і refresh token шифруються AES-256-GCM; повні значення не повертаються у UI. Відкликати доступ можна у Google Account → Security → Third-party access.

Офіційна документація OAuth → · помилки Google Ads API →

Як підключити Telegram-сповіщення

Один бот може повідомляти про нові проблемні рекламні кампанії, посилки Нової пошти, що довго лежать у відділенні, зміни автоскейлера, нічний reset бюджетів і помилки Meta automation. Кожен тип повідомлень вмикається окремо.

1. Створи бота. Відкрий офіційного @BotFather, надішли /newbot, задай ім’я та username, що закінчується на bot. BotFather видасть token — стався до нього як до пароля.
2. Обери чат. Для приватних повідомлень відкрий свого бота й натисни Start. Для групи додай бота до учасників і надішли в групі команду /start@username_бота. Для forum topic надішли команду саме в потрібній темі.
3. Встав token. Відкрий Налаштування → Сповіщення, увімкни картку Telegram і встав Bot token. На першому кроці Chat ID можна залишити порожнім.
4. Визнач Chat ID. Натисни «Перевірити». ECOMOS перевірить бота через getMe, прочитає останнє повідомлення через getUpdates і підставить Chat ID та Topic ID, якщо вони є. Після підстановки натисни «Зберегти».
5. Надішли тест. Натисни «Перевірити» ще раз. У вибраному чаті має з’явитися повідомлення «ECOMOS підключено». Якщо воно не прийшло, перевір, чи бот досі є учасником чату та має право надсилати повідомлення.
6. Обери події. Увімкни лише потрібне: проблемні кампанії, продзвін посилок, зміни автоскейлу, нічний reset або помилки automation. Поріг Нової пошти за замовчуванням — 6 повних днів у відділенні.
7. Автоматизація бюджетів. У Фінанси і КЦ → Автоматизація бюджетів Meta окремо увімкни автоскейл та/або нічний reset, задай мінімум лідів, максимальний денний і базовий нічний бюджет. Пороги задаються в USD-еквіваленті; для акаунтів у UAH, EUR або PLN ECOMOS конвертує їх у нативну валюту перед записом. Невідома валюта безпечно блокує зміну. Самі сповіщення не вмикають бюджети.

Безпека: token шифрується AES-256-GCM у tenant-конекторі, не записується у відкритий tenant settings і після збереження показується лише маскою. Якщо token потрапив стороннім, негайно згенеруй новий через @BotFather і заміни його в ECOMOS.

Офіційна інструкція BotFather → · getUpdates → · sendMessage →