スタートガイド – Unity

このガイドでは、Facebook Unity SDKを使用して新しいアプリまたは既存のアプリにアプリイベントを追加する方法を紹介します。

開始する前に

• Facebook開発者アカウント
• FacebookアプリID
• Facebook Unity SDK v4.27以降 – Facebook Unity SDKをまだ実装していない人は、スタートガイドをご覧ください。

アプリの起動を記録する

SDKで提供されているヘルパーメソッドFB.ActivateAppを使用してアプリの起動を記録します。FB.InitでSDKを初期化したら、FB.ActivateAppを呼び出せるようになります。

ユーザーがアプリを起動したときのログを記録するには、MonoBehaviorのAwake関数を使用します。

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

ユーザーがアプリを再開したときのログを記録するには、MonoBehaviorのOnApplicationPause関数を使用します。

// 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();
      });
    }
  }
}

手動でイベントを記録する

次のコード例は、イベントを手動で記録する方法を示しています。

アプリ内購入の記録

この例では、priceCurrencyは使用された通貨を表す3文字のISO codeの文字列、priceAmountは購入したアイテムの価格のfloat、packageNameは購入したアイテムのSKU codeの文字列です。

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

ゲームのイベントのトラッキング

2番目の例では、ユーザーがゲームで消費したクレジットの数値をトラッキングしています。numGoldは消費されたクレジットの数値のfloat、storeItemはユーザーが購入したアイテムの名前の文字列です。

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

イベントの自動ログ記録を無効にする

Unity SDKでは、デフォルトでイベントの自動記録がオンになっています。自動イベント記録のオンオフを切り替えるには、Unity IDEメニューバーの[Facebook] -> [設定の編集]にアクセスして、[アプリイベント設定]セクションにある[アプリイベントの自動記録]を選択または選択解除してください。

プログラムを使用してイベントの自動記録をオフにするには、Fb.MobileのSetAutoLogAppEventsEnabled()メソッドをfalseに設定します。

FB.Mobile.SetAutoLogAppEventsEnabled(false); 

場合によっては、エンドユーザーが同意した後、自動記録を再度オンにしたいと思うかもしれません。これを行うには、SetAutoLogAppEventsEnabled()をtrueに設定します。

FB.Mobile.SetAutoLogAppEventsEnabled(true); 

広告主IDの収集を無効にする

Unity SDKでは、デフォルトで広告主IDの収集をオンにしています。広告主ID収集のオンオフを切り替えるには、Unity IDEメニューバーの[Facebook] -> [設定の編集]にアクセスして、[アプリイベント設定]セクションにある[広告主IDの収集]を選択または選択解除してください。

プログラムを使用して広告主ID収集をオフにするには、Fb.MobileのSetAdvertiserIDCollectionEnabled ()メソッドをfalseに設定します。

FB.Mobile.SetAdvertiserIDCollectionEnabled (false);

場合によっては、エンドユーザーが同意した後、広告主ID収集を再度オンにしたいと思うかもしれません。これを行うには、SetAdvertiserIDCollectionEnabled()をtrueに設定します。

FB.Mobile.SetAdvertiserIDCollectionEnabled (true); 

詳細

• Unityのアプリイベントのリファレンス
• アプリイベントのベストプラクティスガイド