Google Analytics Özel Etkinlikler ve Flutter ile Google Ads Kampanyaları Başlatma

1. Giriş

Son Güncelleme: 2021-01-25

Ne oluşturacaksınız?

Bu codelab'de, GA4F ile özel etkinlikleri nasıl uygulayacağınızı ve Flutter uygulaması için Google Ads üzerinden nasıl harekete geçirici mesaj kampanyaları başlatacağınızı öğreneceksiniz.

Basit bir sayaç widget'ı içeren varsayılan Flutter uygulamasını kullanacağız. Uygulamamızı, sayaç widget'ını tıklama olasılığı yüksek olan potansiyel kullanıcılara tanıtırız.

Neler öğreneceksiniz?

• Flutter'da GA4F'yi (Firebase için Google Analytics) başlatma
• Özel etkinlik ve parametre oluşturma
• Etkinlikleri Firebase'den Google Ads'e aktarma
• Özel etkinliklerle işleme yönelik kampanyaları başlatma

Gerekenler

• Android Studio 3.6 veya sonraki sürümler
• Xcode (iOS desteği için)
• Firebase Hesabı
• Google Ads hesabı

2. Yeni bir Flutter projesi başlatma

Basit bir şablonlu Flutter uygulaması oluşturun. Bu başlangıç uygulamasını bu codelab için değiştireceksiniz.

Android Studio'yu başlatın.

Not: IDE'nizde Yeni Flutter Projesi seçeneğini görmüyorsanız Flutter ve Dart için eklentilerin yüklendiğinden emin olun.

1. Açık projeniz yoksa karşılama sayfasından Yeni bir Flutter uygulaması başlat'ı seçin. Aksi takdirde, File > New > New Flutter Project'i (Dosya > Yeni > Yeni Flutter Projesi) seçin.
2. Proje türü olarak Flutter Application'ı (Flutter Uygulaması) seçip Next'i (İleri) tıklayın.
3. Flutter SDK yolunun, SDK'nın konumunu belirttiğini doğrulayın. (Metin alanı boşsa SDK'yı yükle'yi seçin.)
4. Proje adını girin ve Sonraki'yi tıklayın.
5. Android Studio'nun önerdiği varsayılan paket adını kullanın ve İleri'yi tıklayın.
6. Son'u tıklayın.
7. Android Studio'nun SDK'yı yüklemesini ve projeyi oluşturmasını bekleyin.

3. 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'yi (veya Proje oluştur) tıklayın ve Firebase projenizi Firebase-Flutter-Ads ya da istediğiniz herhangi bir adla adlandırın.

2. Proje oluşturma seçeneklerini tıklayın. İstenirse Firebase şartlarını kabul edin. İşlem etkinliklerini izlemek ve dönüşümleri analiz etmek 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 edinmek için Firebase projelerini anlama başlıklı makaleyi inceleyin.

4. Platforma özgü Firebase yapılandırması (Android)

Android'i yapılandırma

1. Firebase konsolunda, soldaki gezinme menüsünden Proje Genel Bakış'ı seçin, ardından "Uygulamanıza Firebase ekleyerek başlayın" bölümünde Android düğmesini tıklayın.

Aşağıdaki ekranda gösterilen iletişim kutusunu görürsünüz.

2. Sağlamanız gereken önemli değer, aşağıdaki adımı kullanarak elde edeceğiniz Android paket adıdır.

İpucu: Paket ve uygulama kimlikleri hakkında daha fazla bilgi için Uygulama kimliğini ayarlama başlıklı makaleyi inceleyin.

3. Flutter uygulama dizininizde android/app/src/main/AndroidManifest.xml dosyasını açın.
4. manifest öğesinde, package özelliğinin dize değerini bulun. Bu değer, Android paket adıdır (örneğin, com.yourcompany.yourproject). Bu değeri kopyalayın.
5. Firebase iletişim kutusunda, kopyalanan paket adını Android package name alanına yapıştırın.
6. Google ile oturum açma veya Firebase Dynamic Links'i kullanmayı planlamıyorsanız (bunların bu codelab'in bir parçası olmadığını unutmayın) burada SHA-1 anahtarına ihtiyacımız yoktur. Google Play'den in_app_purchase verilerini içe aktarmayı planlıyorsanız anahtarı daha sonra ayarlamanız gerekir.
7. Register App'i (Uygulamayı Kaydet) tıklayın.
8. Firebase'de devam ederek yapılandırma dosyasını indirme talimatlarını uygulayın google-services.json.

9. Flutter uygulamanızın dizinine gidin, ardından yeni indirdiğiniz google-services.json dosyasını android/app dizinine taşıyın.
10. Firebase konsoluna geri dönün, kalan adımları atlayın ve Firebase konsolunun ana sayfasına geri dönün.
11. Son olarak, Firebase tarafından oluşturulan google-services.json dosyasını okumak için Google Hizmetleri Gradle eklentisine ihtiyacınız vardır.
12. IDE'nizde veya düzenleyicinizde android/app/build.gradle dosyasını açın ve aşağıdaki satırı dosyanın son satırı olarak ekleyin:

apply plugin: 'com.google.gms.google-services'

13. android/build.gradle dosyasını açın, ardından buildscript etiketi içinde yeni bir bağımlılık ekleyin:

buildscript { 
   repositories {
      // ...
   }
   dependencies {
      // ...
      Classpath 'com.google.gms:google-services:4.3.3'
   }
}

14. Uygulamanız hâlâ çalışıyorsa gradle'ın bağımlılıkları yüklemesine izin vermek için uygulamayı kapatıp yeniden oluşturun.

Android için Flutter uygulamanızı yapılandırma işlemini tamamladınız. iOS için bu codelab'e ( Flutter için Firebase'i tanıma) göz atabilirsiniz.

5. Flutter'da Firebase Analytics'i yapılandırma

Bu adımda, Firebase Analytics özelliklerini içeren firebase_analytics adlı Firebase Analytics paketini kullanmaya başlayacaksınız.

pubspec dosyası, Flutter uygulamasının öğelerini yönetir. pubspec.yaml içinde, bağımlılıklar listesine firebase_analytics: ^6.2.0 (firebase_analytics 6.2.0 veya daha yeni) ekleyin :

dependencies: 
   flutter: 
      sdk: flutter 
   cupertino_icons: ^0.1.2 
   firebase_analytics: ^6.2.0   # add this line

Android Studio'nun düzenleyici görünümünde pubspec'i görüntülerken Packages get'i (Paketleri al) tıklayın. Bu işlem, paketi projenize çeker. Konsolda aşağıdakileri görmeniz gerekir:

flutter packages get 
Running "flutter packages get" in startup_namer... 
Process finished with exit code 0

Pub get komutunu çalıştırmak, projeye çekilen tüm paketlerin ve bunların sürüm numaralarının listesini içeren pubspec.lock dosyasını da otomatik olarak oluşturur.

Dikkat: Belirli Firebase sürümlerinde, FirebaseAnalytics sınıfı ilk kez başlatılırken java.lang.IllegalArgumentException: Service not registered gösterilir (1662 numaralı GitHub sorununa bakın)..

lib/main.dart bölümünde yeni paketi içe aktarın:

import 'package:firebase_analytics/firebase_analytics.dart';

MyApp sınıfında, oluşturucuyu çağırarak FirebaseAnalytics nesnesini başlatın.

class MyApp extends StatelessWidget {
 static FirebaseAnalytics analytics = FirebaseAnalytics();
   ...
}

Artık bazı özel etkinlik günlüklerini tetiklemeye hazırsınız.

6. Firebase Analytics ile özel etkinlikleri günlüğe kaydetme

Flutter uygulamasında yeni bir şablon oluşturursanız _counter değişkenini ve varsayılan State sınıfının içindeki _incrementCounter() yöntemini görürsünüz. Şimdi, artırma düğmesi aşırı hevesli kullanıcılar tarafından beş defadan fazla tıklandığında özel etkinlikleri günlüğe kaydetmek istiyorsunuz. Daha sonra, potansiyel olarak ilgili kullanıcıların ilgisini çekmek için bir uygulama kampanyası başlatacağız.

İlk olarak, başlattığımız analiz nesnelerini Stateful widget'ına iletmek istiyoruz. MyHomePage oluşturucusuna bir analiz parametresi ekleyerek başlıyoruz.

MyHomePage({Key key, this.title, this.analytics}) : super(key: key);

Ayrıca oluşturucuyu çağırırken bir analiz parametresi de eklersiniz.

home: MyHomePage(
   title: 'Flutter Demo Home Page',
   analytics: analytics,
),

Artık logEvent() yöntemiyle etkinlikleri kolayca kaydedebilirsiniz. Yöntemi ekleyin ve _counter değişkenini artırın.

void _incrementCounter() {
 setState(() {
   _counter++;

   //add this
   if(_counter > 5) { 
     widget.analytics.logEvent(name: "clicked_counter"); 
   }

 });
}

Artık uygulamanız özel etkinlik günlüğünü tetiklemeye hazır.

Etkinlikleri tetiklemek için önceden oluşturulmuş yöntemleri de kullanabilirsiniz.

Artık her şey hazır. Android Studio'da "main.dart"ı çalıştırın.

(İsteğe bağlı) Parametreleri kullanarak Firebase Analytics'e ek bilgi gönderme

Parametreler aracılığıyla ek bilgiler gönderebilirsiniz. Özel parametreler, Analytics raporlarınızda raporlama için kaydedilebilir. Ayrıca, her rapora uygulanabilen kitle tanımlarında filtre olarak da kullanılabilirler. Uygulamanız bir BigQuery projesine bağlıysa özel parametreler BigQuery'de de bulunur (bkz. Firebase için BigQuery Export).

Burada _counter değerini parametre olarak ayarlıyoruz.

void _incrementCounter() {
 setState(() {
   _counter++;

   if(_counter > 5) {
     widget.analytics.logEvent(name: "clicked_counter", parameters: {'count' : _counter});
   }
 });
}

Etkinlikleri kontrol etme ve hata ayıklama

Birkaç saat içinde, kaydedilen etkinliklerinizi Firebase konsolunda görebilirsiniz. Firebase konsolundaki Analytics bölümünde Etkinlikler sekmesini tıklamanız yeterlidir. Etkinliği tıklayarak etkinlik clicked_counter içindeki değerleri de kontrol edebilirsiniz.

clicked_counter simgesini dönüşüm olarak işaretlemek için Dönüşüm olarak işaretle anahtarını sağa kaydırın.

Etkinlik Dönüşüm sekmesinde görünüyorsa etkinliği başarıyla dönüşüm olarak işaretlemişsinizdir. Google Ads artık bu etkinliği Firebase'den içe aktarabilir.

Hata ayıklama amacıyla Firebase DebugView'u kullanın. Daha fazla bilgi için Etkinlikte hata ayıklama başlıklı makaleyi inceleyin.

7. Google Ads'de analiz etkinliklerini içe aktarma

Firebase-Flutter kurulumunuz tamamlandıktan sonra, işlem etkinlikleriyle uygulama kampanyalarını başlatmaya hazırsınız. Firebase'i Google Ads'e bağlayarak başlayın. Firebase'i Google Ads'e bağlayarak uygulama kampanyaları Firebase etkinliklerini içe aktarabilir. Bu süreç, Google Ads'in kitleleri hakkında daha fazla bilgi edinmesine olanak tanıyarak uygulama kampanyalarını artırmasına da yardımcı olur.

1. Proje Genel Bakış'ın yanındaki düğmeyi tıklayarak Firebase Ayarları'na gidin.
2. Entegrasyonlar sekmesinde Google Ads ve Bağla düğmesini görürsünüz. Bağla'yı ve ardından Devam'ı tıklayın.

3. Google Ads hesabını seçin.

Dikkat: Hedef etkinlik bir dönüşüm etkinliği 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.

Firebase bölümü tamamlandı.

Google Ads'e gidin.

1. Oturum açın ve özel etkinlikleri dönüşüm olarak içe aktarmak için Araçlar ve Ayarlar > Ölçüm > Dönüşümler'e gidin.
2. Yeni dönüşüm işlemleri eklemek için + düğmesini tıklayın.

3. Google Analytics 4 mülkleri (Firebase)'ni seçin ve Devam'ı tıklayın.

4. Dönüşüm olarak işaretlenen tüm analiz etkinliklerini görebilirsiniz. Daha önce uyguladığımız clicked_counter etkinliğini bulun.

5. İşlemi işaretleyin, İçe aktar'ı ve ardından Devam et'i tıklayın.

clicked_counter etkinliğini dönüşüm işlemi olarak ayarladıktan sonra, clicked_counter etkinliklerini 5'ten fazla kez tetikleme olasılığı yüksek olan kullanıcıları hedefleyebilen işlem kampanyaları başlatabilirsiniz.

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

Önemli: Bir uygulama kampanyasını başarıyla başlatmak için Google Play'de üretim düzeyinde bir uygulama edinmeniz gerekir. Ancak henüz yayınlamaya hazır değilseniz bu adımı şimdilik atlayabilirsiniz.

6. Mevcut hesabınızın kampanya sekmesine gidin ve + düğmesini tıklayarak yeni bir kampanya başlatın. [Yeni kampanya]'yı ve ardından Devam'ı tıklayın.
7. Uygulama yüklemeleri seçeneğiyle uygulama tanıtım kampanyası başlatın.

8. Uygulama adını, paket adını veya yayıncıyı yazarak uygulamanızı bulun.
9. Teklif verme bölümündeki açılır menüden Uygulama içi işlemler'i seçin.
10. Sağlanan listede özel etkinliğinizi bulun. Hedef işlem başına maliyet'i ayarlayın ve diğer seçenekleri tamamlayın.

11. Kampanya ayarlarınızı tamamlayın.

9. Tebrikler

Tebrikler, Firebase ve Google Ads'i başarıyla entegre ettiniz. Bu sayede, Firebase'den içe aktarılan etkinliklerle kampanya performansınızı artırabilirsiniz.

Öğrendikleriniz

• Firebase Analytics'i Flutter için Yapılandırma
• Flutter uygulamasında Firebase Analytics ile özel etkinlikler nasıl günlüğe kaydedilir?
• Etkinlikleri içe aktarma ve işlem kampanyalarında kullanma