Erste Schritte mit App-Events (Android)

Deaktivieren automatisch protokollierter Events

Füge der AndroidManifest.xml-Datei Folgendes hinzu, um automatisch protokollierte Events zu deaktivieren:

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

In einigen Fällen solltest du die Erfassung automatisch protokollierter Events unter Umständen verzögern, anstatt sie zu deaktivieren, beispielsweise um die Einwilligung eines Nutzers einzuholen oder deine rechtlichen Pflichten zu erfüllen. Rufe in diesem Fall die setAutoLogAppEventsEnabled()-Methode der FacebookSDK-Klasse auf und setze sie auf true, um die Protokollierung nach der Einwilligung des Endbenutzers wieder zu aktivieren.

setAutoLogAppEventsEnabled(true);

Um die Protokollierung aus einem beliebigen Grund erneut zu deaktivieren, legst du für die setAutoLogAppEventsEnabled()-Methode den Wert false fest.

setAutoLogAppEventsEnabled(false);

Du kannst mit dem App-Dashboard auch die automatische Protokollierung von App-internen Käufen deaktivieren. Navigiere zur Android-Karte unter Allgemeines > Einstellungen und setze den Schalter auf Nein.

Deaktivieren der automatischen SDK-Initialisierung

Füge der AndroidManifest.xml-Datei Folgendes hinzu, um die automatische SDK-Initialisierung zu deaktivieren:

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

In einigen Fällen ist es sinnvoll, die SDK-Initialisierung zu verzögern anstatt sie zu deaktivieren, beispielsweise um die Einwilligung eines Nutzers einzuholen oder deine rechtlichen Pflichten zu erfüllen. Rufe in diesem Fall die Klassenmethode setAutoInitEnabled auf und lege sie auf true fest, um das SDK manuell zu initialisieren, nachdem der Endbenutzer seine Einwilligung erteilt hat.

FacebookSdk.setAutoInitEnabled(true)
FacebookSdk.fullyInitialize()

Erfassung von Werbekunden-IDs deaktivieren

Füge der AndroidManifest.xml-Datei Folgendes hinzu, um die Erfassung der advertiser-id zu deaktivieren:

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

In einigen Fällen solltest du die Erfassung von advertiser_id unter Umständen verzögern, anstatt sie zu deaktivieren, beispielsweise um die Einwilligung eines Nutzers einzuholen oder deine rechtlichen Pflichten zu erfüllen. Rufe in diesem Fall die Methode setAdvertiserIDCollectionEnabled() der Klasse FacebookSDK auf und lege sie auf true fest, um die Erfassung der advertiser_id wieder zu aktivieren, nachdem der Endbenutzer seine Einwilligung erteilt hat.

setAdvertiserIDCollectionEnabled(true);

Um die Erfassung aus einem beliebigen Grund zu deaktivieren, legst du die setAdvertiserIDCollectionEnabled()-Methode auf false fest.

setAdvertiserIDCollectionEnabled(false);

Manuelles Protokollieren von Events

Erstelle ein AppEventsLogger-Objekt mit der Hilfstool-Methode, um deine Events zu protokollieren. Dabei ist this die Activity, in der sich deine Methode befindet.

AppEventsLogger logger = AppEventsLogger.newLogger(this);

Anschließend kannst du dein Event in logger protokollieren, wobei AppEventConstants.EVENT_NAME_X eine der Konstanten ist, die in der Tabelle „Standard-Events“ angezeigt werden oder aus dem Codegenerator-Code stammen.

logger.logEvent(AppEventsConstants.EVENT_NAME_X);

Du kannst auch eine Reihe an Parametern in einem Bundle und eine valueToSum-Eigenschaft angeben. Dabei handelt es sich um eine beliebige Zahl, die für jeden gewünschten Wert stehen kann, z. B. einen Preis oder eine Anzahl. Im Bericht werden alle valueToSum-Eigenschaften summiert. Beispiel: Wenn 10 Personen einen Artikel für je 10 $ kaufen (und valueToSum übergeben wurde), wird im Report die Zahl 100 $ als Summe angegeben.

Hinweis: Sowohl valueToSum als auch parameters sind optional.

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