Google Ads dengan Peristiwa kustom Google Analytics for Firebase - iOS

1. Pengantar

Terakhir Diperbarui: 14-12-2020

Yang akan Anda bangun

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

Melalui codelab ini, Anda dapat merasakan seluruh proses bisnis Aplikasi yang dihadapi klien kami. Jika Anda ingin mempelajari pengantar yang lebih mudah tentang Firebase iOS, mulailah dengan Firebase iOS Codelab Swift

Yang akan Anda pelajari

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

Yang Anda butuhkan

• Xcode
• Akun Firebase
• Akun Google Ads

2. Mulai project iOS Swift baru

Buat aplikasi iOS Swift dengan template sederhana. Anda akan memodifikasi aplikasi awal ini untuk membuat aplikasi yang sudah selesai.

Pertama, Luncurkan Xcode.

1. Jika Anda tidak memiliki project yang terbuka, pilih Create a new Xcode project dari halaman sambutan.
2. Pilih iOS di bagian atas dialog.
3. Di bagian Aplikasi, pilih Aplikasi, lalu klik Berikutnya.
4. Pada dialog yang muncul, gunakan nilai berikut untuk memberi nama aplikasi dan memilih opsi tambahan untuk project Anda, lalu klik Next :
5. Nama Produk: misalnya ios-app

Xcode menggunakan nama produk yang Anda masukkan untuk memberi nama project dan aplikasi Anda.

2. Tim: Jika tidak diisi secara otomatis, tetapkan tim ke Tidak Ada.
3. Nama Organisasi: Nama organisasi Anda atau nama Anda sendiri.
4. ID Paket: Nilai ini otomatis dibuat berdasarkan nama produk dan ID organisasi Anda.
5. Bahasa: Swift
6. Pilih lokasi untuk menyimpan project Anda, lalu klik Buat.
7. Xcode 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.

Membuat project Firebase

Jika Anda sudah memiliki project Firebase yang belum mengaktifkan Google Analytics, Anda dapat mengaktifkan Google Analytics dari tab Integrasi di bagian 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 membutuhkan peristiwa Google Analytics untuk melacak peristiwa tindakan dan konversi.

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

4. Konfigurasi Firebase

1. Di Firebase Console, Pilih Ringkasan Project > Setelan Project di panel navigasi sebelah kiri, lalu klik tombol iOS di bagian Umum > Aplikasi Anda

Anda akan melihat dialog yang ditampilkan di layar berikut.

2. Nilai penting yang harus diberikan adalah ID paket iOS, yang akan Anda dapatkan mengikuti langkah berikut.
3. Di project Xcode untuk aplikasi iOS, pilih aplikasi level teratas di navigator project, lalu pilih tab General.
4. Nilai kolom ID Paket adalah ID paket iOS (misalnya com.yourcompany.yourproject). Salin nilai ini.
5. Di dialog Firebase, tempelkan ID paket yang disalin ke kolom iOS bundle ID.
6. Klik Daftarkan Aplikasi.
7. Lanjutkan di Firebase, lalu ikuti petunjuk untuk mendownload file konfigurasi GoogleService-Info.plist.

8. Buka Project Xcode Anda, lalu pindahkan file GoogleService-Info.plist (yang baru saja Anda download) ke root project Xcode Anda.
9. Lewati langkah-langkah yang tersisa, lalu kembali ke halaman utama Firebase console.

5. Mengonfigurasi Firebase Analytics di Xcode

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

Catatan: Layanan Google menggunakan CocoaPods untuk menginstal dan mengelola dependensi. Jika belum pernah menggunakan CocoaPods, Anda harus menginstalnya terlebih dahulu dengan menjalankan perintah ini di terminal:

$ sudo gem install cocoapods

1. Buka jendela terminal dan buka lokasi project Xcode untuk aplikasi Anda.
2. Buat Podfile jika Anda belum memilikinya:

$ pod init

3. Buka Podfile Anda dan tambahkan :

$ vi Podfile

$ pod 'Firebase/Analytics'

4. Simpan file dan jalankan :

$ pod install

5. Tambahkan kode inisialisasi :

Untuk menghubungkan Firebase saat aplikasi dimulai, tambahkan kode inisialisasi di bawah ke class AppDelegate utama Anda.

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

6. Anda sudah siap! Lanjutkan ke konsol.

Sekarang Anda sudah siap untuk mengaktifkan beberapa log peristiwa kustom.

6. Mencatat Peristiwa Kustom dengan Firebase Analytics

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

Firebase Analytics 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 tersebut.

Peristiwa log

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

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

Menetapkan parameter peristiwa default

Anda dapat mencatat parameter untuk semua peristiwa ke dalam log menggunakan setDefaultEventParameters. Parameter default dikaitkan dengan semua peristiwa mendatang yang dicatat.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Melihat peristiwa di 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. Lokasinya 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 akan 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 ke dalam log. Anda akan memulai dengan menautkan Firebase ke Google Ads. Dengan menautkan Firebase ke Google Ads, kampanye Aplikasi akan dapat mempelajari lebih lanjut audiens 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, lalu Login.

1. Buka Google Ads, 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 mengaktifkan 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 Anda belum siap memublikasikan aplikasi, lewati langkah ini untuk sekarang.

6. Buka tab kampanye di akun Anda sekarang, dan mulai kampanye baru dengan mengklik tombol +. Klik kampanye baru, lalu 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 kotak drop untuk Ads agar berfokus pada tindakan.
10. Anda dapat menemukan peristiwa kustom Anda di daftar yang diberikan. Tetapkan Target biaya per tindakan, dan isi juga opsi lainnya.

11. Konfigurasi setelan kampanye. Hal ini 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 dan Google Ads Anda. Tindakan ini akan membantu Anda meningkatkan performa kampanye.

Anda telah menginstal skrip, membuat dan menyiapkan daftar perubahan codelab baru, memperbarui dan menyiapkan daftar perubahan codelab yang tertunda, meninjau dan menyetujui daftar perubahan codelab, serta mengirim dan memublikasikan daftar perubahan codelab.

Anda telah mempelajari

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