Google Ads dengan Peristiwa kustom Google Analytics for Firebase - Android

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 untuk menerapkan peristiwa dengan GA4F dan mengimpor peristiwa di Google Ads. Jika Anda ingin mempelajari cara membangun aplikasi Android dengan Firebase, lihat Firebase Android Codelab-Build Friendly Chat.

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

1. Login ke Firebase.

Di Firebase console, klik Add Project(atau Create a project), lalu beri nama project Firebase sesuai keinginan Anda.

2. 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 dan konversi tindakan.

Untuk mempelajari project Firebase lebih lanjut, lihat artikel Memahami project Firebase.

3. Pilih akun Google Analytics. Jika Anda sudah memiliki akun, pilih akun tersebut atau buat yang baru. Klik tombol Buat project.

4. Sekarang build project Firebase telah selesai.

Di langkah berikutnya, Anda akan mempelajari cara menambahkan Firebase ke aplikasi Android.

3. Tambahkan Firebase ke aplikasi Android

Daftarkan aplikasi

1. Di Firebase Console, Pilih Ringkasan Project di navigasi sebelah kiri, lalu klik tombol Android di bagian "Mulai dengan menambahkan Firebase ke aplikasi Anda"

2. Isi informasi yang diperlukan.

Untuk nama paket Android, di Android Studio, buka direktori aplikasi, lalu buka nama file build.gradle. Dalam file tersebut, telusuri applicationId. Nilai ini adalah nama paket Android. Salin nilai ini dan tempelkan.

Kita tidak memerlukan kunci SHA-1 di sini, kecuali jika Anda berencana menggunakan Login dengan Google atau Firebase Dynamic Links (Perhatikan bahwa ini bukan bagian dari codelab ini, untuk informasi selengkapnya tentang kunci SHA-1, lihat dokumen ini.).

Tips: Baca Menetapkan ID aplikasi untuk mengetahui informasi selengkapnya tentang ID paket dan aplikasi.

3. Klik tombol Register App.

Download file konfigurasi

1. Klik tombol Download google-services.json untuk mendownload file konfigurasi google-services.json.

2. Di Android Studio, buka direktori app dan pindahkan file google-services.json (yang baru saja Anda download di atas) ke direktori app. Kembali ke Firebase console, klik tombol Next.

Mengaktifkan Firebase di aplikasi

1. Anda memerlukan plugin Gradle Layanan Google untuk membaca file google-services.json yang dihasilkan oleh Firebase.
2. 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
      ...
      }
   }
}

3. 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'

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.

Kami 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.

1. 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 dapat dilihat, dengan menentukan versi BoM, Anda tidak perlu menentukan versi library analisis Firebase. Namun, jika ingin menggunakan versi yang diinginkan untuk library Firebase, apa pun versi yang ditetapkan dalam 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'

2. Sekarang sinkronkan aplikasi Anda dengan mengklik tombol Sync Now.

Anda sudah selesai menambahkan Firebase SDK untuk Google Analytics ke aplikasi Android Anda.

Di langkah berikutnya, Anda akan mempelajari cara mencatat peristiwa Firebase ke dalam log di aplikasi Android.

5. Mencatat peristiwa ke dalam log dengan Firebase Analytics

Di 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 direkomendasikan

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. Dengan parameter tersebut, Anda dapat memaksimalkan detail yang tersedia dalam laporan Firebase. ( Referensi peristiwa yang disarankan)

1. Deklarasikan objek FirebaseAnalytics di bagian atas aktivitas:

private lateinit var firebaseAnalytics: FirebaseAnalytics

2. Inisialisasi objek dalam metode onCreate():

firebaseAnalytics = Firebase.analytics

3. 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 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, update berlangsung secara berkala sepanjang hari. Anda tidak dapat langsung melihat peristiwa tersebut setelah login ke aplikasi.

Untuk tujuan pengujian dan proses debug langsung, Anda dapat menggunakan Firebase Debugview. DebugView memungkinkan Anda melihat data peristiwa yang dicatat ke dalam log oleh aplikasi Anda di perangkat pengembangan hampir secara real-time. Untuk DebugView, lihat bagian Peristiwa proses debug.

Sekarang Anda telah selesai mencatat peristiwa ke dalam log 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 ke dalam log. Anda akan memulai dengan menautkan Firebase ke Google Ads. Dengan menautkan Firebase ke Google Ads, kampanye Aplikasi dapat mempelajari audiens lebih lanjut dan meningkatkan pembelajaran kampanye Aplikasi, yang biasanya menghasilkan performa dan konversi yang lebih baik.

Menautkan Firebase dan Google Ads

1. Buka Setelan Firebase dengan mengklik tombol di samping Ringkasan Project.

2. Di tab Integrasi, Anda akan melihat Google Ads dan tombol Tautkan. Klik Tautkan dan Lanjutkan.

3. Pilih akun Google Ads yang ingin ditautkan.

Sekarang Anda telah selesai menautkan Firebase dan Google Ads. Mari impor peristiwa Firebase ke Google Ads.

Mengimpor peristiwa Firebase

1. Di Firebase console, buka menu Events dan tandai peristiwa yang ingin Anda impor sebagai konversi.

Perhatian: Jika peristiwa target tidak ditandai sebagai konversi, Google Ads tidak akan dapat mengimpornya. Pastikan peristiwa ditandai sebagai konversi dengan benar.

2. Sekarang, buka Google Ads dan login ke akun yang Anda tautkan dengan Firebase.
3. Di Google Ads, buka Alat → Pengukuran → Konversi
4. Klik tombol +
5. Pilih properti App → Google Analytics 4 (Firebase) dan klik lanjutkan.
6. Anda dapat melihat semua peristiwa analisis yang ditandai sebagai konversi. Cari peristiwa yang ingin Anda impor. Dalam hal ini, pilih peristiwa delete_item yang telah kita terapkan sebelumnya. Klik tombol Impor dan Lanjutkan.
7. 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

Penting: Untuk meluncurkan kampanye aplikasi, Anda memerlukan aplikasi level produksi di Google Play. Jika belum siap untuk memublikasikan aplikasi, biarkan langkah ini untuk saat ini.

1. Buka tab Kampanye aplikasi di akun Google Ads Anda saat ini, dan mulai kampanye baru dengan mengklik tombol +.

2. Kami akan meluncurkan kampanye promosi Aplikasi dengan opsi Penginstalan Aplikasi. Di bagian bawah, pilih aplikasi yang ingin dipromosikan, lalu klik lanjutkan.
3. Di bagian Bidding, jika memilih Tindakan dalam aplikasi di menu dropdown, Anda dapat melihat peristiwa. Pilih peristiwa yang ingin Anda fokuskan.

4. Tetapkan setelan kampanye lainnya dan selesai.

8. Selamat

Selamat, Anda telah berhasil mengintegrasikan Firebase dan Google Ads. Hal ini akan membantu meningkatkan performa kampanye Anda.

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.