Bu rehberde: Sitenizin Google aramadaki performansını OrqLabs'a taşırsınız. Mülk adresinizi doğru biçimde girer ve Google hesabınızla izin verirsiniz.
⏱ 15 dakika (Google Cloud kurulumu hazırsa)
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | GOOGLE_SEARCH_CONSOLE |
| Kategori | Analitik ve SEO |
| Kimlik doğrulama | İzin ekranı (Google) + Site URL / property alanı |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Yetenekler | Analitik okuma |
| Kullanan kutular | Search Console |
| Kullanan ajanlar | SEO & Traffic, Analytics Strategist |
Ne işe yarar?
Hangi aramalarda göründüğünüzü, tıklama, gösterim, tıklama oranı ve ortalama sırayı OrqLabs'a taşır. SEO & Traffic ajanı düşük tıklanan ama çok gösterilen aramaları ve 5-15. sıradaki fırsatları buradan bulur.
Ön koşullar
- search.google.com/search-console üzerinde doğrulanmış bir mülk ve Sahip, Tam veya Kısıtlı kullanıcı yetkisi (Kısıtlı okuma için yeterli).
- Google Cloud OAuth istemcisi (GA4 ile paylaşılır): yönetici
GOOGLE_CLIENT_ID,GOOGLE_CLIENT_SECRET.
Adım adım kurulum
A) Google Cloud Console (platform yöneticisi)
- APIs & Services → Library → ① Google Search Console API → Enable.
- Google Auth Platform → Data Access → ① kapsam ekleyin:
https://www.googleapis.com/auth/webmasters.readonly. - ③ Audience: Testing'de test kullanıcılarını ekleyin (izin 7 gün); canlı için In production. ② Hassas kapsam; production'da doğrulama gerekir.
- Clients → mevcut Web application istemcisi → ① Authorized redirect URIs listesine ekleyin:
https://api.orqlabs.com/api/v1/integrations/oauth/google_search_console/callback. ③ Save.
B) Mülk adresini belirleme
| Mülk türü | Search Console'da görünüm | OrqLabs'a girilecek değer |
|---|---|---|
| ① Alan adı mülkü | ornek.com | sc-domain:ornek.com |
| ② URL ön eki | https://www.ornek.com/ | https://www.ornek.com/ (sondaki / dahil, birebir) |
Alan adı mülkü tüm alt alan adlarını kapsar; mümkünse onu kullanın.
C) OrqLabs'ta bağlama
- Entegrasyonlar → Google Search Console → Bağla → ① Proje.
- Site URL / property alanına mülk değerini girin.
- ② Bağla → mülke yetkili Google hesabını seçin → izni onaylayın.
- Geri dönüşte OrqLabs erişilebilir mülkleri kontrol eder; girdiğiniz mülk listede yoksa uyarı verir.
- Bağlantıyı test et: son 7 günün tıklama/gösterim toplamı görünür.
İzinler ve kapsamlar
| Kapsam | Neden gerekli |
|---|---|
https://www.googleapis.com/auth/webmasters.readonly | Mülk listesi ve arama analitiği (salt okunur) |
OrqLabs Search Console'da değişiklik yapmaz.
Limitler
| Konu | Sınır |
|---|---|
| Veri gecikmesi | 2-3 gün; sorgular otomatik geriye kaydırılır |
| Geçmiş | 16 ay |
| Satır | İstek başına 25.000; kutu varsayılanı 200 |
| Kota | Pratikte sınıra ulaşılmaz |
| Boyutlar | query, page, country, device |
| Anonimleştirme | Düşük hacimli sorgular gizlenir |
Bağlantıyı test etme
② Bağlantıyı test et mülk erişimini ve 7 günlük toplamları döndürür. Analitik sayfasındaki Search Console bölümünde ilk sorgular görünür; Şimdi senkronize et hızlandırır.
Kimlik bilgilerini yenileme
- Production'da izin süresizdir; 6 ay kullanılmazsa veya kullanıcı kaldırırsa düşer → Yeniden yetkilendir.
- Mülk yetkisi kaldırılırsa
INVALID(403); Search Console'da kullanıcıyı yeniden ekleyin. - Mülk değiştirmek için Düzenle → Site URL / property.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
| "redirect_uri_mismatch" | Adres eklenmemiş | Clients → URI ekleyin |
INVALID – 403 "sufficient permission for site" | Hesap yetkili değil veya mülk adı yanlış | Doğru hesap; sc-domain: ve / birebir |
INVALID – 404 "Site not found" | Mülk türü karışmış | Alan adı / URL ön eki kontrolü |
AUTH – invalid_grant | Testing 7 gün veya iptal | Yeniden yetkilendir |
RATE_LIMIT – 429 | Dakika kotası | Saatlik çalıştırmaları azaltın |
| Veri boş | Son 2-3 gün veya yeni mülk | 7 gün ve üstü; bekleyin |
Sık sorulan sorular
GA4 ile aynı hesabı kullanabilir miyim? Evet. Aynı Google istemcisi ve aynı Google hesabı işe yarar; yalnızca Search Console'da mülk yetkisi olmalı.
Hangi mülk türünü seçmeliyim?
Alan adı mülkü (sc-domain:). Tüm alt alan adlarını ve http/https sürümlerini kapsar.
Veri neden 3 gün geride? Google Search Console verisi 2-3 gün gecikmelidir. OrqLabs bunu otomatik hesaba katar.