Introdução aos eventos do app (Android)

Desabilitar eventos registrados automaticamente

Para desabilitar eventos registrados automaticamente, adicione o seguinte ao arquivo AndroidManifest.xml:

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

Em alguns casos, em vez de desabilitar o recurso, é possível adiar a coleta de eventos registrados automaticamente para obter consentimento do usuário ou atender a requisitos legais, por exemplo. Para isso, chame o método setAutoLogAppEventsEnabled() da classe FacebookSDK e defina-o como true para reabilitar o registro automático após o consentimento do usuário final.

setAutoLogAppEventsEnabled(true);

Para suspender o registro de novo, defina o método setAutoLogAppEventsEnabled() como false.

setAutoLogAppEventsEnabled(false);

Também é possível desabilitar o registro automático de eventos de compra no app no Painel de Apps. Acesse o Cartão do Android em Básico > Configurações e alterne o controle para Não.

Desabilitar a inicialização automática do SDK

Para desabilitar a inicialização automática do SDK, adicione o seguinte ao arquivo AndroidManifest.xml:

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

Em vez de desabilitar o recurso, em alguns casos é possível adiar a inicialização automática do SDK para obter consentimento do usuário ou atender a requisitos legais, por exemplo. Para isso, chame o método setAutoInitEnabled da classe true para inicializar o SDK de forma manual após receber o consentimento do usuário final.

FacebookSdk.setAutoInitEnabled(true)
FacebookSdk.fullyInitialize()

Desabilitar a coleta de identificações de anunciante

Para desabilitar a coleta de advertiser-id, adicione o seguinte ao arquivo AndroidManifest.xml:

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

Em vez de desabilitar o recurso, em alguns casos, é possível adiar a coleta de advertiser_id para obter consentimento do usuário ou atender a obrigações legais, por exemplo. Para isso, chame o método setAdvertiserIDCollectionEnabled() da classe FacebookSDK e defina-o como true para reabilitar a coleta de advertiser_id após receber o consentimento do usuário final.

setAdvertiserIDCollectionEnabled(true);

Para suspender a coleta por algum motivo, defina o método setAdvertiserIDCollectionEnabled() como false.

setAdvertiserIDCollectionEnabled(false);

Registrar eventos manualmente

Crie um objeto AppEventsLogger por meio de métodos auxiliares para registrar os eventos, sendo this a Activity em que está o método.

AppEventsLogger logger = AppEventsLogger.newLogger(this);

Depois, registre o evento em logger, sendo AppEventConstants.EVENT_NAME_X uma das constantes mostradas na tabela de eventos-padrão ou no código do Gerador de Códigos.

logger.logEvent(AppEventsConstants.EVENT_NAME_X);

Também é possível especificar um conjunto de parâmetros em Bundle e uma propriedade valueToSum, que é um número arbitrário que representa qualquer valor, como um preço ou uma quantidade. Quando informadas, todas as propriedades de valueToSum serão somadas. Por exemplo, se dez pessoas comprassem um item que custa R$ 10 (e transmitissem em valueToSum), esses valores seriam somados para informar R$ 100.

Observação: tanto valueToSum quanto parameters são opcionais.

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