アプリイベントのスタートガイド(Android)

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

自動で記録されるイベントを無効にするには、AndroidManifest.xmlファイルに以下を追加します。

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

ユーザーの同意を得たり法的な義務を履行したりする場合など、状況によっては、自動的に記録されるイベントの収集を無効にするのではなく、単に遅らせたいことがあります。その場合、エンドユーザーの同意を得た後で、FacebookSDKクラスのsetAutoLogAppEventsEnabled()メソッドを呼び出してtrueに設定し、イベントの記録を再度有効化します。

setAutoLogAppEventsEnabled(true);

何らかの理由で記録を再度中断するには、setAutoLogAppEventsEnabled()メソッドをfalseに設定します。

setAutoLogAppEventsEnabled(false);

アプリ内購入イベントの自動イベント記録は、アプリダッシュボードを使って無効にすることもできます。[基本] >[設定]の下の[Androidカード]に移動してスイッチを[No]に切り替えます。

SDKの自動初期化を無効にする

SDKの自動初期化を無効にするには、AndroidManifest.xmlファイルに以下を追加します。

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

ユーザーの同意を得たり法的な義務を履行したりする場合など、状況によっては、SDKの初期化を無効にするのではなく、単に遅らせたいことがあります。その場合、エンドユーザーの同意を得た後で、setAutoInitEnabledクラスメソッドを呼び出してtrueに設定し、手動でSDKを初期化します。

FacebookSdk.setAutoInitEnabled(true)
FacebookSdk.fullyInitialize()

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

advertiser-idの収集を無効にするには、AndroidManifest.xmlファイルに以下を追加します。

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

ユーザーの同意を得たり法的な義務を履行したりする場合など、状況によっては、advertiser_idの収集を無効にするのではなく、単に遅らせたいことがあります。その場合、エンドユーザーの同意を得た後で、FacebookSDKクラスのsetAdvertiserIDCollectionEnabled()メソッドを呼び出してtrueに設定し、advertiser_idの収集を再度有効化します。

setAdvertiserIDCollectionEnabled(true);

何らかの理由で収集を中断するには、setAdvertiserIDCollectionEnabled()メソッドをfalseに設定します。

setAdvertiserIDCollectionEnabled(false);

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

ヘルパーメソッドを使ってAppEventsLoggerオブジェクトを作成し、イベントを記録します。ここで、thisはメソッドが指定されているActivityです。

AppEventsLogger logger = AppEventsLogger.newLogger(this);

そうすると、イベントをloggerに記録できます。ここで、AppEventConstants.EVENT_NAME_Xは標準イベントの表に示されている定数のいずれか、またはコードジェネレーターで生成されたコードになります。

logger.logEvent(AppEventsConstants.EVENT_NAME_X);

また、一連のパラメーターをBundleとvalueToSumプロパティに指定することもできます。後者は、何らかの値を表す任意の数になります(価格や数量など)。レポート作成時には、すべてのvalueToSumプロパティが合計されます。例えば、10人の利用者がそれぞれ$10のアイテムを購入する(valueToSumに渡す)と、価格が合計され$100が報告されます。

注:valueToSumとparametersのいずれも、使用は任意です。

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);