Peristiwa Aplikasi Meta

Memulai – Unity

Panduan ini menunjukkan kepada Anda cara menambahkan Peristiwa Aplikasi ke aplikasi baru atau yang sudah ada menggunakan Facebook SDK untuk Unity.

Sebelum Memulai

Mencatat Peluncuran Aplikasi

SDK menyediakan metode bantuan FB.ActivateApp untuk mencatat peluncuran aplikasi. Anda harus menginisialisasi SDK dengan FB.Init sebelum Anda dapat memanggil FB.ActivateApp.

Gunakan fungsi Awake dari MonoBehavior untuk mencatat saat pengguna meluncurkan aplikasi Anda.

void Awake ()
{
  if (FB.IsInitialized) {
    FB.ActivateApp();
  } else {
    //Handle FB.Init
    FB.Init( () => {
      FB.ActivateApp();
    });
  }
}

Gunakan fungsi OnApplicationPause dari MonoBehavior untuk mencatat saat pengguna melanjutkan aplikasi Anda.

// Unity will call OnApplicationPause(false) when an app is resumed
// from the background
void OnApplicationPause (bool pauseStatus)
{
  // Check the pauseStatus to see if we are in the foreground
  // or background
  if (!pauseStatus) {
    //app resume
    if (FB.IsInitialized) {
      FB.ActivateApp();
    } else {
      //Handle FB.Init
      FB.Init( () => {
        FB.ActivateApp();
      });
    }
  }
}

Mencatat Peristiwa Secara Manual

Contoh kode berikut menunjukkan cara mencatat peristiwa secara manual.

Mencatat Pembelian dalam Aplikasi

Dalam contoh ini, priceCurrency adalah string yang berisi 3 huruf ISO code yang mewakili mata uang yang digunakan, priceAmount adalah float yang berisi harga barang yang dibeli, dan packageName adalah string yang berisi SKU code untuk barang yang dibeli.

var iapParameters = new Dictionary<string, object>();
iapParameters["mygame_packagename"] = packageName;
FB.LogPurchase(
  priceAmount,
  priceCurrency,
  iapParameters
);

Melacak Peristiwa dalam Game

Pada contoh kedua, kita melacak jumlah kredit yang dihabiskan pengguna dalam game. numGold adalah float yang berisi jumlah kredit yang dikeluarkan dan storeItem adalah string yang berisi nama barang yang dibeli pengguna.

var softPurchaseParameters = new Dictionary<string, object>();
softPurchaseParameters["mygame_purchased_item"] = storeItem;
FB.LogAppEvent(
  Facebook.Unity.AppEventName.SpentCredits,
  (float)numGold,
  softPurchaseParameters
);

Menonaktifkan Peristiwa yang Otomatis Dicatat

Setelah Anda mengintegrasikan Facebook SDK, Peristiwa Aplikasi tertentu dicatat dan dikumpulkan secara otomatis untuk Pengelola Peristiwa, kecuali Anda menonaktifkan Pencatatan Peristiwa Aplikasi Otomatis. Anda dapat mengubahnya dalam kode aplikasi Anda atau melalui tombol geser di bawah Peristiwa Aplikasi di Dasbor Aplikasi atau Pengelola Peristiwa. Perlu diperhatikan bahwa jika terjadi konflik nilai antara tanda AutoLogAppEventsEnabled dan tombol geser, kami akan menerapkan nilai pada tombol geser ‘Pencatatan peristiwa otomatis untuk Facebook SDK’. Untuk detail tentang informasi apa saja yang dikumpulkan dan cara menonaktifkan Pencatatan Peristiwa Aplikasi Otomatis, lihat Pencatatan Peristiwa Aplikasi Otomatis.

Unity SDK kami memungkinkan pencatatan peristiwa secara otomatis, secara default. Untuk menonaktifkan atau mengaktifkan pencatatan acara secara otomatis, buka Facebook -> Edit Pengaturan di bilah menu Unity IDE dan pilih atau hapus Pencatatan Otomatis Peristiwa Aplikasi di bawah bagian Pengaturan Peristiwa Aplikasi.

Anda dapat secara terprogram menonaktifkan peristiwa yang dicatat secara otomatis dengan mengatur metode SetAutoLogAppEventsEnabled() dari Fb.Mobile ke false.

FB.Mobile.SetAutoLogAppEventsEnabled(false);

Dalam beberapa kasus, Anda mungkin ingin mengaktifkan kembali pencatatan otomatis setelah pengguna akhir memberikan persetujuan. Anda dapat melakukan ini dengan mengatur metode SetAutoLogAppEventsEnabled() ke true.

FB.Mobile.SetAutoLogAppEventsEnabled(true);

Menonaktifkan Pengumpulan ID Pengiklan

Unity SDK kami memungkinkan pengumpulan ID Pengiklan secara default. Untuk menonaktifkan atau mengaktifkan pengumpulan ID Pengiklan, buka Facebook -> Edit Pengaturan di bilah menu Unity IDE dan pilih atau hapus Pengumpulan ID Pengiklan di bawah bagian Pengaturan Peristiwa Aplikasi.

Anda dapat secara terprogram menonaktifkan pengumpulan ID Pengiklan dengan mengatur metode SetAdvertiserIDCollectionEnabled () dari Fb.Mobile ke false.

FB.Mobile.SetAdvertiserIDCollectionEnabled (false);

Dalam beberapa kasus, Anda mungkin ingin mengaktifkan kembali pengumpulan ID Pengiklan setelah pengguna akhir memberikan persetujuan. Anda dapat melakukan ini dengan mengatur metode SetAdvertiserIDCollectionEnabled() ke true.

FB.Mobile.SetAdvertiserIDCollectionEnabled (true);

Pelajari Selengkapnya