Google Analytics 4'ü Elido'ya bağlayın

Elido, dönüşüm olaylarını Measurement Protocol kullanarak sunucu tarafında GA4'e gönderir. Bu, kullanıcının reklam engelleyicisi olup olmadığına bakılmaksızın ve sayfanızda hiçbir JavaScript olmadan dönüşümlerin GA4'te görünmesi anlamına gelir.

Neye ihtiyacınız var

• Bir GA4 mülkü (Universal Analytics değil).
• Mülkün Yönetici paneline erişim.
• Yaklaşık 5 dakika.

Adım 1 — Measurement ID'nizi bulun

1. Google Analytics'e gidin.
2. Admin'e tıklayın (sol altta dişli simgesi).
3. Property altında Data streams → Web'e tıklayın.
4. Web veri akışınıza tıklayın.
5. Measurement ID'yi kopyalayın — G- ile başlar, ör. G-XXXXXXXXXX.

Adım 2 — Bir Measurement Protocol API secret'ı oluşturun

Aynı veri akışı sayfasında:

1. Measurement Protocol API secrets'a kadar aşağı kaydırın.
2. Create'e tıklayın.
3. Bir isim verin ("Elido") ve Create'e tıklayın.
4. Secret değerini kopyalayın. Yalnızca bir kez gösterilir. Kaybederseniz yenisini oluşturun — eski secret'lar siz silene kadar çalışmaya devam eder.

Adım 3 — Elido'da yapılandırın

1. Panel → Conversions → GA4 → Set up forwarding'e gidin.
2. Measurement ID'yi ve API secret'ı yapıştırın.
3. Kaydet'e tıklayın. Elido hemen bir test olayı (elido_test) GA4'e gönderir.

Elido, client_id'yi nasıl eşler

GA4, olayları bir kullanıcıya atfetmek için bir client_id gerektirir. Elido bunu şu şekilde türetir:

1. Kısa bağlantı hedef sayfanız bir _ga çerezi ayarlıyor ve değer dönüşüm pikseliniz aracılığıyla geri iletiliyorsa — Elido onu doğrudan okur.
2. Aksi halde Elido, Elido click_id'sini (ör. clk_abc123) kararlı bir UUID biçimli dizeye hash'ler ve bunu client_id olarak kullanır.

Bu, GA4'ün bu olayları mevcut GA4 web oturumlarınızla eşleşmeyebilecek bir "kullanıcı" altında göstereceği anlamına gelir — birbirine dikilmezler. Tam oturum birleştirmesi için _ga çerez değerini sunucunuza aktarın ve Elido Conversions API çağrısına ekleyin.

GA4'teki olay adları

Elido şu olayları iletir:

Elido olayı	GA4 olay adı
conversion.recorded	purchase (değer + para birimiyle)
link.clicked (etkinse)	elido_click
threshold.exceeded	elido_threshold

purchase olayı kullanılır çünkü GA4'ün Monetization bölümünde bunun için yerleşik raporlama vardır. Tüm olaylar, olay parametreleri olarak utm_source, utm_medium, utm_campaign içerir.

Sorun giderme

Realtime'da hiç olay görünmüyor — Measurement ID'yi ve API secret'ı kontrol edin. Yanlış bir API secret HTTP 204 (içerik yok) döndürür ama GA4 yükü sessizce düşürür. Measurement Protocol uç noktasını doğrudan çağırarak doğrulayın:

curl -X POST \
  "https://www.google-analytics.com/debug/mp/collect?measurement_id=G-XXXX&api_secret=YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"test","events":[{"name":"elido_test","params":{}}]}'

Başarılı bir hata ayıklama çağrısı {"validationMessages":[]} döndürür.

Olaylar Realtime'da görünüyor ama normal raporlarda görünmüyor — Measurement Protocol olayları, gerçek zamanlı olmayan GA4 raporlarında görünmek için 24-48 saat sürebilir. Bu bir GA4 sınırlamasıdır, Elido sorunu değildir.

Purchase olaylarında yanlış para birimi — Elido, para birimini dönüşüm olayının currency alanından okur. Varsayılan EUR'dur. Dönüşüm kaydetme API çağrınızda açıkça belirleyin.

Yinelenen olaylar — Siteniz de istemci tarafında bir GA4 purchase olayı tetikliyorsa çift kayıt görürsünüz. İstemci tarafı olayı devre dışı bırakın veya Elido eşleme ayarlarında farklı bir olay adı kullanın.