Memulai Peristiwa Aplikasi (iOS)

Panduan ini menunjukkan cara menambahkan Peristiwa Aplikasi ke aplikasi baru Anda atau yang sudah ada dengan mengintegrasikan Facebook SDK lalu mencatat peristiwa-peristiwa ini.

Sebelum Memulai

Anda akan memerlukan:

• Akun Developer Facebook
• Akun Iklan Facebook
• Akun Bisnis Facebook(buat akun bisnis baru jika Anda belum memilikinya)
• Aplikasi Facebook

Langkah 1: Konfigurasikan Aplikasi Facebook Anda

Buka Dasbor Aplikasi, klik Aplikasi Saya, dan buat aplikasi baru jika belum punya. Buka Pengaturan > Dasar untuk melihat Panel Detail Aplikasi dengan ID Aplikasi Anda, Rahasia Aplikasi Anda, dan detail lainnya tentang aplikasi Anda.

Gulir turun ke bawah halaman dan klik Tambahkan Platform. Pilih iOS, tambahkan detail aplikasi Anda, dan simpan perubahan Anda.

Siapkan aplikasi Anda untuk beriklan dengan menambahkan detail berikut:

• Domain Aplikasi - Sediakan URL Apple App Store aplikasi Anda.
• URL Kebijakan Privasi - Sediakan URL Kebijakan Privasi. Diperlukan untuk menjadikan aplikasi Anda publik.
• URL Ketentuan Layanan - Sediakan URL Ketentuan Layanan.
• Platform - Gulir ke bagian terbawah panel Pengaturan untuk menambahkan Platform iOS.

Untuk mempelajari lebih lanjut tentang menambahkan detail ke aplikasi Anda, seperti ikon atau kategori, kunjungi dokumen Pengembangan Aplikasi.

Langkah 2: Tautkan Akun Iklan dan Bisnis Anda

Untuk menjalankan iklan dan mengukur penginstalan di Pengelola Iklan, hubungkan setidaknya satu Akun Iklan dan Akun Bisnis dengan Aplikasi Anda.

1. Di Dasbor Aplikasi klik Pengaturan > Lanjutan.
2. Di ID Akun Iklan Resmi, tambahkan ID Akun Iklan Anda. Anda dapat memperoleh ID akun iklan Anda dari Pengelola Iklan.
3. Di Panel Akun Iklan, klik Mulai dan ikuti petunjuk untuk menghubungkan aplikasi ke Bisnis.

Langkah 3: Siapkan Lingkungan Pengembangan Anda

Prosedur berikut menggunakan Swift Package Manager untuk menyiapkan lingkungan pengembangan Anda di Xcode.

1. Di Xcode, klik File > Add Packages....
2. Di kolom pencarian yang muncul, masukkan URL repositori: https://github.com/facebook/facebook-ios-sdk.
3. Di Dependency Rule, pilih Up to Next Major Version dan masukkan versi terbaru. Rilis paling terkini terdaftar di https://github.com/facebook/facebook-ios-sdk/releases/
4. Pilih pustaka yang ingin Anda gunakan dan target yang ingin Anda tambahi pustaka tersebut.
5. Klik Add Package untuk menyelesaikan pengaturan Anda.

Langkah 4: Daftarkan dan Konfigurasikan Aplikasi Anda dengan Facebook

Tambahkan Pengidentifikasi Bundel Anda dan aktifkan Single Sign-On (SSO) untuk aplikasi Anda.

Langkah 5: Konfigurasikan Proyek Anda

Langkah 6: Hubungkan AppDelegate dan SceneDelegate

    
// AppDelegate.swift
import UIKit
import FacebookCore

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {          
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )

        return true
    }
          
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {
        ApplicationDelegate.shared.application(
            app,
            open: url,
            sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
            annotation: options[UIApplication.OpenURLOptionsKey.annotation]
        )
    }  
}

// SceneDelegate.swift
import FacebookCore
  ...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }

    ApplicationDelegate.shared.application(
        UIApplication.shared,
        open: url,
        sourceApplication: nil,
        annotation: [UIApplication.OpenURLOptionsKey.annotation]
    )
}

Langkah 7: Tambahkan Peristiwa Aplikasi

Ada tiga cara peristiwa dilacak di aplikasi Anda:

• Peristiwa yang Dicatat Secara Otomatis - Penginstalan aplikasi, peluncuran, dan pembelian dalam-aplikasi secara otomatis dicatat dengan Facebook SDK.
• Fitur Peristiwa Aplikasi Tanpa Kode - Gunakan fitur ini untuk menambahkan Peristiwa Standar tanpa menambahkan kode ke aplikasi Anda.
• Peristiwa yang Dicatat Secara Manual - Tambahkan kode ke aplikasi Anda untuk melacak Peristiwa Standar dan Khusus.

Peristiwa yang Dicatat Secara Otomatis

Mendapatkan Persetujuan Perangkat

Mulai iOS 14.5, Anda akan perlu mengatur isAdvertiserTrackingEnabled dan mencatat setiap kali Anda memberi perangkat izin untuk membagikan data dengan Facebook.

Jika perangkat memberikan persetujuan, atur Settings.shared.isAdvertiserTrackingEnabled = true.

Jika perangkat tidak mengizinkan pelacakan, atur Settings.shared.isAdvertiserTrackingEnabled = false.

<key>FacebookAutoLogAppEventsEnabled</key>
<false/>

<key>FacebookAdvertiserIDCollectionEnabled</key>
<false/>

Mencatat Peristiwa Secara Manual

Untuk mencatat peristiwa khusus, teruskan nama peristiwa sebagai AppEvents.Name:

AppEvents.shared.logEvent(AppEvents.Name("battledAnOrc"))

Parameter Peristiwa

Facebook telah membuat satu set parameter peristiwa berguna untuk disertakan dengan peristiwa standar atau dengan peristiwa khusus Anda sendiri. Anda juga dapat menyediakan parameter Anda sendiri.

Parameter yang sudah ditentukan ini dimaksudkan untuk memberikan panduan tentang pola pencatatan umum, dan mungkin memiliki bentuk yang lebih mudah dibaca dalam pelaporan dan UI lainnya. Catat set parameter yang Anda minati untuk melihat perinciannya. Rekomendasi deskripsi untuk parameter tersebut hanyalah panduan semata - Anda dapat menggunakan parameter tersebut untuk apa pun yang masuk akal untuk aplikasi Anda.

Parameter diteruskan melalui kamus tempat kode memegang nama parameter sebagai AppEvents.ParameterName, dan nilainya harus String atau angka (Int, Double, dsb.).

Langkah 8: Uji Peristiwa Anda

Dengan Bantuan Iklan Aplikasi, Anda dapat menguji peristiwa aplikasi Anda demi memastikan bahwa aplikasi Anda mengirimkan peristiwa ke Facebook.

1. Buka Bantuan Iklan Aplikasi.
2. Di Pilih Aplikasi, pilih aplikasi Anda dan pilih Kirim.
3. Gulir ke bawah dan pilih Uji Peristiwa.
4. Mulailah aplikasi Anda dan kirim peristiwa. Peristiwa seharusnya muncul di halaman.

Pelajari Selengkapnya

• Panduan Praktik Terbaik - Lihat beragam contoh aplikasi dan bagaimana tiap aplikasi itu menangani Peristiwa Aplikasi.
• Pertanyaan Umum - Lihat Pertanyaan Umum kami.
• Kursus Meta Blueprint: Mengonfigurasi SDK dan Peristiwa Aplikasi untuk iOS
• Kursus Meta Blueprint: Menggunakan Peristiwa Aplikasi untuk Menargetkan, Mengoptimalkan, dan Mengukur

Contoh Aplikasi

Kami sudah membuat beberapa contoh untuk berbagai jenis aplikasi agar Anda lebih mudah memahami cara melihat peristiwa aplikasi. Masing-masing contoh aplikasi menyediakan perincian layar demi layar dari berbagai peristiwa dan parameter yang dapat dikumpulkan. Di akhir setiap bagian, terdapat tabel yang berisi daftar rekomendasi peristiwa dan parameter yang untuk setiap aplikasi. Dan, jika perlu, Anda dapat membuat peristiwa dan parameter Anda sendiri.