Ölçüm Protokolünü kullanarak uygulama etkinliklerini GA4'e gönderme

1. Giriş

Son Güncelleme: 2021-06-08

Ne inşa edeceksin

Bu codelab'de, Measurement Protokolü kullanarak harici etkinlikleri GA4'e nasıl göndereceğinizi öğreneceksiniz.

Bu codelab, Firebase için Google Analytics'in uygulandığı bir Uygulamanın zaten bulunduğunu varsayar. Firebase için Google Analytics'i nasıl entegre edeceğinizi öğrenmek istiyorsanız lütfen önce bu codelab'e bakın. Firebase ile nasıl uygulama geliştireceğinizi öğrenmek istiyorsanız lütfen Firebase Android Codelab-Derleme Dostu Sohbet'e bakın.

Ne öğreneceksin

  • İlk MP çağrınızı yapma adımları
  • Çağrı için gerekli parametreleri anlayın
  • Test çağrınızı gönderin ve doğrulayın
  • Aramayı yapmak için Python'da örnek bir komut dosyası oluşturun

İhtiyacınız olan şey

  • Android veya iOS Uygulamanız
  • 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 Sırrı Oluşturun

GA4'e gidin ve Yönetici > Veri Akışları > akışınızı seçin > Ölçüm Protokolü > Oluştur'a giderek yeni API sırrınızı oluşturun

6e4afca63054d291.png

c9e9ccd2ffba98eb.png

e714cd969fca4a4d.png

Herhangi bir takma adı girebilirsiniz; aramanızda kullanabileceğiniz gizli değer görüntülenecektir.

GA4'e nasıl erişeceğinizden emin değilseniz Firebase Projenizi ziyaret edebilir, Proje Ayarları > Entegrasyonlar > Google Analytics'i kontrol edip "Yönet"i tıklayabilirsiniz. Google Analytics bağlantısı görünür olmalıdır ve buradan da doğrudan gezinebilirsiniz

73b4d77a57eddfba.png

app_instance_id'yi topla

app_instance_id'nizi toplamak için aşağıdaki yöntemlerden herhangi birini kullanabilirsiniz.

  1. BigQuery Export'u kullanma
  2. Uygulama Kaynak Kodunuzda Yerel Olarak Getirme

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

  1. BigQuery Export'u kullanma

BigQuery Export'u etkinleştirdiyseniz aşağıdaki adımları uygulayabilirsiniz

  • Firebase'de oturum açın
  • Proje Ayarları > Entegrasyonlar > BigQuery'ye gidin
  • Veri kümesinin yakınındaki "BigQuery'de Görüntüle"yi tıklayın

Not: Veri kümesi yalnızca geçiş yaklaşık 24-48 saat süreyle etkinleştirildikten sonra kullanılabilir.

63d061088b622961.png

  • BigQuery'de, tabloda user_pseudo_id olup olmadığını kontrol edebilirsiniz. Bu, çağrınızda kullanabileceğiniz app_instance_id'dir

4b1b80bdc2884581.png

  1. Uygulama Kaynak Kodunuzda Yerel Olarak Getirme

Uygulamanız Java kullanılarak oluşturulduysa app_instance_id değerini almak için buna benzer bir şey kullanabilirsiniz.

 FirebaseAnalytics.getInstance(this).getAppInstanceId().addOnCompleteListener(new OnCompleteListener<String>() {
        @Override
        public void onComplete(@NonNull Task<String> task) {
            if (task.isSuccessful()) {
                String user_pseudo_id = task.getResult();
            }
        }
    });

Kotlin için aşağıdakileri deneyebilirsiniz

Thread {
   Firebase.analytics.appInstanceId.addOnSuccessListener { user_pseudo_id ->
       Log.d("Firebase", "user_pseudo_id using appInstanceId is $user_pseudo_id")
       /*
       Store the value to your server or do something with the retrieved id
        */
   }
}.start()

Bir iOS Uygulamanız varsa Swift'de aşağıdakileri kullanabilirsiniz

let user_pseudo_id = Analytics.appInstanceID()
print("user_pseudo_id = \(user_pseudo_id)")
/*
Store the value to your server or do something with the retrieved id
*/

Aşağıda altyapınıza bağlı olarak daha fazla bağlantı bulunmaktadır

3. Çağrıyı Oluşturma

GA4'teki Etkinlik Oluşturucu'yu kullanarak örnek bir çağrı oluşturabilirsiniz. (Bunun için giriş yapmanız ve çerezleri etkinleştirmeniz gerekir). Geçişin "firebase" olarak ayarlandığından emin olun

fd78d961f3e48238.png

Aşağıdaki alanları doldurmanız gerekecek

  • api_secret - GA4'te daha önce oluşturulmuştu
  • firebase_app_id - Bunu elde etmek için Yönetici > Veri Akışları'na gidebilir > akışınızı seçebilirsiniz . Aşağıdaki gibi görüntülenmelidir

19801c8e5cb29222.png

  • app_instance_id - Bu değeri zaten aldınız
  • user_id zorunlu değildir. Şimdilik boş bırakabilirsiniz
  • Kategori - açılır menüden bunu "Özel" olarak değiştirin ve istediğiniz herhangi bir etkinlik adını girin ( otomatik olarak toplanan herhangi bir etkinliği kullanmayın). Burada "test_from_codelab" kullanıyoruz

54cce53df64d697.png

İsteğe bağlı olarak aşağıdaki düğmelere tıklayarak etkinlik parametrelerini ve/veya kullanıcı özelliklerini sağlamayı da seçebilirsiniz.

16a8f531a3894021.png

Her şeyi doldurduktan sonra, "Etkinliği Doğrula" butonunu içeren buna benzer bir şey görmelisiniz.

475801f25c3caf26.png

Buna ulaştığınızda, turuncu renkle vurgulanan düğme olan "OLAYI DOĞRULA" düğmesine tıklayın. Etkinliğin geçerli olduğunu belirten aşağıdaki mesajı görüntülemelidir ve şimdi "GA'YA GÖNDER" düğmesini göreceksiniz. Bu noktada, etkinlik geçersiz çıkarsa araç size sorunun olduğu alanı tam olarak söyleyecektir; sorunu düzeltip yeniden deneyebilirsiniz.

23e4e6800705b4aa.png

Artık düğmeye tıklayabilirsiniz; GA4'e bir test etkinliği gönderilmelidir.

4. GA4'teki etkinlikleri doğrulama

Etkinliği gönderdikten sonra GA4 hesabınıza gidebilir ve Gerçek Zamanlıyı kontrol edebilirsiniz. Olayın gerçekleştiğini görmelisiniz

994b51ca46bb1973.png

Olayların gerçek zamanlı görünümden gerçek olay raporlama sekmesine yayılması yaklaşık 24 saat sürebilir; bu nedenle, bunu normal olay raporlamasında hemen göremezseniz endişelenmenize gerek yok!

Sorunlarla veya tutarsızlıklarla karşılaşıyorsanız, Measurement Protokolünün bilinen sınırlamalarına buradan göz atmanız faydalı olabilir.

5. Python Komut Dosyası Oluşturmak

Artık test ettiğinize göre, Python'da (veya seçtiğiniz herhangi bir dilde) bu çağrıyı yapabilecek benzer bir mimari oluşturmak için API çağrısını ve olay yükünü inceleyebilirsiniz. Daha sonra bunu istediğiniz sıklıkta planlayabilir ve çalıştırabilirsiniz. Bu bölüm için Python'u destekleyen herhangi bir IDE'yi kullanabilir veya cihazınıza herhangi bir kurulum gerektirmeyen bir Google Colab dizüstü bilgisayar kullanabilirsiniz.

GA4 Event Builder'a geri döndüğünüzde uç noktanın aşağıdaki gibi olduğunu göreceksiniz.

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

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

{
  "app_instance_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?firebase_app_id=XXXX&api_secret=XXXX"
payload = {
  "app_instance_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 çalıştırdığınızda benzer şekilde olayın GA4'te gerçek zamanlı olarak yansıdığını görmelisiniz.

6. Tebrikler

Tebrikler, GA4'te Measurement Protokolü başarıyla kullandınız. Artık Google Analytics'e daha anlamlı veriler göndermek ve pazarlama ve iş analizlerinizi geliştirmek için güçlü çözüm mimarileri oluşturabilirsiniz. Bundan 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. Bununla ilgili ayrıntılı talimatlar için bu codelab'deki 6. adıma başvurabilirsiniz. Dönüşüm izleme amacıyla, Google Ads yalnızca son 60 gün içinde Firebase SDK'sından toplanan IDFA veya cihaz kimlikleriyle ilişkili verileri gösterecektir. Bunun hala bir alfa API olduğunu unutmayın ve burada listelenen ve tam lansmandan önce ele alınması gereken sınırlamaları uyguladığınızdan emin olun.

öğrendin

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