1. Giriş
Last Updated: 2019-04-30
Ne oluşturacaksınız?
- Bu codelab'de, Measurement Protocol'ü kullanarak harici etkinlikleri GA4'e nasıl göndereceğinizi öğreneceksiniz.
- Bu codelab'de, Google Analytics 4'ün uygulandığı bir web sayfanız/siteniz 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. Arama sırasında kullanabileceğiniz gizli değer gösterilir.
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.
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ş
- measurement_id: Bunu 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 zaten 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 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üğmesini içeren aşağıdaki gibi 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 "GA'YA GÖNDER" düğmesini göstermelidir. 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. Düğme, GA4'e bir test etkinliği göndermelidir.
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ğıdakine benzer bir kod 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.
Öğ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