Начало работы с событиями в приложении (Android)

Отключение автоматической регистрации событий

Чтобы отключить автоматическую регистрацию событий, в файл AndroidManifest.xml добавьте следующее:

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

Иногда (например, чтобы получить согласие пользователя или обеспечить соблюдение требований законодательства) лучше просто отложить сбор данных об автоматически регистрируемых событиях, но не отключать его. В таком случае вызовите метод setAutoLogAppEventsEnabled() класса FacebookSDK и укажите значение 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()

Отключение сбора ID рекламодателей

Чтобы отключить сбор advertiser-id, в файл AndroidManifest.xml добавьте следующее:

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

Иногда (например, чтобы получить согласие пользователя или обеспечить соблюдение требований законодательства) лучше просто отложить сбор advertiser_id, но не отключать его. В этом случае вызовите метод setAdvertiserIDCollectionEnabled() класса FacebookSDK и задайте для него значение 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);