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 mengalami seluruh proses bisnis Aplikasi yang dihadapi klien kami. Jika Anda ingin mempelajari pengantar Firebase iOS yang lebih sederhana, 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. Memulai 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 selamat datang.
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 proyek Anda, dan klik Next :
5. Nama Produk: misalnya ios-app

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

2. Tim: Jika ini 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, lalu klik Buat.
7. Xcode akan membuka project baru Anda di jendela workspace.

3. Membuat dan menyiapkan project Firebase

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

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

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

4. Konfigurasi Firebase

1. Di Firebase Console, Pilih Project Overview > Project Settings di panel navigasi sebelah kiri, lalu klik tombol iOS di bagian General > Your apps

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 Bundle Identifier (ID Paket) adalah ID paket iOS (seperti com.yourcompany.yourproject). Salin nilai ini.
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 Project Xcode Anda, lalu pindahkan file GoogleService-Info.plist (yang baru saja Anda download) ke root project Xcode Anda.
9. Lewati langkah yang tersisa dan kembali ke halaman utama Firebase console.

5. Mengonfigurasi Firebase Analytics di Xcode

Di 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 arahkan ke 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 ketika aplikasi dimulai, tambahkan kode inisialisasi di bawah ini ke kelas Tailwind utama.

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 Log Peristiwa Kustom dengan Firebase Analytics

Pada langkah ini, Anda akan mempelajari cara mencatat 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.

Log peristiwa

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

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. Centang 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 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, kita 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 agar Google Ads 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 dan Google Ads Anda. Hal ini akan membantu Anda meningkatkan performa kampanye.

Anda telah menginstal skrip, membuat dan melakukan staging daftar perubahan codelab baru, memperbarui dan melakukan staging daftar perubahan codelab yang tertunda, meninjau dan menyetujui daftar perubahan codelab, serta mengirimkan dan memublikasikan daftar perubahan codelab.

Anda telah mempelajari

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