1. Pengantar
Terakhir Diperbarui: 25-01-2021
Yang akan Anda bangun
Dalam codelab ini, Anda akan mempelajari cara menerapkan peristiwa kustom dengan GA4F, dan meluncurkan kampanye tindakan melalui aplikasi Google Ads untuk Flutter.
Kita akan menggunakan aplikasi Flutter default dengan widget penghitung sederhana. Kita akan mengiklankan aplikasi kepada calon pengguna yang kemungkinan akan mengklik widget penghitung.
Yang akan Anda pelajari
- Cara melakukan inisialisasi GA4F (Google Analytics for Firebase) di Flutter
- Cara membuat peristiwa dan parameter kustom
- Cara mengimpor peristiwa dari Firebase ke Google Ads
- Cara meluncurkan kampanye tindakan dengan peristiwa kustom
Yang Anda butuhkan
- Android Studio 3.6 atau yang lebih tinggi
- Xcode (untuk dukungan iOS)
- Akun Firebase
- Akun Google Ads
2. Memulai project Flutter baru
Membuat aplikasi Flutter dengan template sederhana. Anda akan memodifikasi aplikasi awal ini untuk codelab ini.
Luncurkan Android Studio.
- Jika Anda tidak memiliki project yang terbuka, pilih Start a new Flutter app dari halaman selamat datang. Jika tidak, pilih File > Baru > Project Flutter Baru.
- Pilih Flutter Application sebagai jenis project, lalu klik Next.
- Verifikasi bahwa jalur Flutter SDK menentukan lokasi SDK. (Pilih Install SDK jika kolom teks kosong.)
- Masukkan nama project, lalu klik Next.
- Gunakan nama paket default yang disarankan oleh Android Studio, lalu klik Next.
- Klik Finish.
- Tunggu Android Studio menginstal SDK dan membuat project tersebut.
3. Membuat dan menyiapkan project Firebase
Untuk memulai Firebase, Anda harus membuat dan menyiapkan project Firebase.
Membuat project Firebase
- Login ke Firebase.
Di Firebase console, klik Tambahkan Project (atau Buat project), dan beri nama project Firebase sebagai Firebase-Flutter-Ads atau nama apa pun yang Anda inginkan.
- Klik opsi pembuatan project. Setujui persyaratan Firebase jika diminta. Anda harus mengaktifkan Google Analytics untuk project ini, karena Anda membutuhkan peristiwa Google Analytics untuk melacak peristiwa tindakan dan menganalisis konversi.
Untuk mempelajari lebih lanjut project Firebase, lihat Memahami project Firebase.
4. Konfigurasi Firebase khusus platform (Android)
Mengonfigurasi Android
- Di Firebase Console, Pilih Project Overview di panel navigasi sebelah kiri, lalu klik tombol Android di bagian "Get started by menambahkan Firebase ke aplikasi Anda"
Anda akan melihat dialog yang ditampilkan di layar berikut.
- Nilai penting yang harus diberikan adalah nama paket Android, yang akan Anda dapatkan mengikuti langkah berikut.
- Di direktori aplikasi Flutter Anda, buka file
android/app/src/main/AndroidManifest.xml
. - Di elemen
manifest
, temukan nilai string atributpackage
. Nilai ini adalah nama paket Android (misalnyacom.yourcompany.yourproject
). Salin nilai ini. - Di dialog Firebase, tempelkan nama paket yang disalin ke kolom
Android package name
. - Kita tidak memerlukan kunci SHA-1 di sini, kecuali Anda berencana untuk menggunakan Login dengan Google atau Firebase Dynamic Links (perlu diketahui bahwa ini bukan bagian dari codelab ini). Jika Anda berencana mengimpor data
in_app_purchase
dari Google Play, Anda akan harus menetapkan kuncinya nanti. - Klik Register App.
- Melanjutkan di Firebase, ikuti petunjuk untuk mendownload file konfigurasi
google-services.json
.
- Buka direktori aplikasi Flutter, lalu pindahkan file
google-services.json
(yang baru saja Anda download) ke direktoriandroid/app
. - Kembali di Firebase console, lewati langkah-langkah yang tersisa, lalu kembali ke halaman utama Firebase console.
- Terakhir, Anda memerlukan Google Services Gradle plugin untuk membaca file
google-services.json
yang dihasilkan oleh Firebase. - Di IDE atau editor Anda, buka
android/app/build.gradle
, lalu tambahkan baris berikut sebagai baris terakhir di file:
apply plugin: 'com.google.gms.google-services'
- Buka
android/build.gradle
, lalu di dalam tagbuildscript
, tambahkan dependensi baru:
buildscript {
repositories {
// ...
}
dependencies {
// ...
Classpath 'com.google.gms:google-services:4.3.3'
}
}
- Jika aplikasi Anda masih berjalan, tutup dan build ulang untuk memungkinkan gradle menginstal dependensi.
Anda telah selesai mengonfigurasi aplikasi Flutter Anda untuk Android. Untuk iOS, sebaiknya baca codelab ini ( Mengenal Firebase untuk Flutter)
5. Mengonfigurasi Firebase Analytics di Flutter
Pada langkah ini, Anda akan mulai menggunakan paket Firebase Analytics bernama firebase_analytics
, yang berisi fitur Firebase Analytics.
File pubspec mengelola aset untuk aplikasi Flutter. Di pubspec.yaml
, tambahkan firebase_analytics: ^6.2.0
(firebase_analytics
6.2.0 atau yang lebih tinggi) ke daftar dependensi:
dependencies:
flutter:
sdk: flutter
cupertino_icons: ^0.1.2
firebase_analytics: ^6.2.0 # add this line
Saat melihat pubspec di tampilan editor Android Studio, klik Packages get. Tindakan ini akan menarik paket ke dalam project Anda. Anda akan melihat tampilan berikut di konsol:
flutter packages get
Running "flutter packages get" in startup_namer...
Process finished with exit code 0
Dengan menjalankan Pub get
, file pubspec.lock
akan otomatis dibuat dengan daftar semua paket yang ditarik ke dalam project beserta nomor versinya.
Di lib/main.dart
, impor paket baru:
import 'package:firebase_analytics/firebase_analytics.dart';
Di class MyApp
, mulai objek FirebaseAnalytics
dengan memanggil konstruktor.
class MyApp extends StatelessWidget {
static FirebaseAnalytics analytics = FirebaseAnalytics();
...
}
Sekarang Anda siap untuk mengaktifkan beberapa log peristiwa kustom.
6. Mencatat log peristiwa kustom dengan Firebase Analytics
Jika akan membuat template baru di aplikasi Flutter, Anda akan melihat variabel _counter
, dan metode _incrementCounter()
di dalam class State
default. Sekarang, Anda ingin mencatat peristiwa khusus ketika tombol penambahan diklik lebih dari lima kali dari pengguna yang terlalu antusias. Nanti, kita akan meluncurkan kampanye aplikasi untuk menarik calon pengguna yang antusias
Pertama, kita ingin meneruskan objek analisis yang telah kita inisialisasi ke widget Stateful
. Kita mulai dengan menambahkan parameter analisis ke konstruktor MyHomePage
.
MyHomePage({Key key, this.title, this.analytics}) : super(key: key);
Anda juga akan menambahkan parameter analisis saat memanggil konstruktor.
home: MyHomePage(
title: 'Flutter Demo Home Page',
analytics: analytics,
),
Sekarang, Anda dapat dengan mudah mencatat peristiwa ke dalam log dengan metode logEvent()
. Tambahkan metode dan tambahkan variabel _counter
.
void _incrementCounter() {
setState(() {
_counter++;
//add this
if(_counter > 5) {
widget.analytics.logEvent(name: "clicked_counter");
}
});
}
Sekarang aplikasi Anda sudah siap untuk mengaktifkan log peristiwa kustom.
Anda juga dapat menggunakan metode yang telah di-build sebelumnya untuk mengaktifkan peristiwa.
Sekarang semuanya sudah siap. Di Android Studio, jalankan "main.dart".
(Opsional) Mengirim informasi tambahan ke Firebase Analytics menggunakan parameter
Anda dapat mengirim informasi tambahan melalui parameter. Parameter kustom dapat didaftarkan untuk pelaporan di laporan Analytics Anda. Parameter juga dapat digunakan sebagai filter di definisi audience yang dapat diterapkan ke setiap laporan. Jika aplikasi Anda ditautkan ke project BigQuery, parameter kustom juga akan ditemukan di BigQuery (lihat BigQuery Export for Firebase).
Kita menetapkan nilai _counter
sebagai parameter di sini.
void _incrementCounter() {
setState(() {
_counter++;
if(_counter > 5) {
widget.analytics.logEvent(name: "clicked_counter", parameters: {'count' : _counter});
}
});
}
Memeriksa dan men-debug peristiwa
Dalam beberapa jam, Anda akan dapat melihat peristiwa yang disimpan di log di Firebase console. Cukup klik tab Events dari Bagian Analytics yang ada di Firebase Console. Anda juga dapat memeriksa nilai di dalam clicked_counter
peristiwa hanya dengan mengklik peristiwa tersebut.
Tandai clicked_counter
sebagai konversi dengan menggeser tombol Tandai sebagai konversi ke kanan.
Jika peristiwa ada di tab Konversi, berarti Anda telah berhasil menandai peristiwa sebagai konversi. Google Ads sekarang dapat mengimpor peristiwa ini dari Firebase.
Untuk tujuan proses debug, gunakan DebugView Firebase. Untuk detail selengkapnya, lihat Proses Debug Peristiwa.
7. Mengimpor peristiwa analisis di Google Ads
Setelah penyiapan Firebase-Flutter Anda selesai, Anda siap meluncurkan kampanye aplikasi dengan peristiwa tindakan. Mulai dengan menautkan Firebase ke Google Ads. Dengan menautkan Firebase ke Google Ads,kampanye aplikasi dapat mengimpor peristiwa Firebase. Proses ini juga membantu Google Ads untuk meningkatkan kampanye aplikasi dengan memungkinkannya mempelajari lebih lanjut audiens mereka.
- Buka Firebase Settings dengan mengklik tombol di samping Project Overview.
- Dalam tab Integrasi, Anda akan melihat Google Ads dan tombol Tautkan. Klik Tautkan, lalu klik Lanjutkan.
- Pilih akun Google Ads.
Sekarang, bagian Firebase sudah selesai.
Buka Google Ads.
- Login, dan buka Alat & Pengaturan > Pengukuran > Konversi untuk mengimpor peristiwa kustom sebagai konversi.
- Klik tombol + untuk menambahkan tindakan konversi baru.
- Pilih properti Google Analytics 4 (Firebase), lalu klik Lanjutkan.
- Anda dapat melihat semua peristiwa analisis yang ditandai sebagai konversi. Temukan peristiwa
clicked_counter
yang kita terapkan sebelumnya.
- Periksa tindakannya, klik Impor, lalu klik Lanjutkan.
Setelah menetapkan clicked_counter
sebagai tindakan konversi, Anda akan meluncurkan kampanye tindakan yang dapat menargetkan pengguna yang kemungkinan mengaktifkan peristiwa clicked_counter
lebih dari 5 kali.
8. Meluncurkan kampanye tindakan aplikasi dengan peristiwa yang diimpor
- Buka tab kampanye di akun Anda saat ini, dan mulai kampanye baru dengan mengklik tombol +. Klik [Kampanye baru], lalu klik Lanjutkan.
- Luncurkan kampanye Promosi aplikasi dengan opsi Instal Aplikasi.
- Temukan aplikasi Anda dengan mengetik nama aplikasi, nama paket, atau penayang.
- Di bagian Bidding, pilih Tindakan dalam aplikasi di menu dropdown.
- Temukan peristiwa kustom Anda di daftar yang disediakan. Tetapkan Target biaya per tindakan, dan selesaikan opsi tambahan.
- Selesaikan setelan kampanye Anda.
9. Selamat
Selamat, Anda telah berhasil mengintegrasikan Firebase dan Google Ads Anda. Hal ini akan membantu Anda meningkatkan performa kampanye dengan peristiwa Firebase yang diimpor.
Anda telah mempelajari
- Cara Mengonfigurasi Firebase Analytics untuk Flutter
- Cara mencatat peristiwa kustom ke dalam log dengan Firebase Analytics di aplikasi Flutter.
- Cara mengimpor peristiwa dan menggunakannya untuk kampanye tindakan.