應用程式事件新手入門（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);