Game di Facebook

    Peristiwa Aplikasi untuk Game di Facebook

    Facebook SDK (JS) App Events API ini telah dihentikan dan tidak didukung lagi sejak tanggal 1 Juli 2022. Tidak ada rencana untuk menambahkan fitur baru ke produk ini. Daripada menggunakan FB.AppEvents.LogEvent, Anda disarankan mengirim peristiwa ini melalui Meta Pixel.

    Peristiwa aplikasi memungkinkan Anda untuk mengukur kinerja iklan dan membangun pemirsa untuk penargetan iklan bagi Game Anda di Facebook.

    Ini dilakukan dengan mengirim peristiwa dari aplikasi Anda melalui Facebook SDK untuk JavaScript. Peristiwa ini bisa berupa satu dari peristiwa yang sudah ditentukan seperti "ditambahkan ke keranjang belanja" dalam aplikasi perdagangan atau "level dicapai" dalam game, atau peristiwa khusus lainnya.

    Prasyarat

    Sebelum memasukkan kode untuk mengukur peristiwa, Anda harus mendaftarkan aplikasi Anda dengan Facebook. Jika Anda belum mendaftarkan aplikasi Anda dengan Facebook, Anda dapat melakukannya di sini: Mulai Cepat Game di Facebook.

    Penerapan

    Game Anda di Facebook seharusnya sudah mencakup Facebook SDK untuk JavaScript. Jika tidak, baca panduan mulai cepat JavaScript kami.

    Anda dapat melihat peristiwa yang dicatat menggunakan Pengelola Peristiwa Facebook.

    Pencatatan Peristiwa Otomatis

    Kami secara otomatis mencatat peristiwa berikut untuk Game di Facebook:

    • Penginstalan Aplikasi: Pertama kali seseorang menerima persyaratan layanan untuk aplikasi Anda.
    • Aplikasi Diluncurkan: Kapan saja seseorang membuka halaman web yang berisi aplikasi Anda.

    Jika Anda telah mengaktifkan pembayaran melalui Facebook, peristiwa tambahan berikut akan dicatat:

    • Memulai Proses Pembayaran: Seseorang memulai proses pembayaran untuk melakukan pembelian.
    • Dibeli: Seseorang berhasil menyelesaikan pembayaran di aplikasi Anda.
    • Pembelian Dibatalkan: Seseorang membatalkan pembayaran mereka (termasuk pembayaran yang dibatalkan secara manual dan ketika metode pembayaran gagal).

    Catatan: Peristiwa Pembelian Dibatalkan mungkin tidak dicatat jika orang tersebut menutup jendela browser-nya di tengah pembelian. Inilah sebabnya mengapa peristiwa Pembatalan Pembelian mungkin tidak sama dengan perbedaan antara peristiwa Proses Pembayaran Dimulai dan peristiwa Pembelian.

    Anda dapat melihat peristiwa yang dicatat menggunakan Pengelola Peristiwa Facebook.

    Mencatat Peristiwa dengan Parameter

    Anda dapat memutuskan untuk mencatat informasi selain peristiwa yang dicatat secara otomatis agar dapat mengukur kinerja aplikasi Anda dengan lebih baik di Facebook.com. Misalnya: Anda mungkin ingin mencatat peristiwa kapan saja seseorang menyelesaikan level dalam game Anda.

    Di bawah ini adalah contoh cara Anda untuk mencatat peristiwa bersama dengan parameter yang menggambarkan peristiwa Anda:

    var params = {};
params[FB.AppEvents.ParameterNames.LEVEL] = '12'; //player level
FB.AppEvents.logEvent(
  FB.AppEvents.EventNames.ACHIEVED_LEVEL,
  null,  // numeric value for this event - in this case, none
  params
);

    Kami merekomendasikan penggunaan salah satu peristiwa yang sudah ditentukan. Namun, kami juga mendukung pencatatan peristiwa khusus.

    Jumlah maksimal nama peristiwa yang berbeda adalah 1.000. Catatan: Jenis peristiwa baru tidak akan dicatat setelah batas ini tercapai dan jika Anda melampaui batas ini, Anda akan melihat pesan kesalahan 100 Invalid parameter saat mencatat. Baca selengkapnya tentang batas peristiwa di Pertanyaan Umum.

    Mencatat Pembelian

    Facebook SDK mencakup fungsi khusus untuk mencatat pembelian, yang mewajibkan spesifikasi mata uang.

    Pembayaran yang dilakukan melalui Game di Facebook secara otomatis dicatat sebagai peristiwa pembelian. Hanya perlu menggunakan kode berikut untuk penjualan barang fisik.

    var params = {};
params[FB.AppEvents.ParameterNames.CONTENT_ID] = 'QW-12345';
FB.AppEvents.logPurchase(98.76, 'USD', params);

    Untuk menggunakan parameter yang sudah ditentukan, buat objek parameter lalu teruskan ke fungsi seperti yang ditunjukkan di bawah ini.

    var params = {};
params[FB.AppEvents.ParameterNames.CONTENT_ID] = '12345';
FB.AppEvents.logPurchase(98.76, 'USD', params);

    Peristiwa Aplikasi Khusus

    Anda juga dapat memilih untuk membuat peristiwa khusus Anda sendiri dengan menetapkan namanya sebagai string:

    FB.AppEvents.logEvent('battledAnOrc');

    Panjang maksimum untuk nama peristiwa khusus adalah 40 karakter dan harus hanya terdiri dari alfanumerik, garis bawah, atau tanda hubung.

    Menangkap Eksepsi

    Jika Anda memanggil fungsi JavaScript SDK yang disediakan dengan parameter yang salah, fungsi akan memberikan eksepsi. Pastikan kode Anda melewati parameter yang benar, dan tangkap eksepsi jika terjadi.

    Debug

    Untuk meningkatkan kinerja, JavaScript SDK dimuat diperkecil. Anda juga dapat memuat versi debug JavaScript SDK yang menyertakan lebih banyak pencatatan dan pemeriksaan argumen yang lebih ketat serta tidak diringkas. Untuk melakukannya, ubah nilai js.src dalam kode pemuatan Anda menjadi seperti berikut:

    js.src = "https://connect.facebook.net/en_US/sdk/debug.js";

    Referensi