1. Giriş
Last Updated: 2021-06-08
Ne oluşturacaksınız?
Bu codelab'de, Measurement Protocol'ü kullanarak harici etkinlikleri GA4'e nasıl göndereceğinizi öğreneceksiniz.
Bu codelab'de, Firebase için Google Analytics'in uygulandığı bir uygulamanızın olduğu varsayılır. Firebase için Google Analytics ile nasıl entegrasyon yapacağınızı öğrenmek istiyorsanız lütfen önce bu codelab'e bakın. Firebase ile nasıl uygulama oluşturacağınızı öğrenmek istiyorsanız lütfen Firebase Android Codelab-Build Friendly Chat'e bakın.
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
- 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 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. Gizli anahtar değeri gösterilir. Bu değeri görüşmenizde kullanabilirsiniz.
GA4'e nasıl erişeceğinizden emin değilseniz Firebase projenizi ziyaret edebilir, Proje Ayarları > Entegrasyonlar > Google Analytics'i kontrol edebilir ve "Yönet"i tıklayabilirsiniz. Google Analytics bağlantısı görünür olmalıdır. Ayrıca, doğrudan buradan da gezinebilirsiniz.
app_instance_id değerini toplama
app_instance_id değerinizi toplamak için aşağıdaki yöntemlerden herhangi birini kullanabilirsiniz.
- BigQuery Export'u kullanma
- Uygulama Kaynak Kodunuzda Yerel Olarak Getirme
Bu iki durum da aşağıda ayrıntılı olarak açıklanmıştır.
- BigQuery Export'u kullanma
BigQuery Export 'u etkinleştirdiyseniz aşağıdaki adımları uygulayabilirsiniz.
- Firebase'de oturum açma
- Proje Ayarları > Entegrasyonlar > BigQuery'ye gidin.
- Veri kümesinin yanındaki "BigQuery'de görüntüle"yi tıklayın.
Not : Veri kümesi yalnızca açma/kapatma düğmesi yaklaşık 24-48 saat boyunca etkinleştirildikten sonra kullanılabilir.
- BigQuery'de tablodaki user_pseudo_id değerini kontrol edebilirsiniz. Bu, çağrınızda kullanabileceğiniz app_instance_id'dir.
- Uygulama Kaynak Kodunuzda Doğal Olarak Getirme
Uygulamanız Java kullanılarak oluşturulduysa app_instance_id'yi almak için aşağıdakine benzer bir kod 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()
iOS uygulamanız varsa Swift'te 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
*/
Altyapınıza bağlı olarak aşağıdaki bağlantılardan daha fazla bilgi edinebilirsiniz.
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 "firebase" olarak ayarlandığından emin olun.
Aşağıdaki alanları doldurmanız gerekir.
- api_secret: Daha önce GA4'te oluşturulmuş
- firebase_app_id: Bu kimliği almak için Yönetici > Veri Akışları > akışınızı seçin'e gidebilirsiniz . Aşağıdaki gibi gösterilmelidir.
- app_instance_id: Bu değeri daha önce aldınız.
- user_id zorunlu değildir. Bu alanı şimdilik boş bırakabilirsiniz.
- Kategori: Bunu açılır listeden "Özel" olarak değiştirin ve istediğiniz bir 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üğmesiyle birlikte aşağıdakine benzer 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 artık "GA'YA GÖNDER" düğmesini görmelisiniz. 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. Bu işlem, GA4'e bir test etkinliği gönderir.
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.
Sorun veya tutarsızlıklarla karşılaşıyorsanız Measurement Protocol'un bilinen sınırlamalarını buradan incelemeniz faydalı olabilir.
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?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"
}
}
]
}
Bunu, aşağıdaki gibi bir ifade kullanarak 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)
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. Bu konuda ayrıntılı talimatlar için bu codelab'deki 6. adıma bakabilirsiniz. Google Ads, dönüşüm izleme amacıyla yalnızca son 60 gün içinde Firebase SDK'sından toplanan IDFA veya cihaz kimlikleriyle ilişkilendirilmiş verileri gösterir. Bu API'nin hâlâ alfa sürümünde olduğunu ve tam lansmandan önce ele alınması gereken burada listelenen sınırlamaları incelediğinizi unutmayın.
Öğ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