Meta-App-Events

Erste Schritte – Unity

In diesem Leitfaden erfährst du, wie du mit dem Facebook Unity SDK App-Events zu deiner neuen oder bestehenden App hinzufügst.

Bevor du beginnst

App-Startvorgänge protokollieren

Das SDK bietet die Hilfsmethode FB.ActivateApp zur Protokollierung von App-Startvorgängen. Du musst das SDK mit FB.Init initialisieren, bevor du FB.ActivateApp aufrufen kannst.

Verwende die Awake-Funktion von MonoBehavior, um zu protokollieren, wenn ein*e Nutzer*in deine App startet.

void Awake ()
{
  if (FB.IsInitialized) {
    FB.ActivateApp();
  } else {
    //Handle FB.Init
    FB.Init( () => {
      FB.ActivateApp();
    });
  }
}

Verwende die OnApplicationPause Funktion von MonoBehavior, um zu protokollieren, wenn ein*e Nutzer*in deine App wieder aktiviert.

// Unity will call OnApplicationPause(false) when an app is resumed
// from the background
void OnApplicationPause (bool pauseStatus)
{
  // Check the pauseStatus to see if we are in the foreground
  // or background
  if (!pauseStatus) {
    //app resume
    if (FB.IsInitialized) {
      FB.ActivateApp();
    } else {
      //Handle FB.Init
      FB.Init( () => {
        FB.ActivateApp();
      });
    }
  }
}

Events manuell protokollieren

Die folgenden Codebeispiele zeigen, wie du Events manuell protokollierst.

In-App-Käufe protokollieren

In diesem Beispiel ist priceCurrency eine Zeichenfolge mit dem aus drei Buchstaben bestehenden ISO code für die verwendete Währung. priceAmount ist ein float-Wert mit dem Preis des gekauften Artikels und packageName ist eine Zeichenfolge mit deinem SKU code für den gekauften Artikel.

var iapParameters = new Dictionary<string, object>();
iapParameters["mygame_packagename"] = packageName;
FB.LogPurchase(
  priceAmount,
  priceCurrency,
  iapParameters
);

Ein Event in einem Spiel erfassen

Im zweiten Beispiel erfassen wir die Anzahl der Gutschriften, die ein*e Nutzer*in in einem Spiel verwendet hat. numGold ist ein float-Wert für die Anzahl der verwendeten Gutschriften und storeItem ist eine Zeichenfolge mit dem Namen des von dem*der Nutzer*in gekauften Artikels.

var softPurchaseParameters = new Dictionary<string, object>();
softPurchaseParameters["mygame_purchased_item"] = storeItem;
FB.LogAppEvent(
  Facebook.Unity.AppEventName.SpentCredits,
  (float)numGold,
  softPurchaseParameters
);

Automatisch protokollierte Events deaktivieren

Nachdem du das Facebook-SDK integriert hast, werden App-Events automatisch für den Events Manager protokolliert und erfasst, es sei denn, du deaktivierst die automatische Protokollierung von App-Events. Du kannst dies in deinem App-Code oder über einen Schalter unter „App-Events“ im App-Dashboard oder im Events Manager ändern. Bitte beachte, dass wir bei widersprüchlichen Werten zwischen der Flag AutoLogAppEventsEnabled und dem Schalter den Wert des Schalters „Automatisches Protokollieren von Events für das Facebook-SDK“ berücksichtigen. Detaillierte Informationen dazu, welche Daten erfasst werden und wie du die automatische App-Event-Protokollierung deaktivierst, findest du im Abschnitt Automatische App-Event-Protokollierung.

In unserem Unity SDK ist die automatische Protokollierung von Events standardmäßig aktiviert. Wenn du die automatische Event-Protokollierung deaktivieren bzw. aktivieren möchtest, wähle in der Unity IDE-Menüleiste Facebook -> Edit Settings (Einstellungen bearbeiten). Aktiviere bzw. deaktiviere die Option Auto Logging App Events (Automatische Protokollierung von App-Events) im Abschnitt App Events Settings (App-Events-Einstellungen).

Indem du die Methode SetAutoLogAppEventsEnabled() von Fb.Mobile auf false festlegst, kannst du die automatische Protokollierung von Events programmgesteuert deaktivieren.

FB.Mobile.SetAutoLogAppEventsEnabled(false);

Es ist denkbar, dass du die automatische Protokollierung wieder aktivieren möchtest, nachdem ein*e Endnutzer*in seine*ihre Einwilligung erteilt hat. Dazu legst du die Methode SetAutoLogAppEventsEnabled() auf true fest.

FB.Mobile.SetAutoLogAppEventsEnabled(true);

Erfassung von Werbekunden-IDs deaktivieren

In unserem Unity SDK ist die Erfassung von Werbekunden-IDs standardmäßig aktiviert. Wenn du die Erfassung von Werbekunden-IDs deaktivieren bzw. aktivieren möchtest, wähle in der Unity IDE-Menüleiste Facebook -> Edit Settings (Einstellungen bearbeiten). Aktiviere bzw. deaktiviere die Option AdvertiserID Collection (Werbekunden-ID-Erfassung) im Abschnitt App Events Settings (App-Events-Einstellungen).

Indem du die Methode SetAdvertiserIDCollectionEnabled () von Fb.Mobile auf false festlegst, kannst du die Erfassung von Werbekunden-IDs programmgesteuert deaktivieren.

FB.Mobile.SetAdvertiserIDCollectionEnabled (false);

Es ist denkbar, dass du die Erfassung von Werbekunden-IDs wieder aktivieren möchtest, nachdem ein*e Endnutzer*in seine*ihre Einwilligung erteilt hat. Dazu legst du die Methode SetAdvertiserIDCollectionEnabled() auf true fest.

FB.Mobile.SetAdvertiserIDCollectionEnabled (true);

Mehr erfahren