1. Pengantar
Terakhir diperbarui: 14-12-2020
Hal yang akan Anda build
Dalam codelab ini, Anda akan mempelajari cara menerapkan peristiwa dengan Google Analytics for Firebase(GA4F) dan meluncurkan kampanye tindakan melalui Google Ads.
Codelab ini berfokus pada penerapan peristiwa dengan GA4F dan pengimporan peristiwa di Google Ads. Jika Anda ingin mempelajari cara mem-build aplikasi Android dengan Firebase, lihat Chat yang Ramah untuk Build Codelab Android Firebase.
Yang akan Anda pelajari
- Cara membuat project Firebase
- Cara menerapkan Firebase SDK di aplikasi Android
- Cara membuat peristiwa dan parameter.
- Cara mengimpor peristiwa dari Firebase ke Google Ads
- Luncurkan kampanye tindakan Google Ads dengan peristiwa kustom.
Yang Anda butuhkan
- Android Studio 3.6 atau yang lebih baru
- Akun Firebase
- Akun Google Ads
2. 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 sesuai keinginan Anda.
- Klik opsi pembuatan project. Setujui persyaratan Firebase jika diminta. Anda harus mengaktifkan Google Analytics untuk project ini, karena Anda memerlukan peristiwa Google Analytics untuk melacak peristiwa tindakan dan konversi.
Untuk mempelajari project Firebase lebih lanjut, lihat Memahami project Firebase.
- Pilih akun Google Analytics. Jika Anda memilikinya, pilih yang itu atau buat yang baru. Klik tombol Create project.
- Sekarang, build project Firebase telah selesai.
Pada langkah berikutnya, Anda akan mempelajari cara menambahkan Firebase ke aplikasi Android.
3. Tambahkan Firebase ke aplikasi Android
Daftarkan aplikasi
- Di Firebase Console, Pilih Ringkasan Project di navigasi sebelah kiri, lalu klik tombol Android di bagian "Memulai dengan menambahkan Firebase ke aplikasi Anda"
- Isi informasi yang dibutuhkan.
Untuk nama paket Android, di Android Studio, buka direktori aplikasi, buka nama file build.gradle. Dalam file, telusuri applicationId. Nilai ini adalah nama paket Android. Salin nilai ini dan tempelkan.
Kita tidak memerlukan kunci SHA-1 di sini, kecuali Anda berencana menggunakan Login dengan Google atau Firebase Dynamic Links (Perlu diperhatikan bahwa ini bukan bagian dari codelab ini, untuk mengetahui informasi selengkapnya tentang kunci SHA-1, baca dokumen ini.).
- Klik tombol Register App (Daftarkan Aplikasi).
Download file konfigurasi
- Klik tombol Download google-services.json untuk mendownload file konfigurasi
google-services.json.
- Di Android Studio, buka direktori
appdan pindahkan filegoogle-services.json(yang baru saja Anda download di atas) ke direktoriapp. Kembali ke Firebase console, klik tombol Next.
Mengaktifkan Firebase di aplikasi
- Anda memerlukan plugin Gradle Layanan Google untuk membaca file
google-services.jsonyang dibuat oleh Firebase. - Di Android Studio, buka
<project>/build.gradle, lalu tambahkan baris berikut dalam file:
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
...
}
}
}
- Buka
<project>/<app-module>/build.gradle, lalu tambahkan baris berikut dalam file:
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'
Anda telah selesai menambahkan Firebase ke aplikasi Android.
Pada langkah berikutnya, Anda akan mempelajari cara menambahkan Firebase SDK ke aplikasi.
4. Menambahkan Firebase SDK ke aplikasi
Pada langkah ini, Anda akan menambahkan Firebase SDK, khususnya Firebase SDK untuk Google Analytics.
Kita akan menggunakan Firebase Android BoM yang memungkinkan Anda mengelola versi library Firebase yang digunakan di aplikasi dengan menentukan versi BoM. Untuk mempelajari versi library Firebase yang dipetakan ke versi BoM tertentu, baca catatan rilis untuk versi BoM tersebut.
- Buka
<project>/<app-module>/build.gradle, lalu tambahkan baris berikut dalam file:
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'
Seperti yang dapat dilihat, dengan menentukan versi BoM saja, Anda tidak perlu menentukan versi library analisis Firebase. Namun, jika ingin menggunakan versi yang diinginkan untuk library Firebase, apa pun versi yang ditetapkan di BoM, Anda hanya perlu menentukan versi yang diinginkan seperti ini:
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'
- Sekarang sinkronkan aplikasi dengan mengklik tombol
Sync Now.
Sekarang, Anda telah selesai menambahkan Firebase SDK untuk Google Analytics ke aplikasi Android Anda.
Pada langkah berikutnya, Anda akan mempelajari cara mencatat peristiwa Firebase ke dalam log di aplikasi Android.
5. Mencatat peristiwa ke dalam log dengan Firebase Analytics
Pada langkah ini, Anda akan mempelajari cara mencatat peristiwa ke dalam log dengan Firebase Analytics di aplikasi Android.
Ada 2 cara untuk mencatat peristiwa ke dalam log: Menggunakan peristiwa yang disarankan atau peristiwa kustom.
Menggunakan peristiwa yang disarankan
Firebase Analytics SDK menetapkan sejumlah peristiwa yang disarankan yang dapat digunakan di berbagai jenis aplikasi seperti game, retail, perjalanan, dan e-commerce. Selain itu, ada beberapa peristiwa yang disarankan yang memerlukan parameter yang telah ditentukan, dan dengan parameter tersebut, Anda dapat memaksimalkan detail yang tersedia dalam laporan Firebase. ( Referensi peristiwa yang disarankan)
- Deklarasikan objek FirebaseAnalytics di bagian atas aktivitas:
private lateinit var firebaseAnalytics: FirebaseAnalytics
- Inisialisasi objek dalam metode
onCreate():
firebaseAnalytics = Firebase.analytics
- Mulai logging peristiwa dengan metode
logEvent(). Kode berikut mencatat peristiwa PURCHASE ke dalam log saat pengguna membeli item di aplikasi:
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
param(FirebaseAnalytics.Param.VALUE, 10)
param(FirebaseAnalytics.Param.CURRENCY, "USE")
}
Menggunakan peristiwa kustom
Jika memerlukan peristiwa yang tidak tercakup oleh peristiwa yang disarankan, Anda dapat mencatat peristiwa kustom Anda sendiri ke dalam log dengan parameter kustom:
firebaseAnalytics.logEvent("delete_item"){
param("item name", name)
param("reason", text)
}
Men-debug peristiwa
Anda dapat melihat data gabungan dan laporan tentang peristiwa di Firebase console. Namun, pembaruan dilakukan secara berkala sepanjang hari, Anda tidak dapat melihat peristiwa tersebut segera setelah Anda memasukkannya ke aplikasi.
Untuk keperluan pengujian dan proses debug langsung, Anda dapat menggunakan Firebase Debugview. DebugView memungkinkan Anda melihat data peristiwa yang dicatat oleh aplikasi di perangkat pengembangan secara hampir real-time. Untuk DebugView, lihat bagian Peristiwa proses debug.
Anda telah menyelesaikan logging peristiwa ke aplikasi Android.
Pada langkah berikutnya, Anda akan mempelajari cara mengimpor peristiwa tersebut ke Google Ads.
6. Mengimpor peristiwa Firebase ke Google Ads
Penyiapan Firebase-Android Anda telah selesai, dan Anda siap meluncurkan kampanye aplikasi dengan peristiwa tindakan yang dicatat. Anda akan memulai dengan menautkan Firebase ke Google Ads. Dengan menautkan Firebase ke Google Ads, kampanye Aplikasi akan dapat mempelajari audiens lebih lanjut dan meningkatkan pembelajaran kampanye Aplikasi, yang biasanya menghasilkan performa dan konversi yang lebih baik.
Menautkan Firebase dan Google Ads
- Buka Setelan Firebase dengan mengklik tombol tepat di samping Ringkasan Project.
- Di tab Integrasi, Anda akan melihat Google Ads dan tombol Tautkan. Klik Tautkan dan Lanjutkan.
- Pilih akun Google Ads yang ingin ditautkan.
Sekarang Anda telah selesai menautkan Firebase dan Google Ads. Mari kita impor peristiwa Firebase ke Google Ads.
Mengimpor peristiwa Firebase
- Di Firebase console, buka menu Events dan tandai peristiwa yang ingin diimpor sebagai konversi.
- Sekarang, Buka Google Ads dan login ke akun yang Anda tautkan dengan Firebase.
- Di Google Ads, buka Alat → Pengukuran → Konversi
- Klik tombol +
- Pilih Aplikasi → properti Google Analytics 4 (Firebase), lalu klik lanjutkan.
- Anda dapat melihat semua peristiwa analisis yang ditandai sebagai konversi. Temukan peristiwa yang ingin Anda impor. Dalam hal ini, pilih peristiwa
delete_itemyang telah kita terapkan sebelumnya. Klik tombol Impor dan Lanjutkan.
- Anda berhasil mengimpor peristiwa konversi dari Firebase.
Sekarang Anda telah selesai mengimpor peristiwa Firebase ke Google Ads.
Pada langkah berikutnya, Anda akan mempelajari cara meluncurkan kampanye tindakan dengan peristiwa yang baru saja diimpor.
7. Meluncurkan kampanye tindakan aplikasi dengan peristiwa yang diimpor
- Buka tab kampanye Aplikasi di akun Google Ads Anda saat ini, dan mulai kampanye baru dengan mengklik tombol +.
- Kami akan meluncurkan kampanye promosi Aplikasi dengan opsi Penginstalan Aplikasi. Di bagian bawah, pilih aplikasi yang ingin dipromosikan lalu klik lanjutkan.
- Di bagian Bidding, jika memilih Tindakan dalam aplikasi di menu dropdown, Anda dapat melihat peristiwa. Pilih acara yang ingin Anda fokuskan.
- Tetapkan sisa setelan kampanye dan selesai.
8. Selamat
Selamat, Anda berhasil mengintegrasikan Firebase dan Google Ads. Hal ini akan membantu Anda meningkatkan performa kampanye.
Anda telah mempelajari
- Cara Mengonfigurasi Firebase Analytics untuk Android
- Cara mencatat peristiwa ke dalam log dengan Firebase Analytics di aplikasi Android.
- Cara mengimpor peristiwa dan menggunakannya untuk kampanye tindakan.