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

1. Giriş

Son Güncelleme: 2020-12-14

Ne inşa edeceksin

Bu kod laboratuvarında, Google Analytics for Firebase(GA4F) ile etkinlikleri nasıl uygulayacağınızı ve Google Ads aracılığıyla eylem kampanyaları başlatmayı öğreneceksiniz.

Bu kod laboratuvarı, etkinlikleri GA4F ile uygulamaya ve etkinlikleri Google Ads'e içe aktarmaya odaklanır. Firebase ile bir android uygulamasının nasıl oluşturulacağını öğrenmek istiyorsanız, lütfen Firebase Android Codelab-Build Dostu Sohbet bölümüne bakın.

ne öğreneceksin

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

Neye ihtiyacın olacak

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

2. Bir Firebase projesi oluşturun ve kurun

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

Bir Firebase projesi oluşturun

1. Firebase'de oturum açın.

Firebase konsolunda, Proje Ekle(veya Bir proje oluştur) seçeneğine tıklayın ve Firebase projenizi istediğiniz gibi adlandırın.

2. Proje oluşturma seçeneklerini 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.

Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase projelerini anlama bölümüne bakın.

3. Google Analytics hesabını seçin. Eğer varsa, onu seçin veya yeni bir tane oluşturun. Proje oluştur düğmesine tıklayın.

4. Artık Firebase proje derlemesi 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, ardından "Firebase'i uygulamanıza ekleyerek başlayın" altındaki Android düğmesini tıklayın.

2. Gerekli bilgileri doldurun.

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

Google Sign In veya Firebase Dynamic Links 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 .) .

İpucu : Paket ve uygulama kimlikleri hakkında daha fazla bilgi için Uygulama kimliğini ayarlama bölümünü okuyun.

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

Yapılandırma dosyasını indir

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

2. Android stüdyosunda, app dizinine gidin ve google-services.json dosyasını (yukarıda az önce indirdiğiniz) app dizinine taşıyın. Firebase konsoluna dönün, İleri düğmesine 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 şu 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
      ...
      }
   }
}

3. <project>/<app-module>/build.gradle dosyasını açın, ardından dosyaya şu 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 Google Analytics için Firebase SDK'sını ekleyeceksiniz.

BoM sürümünü belirterek uygulamanızda kullandığınız Firebase kitaplık sürümlerini yönetmenize olanak sağlayan 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 o BoM sürümünün sürüm notlarına bakın.

1. <project>/<app-module>/build.gradle dosyasını açın, ardından dosyaya şu 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 analytics kitaplığının sürümünü belirtmeniz gerekmez. 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'

2. Şimdi Sync Now düğmesine tıklayarak uygulamanızı senkronize edin.

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

Bir sonraki adımda, Android uygulamanızda Firebase etkinliklerini nasıl günlüğe kaydedeceğinizi öğreneceksiniz.

5. Firebase Analytics ile olayları günlüğe kaydedin

Bu adımda, Android uygulamasında Firebase Analytics ile etkinliklerin nasıl günlüğe kaydedileceğini öğreneceksiniz.

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

Önerilen etkinlikleri kullanma

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

1. Etkinliğin en üstünde FirebaseAnalytics nesnesini bildirin:

private lateinit var firebaseAnalytics: FirebaseAnalytics

2. Nesneyi onCreate() yönteminde başlatın:

firebaseAnalytics = Firebase.analytics

3. logEvent() yöntemiyle olayları günlüğe kaydetmeye başlayın. Aşağıdaki kod, bir kullanıcı uygulamada bir öğe(ler) 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 olayların kapsamadığı olaylara ihtiyacınız varsa, kendi özel olaylarınızı özel parametrelerle günlüğe kaydedebilirsiniz:

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

Hata ayıklama olayları

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.

Anında test etme ve hata ayıklama amaçları için Firebase Debugview'i kullanabilirsiniz. DebugView, uygulamanız tarafından geliştirme cihazlarında kaydedilen olay verilerini neredeyse gerçek zamanlı olarak görmenizi sağlar. DebugView için lütfen Hata Ayıklama olayı 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 eylem 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 edinebilir ve uygulama kampanyasından öğrenilenleri artırabilir, bu da genellikle daha iyi performans ve dönüşüm sağlar.

Firebase ve Google Ads'i bağlayın

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

2. Entegrasyonlar sekmesinde, Google Reklamlarını ve bir Bağlantı düğmesini göreceksiniz. Bağla ve Devam Et'i tıklayın.

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

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

Firebase etkinliklerini içe aktarın

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

Dikkat: Hedef etkinlik dönüşüm olarak işaretlenmemişse Google Ads bunu içe aktaramaz. Etkinliğin doğru bir şekilde dönüşüm olarak işaretlendiğinden emin olun.

2. Şimdi Google Ads'e gidin ve Firebase ile bağladığınız hesaba giriş yapın.
3. Google Ads'de Araçlar → Ölçüm → Dönüşümler'e gidin
4. + düğmesine tıklayın
5. Uygulama → Google Analytics 4 mülklerini (Firebase) seçin ve devam et'i tıklayın.
6. Dönüşüm olarak işaretlenen tüm analiz olaylarını 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.
7. Firebase'den bir dönüşüm etkinliğini başarıyla içe aktardınız.

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

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

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

Önemli: Bir uygulama kampanyası başlatmak için Google Play'de üretim düzeyinde bir uygulamaya ihtiyacınız vardır. Uygulamayı yayınlamaya hazır değilseniz, şimdilik bu adımı bırakın.

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

2. Uygulama Yükleme seçeneğiyle bir Uygulama tanıtım kampanyası başlatacağız. Altta, tanıtmak istediğiniz uygulamanızı seçin ve devam et'i tıklayın.
3. Teklif verme bölümünde, açılır menüden Uygulama içi işlemleri seçerseniz etkinlikleri görüntüleyebilirsiniz. Odaklanmak istediğiniz olayları seçin.

4. Kampanya ayarlarının geri kalanını ayarlayın ve tamamlayın.

8. Tebrikler

Tebrikler, Firebase'inizi ve 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 olaylar nasıl kaydedilir?
• Etkinlikler nasıl içe aktarılır ve eylem kampanyaları için kullanılır.