Google Analytics 4

Bu rehberde: Web sitenizin ziyaretçi ve dönüşüm verisini OrqLabs'a taşırsınız. Platform yöneticisi Google Cloud'da bir kez OAuth istemcisi kurar; siz mülk kimliğinizi girip Google hesabınızla izin verirsiniz.

⏱ 25 dakika (Google Cloud kurulumu dahil)

Kimlik kartı#

Ne işe yarar?#

• Her gün bir önceki günün verisi çekilir; Analitik sayfasında ve Panel'de görünür.
• GA4 raporu kutusu iş akışı içinde istediğiniz metrik ve boyut raporunu üretir.
• KPI kontrolü kutusu bir metriği eşikle karşılaştırır.
• Analytics Strategist sonuçları hedeflere göre değerlendirir ve stratejiyi günceller.

Entegrasyon yalnızca okur; GA4'te hiçbir ayar değiştirilmez.

Ön koşullar#

• Bir GA4 mülkü (eski Universal Analytics desteklenmez).
• Bağlantıyı yapacak Google hesabının mülkte en az Viewer rolü.
• Platform yöneticisinin GOOGLE_CLIENT_ID ve GOOGLE_CLIENT_SECRET tanımlamış olması. Bu tek istemci GA4, Search Console, YouTube ve Sheets tarafından paylaşılır.
• OrqLabs'ta Sahip veya Yönetici rolü ve boş entegrasyon hakkı (FREE 2, STARTER 8, PRO 30).

Adım adım kurulum#

A) Google Cloud Console (platform yöneticisi, bir kez)#

1. console.cloud.google.com → proje seçin veya New project.
2. APIs & Services → Library → ① Google Analytics Data API → Enable.

3. Google Auth Platform:
   • Branding: uygulama adı (örneğin "OrqLabs"), destek e-postası, yetkili alan adları.
   • ③ Audience: Internal (yalnızca kendi Workspace kullanıcılarınız; doğrulama gerekmez) veya External. External'da başlangıç Testing: en fazla 100 test kullanıcısı ve 7 günde dolan izin. Canlı için Publish app → In production.
   • ① Data Access → Add or remove scopes → https://www.googleapis.com/auth/analytics.readonly → Update → Save.

4. Clients → Create client → Web application. ① Authorized redirect URIs → Add URI:

https://api.orqlabs.com/api/v1/integrations/oauth/google_analytics/callback
https://api.orqlabs.com/api/v1/integrations/oauth/google_search_console/callback
https://api.orqlabs.com/api/v1/integrations/oauth/youtube/callback
https://api.orqlabs.com/api/v1/integrations/oauth/google_sheets/callback

② Authorized JavaScript origins: https://app.orqlabs.com. ③ Save. ④ Client ID ve Client secret değerlerini kopyalayın. 5. Yönetici GOOGLE_CLIENT_ID ve GOOGLE_CLIENT_SECRET tanımlar ve API'yi yeniden başlatır.

Geliştirici notu: Yerel geliştirmede http://localhost:4000/api/v1/integrations/oauth/google_analytics/callback adresi eklenebilir; Google localhost adreslerine izin verir.

B) Google Analytics'te mülk kimliği#

1. analytics.google.com → Admin → Property → Property details.
2. ① PROPERTY ID: 9 haneli sayı (örneğin 123456789). ② G-XXXXXXX ölçüm kimliği ile karıştırmayın.
3. ③ Bağlantıyı yapacak hesabın erişimi yoksa Property access management → + → Add users → rol Viewer.

C) OrqLabs'ta bağlama#

1. Entegrasyonlar → Google Analytics 4 → Bağla.
2. ① Proje seçin.
3. GA4 Property ID alanına properties/123456789 biçiminde girin (properties/ ön eki dahil).
4. ② Bağla. Google izin ekranı açılır. Doğru hesabı seçin; uygulama Testing'de ise "Google hasn't verified this app" uyarısında Continue. İstenen izin yalnızca "Google Analytics verinizi görme" olmalıdır.
5. Geri dönüşte kart Bağlı görünür.
6. Bağlantıyı test et, ardından Şimdi senkronize et ile ilk veriyi çekin. Mülk kimliğini sonradan Düzenle ile değiştirebilirsiniz.

Veri senkronizasyonu#

• Günlük çekim: her gün bir önceki gün çekilir. GA4 verisi 24-48 saatte kesinleştiği için son iki gün her seferinde yeniden yazılır.
• Manuel: karttaki Şimdi senkronize et.
• GA4 raporu kutusu: Metrics (varsayılan sessions, totalUsers, conversions, engagementRate), Dimensions (varsayılan date, sessionDefaultChannelGroup), Date range, Row limit (varsayılan 500).
• KPI kontrolü: ga.sessions, ga.users, ga.new_users, ga.pageviews, ga.engaged_sessions, ga.conversions, ga.avg_session_duration, ga.bounce_rate.

Sık kullanılan GA4 adları (büyük/küçük harfe duyarlı):

İzinler ve kapsamlar#

Başka izin istenmez. Yazma izni görüyorsanız yanlış istemciye bağlanıyorsunuz demektir.

Doğrulama#

• Internal uygulamalar doğrulama gerektirmez; tek şirket için en pratik yol.
• External + Testing: 100 test kullanıcısı, izin 7 günde düşer; kart her hafta "Yeniden yetkilendirme gerekli" olur.
• External + In production: analytics.readonly hassas olduğu için Google doğrulaması (gizlilik politikası, alan adı sahipliği, kısa açıklama). Birkaç iş günü.
• Workspace yöneticisi üçüncü taraf uygulamaları kısıtladıysa "This app is blocked" alırsınız; yönetici istemciyi güvenilir yapmalı.

Limitler#

Sık çalışan akışlarda KPI kontrolü kullanın; bu kutu GA4'e istek atmaz, günlük verileri okur.

Bağlantıyı test etme#

② Bağlantıyı test et son 7 günün oturum toplamını çeker. Sıfır oturum da geçerli bir sonuçtur. Sonra Şimdi senkronize et ve Analitik sayfasında dünün değerlerini görün.

Kimlik bilgilerini yenileme#

• Erişim ~1 saat geçerlidir; OrqLabs otomatik yeniler.
• Yenileme şu durumlarda düşer: Testing modunda 7 gün; kullanıcı myaccount.google.com/permissions sayfasından erişimi kaldırdı; istemci silindi; parola zorunlu sıfırlandı. Yeniden yetkilendir aynı kaydı korur.
• Başka Google hesabına taşımak için silmeyin; Yeniden yetkilendir akışında farklı hesabı seçin.

Sık karşılaşılan hatalar#

Sık sorulan sorular#

Google hesabımın şifresini veriyor muyum? Hayır. Google'ın kendi izin sayfasında yalnızca "Analytics verisini görme" izni verirsiniz.

Hangi hesapla izin vermeliyim? GA4 mülkünde en az Viewer rolü olan bir hesapla. Şirketten ayrılmayacak bir hesap seçin.

Her hafta yeniden bağlanmam isteniyor. Neden? Google uygulaması Testing modunda. Yönetici uygulamayı yayınlamalı (In production) veya Internal yapmalı.

Sonraki adım#

• Google Analytics kurulumu ve strateji döngüsü
• Ajanlar analitiği nasıl kullanır
• Google Search Console