Firebase ve Google Analytics

Google Analytics ve Firebase gibi Google ürünleri kullanıyorsanız, bu makalede anlatılan entegrasyon sayesinde analitik verilerinizi Adapty’nin olaylarıyla zenginleştirebilirsiniz. Olaylar Google Analytics üzerinden Firebase’e iletilir ve her iki serviste de kullanılabilir.

Bu özellik, kullanıcılarınızın davranışlarını Firebase’deki ödeme geçmişleriyle ilişkilendirmenizi sağlar; böylece daha bilinçli ürün kararları alabilirsiniz.

Firebase entegrasyonu nasıl kurulur

1. Firebase’i yapılandırın

Öncelikle Firebase ile Google Analytics arasındaki entegrasyonu etkinleştirmeniz gerekir. Bunu Firebase Console’daki Integrations sekmesinden yapabilirsiniz.

2. Adapty ile entegre edin

Adapty’nin olayları ve kullanıcı özelliklerini gönderebilmesi için Firebase App ID ve Google Analytics API Secret bilgilerinize ihtiyacı vardır. Bu parametreleri sırasıyla Firebase Console’da ve Google Analytics Data Streams sekmesinde bulabilirsiniz.

Ardından Google Analytics Admin ayarlarındaki Data Streams bölümünden uygulamanızın Stream detaylar sayfasına gidin.

Additional settings altında Measurement Protocol API secrets sayfasına gidin ve henüz yoksa yeni bir API Secret oluşturun. Değeri kopyalayın.

Sonraki adımda Adapty Kontrol Paneli’nde entegrasyonu yapılandırmanız gerekir. iOS, Android ve/veya Stripe platformlarınız için Firebase App ID ve Google Analytics API Secret bilgilerini girmeniz gerekecek.

SDK yapılandırması

Ardından kullanıcılarınızı Firebase ile ilişkilendirmek için Adapty SDK’yı yapılandırmanız gerekir. Her kullanıcı için firebase_app_instance_id değerini Adapty’ye göndermelisiniz. Aşağıda Firebase SDK ile Adapty SDK’yı entegre etmek için kullanılabilecek örnek kodlar yer almaktadır.

FirebaseApp.configure()
        
if let appInstanceId = Analytics.appInstanceID() {            
    do {
        try await Adapty.setIntegrationIdentifier(
            key: "firebase_app_instance_id", 
            value: appInstanceId
        )
    } catch {
        // handle the error
    }
}

//after Adapty.activate()

FirebaseAnalytics.getInstance(context).appInstanceId.addOnSuccessListener { appInstanceId ->
    Adapty.setIntegrationIdentifier("firebase_app_instance_id", appInstanceId) { error ->
        if (error != null) {
            // handle the error
        }
    }
}

//after Adapty.activate()

FirebaseAnalytics.getInstance(context).getAppInstanceId().addOnSuccessListener(appInstanceId -> {
    Adapty.setIntegrationIdentifier("firebase_app_instance_id", appInstanceId, error -> {
        if (error != null) {
            // handle the error
        }
    });
});

final appInstanceId = await FirebaseAnalytics.instance.appInstanceId;

try {
    await Adapty().setIntegrationIdentifier(
        key: "firebase_app_instance_id", 
        value: appInstanceId,
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

using AdaptySDK;

// We suppose FirebaseAnalytics Unity Plugin is already installed

Firebase.Analytics
  .FirebaseAnalytics
  .GetAnalyticsInstanceIdAsync()
  .ContinueWithOnMainThread((task) => {
    if (!task.IsCompletedSuccessfully) {
      // handle error
      return;
    }

    var firebaseId = task.Result
    var builder = new Adapty.ProfileParameters.Builder();
    
    Adapty.SetIntegrationIdentifier(
      "firebase_app_instance_id", 
      firebaseId, 
      (error) => {
        // handle the error
    });
  });

try {
  const appInstanceId = await analytics().getAppInstanceId();

  await adapty.setIntegrationIdentifier("firebase_app_instance_id", appInstanceId);
} catch (error) {
  // handle `AdaptyError`
}

Olay ve kullanıcı özelliklerini gönderme

Artık Firebase ve Google Analytics’te hangi olayları almak istediğinize karar verme zamanı.

Bazı olayların “Purchase” gibi özel adları olduğunu, diğerlerinin ise standart Adapty olayları olduğunu görebilirsiniz. Bu fark, Google Analytics olay türlerinden kaynaklanmaktadır. Şu anda desteklenen olaylar Refund ve Purchase’dır; diğerleri özel olaylardır. Bu nedenle olay adlarınızın Google Analytics tarafından desteklendiğinden emin olun.
Ayrıca Adapty kontrol panelinden kullanıcı özelliklerinin gönderilmesini de yapılandırabilirsiniz.

Bu sayede olaylarınız Adapty tarafından subscription_state ve subscription_product_id bilgileriyle zenginleştirilecektir. Ancak bu özelliği Google Analytics’te de etkinleştirmeniz gerekir. User properties özelliğini analizlerinizde kullanmak için önce Firebase Console’daki Custom Definitions bölümünden User scope seçerek bir özel boyut tanımlamanız, adını ve açıklamasını girmeniz gerekir.

Kullanıcı özelliği adlarınızın subscription_state ve subscription_product_id olduğundan emin olun; aksi hâlde abonelik durumu verilerini gönderemeyiz.

Hepsi bu kadar! Google’dan gelecek yeni içgörüleri bekliyoruz.

Sorun giderme

Veri tutarsızlığı

Adapty ile Firebase arasında veri tutarsızlığı yaşanıyorsa bunun nedeni, tüm kullanıcılarınızın Adapty SDK içeren uygulama sürümünü kullanmaması olabilir. Veri tutarlılığını sağlamak için kullanıcılarınızı Adapty SDK içeren bir sürüme güncellemeye zorlayabilirsiniz.

Ayrıca sandbox olayları varsayılan olarak Firebase’e gönderilir ve bu devre dışı bırakılamaz. Bu nedenle, bir uygulamanın az sayıda Production olayı ve çok sayıda Sandbox olayı olduğu durumlarda, Adapty Analytics ile Firebase arasında kayda değer sayısal farklılıklar oluşabilir.

Olaylar Adapty’de iletildi olarak görünüyor ancak Firebase’de görünmüyor

Olayların Adapty’den gönderilmesi ile Google Analytics kontrol panelinde görünmesi arasında bir zaman gecikmesi yaşanabilir. En son olayları gerçek zamanlı takip etmek için Google Analytics hesabınızdaki Gerçek Zamanlı Kontrol Paneli’ni izlemeniz önerilir.