应用事件入门指南（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 图卡，将开关切换为否。

禁用 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()

禁用广告主编号收集功能

要禁用 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);