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