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

1. Giriş

Son Güncelleme Tarihi: 30.04.2019

Oluşturacaklarınız

  • Bu codelab'de, Measurement Protocol'u kullanarak harici etkinlikleri GA4'e nasıl göndereceğinizi öğreneceksiniz.
  • Bu codelab'de, Google Analytics 4'ün uygulandığı bir web sayfanızın/sitenizin zaten olduğu varsayılmıştır.

Neler öğreneceksiniz?

  • İlk MP aramanızı yapmak için uygulanacak adımlar
  • Görüşme için gerekli parametreleri anlama
  • Test aramanızı gönderme ve doğrulama
  • Çağrı yapmak için Python'da örnek bir komut dosyası oluşturun

Gerekenler

  • Bir Web Sitesi/Web sayfası
  • Değişiklik yapılacak 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 > İçerik üretme

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

İstediğiniz takma adı girdiğinizde, görüşmenizde kullanabileceğiniz gizli değer gösterilir

client_id değerini topla

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

  1. gTag aracılığıyla toplama

Bunların her ikisi de aşağıda ayrıntılı olarak açıklanmıştır

gTag aracılığıyla toplama

Client_id değerini web siteniz üzerinden şu şekilde alabilirsiniz :

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

Altyapınıza bağlı olarak daha fazla bağlantıyı aşağıda bulabilirsiniz

3. Görüşme Yapma

GA4'teki Etkinlik Oluşturucu'yu kullanarak örnek bir görüşme oluşturabilirsiniz. (Bunun için giriş yapmanız ve çerezleri etkinleştirmeniz 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 - GA4'te daha önce oluşturulmuş
  • device_id: Bu veriyi öğrenmek için Yönetici > Veri Akışları > akışınızı seçin . Aşağıdaki gibi görüntülenmelidir

d362992ff592c675.png

  • client_id - Bu değeri zaten aldınız
  • user_id zorunlu değildir. Bu alanı şimdilik boş bırakabilirsiniz
  • Kategori - bunu "Özel" olarak değiştirin ve istediğiniz bir etkinlik adını girin (otomatik olarak toplanan etkinlikleri kullanmayın). Burada "test_from_codelab"i kullanıyoruz.

cf580a708bb0a8a2.png

İsteğe bağlı olarak, aşağıdaki düğmeleri tıklayarak etkinlik parametreleri ve/veya kullanıcı özellikleri sağlamayı da seçebilirsiniz

da59bb982f6f906a.png

Her şeyi doldurduktan sonra, "Etkinliği Doğrula" düğmesiyle birlikte bunun gibi bir şey görürsünüz.

31f720d550906298.png

Bu sayfaya ulaştığınızda "ETKİNLİĞİ DOĞRULA"yı tıklayın varsa düğme turuncu renkle vurgulanır. Etkinlikte etkinliğin geçerli olduğunu belirten aşağıdaki mesaj görüntülenir ve artık "GA'YA GÖNDER" düğmesini görebilirsiniz. Bu noktada, etkinlik geçersiz olarak gelirse araç, sorunun olduğu alanı size tam olarak bildirir. Siz de sorunu düzeltip tekrar deneyebilirsiniz

1d63d1e067c46294.png

Şimdi düğmeyi tıkladığınızda GA4'e bir test etkinliği gönderilir

4. GA4'teki etkinlikleri doğrulama

Etkinliği gönderdikten sonra GA4 hesabınıza gidip Gerçek Zamanlı sayfasını kontrol edebilirsiniz. Etkinliği görebilirsiniz.

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, bu bilgileri normal etkinlik raporlamasında hemen görmüyorsanız endişelenmenize gerek yoktur.

5. Python Komut Dosyası Oluşturma

Şimdi bunu test ettiğinize göre Python'da (veya istediğiniz herhangi bir dilde) bu çağrıyı yapabilecek benzer bir mimari 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 çalıştırabilirsiniz. Bu bölümde, Python'u destekleyen herhangi bir IDE'yi veya cihazınıza yükleme gerektirmeyen bir Google Colab not defteri kullanabilirsiniz

GA4 Etkinlik Oluşturucu'ya döndüğünüzde uç noktanın aşağıdaki gibi olduğunu görürsünü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"
      }
    }
  ]
}

Bunun gibi bir şey kullanarak bunu 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)

Bunu doğru değerlerle yürüttüğünüzde, benzer şekilde etkinliğin GA4'te gerçek zamanlı olarak yansıtıldığını görmeniz gerekir.

6. Tebrikler

Tebrikler, GA4'te Measurement Protocol'u başarıyla kullandınız. Artık Google Analytics'e daha anlamlı veriler göndermek, pazarlama ve iş analizlerinizi iyileştirmek için güçlü çözüm mimarileri oluşturabilirsiniz. Ayrıca 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ı öneririz.

Öğrendikleriniz

  • MP çağrıları yapmak için doğru değişkenleri toplama
  • Test etkinlikleri nasıl gönderilir ve doğrulanır?
  • MP çağrıları göndermek için komut dosyası oluşturma

Referans belgeler