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

1. Giriş

Son Güncelleme: 14.12.2020

Oluşturacaklarınız

Bu codelab'de, Firebase için Google Analytics(GA4F) ile etkinlikleri nasıl uygulayacağınızı ve Google Ads üzerinden işleme yönelik kampanyaları nasıl başlatacağınızı öğreneceksiniz.

Bu codelab'de, etkinlikleri GA4F ile uygulama ve Google Ads'e aktarma konuları ele alınmaktadır. Firebase ile Android uygulaması geliştirmeyi öğrenmek istiyorsanız lütfen Firebase Android Codelab-Derleme Uygun Sohbet bölümünü inceleyin.

Neler öğreneceksiniz?

• Firebase projesi oluşturma
• Android uygulamasında Firebase SDK'sı nasıl kullanılır?
• Etkinlik ve parametre oluşturma
• Etkinlikleri Firebase'den Google Ads'e aktarma
• Özel etkinliklerle Google Ads işleme yönelik kampanyalar başlatın.

Gerekenler

• Android Studio 3.6 veya sonraki sürümler
• Firebase Hesabı
• Google Ads Hesabı

2. Firebase projesi oluşturma ve ayarlama

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

Firebase projesi oluşturma

1. Firebase'de oturum açın.

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

2. Proje oluşturma seçeneklerini tıklayarak ilerleyin. İstenirse Firebase şartlarını kabul edin. İşlem etkinliklerini ve dönüşümleri izlemek için Google Analytics etkinliklerine ihtiyacınız olduğundan bu proje için Google Analytics'i etkinleştirmeniz gerekir.

Firebase projeleri hakkında daha fazla bilgi için Firebase projelerini anlama başlıklı makaleyi inceleyin.

3. Google Analytics hesabı seçin. Varsa onu seçin veya yeni bir tane oluşturun. Proje oluştur düğmesini tıklayın.

4. Firebase proje oluşturma işlemi tamamlandı.

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

3. Firebase'i Android uygulamanıza ekleyin

Uygulamayı kaydet

1. Firebase Konsolu'nda, sol gezinme menüsünden Projeye Genel Bakış'ı seçin ve ardından "Uygulamanıza Firebase'i ekleyerek başlayın"ın altındaki Android düğmesini tıklayın.

2. Gerekli bilgileri doldurun.

Android paketinin adı için Android Studio'da uygulama dizinine gidip build.gradle adlı bir dosya açın. Dosyada applicationId araması yapın. Bu değer, Android paketinin adıdır. Bu değeri kopyalayıp yapıştırın.

Google ile Oturum Açma veya Firebase Dynamic Links kullanmayı planlamıyorsanız burada SHA-1 anahtarına ihtiyacımız yoktur (Bunların bu codelab'in bir 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 dosyasını indir düğmesini tıklayın.

2. Android Studio'da app dizinine gidin ve yukarıda indirdiğiniz google-services.json dosyasını app dizinine taşıyın. Firebase konsoluna dönün ve Sonraki 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 vardır.
2. Android Studio'da <project>/build.gradle uygulamasını açın, ardından aşağıdaki satırları dosyaya 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 ve aşağıdaki satırları dosyaya ekleyin:

apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

Firebase'i Android uygulamanıza eklemeyi tamamladınız.

Sonraki adımda Firebase SDK'sını 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ı ekleyin.

BoM sürümünü belirterek, uygulamanızda kullandığınız Firebase kitaplık sürümlerini yönetmenizi sağlayan Firebase Android BoM'u kullanacağız. Belirli bir BoM sürümüyle hangi Firebase kitaplık sürümlerinin 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 ve aşağıdaki satırları dosyaya 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'da hangi sürüm belirtilmiş olursa olsun Firebase kitaplığınız için istediğiniz sürümü kullanmak istiyorsanız aşağıdaki gibi istediğiniz sürümü 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üğmesini tıklayarak uygulamanızı senkronize edin.

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

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

5. Firebase Analytics ile etkinlik kaydetme

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

Etkinlikleri günlüğe kaydetmenin iki yolu vardır: önerilen etkinlikleri veya özel etkinlikleri kullanmak.

Önerilen etkinlikleri kullanma

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

1. Etkinliğin en üstünde FirebaseAnalytics nesnesini tanımlayın:

private lateinit var firebaseAnalytics: FirebaseAnalytics

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

firebaseAnalytics = Firebase.analytics

3. Etkinlikleri logEvent() yöntemiyle günlüğe kaydetmeye başlayın. Aşağıdaki kod, bir kullanıcı uygulamada öğe satın aldığında bir PURCHASE etkinliğini 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ında olmayan etkinliklere ihtiyacınız varsa özel parametrelerle kendi özel etkinliklerinizi kaydedebilirsiniz:

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

Hata ayıklama etkinlikleri

Firebase konsolunda etkinliklerinizle ilgili birleştirilmiş verileri ve raporları görüntüleyebilirsiniz. Ancak güncellemeler gün boyunca düzenli olarak gerçekleşir ve uygulamanıza giriş yaptıktan hemen sonra bu etkinlikleri görüntüleyemezsiniz.

Anında test ve hata ayıklama amacıyla Firebase Debugview'u kullanabilirsiniz. DebugView, geliştirme cihazlarında uygulamanız tarafından günlüğe 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 Android uygulamanıza etkinlikleri günlüğe kaydetmeyi tamamladınız.

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şlayın. Firebase'i Google Ads'e bağladığınızda, uygulama kampanyaları kitleler hakkında daha fazla bilgi edinebilir ve uygulama kampanyasından daha iyi bilgi edinebilir. Bu da genellikle daha iyi performans ve dönüşüm sağlar.

Firebase ile Google Ads'i bağlama

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

2. Entegrasyonlar sekmesinde Google Ads ve bir Bağlantı düğmesi görürsünüz. Bağlantı Oluştur 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 bu etkinliği içe aktaramaz. Etkinliğin doğru şekilde dönüşüm olarak işaretlendiğinden emin olun.

2. Google Ads'e gidip 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üğmesini tıklayın
5. Uygulama → Google Analytics 4 mülkleri (Firebase) seçeneğini belirleyin ve Devam'ı tıklayın. .
6. 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 etkinliğini 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. .

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

Sonraki adımda, yeni içe aktardığınız etkinliği kullanarak bir işlem kampanyasını nasıl başlatacağınızı öğreneceksiniz.

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

Önemli: 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 bu adımı şimdilik 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üklemeleri seçeneğini içeren bir Uygulama tanıtım kampanyası yayınlayacağız. Altta tanıtmak istediğiniz uygulamanızı seçip devam'ı tıklayın. .
3. 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 etkinlikleri seçin.

4. Geri kalan kampanya ayarlarını yapın ve hepsi bu kadar.

8. Tebrikler

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

Neler öğrendiniz?

• Android için Firebase Analytics'i Yapılandırma
• Bir Android uygulamasında Firebase Analytics ile etkinlikleri günlüğe kaydetme.
• Etkinlikleri içe aktarma ve işleme yönelik kampanyalarda kullanma