Guida introduttiva ad App Events (Android)

Disabilitare gli eventi registrati automaticamente

Per disabilitare gli eventi registrati automaticamente, aggiungi quanto segue al file AndroidManifest.xml:

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

In alcuni casi, è consigliabile ritardare la raccolta di eventi registrati automaticamente, ad esempio per ottenere il consenso dell'utente o adempiere a obblighi legali, invece di disabilitarla. In questo caso, chiama il metodo setAutoLogAppEventsEnabled() della classe FacebookSDK e impostalo su true per abilitare nuovamente la registrazione degli eventi dopo aver ottenuto il consenso dell'utente finale.

setAutoLogAppEventsEnabled(true);

Per sospendere di nuovo la raccolta per qualsiasi motivo, imposta il metodo setAutoLogAppEventsEnabled() su false.

setAutoLogAppEventsEnabled(false);

Puoi anche disabilitare la registrazione automatica degli eventi di acquisto in-app usando la Dashboard gestione app. Vai alla scheda Android in Di base > Impostazioni e porta lo switch su No.

Disabilitare l'inizializzazione automatica dell'SDK

Per disabilitare l'inizializzazione automatica dell'SDK, aggiungi quanto segue al file AndroidManifest.xml:

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

In alcuni casi, è consigliabile ritardare l'inizializzazione dell'SDK, ad esempio per ottenere il consenso dell'utente o adempiere a obblighi legali, invece di disabilitarla. In questo caso, chiama il metodo della classe setAutoInitEnabled e impostalo su true per inizializzare manualmente l'SDK dopo aver ottenuto il consenso dell'utente finale.

FacebookSdk.setAutoInitEnabled(true)
FacebookSdk.fullyInitialize()

Disabilitare la raccolta degli ID inserzionista

Per disabilitare la raccolta di advertiser-id, aggiungi quanto segue al file AndroidManifest.xml:

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

In alcuni casi, è consigliabile ritardare la raccolta di advertiser_id, ad esempio per ottenere il consenso dell'utente o adempiere a obblighi legali, invece di disabilitarla. In questo caso, chiama il metodo setAdvertiserIDCollectionEnabled() della classe FacebookSDK e impostalo su true per riabilitare la raccolta di advertiser_id dopo aver ottenuto il consenso dell'utente finale.

setAdvertiserIDCollectionEnabled(true);

Per sospendere la raccolta per qualsiasi motivo, imposta il metodo setAdvertiserIDCollectionEnabled() su false.

setAdvertiserIDCollectionEnabled(false);

Registrare manualmente gli eventi

Crea un oggetto AppEventsLogger usando il metodo dello strumento di assistenza per registrare gli eventi, dove this è l'Activity in cui si trova il tuo metodo.

AppEventsLogger logger = AppEventsLogger.newLogger(this);

Puoi quindi registrare l'evento su logger, dove AppEventConstants.EVENT_NAME_X è una delle costanti mostrata nella tabella Eventi standard o dal codice del Generatore di codici.

logger.logEvent(AppEventsConstants.EVENT_NAME_X);

Puoi inoltre specificare una serie di parametri in un Bundle e una proprietà valueToSum, ovvero un numero a caso che può rappresentare qualsiasi valore (ad es. un prezzo o una quantità). Quando riportate, tutte le proprietà valueToSum vengono sommate. Ad esempio, se 10 utenti hanno acquistato un articolo e il costo di ogni articolo era di 10 $ (e tale valore viene passato in valueToSum), tutti i costi vengono sommati per restituire un valore di 100 $.

Nota: valueToSum e parameters sono entrambi facoltativi.

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