Measurement Protocol'ü kullanarak web etkinliklerini GA4'e gönderme

1. Giriş

Last Updated: 2019-04-30

Ne oluşturacaksınız?

Bu codelab'de, Measurement Protocol'ü kullanarak harici etkinlikleri GA4'e göndermeyi öğreneceksiniz.
Bu codelab'de, Google Analytics 4'ün uygulandığı bir web sayfanızın/sitenizin olduğu varsayılır.

Neler öğreneceksiniz?

İlk MP çağrınızı yapma adımları
Çağrı için gereken parametreleri anlama
Test çağrınızı gönderme ve doğrulama
Aramayı yapmak için Python'da örnek bir komut dosyası oluşturun.

Gerekenler

Web sitesi/web sayfası
Değişiklik yapmak için herhangi bir IDE
GA4 hesabı
İsteğe bağlı: Python geliştirme ortamı (veya Colab)

2. Zorunlu alanları toplayın

GA4'te API gizli anahtarı oluşturma

GA4'e gidin ve Yönetici > Veri Akışları > akışınızı seçin > Measurement Protocol > Oluştur'a giderek yeni API gizli anahtarınızı oluşturun.

Dilediğiniz takma adı girebilirsiniz. Gizli değer gösterilir ve bu değeri görüşmenizde kullanabilirsiniz.

client_id değerini toplama

client_id değerinizi toplamak için aşağıdaki yöntemlerden herhangi birini kullanabilirsiniz.

gTag aracılığıyla toplama

Bu iki durum da aşağıda ayrıntılı olarak açıklanmıştır.

gTag aracılığıyla toplama

Aşağıdaki kodu kullanarak web siteniz üzerinden client_id değerinizi alabilirsiniz :

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  Do something with clientID)
}

Altyapınıza bağlı olarak aşağıdaki bağlantılardan da yararlanabilirsiniz.

gtag.js(‘get')

3. Görüşmeyi Oluşturma

GA4'teki Etkinlik Oluşturucu aracını kullanarak örnek çağrı oluşturabilirsiniz. (Bu işlem için giriş yapmanız ve çerezleri etkinleştirmiş olmanız gerekir). Açma/kapatma anahtarının "gtag.js" olarak ayarlandığından emin olun.

Aşağıdaki alanları doldurmanız gerekir.

api_secret: Daha önce GA4'te oluşturulmuş olmalıdır.
measurement_id: Bu kimliği almak için Yönetici > Veri Akışları > akışınızı seçin'e gidebilirsiniz . Aşağıdaki gibi gösterilmelidir.

client_id: Bu değeri daha önce aldınız.
user_id zorunlu değildir. Bu alanı şimdilik boş bırakabilirsiniz.
Kategori: Açılır listeden "Özel" olarak değiştirin ve istediğiniz bir etkinlik adını girin (otomatik olarak toplanan etkinlik kullanmayın). Burada "test_from_codelab"ı kullanıyoruz.

İsteğe bağlı olarak, aşağıdaki düğmeleri tıklayarak etkinlik parametreleri ve/veya kullanıcı özellikleri de sağlayabilirsiniz.

Her şeyi doldurduktan sonra, "Etkinliği Doğrula" düğmesiyle birlikte aşağıdakine benzer bir ekran görürsünüz.

Bu sınıra ulaştığınızda turuncu renkle vurgulanan "ETKİNLİĞİ DOĞRULA" düğmesini tıklayın. Aşağıdaki mesajı göstererek etkinliğin geçerli olduğunu belirtmeli ve artık "GA'YA GÖNDER" düğmesini görmelisiniz. Bu noktada etkinlik geçersiz olarak görünürse araç, sorunun olduğu alanı size bildirir. Bu alanı düzelterek tekrar deneyebilirsiniz.

Artık düğmeyi tıklayabilirsiniz. Bu işlem, GA4'e bir test etkinliği gönderir.

4. GA4'te etkinlikleri doğrulama

Etkinliği gönderdikten sonra GA4 hesabınıza gidip anlık raporu kontrol edebilirsiniz. Etkinliğin gerçekleştiğini görmeniz gerekir.

Etkinliklerin gerçek zamanlı görünümden gerçek etkinlik raporlama sekmesine yayılması yaklaşık 24 saat sürebilir. Bu nedenle, normal etkinlik raporlamasında bu durumu hemen görmezseniz endişelenmenize gerek yoktur.

5. Python komut dosyası oluşturma

Test ettikten sonra, bu çağrıyı yapabilecek benzer bir mimariyi Python'da (veya istediğiniz herhangi bir dilde) oluşturmak için API çağrısını ve etkinlik yükünü inceleyebilirsiniz. Ardından, bunu istediğiniz sıklıkta planlayabilir ve işleme koyabilirsiniz. Bu bölüm için Python'u destekleyen istediğiniz bir IDE'yi veya cihazınıza herhangi bir yükleme yapmanızı gerektirmeyen bir Google Colab not defterini kullanabilirsiniz.

GA4 Etkinlik Oluşturucu'ya geri dönersek uç noktanın aşağıdaki gibi olduğunu görürüz.

POST /mp/collect?measurement_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

Etkinlik yükü aşağıdaki gibiydi:

{
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

Bunu, aşağıdaki gibi bir ifade kullanarak Python'a çevirebilirsiniz:

import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)

Bu işlemi doğru değerlerle yürüttüğünüzde, etkinliğin GA4'te anlık olarak yansıtıldığını görmeniz gerekir.

6. Tebrikler

Tebrikler, GA4'te Measurement Protocol'ü başarıyla kullandınız. Artık Google Analytics'e daha anlamlı veriler göndermek ve pazarlama ile iş analizlerinizi iyileştirmek için güçlü çözüm mimarileri oluşturabilirsiniz. Bu özellikten en iyi şekilde yararlanmak için Google Ads'e bağlanmanızı ve bu etkinlikleri dönüşüm olarak içe aktarmanızı da öneririz.

Bu kursta öğrendikleriniz:

MP çağrıları yapmak için doğru değişkenleri toplama
Test etkinliklerini gönderme ve doğrulama
MP çağrıları göndermek için komut dosyası oluşturma