Spiele auf Facebook

    App-Events für Spiele auf Facebook

    Diese Facebook SDK (JS) App Events API wurde eingestellt und wird seit dem 1. Juli 2022 nicht mehr unterstützt. Neue Features für dieses Produkt sind nicht geplant. Statt FB.AppEvents.LogEvent zu verwenden, empfehlen wir, diese Events über das Meta Pixel zu senden.

    Mit App-Events kannst du die Performance von Werbeanzeigen messen und Zielgruppen erstellen für das Anzeigen-Targeting für dein Spiel auf Facebook.

    Dazu musst du Events aus deiner App über das Facebook-SDK für JavaScript senden. Bei diesem Event kann es sich um eines der vordefinierten Events handeln, z. B. "Zum Einkaufswagen hinzugefügt" in einer Shopping-App, "Level erreicht" in einem Spiel oder andere selbstdefinierte Events.

    Voraussetzungen

    Vor der Eingabe des Codes zum Messen von Events musst du deine App bei Facebook registrieren. Wenn du deine App nicht bei Facebook registriert hast, kannst du das hier nachholen: Games on Facebook Quickstart.

    Implementierung

    Dein Spiel auf Facebook sollte bereits das Facebook SDK für JavaScript beinhalten. Ist dies nicht der Fall, findest du in unserer JavaScript Schnellstart-Anleitung hilfreiche Informationen.

    Du kannst deine protokollierten Events mit dem Facebook Events Manager anzeigen.

    Automatische Events-Protokollierung

    Wir protokollieren automatisch die folgenden Events für Spiele auf Facebook:

    • App-Installation: Beim ersten Mal akzeptiert eine Person die Servicebedingungen für deine App.
    • App gestartet: Jedes Mal, wenn eine Person die Webseite mit deiner App öffnet.

    Falls du Zahlungen über Facebook aktiviert hast, werden die folgenden zusätzlichen Events protokolliert:

    • Kaufvorgang gestartet: Eine Person startet den Zahlungsvorgang, um einen Kauf zu tätigen.
    • Gekauft: Eine Person schließt eine Zahlung in deiner App erfolgreich ab.
    • Kaufvorgang storniert: Eine Person hat ihre Zahlung storniert (umfasst manuell stornierte Zahlungen und fehlgeschlagene Zahlungsmethoden).

    Hinweis: Ein Event "Kaufvorgang storniert" wird möglicherweise nicht protokolliert, wenn die Person ihr Browserfenster während des Kaufvorgangs schließt. Deshalb gleichen Event "Kauf storniert" eventuell die Differenz zwischen Events "Kaufvorgang gestartet" und "Käufe" nicht aus.

    Du kannst deine protokollierten Events mit dem Facebook Events Manager anzeigen.

    Events mit Parametern protokollieren

    Du kannst zusätzlich zu den automatisch protokollierten Events Informationen protokollieren, um die Performance deiner App auf Facebook.com zu messen. So möchtest du vielleicht immer dann ein Event protokollieren, wenn eine Person ein Level in deinem Spiel abschließt.

    Nachstehend findest du ein Beispiel, wie du ein Event mit einem Parameter protokollieren kannst, das dein Event beschreibt:

    var params = {};
params[FB.AppEvents.ParameterNames.LEVEL] = '12'; //player level
FB.AppEvents.logEvent(
  FB.AppEvents.EventNames.ACHIEVED_LEVEL,
  null,  // numeric value for this event - in this case, none
  params
);

    Wir empfehlen dir, eines der vordefinierten Events zu verwenden. Wir unterstützen jedoch auch die Protokollierung von selbstdefinierten Events.

    Es sind maximal 1.000 unterschiedliche Event-Namen möglich. Hinweis: Es werden keine neuen Event-Typen protokolliert, wenn du diese Grenze erreichst. Wenn du den Grenzwert überschreitest, kann der Fehler 100 Invalid parameter bei der Protokollierung angezeigt werden. Weitere Informationen zu Event-Begrenzungen findest du in den FAQ.

    Käufe protokollieren

    Das Facebook SDK beinhaltet eine dedizierte Funktion für die Protokollierung von Käufen. Hierfür musst du eine Währung angeben.

    Über Spiele auf Facebook vorgenommene Zahlungen werden automatisch protokolliert als Kauf-Events. Du musst nur den folgenden Code für die Verkäufe physischer Artikel verwenden.

    var params = {};
params[FB.AppEvents.ParameterNames.CONTENT_ID] = 'QW-12345';
FB.AppEvents.logPurchase(98.76, 'USD', params);

    Erstelle zur Verwenden der vordefinierten Parameter das Parameterobjekt und übergib es wie nachfolgend gezeigt an die Funktion.

    var params = {};
params[FB.AppEvents.ParameterNames.CONTENT_ID] = '12345';
FB.AppEvents.logPurchase(98.76, 'USD', params);

    Selbstdefinierte App-Events

    Du kannst auch deine selbstdefinierten Events erstellen. Dabei gibst du einfach den jeweiligen Namen als String an:

    FB.AppEvents.logEvent('battledAnOrc');

    Namen angepasster Events dürfen maximal 40 Zeichen umfassen und dürfen nur alphanumerische Zeichen, Unterstriche oder Dashes enthalten.

    Ausnahmen finden

    Wenn du die angegebene SDK JavaScript-Funktion mit falschen Parametern aufrufst, gibt die Funktion eine Ausnahme aus. Stelle sicher, dass dein Code die richtigen Parameter übergibt und finde alle Ausnahmen, die eventuell auftreten.

    Debuggen

    Für eine bessere Performance wird das JavaScript SDK minimiert geladen. Du kannst auch eine Debug-Version des JavaScript-SDK laden, die eine erweiterte Protokollierung und strengere Argumentprüfung umfasst und nicht minimalisiert ist. Dazu änderst du den js.src-Wert in deinem Ladecode in:

    js.src = "https://connect.facebook.net/en_US/sdk/debug.js";

    Referenz