How Sync Works
Як ваші дані з Google Search Console потрапляють у SEO Rocks: коли оновлюються метрики, як з'являються нові сайти, що відбувається при додаванні Google-акаунту, і чому деякі речі (наприклад індексація) приходять з невеликою затримкою.
Зміст
cloud_sync Що таке sync і навіщо він
Google Search Console тримає ваші дані у себе — кожен запит до них іде через API і займає секунди-хвилини. SEO Rocks копіює ці дані у власну базу щоб дашборди відкривалися миттєво (десятки мілісекунд замість десятків секунд) і щоб ми могли робити складні агрегації яких в GSC немає.
Sync — це фоновий процес який тягне свіжі дані з GSC за вас. Ви нічого не натискаєте: усе оновлюється автоматично за розкладом. Дані в дашборді — це копія GSC на момент останнього sync.
Затримка Google: сам Google публікує метрики з лагом 2 дні. Наприклад,
сьогоднішній день з'являється тільки післязавтра. Це обмеження GSC, не наше.
schedule Що, коли і як оновлюється
Розклад фонових задач (час UTC):
| Час | Що оновлюється | Як часто |
|---|---|---|
| schedule 02:00 UTC | Оновлення кешу дашбордів (швидші відкриття сторінок) | щодня |
| schedule 04:00 UTC | Google Core Updates — нові офіційні апдейти Google для маркерів на графіках | щодня |
| schedule 06:00 UTC | Ранковий sync (~08:00 за Києвом). Доганяє останні 3 дні метрик для всіх ваших сайтів: clicks, impressions, queries, pages, countries, devices, search appearance | щодня |
| schedule 14:00 UTC | Денний catch-up sync (~16:00 за Києвом). Догоняє дані, які Google не встиг віддати вранці — інколи у GSC лаг 3 дні замість 2, і вчорашні рядки з'являються тільки після обіду | щодня |
| schedule Пн 05:00 UTC | Перерахунок Topic Clusters | щотижня |
| schedule Нд 03:00 UTC | Очищення даних для сайтів які ви видалили >7 днів тому | щотижня |
| timer Кожні 3 год | Перевірка нових сайтів які ви могли додати в GSC (auto-discovery) | ~8 раз/добу |
| timer Кожні 10 хв | Самовідновлення застряглих синхронізацій (якщо щось обірвалось) | безперервно |
Якщо коротко: метрики оновлюються двічі на день — вранці о 08:00 за Києвом та вдень о 16:00 за Києвом (другий прохід догоняє дані які Google не встиг віддати вранці). Нові сайти підхоплюються до 3 годин після того як ви додали їх у GSC.
person_add Як додати новий Google-акаунт
Коли ви натискаєте "Connect Google Account" на сторінці Settings → Accounts:
1
Відкривається сторінка Google де ви даєте дозвіл на читання Search Console.
~30 секунд
2
SEO Rocks отримує список усіх верифікованих сайтів цього акаунту з GSC. Ви бачите модалку
зі статусами для кожного: New (нові), Already imported,
In other account, Permission revoked, тощо.
~2 секунди
3
Ви позначаєте галочками які сайти імпортувати → натискаєте "Import".
4
Phase 1 — Метрики (швидко): для кожного нового сайту тягнеться вся
історія за 16 місяців: clicks, impressions, queries, pages, countries, devices, search appearance.
Сайт стає доступним як тільки метрики готові — ви вже можете аналізувати трафік, графіки і таблиці.
5-15 хвилин на акаунт з 10 сайтів
5
Phase 2 — Indexing (повільно, у фоні): після метрик окремо запускається
URL Inspection для tab "Indexing". Тут Google обмежує до 2000 перевірок на день на сайт —
тому великі сайти індексуються поступово, день за днем. Метрики від цього не страждають.
години-дні залежно від розміру сайту
Скільки треба чекати? Зазвичай дашборди з метриками доступні за 5-15 хвилин після Import.
Tab "Indexing" наповнюється поступово — для невеликих сайтів повністю за 1 день, для великих (10+ тисяч URL) — за тиждень.
add_link Як з'являється новий сайт у вже підключеному акаунті
Сценарій: ви додали новий property в GSC (наприклад, https://newproject.com/) під вже
підключеним до SEO Rocks Google-акаунтом. Що відбувається:
1
Auto-discovery cron запускається кожні 3 години. Він перевіряє кожен ваш
активний Google-акаунт через GSC API: чи з'явилися нові verifiед-сайти.
через ≤ 3 години після додавання у GSC
2
Як тільки новий сайт виявлено — він автоматично додається до вашого Default workspace зі статусом pending
і в чергу sync ставиться задача "тягнути повну історію".
3
Worker бере задачу і синкає метрики (Phase 1) за всю історію 16 місяців.
5-15 хвилин для типового сайту
4
Після метрик окремо запускається indexing (Phase 2) — поступово в межах 2000/день quota.
Як прискорити: якщо не хочете чекати 3 години — зайдіть у Settings → Accounts і натисніть
Discover у потрібного акаунту. Це запустить пошук нових сайтів одразу.
manage_search Чому Indexing tab наповнюється поступово
Google має дві окремі API:
- Search Analytics API — для метрик (clicks, impressions, queries). Ліміт 1200 запитів/хв на весь додаток. Швидкий.
- URL Inspection API — для табу Indexing (verdict, coverage, last crawl). Ліміт 2000 запитів на день на КОЖЕН сайт окремо. Повільний.
Тобто навіть якщо ми хочемо проіндексувати сайт з 10 000 URL — Google дасть нам тільки 2000 перевірок сьогодні. Решту ми догоняємо протягом наступних днів.
Що ми робимо: метрики синкаються одразу і повністю — сайт у вас доступний. Окремо у фоні працює job для indexing який щодня викликає до 2000 inspections на сайт. URLs з'являються в табі Indexing поступово, поки ми не покриємо всі.
Реальний приклад: сайт з 5 000 URL — повна індексація готова за 2-3 дні.
Сайт з 30 000 URL — за 15 днів. Це обмеження Google, не наше — у нас немає способу його обійти.
hourglass_top Очікувані затримки і таймінг
| Подія | Час до появи в SEO Rocks |
|---|---|
| Дані за сьогодні (метрики GSC) | ~48 годин (Google ліміт, не наш) |
| Підключення Google-акаунту → метрики готові | 5-15 хвилин |
| Підключення Google-акаунту → повна індексація | від 1 дня до тижня+ (залежить від розміру сайтів) |
| Новий сайт у GSC → з'являється в SEO Rocks | до 3 годин (auto-discovery) |
| Новий сайт через кнопку "Discover" → з'являється | миттєво |
| Свіжі дані за минулий день | 06:00 UTC (~08:00 Київ) + повтор о 14:00 UTC (~16:00 Київ) |
| Нові Google Core Updates на графіках | 04:00 UTC щодня |
help Що робити якщо щось не з'являється
Підключив акаунт, минуло 30 хвилин — даних немає
- Перевір Settings → Accounts: який статус у сайтів. Якщо syncing — потерпи, працює. Якщо failed або no permission — Google не дає нам доступ до цього сайту.
- Якщо акаунт у Settings показано як Disconnected — натисни Reconnect, OAuth-токен Google міг прострочитися.
Indexing tab порожній або частково заповнений
- Це норма для нових сайтів — URL-и підвантажуються поступово в межах 2000/день на сайт.
- Перевір "Last crawl" у вкладці — якщо там є дати, значить indexing працює, просто йде поступово.
Сайт додав у GSC, але в SEO Rocks нема
- Auto-discovery працює раз на 3 години. Якщо терпіти не можна — натисни Discover у Settings → Accounts.
- Переконайся що сайт у GSC verifiед (іконка зеленої галочки). Не-верифіковані сайти ми пропускаємо.
Дані застаріли — останній sync день/два тому
- Перевір Settings → Cron Jobs — там видно коли востаннє відпрацював нічний sync і чи були помилки.
- Можеш натиснути Sync у Settings → Accounts → справа від акаунту — запустити синк вручну.
Підозра що щось зламано
Напиши нам — на сторінці Changelog внизу є контакт. Прикладай скриншот сторінки Settings → Cron Jobs з останніми логами — це нам швидко покаже причину.
Технічна документація архітектури — у файлі SYNC.md репозиторію.