Google Ads dengan peristiwa kustom Google Analytics for Firebase - Unity

1. Pengantar

Terakhir Diperbarui: 19-02-2021

Yang akan Anda bangun

Dalam codelab ini, Anda akan mempelajari cara menerapkan peristiwa kustom dengan GA4F iOS di lingkungan Unity dan meluncurkan kampanye tindakan melalui Google Ads.

Sepanjang codelab ini, Anda dapat mengalami seluruh proses bisnis Aplikasi yang dihadapi klien kami. Jika Anda ingin mempelajari pengantar Firebase dan Admob yang lebih sederhana di iOS, mulailah dengan AdMob+Firebase 101 Unity: Dasar-Dasar Penyiapan &Analisis.

Yang akan Anda pelajari

• Cara melakukan inisialisasi GA4F (Google Analytics for Firebase) di Unity + iOS.
• Cara membuat parameter dan peristiwa custom.
• Cara mengimpor peristiwa dari Firebase ke Google Ads.
• Meluncurkan kampanye tindakan dengan peristiwa kustom.

Yang Anda butuhkan

• Xcode
• Unity
• Akun Firebase
• Akun Google Ads

2. Memulai project Unity baru

Buat aplikasi Unity dengan template sederhana. Anda akan memodifikasi aplikasi sederhana ini untuk membuat aplikasi yang sudah selesai.

Meluncurkan Unity

1. Jika Anda tidak memiliki project yang terbuka, pilih buat project baru.
2. Pilih template 3D dari dialog.
3. Isi Project Name: misalnya, Unity Firebase Custom Event.
4. Pilih Lokasi untuk menyimpan project Anda dan klik CREATE.
5. Unity akan membuka project baru Anda di jendela ruang kerja.

3. Membuat dan menyiapkan project Firebase

Untuk memulai Firebase, Anda harus membuat dan menyiapkan project Firebase.

Jika sudah memiliki project Firebase yang belum mengaktifkan Google Analytics, Anda dapat mengaktifkan Google Analytics dari tab Integrasi di setelan > Setelan project. Lanjutkan ke Langkah konfigurasi Firebase.

1. Login ke Firebase.

Di Firebase console, klik Tambahkan Project (atau Buat project), lalu beri nama project Firebase Anda Firebase-iOS-Ads

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 lebih lanjut project Firebase, lihat Memahami project Firebase.

4. Konfigurasi Unity

1. Di Unity > File > Build Settings. Nilai yang penting adalah menetapkan ID paket iOS, yang akan Anda dapatkan menggunakan langkah berikut.

Anda akan melihat dialog yang ditampilkan di layar berikut.

2. Di project Unity untuk aplikasi iOS, buka dialog Build Settings, File > Build Settings (Jika Platform tidak disetel ke iOS, Anda dapat memilih Platform iOS dan mengklik tombol Switch Platform)

3. Setelah perubahan platform, klik tombol Setelan Pemain untuk menetapkan ID paket. Anda dapat melihat kolom teks di sekitar area Identifikasi.
4. Nilai kolom Bundle Identifier (ID Paket) adalah ID paket iOS (seperti com.yourcompany.yourproject). Salin nilai ini atau tetapkan nilai Anda, lalu salin.
5. Di dialog Firebase, tempel ID paket yang disalin ke kolom iOS bundle ID.
6. Klik Daftarkan Aplikasi.
7. Melanjutkan di Firebase, ikuti petunjuk untuk mendownload file konfigurasi GoogleService-Info.plist
8. Buka jendela Project untuk project Unity Anda, lalu pindahkan file konfigurasi ke folder Assets.
9. Lewati langkah-langkah yang tersisa, lalu kembali ke halaman utama Firebase console.

5. Mengonfigurasi Firebase Analytics di Unity

Pada langkah ini, Anda akan mulai menambahkan Firebase SDK ke project Unity.

1. Buka Firebase console.
2. Di bagian tengah halaman ringkasan project, klik ikon Unity ( ) untuk meluncurkan alur kerja penyiapan. Jika Anda sudah menambahkan aplikasi ke project Firebase, klik Tambahkan aplikasi untuk menampilkan opsi platform.
3. Pilih target build project Unity yang ingin didaftarkan, atau Anda bahkan dapat memilih untuk mendaftarkan kedua target secara bersamaan.

Catatan: Jika hanya mendaftarkan satu target build project Unity sekarang, Anda dapat kembali ke alur kerja penyiapan kapan saja untuk mendaftarkan target build lainnya.

4. Masukkan ID khusus platform project Unity Anda.

• Untuk iOS — Masukkan ID iOS project Unity Anda di kolom iOS bundle ID.
• Untuk Android — Masukkan ID Android project Unity Anda di kolom Android package name. Istilah nama paket dan ID aplikasi sering kali digunakan secara bergantian.

5. Di mana lokasi ID project Unity Anda?

Catatan: Pastikan Anda memasukkan ID yang benar-benar digunakan project Anda. Nilai ID peka huruf besar/kecil dan tidak dapat diubah untuk aplikasi Firebase ini setelah didaftarkan ke project Firebase Anda.

6. (Opsional) Masukkan nama panggilan khusus platform project Unity Anda. Nama panggilan ini adalah ID internal praktis yang hanya terlihat oleh Anda di Firebase console.
7. Klik Daftarkan aplikasi.

Menambahkan Firebase Analytics Unity SDK

1. Di Firebase console, klik Download Firebase Unity SDK, lalu ekstrak SDK di tempat yang mudah diakses.

• Anda dapat mendownload Firebase Unity SDK lagi kapan saja.
• Firebase Unity SDK tidak dikhususkan untuk platform tertentu.

2. Pada project Unity yang terbuka, buka Assets > Import Package > Custom Package.
3. Dari SDK yang telah diekstrak, pilih produk Firebase yang didukung yang ingin digunakan dalam aplikasi Anda.

• Menambahkan paket Firebase untuk Google Analytics: FirebaseAnalytics.unitypackage
• Tambahkan paket untuk produk Firebase lainnya yang ingin digunakan di aplikasi Anda. Misalnya, untuk menggunakan Firebase Authentication dan Firebase Realtime Database: FirebaseAuth.unitypackage dan FirebaseDatabase.unitypackage

Unity 5.x dan versi sebelumnya menggunakan framework .NET 3.x, jadi impor paket dotnet3/. Unity 2017.x dan versi setelahnya mendukung penggunaan framework .NET 4.x. Jika project Unity Anda menggunakan .NET 4.x, impor paket dotnet4/. Unity 2019 dan yang lebih baru tidak lagi mendukung framework .NET 3.x, jadi impor paket dotnet4/.

4. Di jendela Import Unity Package, klik Import.
5. Kembali ke Firebase console, di alur kerja penyiapan, klik Next.

Penting: Saat menggunakan Firebase Unity SDK untuk iOS, jangan nonaktifkan method swizzling. Swizzling diperlukan oleh SDK. Jika dinonaktifkan, fitur-fitur penting Firebase (seperti penanganan token FCM) tidak akan berfungsi dengan benar.

6. Mencatat Log Peristiwa Kustom dengan Firebase Analytics

Pada langkah ini, Anda akan mempelajari cara mencatat peristiwa kustom ke dalam log dengan Firebase Analytics di aplikasi Unity untuk iOS.

Firebase Analytics akan otomatis mencatat beberapa peristiwa ke dalam log untuk Anda. Anda tidak perlu menambahkan kode apa pun untuk menerimanya. Jika aplikasi Anda perlu mengumpulkan data tambahan, Anda dapat mencatat hingga 500 jenis Peristiwa Kustom Analytics yang berbeda ke dalam log di aplikasi.

Log peristiwa

Setelah mengonfigurasi instance FirebaseApp, Anda dapat mulai mencatat peristiwa ke dalam log dengan metode logEvent().

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

Melihat peristiwa dalam konsol debug Xcode

Anda dapat mengaktifkan logging panjang untuk memantau pencatatan peristiwa oleh SDK guna membantu memastikan bahwa peristiwa dicatat dengan benar. Hal ini mencakup pencatatan peristiwa baik secara otomatis maupun manual.

Anda dapat mengaktifkan logging panjang sebagai berikut:

1. Di Xcode, pilih Product > Scheme > Edit scheme...
2. Pilih Run dari menu kiri.
3. Pilih tab Arguments.
4. Di bagian Arguments Passed On Launch, tambahkan -FIRAnalyticsDebugEnabled.

Saat Anda menjalankan aplikasi kembali, peristiwa akan ditampilkan di konsol debug Xcode, sehingga Anda dapat segera memastikan bahwa peristiwa memang benar dikirim.

Melihat peristiwa di dasbor

Anda akan melihat peristiwa yang dicatat ke dalam log di Firebase console dalam beberapa jam. ID tersebut ada di Analytics → Peristiwa. Anda juga dapat menemukan nilai parameter dengan mengklik peristiwa.

Anda akan menandai 'text_search' sebagai konversi dengan menggeser tombol 'tandai sebagai konversi' ke kanan.

Anda dapat memeriksa ulang apakah peristiwa berhasil ditandai sebagai konversi melalui tab Konversi Firebase Analytics. Dengan menandai peristiwa sebagai konversi, Google Ads juga dapat mengimpor peristiwa tersebut sebagai konversi.

7. Mengimpor peristiwa analisis di Google Ads

Penyiapan Firebase-iOS Anda sudah selesai, dan Anda siap meluncurkan kampanye Aplikasi dengan peristiwa tindakan yang dicatat dalam log. 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.

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.

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

Sekarang, bagian Firebase sudah selesai.

Sekarang, Buka Google Ads dan Login.

1. Buka Google Ads dan login, lalu buka Alat &Setelan → Pengukuran → Konversi untuk mengimpor peristiwa kustom sebagai konversi.
2. Klik tombol + untuk menambahkan tindakan konversi baru.

3. Pilih properti Google Analytics 4 (Firebase) dan klik lanjutkan.

4. Anda dapat melihat semua peristiwa analisis yang ditandai sebagai konversi. Temukan peristiwa clicked_counter yang kita terapkan sebelumnya.

5. Periksa dan klik tombol Impor dan Lanjutkan.

Setelah menetapkan text_search sebagai tindakan konversi, sekarang saatnya meluncurkan kampanye yang menargetkan pengguna yang kemungkinan akan memicu peristiwa text_search.

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

6. Buka tab kampanye di akun Anda sekarang, dan mulai kampanye baru dengan mengklik tombol +. Klik kampanye baru dan lanjutkan.
7. Untuk kali ini, kami akan meluncurkan kampanye Promosi aplikasi dengan opsi Penginstalan Aplikasi.

8. Temukan aplikasi Anda dengan memberikan nama aplikasi, nama paket, atau penayang.
9. Di bagian Bidding, pilih Tindakan dalam aplikasi di dropbox untuk Google Ads agar berfokus pada tindakan.
10. Anda dapat menemukan peristiwa kustom di daftar yang disediakan. Tetapkan Target biaya per tindakan, dan isi juga opsi lainnya.

11. Konfigurasikan setelan kampanye. Hal ini akan berada di luar cakupan codelab, jadi lihat dokumen ini atau hubungi melalui saluran lain untuk mengoptimalkan setelan.

9. Selamat

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

Anda telah mempelajari

• Cara Mengonfigurasi Firebase untuk platform iOS Unity
• Cara mencatat peristiwa kustom ke dalam log dengan Unity dan Firebase Analytics
• Cara mengimpor peristiwa dan menggunakannya untuk kampanye tindakan.

Dokumen referensi

• Menambahkan Firebase ke project Unity
• GitHub: firebase/quickstart-unity