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 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.

8dee89e850ae90bb.pngd0be19d8112435a2.pngde5a80a1445d3a14.png

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.

  1. 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.

b904d2a053eb7817.png

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.

d362992ff592c675.png

  • 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.

cf580a708bb0a8a2.png

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

da59bb982f6f906a.png

Her şeyi doldurduktan sonra, "Etkinliği Doğrula" düğmesini içeren aşağıdaki gibi bir ekran görürsünüz.

31f720d550906298.png

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.

1d63d1e067c46294.png

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.

7b9e9a0f74b64757.png

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

Referans belgeler