Firebase özel etkinlikleri için Google Analytics ile Google Ads - Android

1. Giriş

Son Güncelleme: 2020-12-14

Ne inşa edeceksin

Bu codelab'de, Firebase için Google Analytics(GA4F) ile etkinliklerin nasıl uygulanacağını ve Google Ads aracılığıyla eylem kampanyalarının nasıl başlatılacağını öğreneceksiniz.

Bu codelab, etkinlikleri GA4F ile uygulamaya ve etkinlikleri Google Ads'e aktarmaya odaklanıyor. Firebase ile nasıl android uygulaması oluşturulacağını öğrenmek istiyorsanız lütfen Firebase Android Codelab-Build Friendly Chat sayfasına bakın.

Ne öğreneceksin

  • Firebase projesi nasıl oluşturulur
  • Firebase SDK'sı Android uygulamasında nasıl uygulanır?
  • Olaylar ve parametreler nasıl oluşturulur?
  • Etkinlikler Firebase'den Google Ads'e nasıl aktarılır?
  • Özel etkinliklerle Google Ads eylem kampanyaları başlatın.

İhtiyacınız olan şey

  • Android Studio 3.6 veya üzeri
  • Firebase Hesabı
  • Google Ads Hesabı

2. Firebase projesi oluşturun ve kurun

Firebase'i kullanmaya başlamak için bir Firebase projesi oluşturup kurmanız gerekir.

Firebase projesi oluşturma

  1. Firebase'de oturum açın.

Firebase konsolunda Proje Ekle'ye (veya Proje oluştur) tıklayın ve Firebase projenizi istediğiniz gibi adlandırın.

8525e77df3536fbb.png

  1. Proje oluşturma seçeneklerine tıklayın. İstenirse Firebase şartlarını kabul edin. Eylem etkinliklerini ve dönüşümleri izlemek için Google Analytics etkinliklerine ihtiyacınız olduğundan, bu proje için Google Analytics'i etkinleştirmelisiniz.

e58151a081f0628.png

Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase projelerini anlama konusuna bakın.

  1. Google Analytics hesabını seçin. Eğer bir tane varsa onu seçin veya yeni bir tane oluşturun. Proje oluştur butonuna tıklayın.

ac928e5947ba7cbf.png

  1. Artık Firebase proje yapısı tamamlandı!

Bir sonraki adımda Firebase'i Android uygulamanıza nasıl ekleyeceğinizi öğreneceksiniz.

3. Firebase'i Android uygulamanıza ekleyin

Uygulamayı kaydet

  1. Firebase Konsolunda, sol gezinme bölmesinde Projeye Genel Bakış'ı seçin ve ardından "Firebase'i uygulamanıza ekleyerek başlayın"ın altındaki Android düğmesini tıklayın.

6cbb33ad3e7c9132.png

  1. Gerekli bilgileri doldurun.

3b7d3b33d81fe8ea.png

Android paket adı için Android stüdyosunda uygulama dizinine gidin, build.gradle dosya adını açın. Dosyada applicationId öğesini arayın. Bu değer Android paket adıdır. Bu değeri kopyalayıp yapıştırın.

Google Oturum Açma veya Firebase Dinamik Bağlantılarını kullanmayı planlamıyorsanız burada SHA-1 anahtarına ihtiyacımız yok (Bunların bu codelab'in parçası olmadığını unutmayın; SHA-1 anahtarı hakkında daha fazla bilgi için lütfen bu belgeye bakın.) .

  1. Uygulamayı Kaydet düğmesini tıklayın.

Yapılandırma dosyasını indirin

  1. Google-services.json yapılandırma dosyasını indirmek için google-services.json indir düğmesini tıklayın.

52f08aa18c8d59d0.png

  1. Android stüdyosunda app dizinine gidin ve google-services.json dosyasını (yukarıda indirdiğiniz) app dizinine taşıyın. Firebase konsoluna döndüğünüzde İleri düğmesini tıklayın.

Uygulamanızda Firebase'i etkinleştirin

  1. Firebase tarafından oluşturulan google-services.json dosyasını okumak için Google Services Gradle eklentisine ihtiyacınız var.
  2. Android stüdyosunda <project>/build.gradle dosyasını açın, ardından dosyaya aşağıdaki satırları ekleyin:
buildscript { 
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
   }
   dependencies {
      ...
      // Add this line
      classpath 'com.google.gms:google-services:4.3.4'
   }
}

allprojects {
   ...
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
      ...
      }
   }
}
  1. <project>/<app-module>/build.gradle dosyasını açın, ardından dosyaya aşağıdaki satırları ekleyin:
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

Artık Firebase'i Android uygulamanıza eklemeyi tamamladınız!

Bir sonraki adımda Firebase SDK'yı uygulamanıza nasıl ekleyeceğinizi öğreneceksiniz.

4. Firebase SDK'sını uygulamanıza ekleyin

Bu adımda Firebase SDK'sını, özellikle de Google Analytics için Firebase SDK'sını ekleyeceksiniz.

BoM'un sürümünü belirterek, uygulamanızda kullandığınız Firebase kitaplık sürümlerini yönetmenize olanak tanıyan Firebase Android BoM'yi kullanacağız. Hangi Firebase kitaplığı sürümlerinin belirli bir BoM sürümüyle eşlendiğini öğrenmek için söz konusu BoM sürümünün sürüm notlarına göz atın.

  1. <project>/<app-module>/build.gradle dosyasını açın, ardından dosyaya aşağıdaki satırları ekleyin:
dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx'

Gördüğünüz gibi yalnızca BoM sürümünü belirterek firebase analitik kütüphanesinin sürümünü belirtmenize gerek yoktur. Ancak BoM'de hangi sürüm belirlenmiş olursa olsun, Firebase kitaplığınız için istediğiniz sürümü kullanmak istiyorsanız, istediğiniz sürümü şu şekilde belirtmeniz yeterlidir:

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'
  1. Şimdi Sync Now düğmesini tıklayarak uygulamanızı senkronize edin. 937206076c88ae5c.png

Artık Google Analytics için Firebase SDK'sını Android uygulamanıza eklemeyi tamamladınız!

Bir sonraki adımda Firebase olaylarını Android uygulamanıza nasıl kaydedeceğinizi öğreneceksiniz.

5. Firebase Analytics ile etkinlikleri günlüğe kaydedin

Bu adımda, Android uygulamasında Firebase Analytics ile etkinlikleri nasıl günlüğe kaydedeceğinizi öğreneceksiniz.

Olayları günlüğe kaydetmenin 2 yolu vardır: Önerilen olayları veya özel olayları kullanma.

Önerilen etkinlikleri kullanma

Firebase Analytics SDK'sı oyun, perakende satış, seyahat ve e-ticaret gibi çeşitli uygulama türlerinde kullanılabilecek bir dizi önerilen etkinliği tanımlar. Ayrıca, önceden belirlenmiş parametrelerini gerektiren bazı önerilen etkinlikler de vardır ve bu parametrelerle, Firebase raporlarınızdaki mevcut ayrıntıları en üst düzeye çıkarabilirsiniz. ( Önerilen etkinlikler referansı )

  1. Etkinliğin en üstünde FirebaseAnalytics nesnesini bildirin:
private lateinit var firebaseAnalytics: FirebaseAnalytics
  1. Nesneyi onCreate() yönteminde başlatın:
firebaseAnalytics = Firebase.analytics
  1. logEvent() yöntemiyle olayları günlüğe kaydetmeye başlayın. Aşağıdaki kod, bir kullanıcı uygulamada bir öğeyi/öğeleri satın aldığında bir PURCHASE olayını günlüğe kaydeder:
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

Özel etkinlikleri kullanma

Önerilen etkinliklerin kapsamına girmeyen etkinliklere ihtiyacınız varsa özel parametrelerle kendi özel etkinliklerinizi günlüğe kaydedebilirsiniz:

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

Hata ayıklama etkinlikleri

Etkinliklerinizle ilgili toplu verileri ve raporları Firebase konsolunda görüntüleyebilirsiniz. Ancak güncellemeler gün boyunca periyodik olarak gerçekleşir, bu etkinlikleri uygulamanıza giriş yaptıktan hemen sonra görüntüleyemezsiniz.

Acil test ve hata ayıklama amacıyla Firebase Debugview'i kullanabilirsiniz. DebugView, uygulamanız tarafından geliştirme cihazlarında kaydedilen etkinlik verilerini neredeyse gerçek zamanlı olarak görmenizi sağlar. DebugView için lütfen Hata Ayıklama etkinliği bölümüne bakın.

Artık etkinlikleri Android uygulamanıza kaydetmeyi tamamladınız!

Bir sonraki adımda bu etkinlikleri Google Ads'e nasıl aktaracağınızı öğreneceksiniz.

6. Firebase etkinliklerini Google Ads'e aktarın

Firebase-Android kurulumunuz tamamlandı ve günlüğe kaydedilen işlem etkinlikleriyle uygulama kampanyasını başlatmaya hazırsınız. Firebase'i Google Ads'e bağlayarak başlayacaksınız. Uygulama kampanyaları, Firebase'i Google Ads'e bağlayarak kitleler hakkında daha fazla bilgi edinebilecek ve uygulama kampanyası öğrenimini artırabilecek; bu da genellikle daha iyi performans ve dönüşümlere yol açacak.

  1. Projeye Genel Bakış'ın hemen yanındaki düğmeye tıklayarak Firebase Ayarları'na gidin.

412830708c61fdc0.png

  1. Entegrasyonlar sekmesinde Google Ads'ü ve Bağlantı düğmesini göreceksiniz. Bağla ve Devam Et'i tıklayın.

796c921fb2b873ae.png

  1. Bağlamak istediğiniz Google Ads hesabını seçin.

Artık Firebase ile Google Ads'ü bağlamayı tamamladınız. Firebase etkinliklerini Google Ads'e aktaralım.

Firebase etkinliklerini içe aktar

  1. Firebase konsolunda Etkinlikler menüsüne gidin ve dönüşüm olarak içe aktarmak istediğiniz etkinliği işaretleyin.

a5f302ba01a1863c.png

  1. Şimdi Google Ads'e gidin ve Firebase'e bağladığınız hesaba giriş yapın.
  2. Google Ads'de Araçlar → Ölçüm → Dönüşümler'e gidin 7acf268d7e799a7e.png
  3. + düğmesine tıklayın d0eed72946d038d8.png
  4. Uygulama → Google Analytics 4 mülklerini (Firebase) seçin ve devam et'i tıklayın. 983f06edb15724de.png
  5. Dönüşüm olarak işaretlenen tüm analiz etkinliklerini görebilirsiniz. İçe aktarmak istediğiniz etkinliği bulun. Bu durumda daha önce uyguladığımız delete_item olayını seçin. İçe Aktar ve Devam Et düğmesini tıklayın. f9bdee80c0d40999.png
  6. Firebase'den bir dönüşüm etkinliğini başarıyla içe aktardınız. be75f6a11913236.png

Artık Firebase etkinliklerini Google Ads'e aktarmayı tamamladınız.

Bir sonraki adımda, yeni içe aktardığınız etkinlikle bir eylem kampanyasını nasıl başlatacağınızı öğreneceksiniz.

7. İçe aktarılan etkinliklerle uygulama eylem kampanyaları başlatma

  1. Mevcut Google Ads hesabınızda Uygulama kampanyaları sekmesine gidin ve + düğmesini tıklayarak yeni bir kampanya başlatın.

19856a65ab999ad7.png

  1. Uygulama Yüklemeleri seçeneğiyle bir Uygulama tanıtım kampanyası başlatacağız. Alt kısımda tanıtımını yapmak istediğiniz uygulamanızı seçin ve devam et'i tıklayın. 8146b5a7a4f961bd.png
  2. Teklif verme bölümünde, açılır menüden Uygulama içi işlemler'i seçerseniz etkinlikleri görüntüleyebilirsiniz. Odaklanmak istediğiniz etkinliği/etkinlikleri seçin.

b75e410c7dbdfec8.png

  1. Kampanya ayarlarının geri kalanını belirleyin ve tamamlayın.

8. Tebrikler

Tebrikler, Firebase ile Google Ads'ü başarıyla entegre ettiniz! Bu, kampanya performansınızı artırmanıza yardımcı olacaktır.

öğrendin

  • Android için Firebase Analytics Nasıl Yapılandırılır
  • Bir Android uygulamasında Firebase Analytics ile etkinlikler nasıl günlüğe kaydedilir?
  • Etkinlikler nasıl içe aktarılır ve eylem kampanyaları için nasıl kullanılır?