Як підключити Google Search Console до SEOAuditAI
Google Search Console (GSC) — це безкоштовний сервіс Google, який показує, як саме Google бачить ваш сайт: за якими запитами вас знаходять, які сторінки в індексі, які — ні, які технічні проблеми Google виявив. SEOAuditAI підключається до вашого GSC через офіційне API, щоб додати ці дані в аудит: реальні топ-запити, CTR, позиції, статус індексації. Підключення безпечне (OAuth, ми не бачимо вашого пароля) і відкликається в один клік у будь-який момент.
Перш ніж починати
Підключення GSC у SEOAuditAI вимагає, щоб ваш сайт уже був зареєстрований і підтверджений у Search Console. Якщо у вас ще немає GSC для цього сайту — спочатку пройдіть кроки 1–3 нижче, потім поверніться сюди.
Якщо ваш сайт уже є в GSC — переходьте одразу до розділу «Підключення до SEOAuditAI» внизу сторінки.
Крок 1 — Створити проперті в Search Console
Відкрийте search.google.com/search-console у браузері та увійдіть тим Google-акаунтом, який буде «власником» даних. ВАЖЛИВО: це має бути той самий акаунт, який ви потім підключите до SEOAuditAI.
Натисніть «Додати ресурс» (Add property). Google запропонує два типи:
Domain property (рекомендовано). Покриває всі піддомени (www, blog, shop) і обидва протоколи (http, https) одним записом. Підтверджується тільки через DNS TXT. Якщо у вас є доступ до налаштувань домену (Cloudflare, реєстратор) — беріть цей варіант.
URL prefix. Конкретна адреса типу https://example.com/ або https://www.example.com/. Не покриває піддомени і протоколи — для кожної комбінації треба окрема проперті. Зате підтверджується чотирма способами замість одного. Беріть якщо немає доступу до DNS, але є доступ до файлів сайту або до коду шаблону.
Крок 2 — Підтвердити володіння
Google пропонує чотири способи. Виберіть один — найзручніший для вашого випадку.
Спосіб 1: DNS TXT (для Domain property)
Google покаже довгий рядок типу google-site-verification=xxxxxxxx. Зайдіть у налаштування домену у вашого реєстратора або DNS-провайдера (Cloudflare, GoDaddy, IM Hosting, тощо). Додайте новий запис: Type=TXT, Name=@ (або порожнє, або сам домен), Value=скопійований рядок від Google. Збережіть, поверніться в GSC, натисніть Verify. Зазвичай підтверджується за хвилину, інколи до 24 годин.
Спосіб 2: HTML-файл (тільки URL prefix)
Google запропонує скачати файл з назвою типу google1234abc.html. Завантажте його в корінь сайту, щоб він був доступний за адресою https://example.com/google1234abc.html. Підходить тільки якщо у вас є FTP/SFTP-доступ або файловий менеджер у хостингу.
Спосіб 3: Мета-тег у <head> (тільки URL prefix)
Google дасть рядок виду <meta name="google-site-verification" content="..." />. Вставте його в <head> головної сторінки сайту. Для більшості сучасних CMS це робиться через SEO-плагін або через окреме поле в адмінці — дивіться інструкції для конкретних платформ нижче.
Спосіб 4: Google Analytics або Google Tag Manager
Якщо у вас уже стоїть GA4 (Google Analytics) або GTM (Google Tag Manager) на сайті, і ви адміністратор того ж самого Google-акаунта — Google підтвердить володіння в один клік. Це найшвидший шлях, якщо умови виконуються.
Платформо-специфічні інструкції для мета-тегу
Tilda
Зайдіть у Site Settings → More → Head code. Вставте отриманий від Google <meta>-тег. Натисніть Save. Опублікуйте сайт (Publish). Поверніться в GSC, натисніть Verify.
WordPress + Yoast SEO
Зайдіть у Yoast SEO → General → Site connections → Google. Вставте тільки значення content="..." (без <meta>-обгортки). Натисніть Save changes. Поверніться в GSC, натисніть Verify.
WordPress + RankMath
Зайдіть у Rank Math → General Settings → Webmaster Tools → Google Search Console. Вставте значення content без обгортки. Save Changes.
WordPress без SEO-плагіна
Не рекомендовано: ручне редагування header.php теми скидається при оновленні теми. Краще встановити Yoast або RankMath, це безкоштовно.
Weblium
Зайдіть у Site Settings → SEO → Verification meta tags → Google Search Console. Вставте значення content. Save. Опублікуйте сайт.
Кастомний сайт без CMS
Просто додайте <meta>-тег у <head> головного HTML-файлу (зазвичай index.html). Якщо сайт на статичному генераторі (Next.js, Hugo, Jekyll) — вставте в шаблон головної сторінки і задеплойте.
Крок 3 — Підключення до SEOAuditAI
Після підтвердження володіння в GSC — поверніться в SEOAuditAI:
- Зайдіть у свій кабінет: seoauditai.com.ua/dashboard
- Знайдіть картку «Підключіть Google Search Console» з кольоровою Google-іконкою
- Натисніть «Підключити GSC»
- Виберіть той самий Google-акаунт, під яким ви налаштовували GSC
- На екрані згоди Google натисніть Allow (Дозволити)
- Вас поверне в SEOAuditAI з зеленим банером «Google Search Console підключено»
Готово. Усі наступні аудити автоматично отримають дані з GSC.
Що робити, якщо ресурс підключено, але «немає доступу до даних»
Якщо в аудиті ви побачили повідомлення «GSC підключено, але немає доступу до даних цього ресурсу», це означає, що ваш Google-акаунт під'єднаний до SEOAuditAI правильно, але саме цей ресурс не верифікований за вашим акаунтом (або вам не дали прав читати його дані). Google не віддає запити, кліки й позиції, поки володіння не підтверджене. Виправити можна двома шляхами:
Якщо це ваш сайт. Підтвердіть володіння ресурсом у Search Console — це той самий процес, що в Кроках 1 і 2 вище: відкрийте search.google.com/search-console тим самим Google-акаунтом, виберіть ресурс зі статусом «Не підтверджено» (Not verified) і пройдіть підтвердження одним зі способів: DNS TXT, HTML-файл, мета-тег у <head> або через Google Analytics / Tag Manager. Платформо-специфічні підказки для мета-тегу — у розділі вище.
Якщо це сайт клієнта. Попросіть власника додати вас: у його Search Console → Settings → Users and permissions → Add user → ваша email-адреса, права щонайменше «Restricted». Після цього ваш акаунт бачитиме ресурс як підтверджений.
Коли ресурс підтверджено — поверніться в SEOAuditAI і запустіть аудит ще раз. Наявний звіт не оновиться сам: GSC-дані підтягуються в момент створення аудиту.
Як додати новий домен у вже підключений Google-акаунт
Якщо ви побачили в аудиті повідомлення «Цей домен не серед ваших GSC-property», це означає, що ваш Google-акаунт підключений до SEOAuditAI правильно, але самого аудитованого сайту немає у вашій Search Console. Виправити швидко:
- Відкрийте search.google.com/search-console у браузері. Увійдіть тим самим Google-акаунтом, який вже підключений до SEOAuditAI, інакше новий домен не з'явиться у звітах.
- Зліва вгорі натисніть selector з назвою поточної проперті, виберіть «+ Додати ресурс» (Add property). Виберіть тип (Domain або URL prefix) і пройдіть підтвердження володіння. Детально про обидва типи і способи підтвердження написано вище у Кроках 1 і 2.
- Поверніться у SEOAuditAI і запустіть аудит ще раз. Наявний звіт не оновиться сам, бо GSC-дані підтягуються в момент створення аудиту. Новий аудит підхопить новий домен одразу.
Що робити, якщо Google не повернув refresh-токен
Google видає refresh-токен лише при першому підключенні додатка. Якщо ви вже колись підключали SEOAuditAI до цього Google-акаунта і пізніше відключили — повторне підключення проходить без refresh-токена, поки ви явно не відкличете доступ через налаштування Google. Виправити це швидко:
- Відкрийте myaccount.google.com/permissions
- Знайдіть «SEOAuditAI» у списку «Сторонні додатки з доступом до акаунта»
- Натисніть на нього і виберіть «Відкликати доступ» (Remove access)
- Поверніться на /dashboard і натисніть «Підключити GSC» ще раз
Після цього refresh-токен прийде нормально і підключення збережеться.
Часті запитання
Я підключив, але в звіті аудиту немає даних з GSC. Що не так?
Найчастіша причина — підключений Google-акаунт не той, під яким налаштовано GSC для цього сайту. Зайдіть на /dashboard, відключіть поточний GSC, підключіть інший Google. Ще одна причина — сайт додано в GSC як https://www.example.com/, а аудит запускали для example.com (без www). Перевірте, що в GSC проперті покриває обидва варіанти, або додайте друге.
Чи можу я підключити сайт клієнта, до якого я не маю прямого доступу?
Так, якщо клієнт дав вам доступ через GSC. Він має зайти у свою Search Console, відкрити Settings → Users and permissions → Add user, ввести вашу email-адресу і дати щонайменше Restricted права. Після цього ваш Google-акаунт бачитиме сайт клієнта як підтверджений.
Треба підтверджувати кожен субдомен окремо?
Тільки якщо ви вибрали URL prefix property. Якщо вибрали Domain property — один запис автоматично покриває всі субдомени і протоколи.
Що робити, якщо мій DNS-провайдер не дозволяє додавати TXT-записи?
Будь-який нормальний реєстратор домену це дозволяє. Якщо ваш ні — або провайдер дуже старий і час змінити, або просто скористайтеся URL prefix замість Domain property і підтвердіть через мета-тег.
Чи безпечно давати SEOAuditAI доступ до GSC?
Ми використовуємо стандартний OAuth 2.0 від Google. Ми ніколи не бачимо вашого пароля. Ми запитуємо тільки право читати дані Search Console (scope webmasters.readonly) — ніяких прав на редагування, видалення сайтів чи зміну налаштувань. Ви можете відкликати доступ у будь-який момент через myaccount.google.com/permissions.