Genel Bakış

Bu rehber, Hardal analitik verilerinizi Measurement Protocol kullanarak doğrudan Google Analytics 4’e (GA4) nasıl göndereceğinizi açıklar. Bu server-to-server entegrasyonu, client-side tracking ad blocker’lar veya gizlilik kontrolleri tarafından sınırlandırıldığında bile doğru analitiği korumayı sağlar.

Ön Koşullar

Bu entegrasyonu kurmadan önce, şunlara sahip olduğunuzdan emin olun:

  • Tracking script’i kurulu aktif bir Hardal hesabı

  • Google Analytics 4 özelliğinize erişim

  • Websiteniz veya uygulamanız için oluşturulmuş bir GA4 veri akışı

  • GA4 özelliğinizden API secret ve Measurement ID

  • HTTP istekleri ve JSON hakkında temel bilgi

GA4 Measurement Protocol Kurulumu

GA4 API kimlik bilgilerinizi alın

1

Google Analytics'e giriş yapın

analytics.google.com adresinden Google Analytics 4 özelliğinize erişin

2

Data Streams'e gidin

Admin > Data Streams’e gidin ve web veri akışınızı seçin

3

API secret'lara erişin

Akış ayarlarında Measurement Protocol API secrets’a tıklayın

4

Yeni bir secret oluşturun

Yeni bir API secret oluşturmak için Create butonuna tıklayın

5

Kimlik bilgilerini kopyalayın

Hem Measurement ID’nizi (G-XXXXXXXX) hem de yeni oluşturulan API Secret’ı kopyalayın

Hardal Entegrasyonunu Yapılandırma

Hardal destinations’a erişin

1

Hardal'a giriş yapın

app.usehardal.com adresinden Hardal dashboard’unuza giriş yapın

2

Marketing Destinations'a erişin

Ana menüdeki Marketing Destinations bölümüne gidin

3

Yeni destination ekleyin

Add Custom Destination butonuna tıklayın

4

GA4 şablonunu seçin

Mevcut şablonlardan “GA4 Measurement Protocol”ü seçin (veya mevcut değilse custom API bağlantısı oluşturun)

Endpoint Yapılandırması

GA4 endpoint’inizi aşağıdaki ayarlarla yapılandırın:

{
  "endpoint_label": "Google Analytics 4",
  "endpoint_id": "ga4-measurement-protocol",
  "endpoint_url": "https://www.google-analytics.com/mp/collect?measurement_id=G-XXXXXXXX&api_secret=YOUR_API_SECRET",
  "request_method": "POST",
  "content_type": "application/json",
  "request_format": {
    "client_id": "##user_id##",
    "events": [
      {
        "name": "##event_name##",
        "params": {
          "session_id": "##session_id##",
          "engagement_time_msec": 100,
          "page_location": "##page.url##",
          "page_title": "##page.title##",
          "page_referrer": "##page.referrer##"
        }
      }
    ]
  }
}

Event Eşleştirme

Temel Event Eşleştirme

Entegrasyon, yaygın Hardal event’lerini otomatik olarak GA4 event’lerine eşleştirir. İşte temel event’lerin nasıl eşleştirildiği:

Hardal EventGA4 Event
page_viewpage_view
clickclick
purchasepurchase
add_to_cartadd_to_cart
begin_checkoutbegin_checkout
view_itemview_item

Özel Event Eşleştirme

Özel event’ler için, özel bir eşleştirme oluşturmanız gerekebilir. İşte bir e-ticaret satın alma event’i için örnek bir eşleştirme:

{
  "endpoint_label": "GA4 E-commerce",
  "endpoint_id": "ga4-ecommerce",
  "endpoint_url": "https://www.google-analytics.com/mp/collect?measurement_id=G-XXXXXXXX&api_secret=YOUR_API_SECRET",
  "request_method": "POST",
  "content_type": "application/json",
  "request_format": {
    "client_id": "##user_id##",
    "events": [
      {
        "name": "purchase",
        "params": {
          "transaction_id": "##properties.transaction_id##",
          "value": ##properties.value##,
          "currency": "##properties.currency##",
          "tax": ##properties.tax##,
          "shipping": ##properties.shipping##,
          "items": ##properties.items##,
          "session_id": "##session_id##",
          "engagement_time_msec": 100
        }
      }
    ]
  }
}

Gelişmiş Yapılandırma

Kullanıcı Özelliklerini Dahil Etme

Event’lerinizle birlikte kullanıcı özelliklerini dahil etmek için, istek formatınıza bir user_properties nesnesi ekleyin:

{
  "client_id": "##user_id##",
  "user_properties": {
    "user_type": {
      "value": "##properties.user_type##"
    },
    "membership_level": {
      "value": "##properties.membership_level##"
    }
  },
  "events": [
    // Event verileri buraya
  ]
}

Özel Parametreler Ayarlama

Gelişmiş kullanım durumları için, event’lerinize özel parametreler dahil edebilirsiniz:

{
  "name": "##event_name##",
  "params": {
    "custom_param1": "##properties.custom_param1##",
    "custom_param2": "##properties.custom_param2##",
    "session_id": "##session_id##",
    "engagement_time_msec": 100
  }
}

Event Doğrulama

Entegrasyonunuzu kurduktan sonra, event’lerin düzgün şekilde alındığını doğrulayın:

  1. Hardal üzerinden test event’leri gönderin

  2. GA4 DebugView’da event’lerin görünüp görünmediğini kontrol edin

  3. Event’lerin GA4 raporlarında göründüğünü doğrulayın (24 saate kadar sürebilir)

En İyi Uygulamalar

Performans Düşünceleri

  • Mümkün olduğunda birden çok event’i tek bir istekte toplu işleyin (25 event’e kadar)

  • Başarısız istekler için hata yönetimi ve yeniden deneme mantığı uygulayın

  • Yüksek trafik hacimlerini yönetmek için uygun önbelleğe alma stratejileri kullanın

Veri Kalitesi

  • Tüm event’lerle session_id ve engagement_time_msec dahil edin

  • Tutarlı parametre adlandırma kuralları kullanın

  • Kişisel Tanımlayıcı Bilgileri (PII) göndermekten kaçının

  • Göndermeden önce veri formatlarını doğrulayın (özellikle para birimi değerleri için)

Gizlilik Uyumluluğu

  • Veri toplamanızın gizlilik düzenlemelerine uyduğundan emin olun

  • Uygulanabilir olduğunda kullanıcı onay tercihlerine saygı gösterin

  • Gizlilik politikanızda uygun açıklamaları dahil edin

  • Hassas bilgiler için veri filtreleme uygulamayı düşünün

Sorun Giderme

Tam Uygulama Örneği

İşte Hardal’da GA4’e e-ticaret satın alma event’leri gönderen özel bir destination kurmak için tam bir uygulama örneği:

{
  "endpoint_label": "GA4 E-commerce Complete",
  "endpoint_id": "ga4-ecommerce-full",
  "endpoint_url": "https://www.google-analytics.com/mp/collect?measurement_id=G-XXXXXXXX&api_secret=YOUR_API_SECRET",
  "request_method": "POST",
  "content_type": "application/json",
  "request_format": {
    "client_id": "##user_id##",
    "user_id": "##properties.customer_id##",
    "non_personalized_ads": false,
    "events": [
      {
        "name": "purchase",
        "params": {
          "transaction_id": "##properties.order_id##",
          "value": ##properties.total##,
          "currency": "##properties.currency##",
          "tax": ##properties.tax##,
          "shipping": ##properties.shipping##,
          "coupon": "##properties.coupon##",
          "items": [
            {
              "item_id": "##properties.items[0].item_id##",
              "item_name": "##properties.items[0].item_name##",
              "price": ##properties.items[0].price##,
              "quantity": ##properties.items[0].quantity##,
              "item_category": "##properties.items[0].category##"
            }
          ],
          "session_id": "##session_id##",
          "engagement_time_msec": 100,
          "page_location": "##page.url##",
          "page_title": "##page.title##"
        }
      }
    ]
  },
  "headers": {
    "Content-Type": "application/json"
  }
}

Sınırlamalar

Bu GA4 Measurement Protocol sınırlamalarının farkında olun:

  • İstek başına maksimum 25 event

  • Event başına maksimum 25 parametre

  • İstek başına maksimum 25 kullanıcı özelliği

  • Kullanıcı özelliği adları 24 karakterle sınırlıdır

  • Kullanıcı özelliği değerleri 36 karakterle sınırlıdır

  • Event adları 40 karakterle sınırlıdır

  • Parametre adları 40 karakterle sınırlıdır

  • Parametre değerleri 100 karakterle sınırlıdır (GA4 360 için 500)

  • Maksimum istek gövdesi boyutu 130KB

İlgili Kaynaklar