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

1. Giriş

Son Güncelleme Tarihi: 25.01.2021

Oluşturacaklarınız

Bu codelab'de, GA4F ile özel etkinlikleri nasıl uygulayacağınızı ve Flutter için Google Ads uygulaması aracılığıyla işlem kampanyaları başlatmayı öğreneceksiniz.

Basit bir sayaç widget'ı ile varsayılan Flutter uygulamasını kullanacağız. Uygulamamızı büyük olasılıkla sayaç widget'ını tıklayacak potansiyel kullanıcılara tanıtacağız.

Neler öğreneceksiniz?

• Flutter'da GA4F'yi (Firebase için Google Analytics) başlatma
• Özel etkinlik ve parametreler oluşturma
• Etkinlikleri Firebase'den Google Ads'e aktarma
• Özel etkinlikler içeren işlem 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 projesine başlayın

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

Android Studio'yu başlatın.

Not: IDE'nizde New Flutter Project seçeneği görünmüyorsa Flutter ve Dart için eklenti yüklediğinizden emin olun.

1. Açık projeniz yoksa karşılama sayfasından Yeni bir Flutter uygulaması başlat'ı seçin. Aksi halde, Dosya > Yeni > Yeni Flutter Projesi.
2. Proje türü olarak Flutter Application'ı (Flutter Uygulaması) seçin ve 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 Next'i (İleri) tıklayın.
5. Android Studio tarafından önerilen 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 (veya Proje Oluştur) seçeneğini tıklayın ve Firebase projenizi Firebase-Flutter-Ads olarak veya istediğiniz herhangi bir adla adlandırın.

2. Proje oluşturma seçeneklerini tıklayarak ilerleyin. İ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 için Firebase projelerini anlama başlıklı makaleyi inceleyin.

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

Android'i yapılandırma

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.

Sonraki ekranda gösterilen iletişim kutusunu göreceksiniz.

2. Sağlanacak önemli değer Android paketi adıdır. Bu değeri aşağıdaki adımı izleyerek edinebilirsiniz.

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

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 paketinin adıdır (com.yourcompany.yourproject gibi). 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 kullanmayı planlamıyorsanız burada SHA-1 anahtarına ihtiyacınız yoktur (bunların bu codelab'in bir parçası olmadığını unutmayın). in_app_purchase verilerini Google Play'den içe aktarmayı planlıyorsanız anahtarı daha sonra ayarlamanız gerekir.
7. Uygulamayı Kaydet'i tıklayın.
8. Firebase'de devam ederek google-services.json yapılandırma dosyasını indirme talimatlarını uygulayın.

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

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

13. android/build.gradle sayfasını açıp buildscript etiketinin içine 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ırmayı tamamladınız. iOS için bu codelab'e göz atabilirsiniz ( Flutter için Firebase'i tanıma)

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şlarsınız.

pubspec dosyası bir Flutter uygulamasının öğelerini yönetir. pubspec.yaml ürününde bağımlılık listesine firebase_analytics: ^6.2.0 (firebase_analytics 6.2.0 veya sonraki bir sürüm) ekleyin :

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

pubspec'i Android Studio'nun düzenleyici görünümünde görüntülerken Paketler alındı'yı tıklayın. Bu işlem, paketi projenize çeker. Konsolda şunu göreceksiniz:

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

Pub get gerçekleştirildiğinde, projeye alınan tüm paketlerin listesiyle ve sürüm numaralarıyla birlikte pubspec.lock dosyası otomatik olarak oluşturulur.

Dikkat: Belirli Firebase sürümleri için FirebaseAnalytics sınıfı ilk kez başlatılırken java.lang.IllegalArgumentException: Service not registered gösterilir (github sorunu 1662'ye bakın).

lib/main.dart uygulamasında 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 kaydedin

Flutter uygulamasında yeni bir şablon oluşturursanız varsayılan State sınıfının içinde bir _counter değişkeni ve _incrementCounter() yöntemi görürsünüz. Şimdi ise gereğinden fazla meraklı kullanıcıların artı düğmesi beş defadan fazla tıklandığında özel etkinlikler kaydetmek istiyorsunuz. Ardından, potansiyel meraklı kullanıcıları çekmek için bir uygulama kampanyası başlatacağız

Öncelikle, başlattığımız analiz nesnelerini Stateful widget'ına iletmek istiyoruz. MyHomePage oluşturucuya bir analytics parametresi ekleyerek başlıyoruz.

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

Oluşturucuyu çağırırken bir analytics parametresi de eklemeniz gerekir.

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

Artık logEvent() yöntemini kullanarak etkinlikleri kolayca günlüğe 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"); 
   }

 });
}

Uygulamanız artık ö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" komutunu çalıştırın.

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

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

Burada parametre olarak _counter değerini 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

Günlüğe kaydedilen etkinliklerinizi birkaç saat içinde Firebase konsolunda görebilirsiniz. Firebase Konsolu'ndaki Analytics bölümünde Etkinlikler sekmesini tıklamanız yeterlidir. Yalnızca etkinliği tıklayarak clicked_counter etkinliğindeki değerleri de kontrol edebilirsiniz.

Dönüşüm olarak işaretle anahtarını sağa kaydırarak clicked_counter dönüşümünü işaretleyin.

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

Hata ayıklama için Firebase DebugView'u kullanın. Daha fazla bilgi için Etkinlikte hata ayıklama bölümüne bakın.

7. Analiz etkinliklerini Google Ads'e aktarma

Firebase-Flutter kurulumunuz tamamlandıktan sonra işlem etkinlikleriyle uygulama kampanyalarını başlatmaya hazırsınız demektir. Firebase'i Google Ads'e bağlayarak başlayın. Firebase Google Ads'e bağlandığında uygulama kampanyaları Firebase etkinliklerini içe aktarabilir. Bu süreç, Google Ads'in kitleleri hakkında daha fazla bilgi edinmesini sağlayarak uygulama kampanyalarını güçlendirmesine de yardımcı olur.

1. Projeye 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ğlantı oluştur'u, ardından Devam'ı tıklayın.

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

Dikkat: Hedef etkinlik 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.

Şimdi Firebase kısmı tamamlandı.

Google Ads'e gidin.

1. Giriş yapın ve Araçlar ve Ayarlar > Ölçüm > Dönüşümler'i seçin.
2. Yeni dönüşüm işlemleri eklemek için + düğmesini tıklayın.

3. Google Analytics 4 mülkleri (Firebase) seçeneğini belirleyin 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 kontrol edin, İçe aktar'ı,ardından Devam'ı tıklayın.

clicked_counter dönüşüm işlemini bir dönüşüm işlemi olarak ayarladıktan sonra, clicked_counter etkinliklerini 5 defadan fazla tetikleyebilecek kullanıcıları hedefleyebilecek işlem kampanyaları başlatabilirsiniz.

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

Önemli: Uygulama kampanyasını başarılı bir şekilde 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] seçeneğini, ardından Devam'ı tıklayın.
7. Uygulama Yüklemeleri seçeneğini kullanarak bir 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. İşlem başına maliyet hedefi'ni ayarlayın ve ek seçenekleri tamamlayın.

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

9. Tebrikler

Tebrikler, Firebase ile Google Ads'i başarıyla entegre ettiniz. Böylece, Firebase'den içe aktarılan etkinliklerle kampanya performansınızı artırabilirsiniz.

Neler öğrendiniz?

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