Memulai Peristiwa Aplikasi (Android)

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

Sebelum Memulai

Anda memerlukan:

• Akun Developer Meta
• ID Aplikasi Meta
• Akun Iklan yang tertaut ke aplikasi Anda
• Implementasi Facebook SDK untuk Android

Menambahkan Peristiwa Aplikasi

Ada tiga cara pelacakan peristiwa di aplikasi Anda:

• Peristiwa yang Dicatat Secara Otomatis - Instalasi 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.

Pencatatan Peristiwa Secara Otomatis

Saat Anda menggunakan Facebook SDK, beberapa peristiwa di dalam aplikasi Anda secara otomatis akan dicatat dan dikumpulkan untuk Facebook Analytics, kecuali jika Anda menonaktifkan pencatatan peristiwa otomatis. Peristiwa ini relevan untuk semua kasus penggunaan - penargetan, pengukuran, dan pengoptimalan. Ada tiga peristiwa penting yang dikumpulkan sebagai bagian dari Pencatatan Peristiwa Aplikasi Otomatis: Penginstalan Aplikasi, Peluncuran Aplikasi, dan Pembelian. Saat pencatatan otomatis diaktifkan, pengiklan dapat menonaktifkan peristiwa ini, serta peristiwa internal Facebook lainnya seperti peristiwa tayangan login. Namun, jika Anda telah menonaktifkan pencatatan otomatis, tetapi masih ingin mencatat peristiwa tertentu, seperti peristiwa instalasi atau pembelian, terapkan pencatatan secara manual untuk peristiwa-peristiwa ini di aplikasi Anda.

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
           android:value="false"/>
  ...
</application>

setAutoLogAppEventsEnabled(true);

setAutoLogAppEventsEnabled(false);

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AutoInitEnabled"
           android:value="false"/>
  ...
</application>

FacebookSdk.setAutoInitEnabled(true)
FacebookSdk.fullyInitialize()

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AdvertiserIDCollectionEnabled"
           android:value="false"/>
  ...
</application>

setAdvertiserIDCollectionEnabled(true);

setAdvertiserIDCollectionEnabled(false);

AppEventsLogger logger = AppEventsLogger.newLogger(this);

logger.logEvent(AppEventsConstants.EVENT_NAME_X);

Bundle params = new Bundle();
params.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT, "[{\"id\": \"1234\", \"quantity\": 2}, {\"id\": \"5678\", \"quantity\": 1}]");

logger.logEvent(AppEventsConstants.EVENT_NAME_PURCHASE,
                54.23,
                params);
Bundle params = new Bundle();
params.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "HDFU-8452");

logger.logEvent(AppEventsConstants.EVENT_NAME_ADDED_TO_CART,
                54.23,
                params);

Untuk mencatat peristiwa khusus, cukup berikan nama peristiwa sebagai string. Fungsi ini berasumsi bahwa pencatat adalah instance dari AppEventsLogger dan telah dibuat menggunakan panggilan AppEventsLogger.newLogger().

public void logBattleTheMonsterEvent () {
    logger.logEvent("BattleTheMonster");
}

Parameter Peristiwa

Setiap peristiwa tersebut dapat dicatat dengan valueToSum dan set parameter hingga 25 parameter. Parameter diteruskan melalui Bundle dengan kunci berisi nama parameter dan nilai String atau int. Jika Anda memberikan jenis nilai lainnya yang tidak sesuai, seperti boolean, maka SDK akan mencatat peringatan ke LogginBehavior.APP_EVENT.

Baca Panduan Referensi Parameter Peristiwa Standar untuk parameter yang biasanya digunakan dengan peristiwa standar. Parameter ini dimaksudkan untuk memberikan panduan, tetapi Anda juga dapat memberikan parameter Anda sendiri.

Jika Anda ingin menggunakan peristiwa aplikasi untuk mengukur konversi Iklan Dinamis, harap tetapkan parameter fb_content_id menjadi nilai ID Produk yang digunakan dalam Iklan Dinamis terkait.

Jangan gunakan "peristiwa" sebagai nama parameter. Parameter khusus dengan nama "event" tidak akan dicatat. Gunakan nama lain atau tambahkan awalan atau akhiran ke nama, seperti my_custom_event.

Menguji Pencatatan Peristiwa Anda

Bantuan Iklan Aplikasi memungkinkan Anda menguji peristiwa aplikasi di aplikasi Anda untuk memastikan bahwa aplikasi Anda mengirimkan peristiwa ke Facebook.

1. Buka Bantuan Iklan Aplikasi.
2. Di Pilih Aplikasi, pilih aplikasi Anda dan pilih Kirim.
3. Telusuri ke bawah dan pilih Uji Peristiwa Aplikasi.
4. Mulai aplikasi Anda lalu kirim peristiwa. Peristiwa tersebut akan muncul di halaman web.

Mengaktifkan Catatan Debug

Aktifkan catatan debug untuk memverifikasi penggunaan Peristiwa Aplikasi dari sisi klien. Catatan debug berisi permintaan mendetail dan tanggapan JSON. Aktifkan catatan debug dengan menambahkan kode berikut setelah menginisialisasi Facebook SDK untuk Android:

FacebookSdk.setIsDebugEnabled(true);
FacebookSdk.addLoggingBehavior(LoggingBehavior.APP_EVENTS);

Ini hanya untuk tujuan debugging. Harap nonaktifkan catatan debug sebelum menerapkan aplikasi Anda ke publik.

Pelajari Selengkapnya

Untuk informasi selengkapnya dan petunjuk bermanfaat tentang Peristiwa Aplikasi, lihat:

• Dokumentasi Referensi Facebook SDK untuk Android
• Panduan Praktik Terbaik - Lihat beragam contoh aplikasi dan bagaimana tiap aplikasi itu menangani Peristiwa Aplikasi.
• Pertanyaan Umum - Lihat Pertanyaan Umum kami
• Pengelola Iklan – Lihat informasi tentang iklan Anda.
• Pengelola Peristiwa – Lihat informasi tentang peristiwa yang Anda lacak.
• Kursus Meta Blueprint: Mengonfigurasikan SDK dan Peristiwa Aplikasi untuk Android
• Kursus Meta Blueprint: Gunakan Peristiwa Aplikasi untuk Menargetkan, Mengoptimalkan, dan Mengukur

Contoh Aplikasi

Kami sudah membuat beberapa contoh untuk berbagai jenis aplikasi guna menunjukkan cara menggunakan peristiwa aplikasi. Tiap contoh aplikasi menyediakan perincian layar demi layar dari berbagai peristiwa dengan contoh kodenya. Penting untuk dicatat bahwa contoh-contoh ini adalah titik awal untuk aplikasi Anda dan harus Anda sesuaikan.