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
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
app_instance_id'yi topla
app_instance_id'nizi toplamak için aşağıdaki yöntemlerden herhangi birini kullanabilirsiniz.
- BigQuery Export'u kullanma
- Uygulama Kaynak Kodunuzda Yerel Olarak Getirme
Bunların her ikisi de aşağıda ayrıntılı olarak açıklanmaktadır
- 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.
- BigQuery'de, tabloda user_pseudo_id olup olmadığını kontrol edebilirsiniz. Bu, çağrınızda kullanabileceğiniz app_instance_id'dir
- 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
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
- 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 etkinlikleri kullanmayın). Burada "test_from_codelab" kullanıyoruz
İsteğe bağlı olarak aşağıdaki düğmelere tıklayarak etkinlik parametrelerini ve/veya kullanıcı özelliklerini sağlamayı da seçebilirsiniz.
Her şeyi doldurduktan sonra, "Etkinliği Doğrula" butonunu içeren buna benzer bir şey görmelisiniz.
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.
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
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!
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