1. Perkenalan
Terakhir Diperbarui: 14-12-2020
Apa yang akan Anda bangun
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 membuat aplikasi android dengan Firebase, silakan merujuk ke Firebase Android Codelab-Build Friendly Chat .
Apa yang akan Anda pelajari
- Cara membuat proyek Firebase
- Cara mengimplementasikan 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 khusus.
Apa yang Anda butuhkan
- Android Studio 3.6 atau lebih tinggi
- Akun Firebase
- Akun Iklan Google
2. Buat dan siapkan proyek Firebase
Untuk memulai Firebase, Anda harus membuat dan menyiapkan proyek Firebase.
Buat proyek Firebase
- Masuk ke Firebase .
Di konsol Firebase, klik Tambahkan Proyek (atau Buat proyek), dan beri nama proyek Firebase Anda sesuai keinginan.
- Klik opsi pembuatan proyek. Terima persyaratan Firebase jika diminta. Anda harus mengaktifkan Google Analytics untuk proyek ini, karena Anda memerlukan peristiwa Google Analytics untuk melacak peristiwa tindakan dan konversi.
Untuk mempelajari lebih lanjut tentang proyek Firebase, lihat Memahami proyek Firebase .
- Pilih akun Google Analytics. Jika Anda memilikinya, pilih yang itu atau buat yang baru. Klik tombol Buat proyek.
- Sekarang pembangunan proyek Firebase telah selesai!
Pada langkah selanjutnya, Anda akan mempelajari cara menambahkan Firebase ke aplikasi Android Anda.
3. Tambahkan Firebase ke aplikasi Android Anda
Daftarkan aplikasi
- Di Firebase Console, Pilih Ikhtisar Proyek di navigasi kiri, lalu klik tombol Android di bawah "Mulai dengan menambahkan Firebase ke aplikasi Anda"
- Isi informasi yang diperlukan.
Untuk nama paket Android, di studio Android buka direktori aplikasi, buka nama file build.gradle
. Di dalam file, cari applicationId
. Nilai ini adalah nama paket Android. Salin nilai ini dan tempel.
Kami tidak memerlukan kunci SHA-1 di sini, kecuali jika Anda berencana untuk menggunakan Google Sign In atau Firebase Dynamic Links (Perhatikan bahwa ini bukan bagian dari codelab ini, untuk informasi lebih lanjut tentang kunci SHA-1, lihat dokumen ini .) .
- Klik tombol Daftar Aplikasi.
Unduh file konfigurasi
- Klik tombol Unduh google-services.json untuk mengunduh file konfigurasi
google-services.json
.
- Di studio Android, buka direktori
app
dan pindahkan filegoogle-services.json
(yang baru saja Anda unduh di atas) ke direktoriapp
. Kembali ke konsol Firebase, klik tombol Berikutnya.
Aktifkan Firebase di aplikasi Anda
- Anda memerlukan plugin Google Services Gradle untuk membaca file
google-services.json
yang dibuat oleh Firebase. - Di Android studio, buka
<project>/build.gradle
, lalu tambahkan baris berikut di 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 di file:
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'
Sekarang, Anda telah selesai menambahkan Firebase ke aplikasi Android Anda!
Pada langkah selanjutnya, Anda akan mempelajari cara menambahkan Firebase SDK ke aplikasi Anda.
4. Tambahkan Firebase SDK ke aplikasi Anda
Pada langkah ini, Anda akan menambahkan Firebase SDK, khususnya Firebase SDK untuk Google Analytics.
Kami akan menggunakan Firebase Android BoM yang memungkinkan Anda mengelola versi pustaka Firebase yang Anda gunakan di aplikasi dengan menentukan versi BoM. Untuk mempelajari versi pustaka Firebase mana yang dipetakan ke versi BoM tertentu, lihat catatan rilis untuk versi BoM tersebut.
- Buka
<project>/<app-module>/build.gradle
, lalu tambahkan baris berikut di 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 Anda lihat, dengan hanya menentukan versi BoM, Anda tidak perlu menentukan versi pustaka analitik firebase. Namun jika Anda ingin menggunakan versi yang diinginkan untuk pustaka Firebase Anda, 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 Anda dengan mengeklik tombol
Sync Now
.
Sekarang, Anda telah selesai menambahkan Firebase SDK untuk Google Analytics ke aplikasi Android Anda!
Pada langkah selanjutnya, Anda akan mempelajari cara membuat log peristiwa Firebase di aplikasi Android Anda.
5. Catat peristiwa dengan Firebase Analytics
Pada langkah ini, Anda akan mempelajari cara membuat log peristiwa dengan Firebase Analytics di aplikasi Android.
Ada 2 cara dalam mencatat peristiwa: Menggunakan peristiwa yang disarankan atau peristiwa khusus.
Menggunakan acara yang disarankan
SDK Firebase Analytics menentukan sejumlah peristiwa yang disarankan yang dapat digunakan di berbagai jenis aplikasi seperti game, ritel, perjalanan, dan e-niaga. Juga ada beberapa peristiwa yang disarankan yang memerlukan parameter yang ditentukan dan dengan parameter tersebut Anda dapat memaksimalkan detail yang tersedia dalam laporan Firebase Anda. ( Referensi acara yang disarankan )
- Deklarasikan objek FirebaseAnalytics di bagian atas aktivitas:
private lateinit var firebaseAnalytics: FirebaseAnalytics
- Inisialisasi objek dalam metode
onCreate()
:
firebaseAnalytics = Firebase.analytics
- Mulailah mencatat peristiwa dengan metode
logEvent()
. Kode berikut mencatat peristiwa PURCHASE saat pengguna membeli item di aplikasi:
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
param(FirebaseAnalytics.Param.VALUE, 10)
param(FirebaseAnalytics.Param.CURRENCY, "USE")
}
Menggunakan acara khusus
Jika Anda memerlukan peristiwa yang tidak dicakup oleh peristiwa yang disarankan, Anda dapat membuat log peristiwa khusus Anda sendiri dengan parameter khusus:
firebaseAnalytics.logEvent("delete_item"){
param("item name", name)
param("reason", text)
}
Men-debug acara
Anda dapat melihat data dan laporan gabungan tentang peristiwa Anda di konsol Firebase. Namun pembaruan berlangsung secara berkala sepanjang hari, Anda tidak dapat melihat peristiwa tersebut segera setelah Anda memasukkannya ke dalam aplikasi.
Untuk tujuan pengujian dan debugging langsung, Anda dapat menggunakan Firebase Debugview. DebugView memungkinkan Anda melihat data peristiwa yang dicatat oleh aplikasi Anda di perangkat pengembangan hampir secara real-time. Untuk DebugView, lihat bagian acara Debugging .
Sekarang Anda telah menyelesaikan pencatatan peristiwa ke aplikasi Android Anda!
Pada langkah berikutnya, Anda akan mempelajari cara mengimpor peristiwa tersebut ke Google Ads.
6. Impor peristiwa Firebase ke Google Ads
Penyiapan Firebase-Android Anda telah selesai, dan Anda siap meluncurkan kampanye aplikasi dengan mencatat peristiwa tindakan. Anda akan mulai 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.
Tautkan Firebase dan Google Ads
- Buka Pengaturan Firebase dengan mengklik tombol tepat di sebelah Ikhtisar Proyek.
- Di tab Integrasi, Anda akan melihat Google Ads dan tombol Tautkan. Klik Tautkan dan Lanjutkan.
- Pilih akun Google Ads yang ingin Anda tautkan.
Sekarang Anda telah selesai menautkan Firebase dan Google Ads. Mari impor peristiwa Firebase ke Google Ads.
Impor peristiwa Firebase
- Di konsol Firebase, buka menu Acara dan tandai acara yang ingin Anda impor sebagai konversi.
- Sekarang, Buka Google Ads dan masuk ke akun yang Anda tautkan dengan Firebase.
- Di Google Ads, buka Alat → Pengukuran → Konversi
- Klik tombol +
- Pilih Aplikasi → Properti Google Analytics 4 (Firebase) dan klik lanjutkan.
- Anda dapat melihat semua peristiwa analitik yang ditandai sebagai konversi. Temukan acara yang ingin Anda impor. Dalam hal ini pilih event
delete_item
yang telah kita implementasikan sebelumnya. Klik tombol Impor dan Lanjutkan. - Anda berhasil mengimpor peristiwa konversi dari Firebase.
Sekarang Anda telah selesai mengimpor peristiwa Firebase ke Google Ads.
Di langkah selanjutnya, Anda akan mempelajari cara meluncurkan kampanye tindakan dengan acara yang baru saja Anda impor.
7. Meluncurkan kampanye tindakan aplikasi dengan acara 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 Pemasangan Aplikasi. Di bagian bawah, pilih aplikasi yang ingin Anda promosikan dan klik lanjutkan.
- Di bagian Penawaran, jika Anda memilih Tindakan dalam aplikasi di menu tarik-turun, Anda dapat melihat peristiwa. Pilih acara yang ingin Anda fokuskan.
- Tetapkan pengaturan kampanye lainnya dan selesai.
8. Selamat
Selamat, Anda telah berhasil mengintegrasikan Firebase dan Google Ads! Ini akan membantu Anda meningkatkan kinerja kampanye Anda.
Anda telah belajar
- Cara Mengonfigurasi Firebase Analytics untuk Android
- Cara mencatat peristiwa dengan Firebase Analytics di aplikasi Android.
- Cara mengimpor acara dan menggunakannya untuk kampanye tindakan.