Как это работает
Adastra автоматически выгружает данные из рекламных кабинетов Facebook Ads в Google Sheets. Данные обновляются по расписанию или вручную.
кампании, метрики по расписанию RAW_campaigns, RAW_ads...
Структура данных
Каждый клиент — это рекламодатель. У клиента может быть несколько рекламных кабинетов и несколько таблиц для выгрузки с разными наборами метрик.
├── Кабинет 1 (act_000...)
├── Кабинет 2 (act_001...)
├── Таблица «Основная» — все метрики
└── Таблица «Видео» — только видео метрики
Листы в таблице
| Лист | Данные |
|---|---|
| RAW_account | Сводные показатели по кабинету за день |
| RAW_campaigns | Разбивка по кампаниям |
| RAW_adsets | Разбивка по группам объявлений |
| RAW_ads | Разбивка по объявлениям |
| RAW_demographics | Разбивка по возрасту и полу |
| RAW_placements | Разбивка по плейсментам |
| RAW_geo | Разбивка по странам и регионам |
Первый вход
Вход через Google
- Открой adastrasync.com и нажми «Войти через Google»
- Выбери Google аккаунт у которого есть доступ к нужным таблицам
- Разреши доступ к Google Sheets — это нужно для записи данных
Подключение Facebook
- После входа нажми на своё имя в правом верхнем углу — откроется профиль
- В разделе «Подключённые аккаунты» нажми «Подключить» рядом с Facebook Ads
- Авторизуйся в Facebook и разреши доступ к рекламным кабинетам
- Токен действует 60 дней — сервис напомнит когда нужно обновить
Клиенты и кабинеты
Добавить клиента
- Нажми + Клиент в шапке
- Введи название клиента — ID сгенерируется автоматически
- Нажми «Добавить клиента»
- В карточке клиента нажми + Таблица и добавь ссылку на Google Sheets
Добавить рекламный кабинет
- В карточке клиента нажми + Кабинет
- Нажми «Загрузить кабинеты» — список подтянется по твоему FB токену
- Выбери нужный кабинет из списка
- Укажи название и timezone кабинета
Управление клиентами
- ▶ Sync — ручной запуск синхронизации
- ✎ — переименовать клиента
- ⏰ — индивидуальное расписание
- Тоггл — включить / выключить автовыгрузку для этого клиента
- ✕ — удалить клиента
Таблицы и метрики
Несколько таблиц на одного клиента
Один клиент может выгружать данные в несколько Google Sheets с разными настройками. Например: одна таблица с базовыми метриками для клиента, другая — с видео и демографией для внутреннего анализа.
- В карточке клиента нажми + Таблица
- Введи название и вставь ссылку на Google Sheets
- Нажми ⚙ Метрики рядом с таблицей чтобы выбрать набор метрик и листов
Выбор листов
Для каждой таблицы можно включить только нужные листы. Например для демографии включи только RAW_demographics — остальные данные записываться не будут.
Выбор метрик
По умолчанию выгружаются все доступные метрики. Отключи ненужные чтобы таблица была чище. Используй кнопки Выбрать все и Убрать все, а также все / нет у каждой группы.
Синхронизация
Ручная синхронизация
В правой части экрана — блок «Ручная синхронизация». Выбери клиента (или «Все клиенты»), укажи период если нужен нестандартный, и нажми ▶ Запустить.
Прогресс синхронизации
После запуска появится блок с прогресс-баром и логом в реальном времени — видно сколько строк получено на каждом уровне. Кнопка 🗑 очищает блок после завершения.
Upsert логика
Сервис не дублирует данные. При каждой синхронизации данные за выбранный период заменяются — старые строки за эти даты удаляются, новые добавляются. Данные за другие периоды не трогаются.
Окно атрибуции
В настройках каждой таблицы можно выбрать окно атрибуции. По умолчанию — 7д клик + 1д просмотр (как в Ads Manager). Выбирай то же окно что используешь в Ads Manager чтобы данные совпадали.
Автовыгрузка
Глобальное расписание
В профиле (клик на своё имя) → раздел «Расписание автовыгрузки» настраивается время и частота для твоего аккаунта.
| Параметр | Описание |
|---|---|
| Время запуска | Час в который запускается выгрузка |
| Частота | Раз в день / каждые 12ч / каждые 6ч |
| Timezone | Для правильного расчёта времени запуска |
Индивидуальное расписание клиента
Нажми ⏰ на карточке клиента чтобы задать отдельное расписание. Если задано — глобальное расписание для этого клиента игнорируется.
Уровни отключения
- Глобально — в профиле, раздел «Расписание автовыгрузки»
- По клиенту — тоггл на карточке клиента
- По кабинету — тоггл на строке кабинета
- По таблице — тоггл на строке таблицы
Telegram уведомления
Подключение
- Открой профиль → раздел «Telegram уведомления»
- Нажми «Открыть Telegram бот» — откроется @adastra_sync_bot
- Напиши боту /start
- Вернись в профиль и нажми ↻ — статус изменится на «Бот подключён»
Что приходит в бот
| Уведомление | Когда |
|---|---|
| ✅ Синхронизация завершена | После каждой успешной выгрузки |
| ❌ Ошибка выгрузки | Если что-то пошло не так |
| ⚠️ Нет данных | Если кабинет вернул пустые данные |
| 📉 Аномалия | Резкое падение или рост ключевых метрик |
| 🔑 Токен скоро истекает | За 14 дней до истечения FB токена |
| 📋 Дайджест расписания | За 1 час до первой выгрузки дня |