FAQ zu Instant Games

Antworten auf Fragen zur Entwicklung, Verwaltung und Monetarisierung von Instant Games.

Allgemeine Informationen

Melde dich bei Facebook.com an und klicke auf das Lesezeichen Spiele auf der linken Seite oder besuche https://www.facebook.com/games/instantgames.

Permalink

Entwickeln eines Spiels

Stelle sicher, dass deine App in der Kategorie Spiele enthalten ist. Das Produkt Instant Games wird nicht für Apps außerhalb dieser Kategorie angezeigt.

Permalink

Wir haben keine Obergrenze für Spielegrößen. Wir empfehlen jedoch, dass der erste Download nicht länger als 5 Sekunden dauern sollte. Du kannst Spiele-Bundles von bis zu 200 MB hosten, solltest jedoch nur zum anfänglichen Laden erforderliche Dateien herunterladen. Weitere Informationen findest du im Abschnitt Best Practices

Permalink

Zum Speichern deiner Informationen hast du mehrere Möglichkeiten:

  1. Verwendung einer Backend-Lösung eines Drittanbieters, mit der dein Spiel über XMLHttpRequest, fetch, WebSocket oder EventSource kommuniziert. Diese Option bietet dir mehr Flexibilität. Allerdings gehen damit auch Hosting-Kosten einher, die sich proportional zu deinem Spielpublikum verhalten.

  2. Verwendung von SDK-basierten Lösungen, die standardmäßig viele serverseitige Funktionalitäten ermöglichen. Verwende zum Speichern spielerspezifischer Informationen unsere Methoden player.getDataASync und player.setDataAsync. Informationen zu Ranglisten findest du in unserem Leaderboard API-Leitfaden.

  3. Drittanbieterdienste wie PlayFab stellen vollständig plattformübergreifende Backend-als-Oberfläche-Plattformen bereit, um LiveOps, Matchmaking und Analysen zu unterstützen. Durchsuche weitere Tools.

Permalink

Die Systemanforderungen zum Spielen von Instant Games sind iOS 8 oder Android 5.0.

Weitere Informationen findest du unter Anleitung für einfache Spiele.

Permalink

Du kannst Probleme direkt auf Howler.js Github melden. Gib "[IG]" als Titel des Problems ein, damit es von den Entwicklern mit Priorität bearbeitet wird.

Permalink

Du solltest sicherstellen, dass du window.innerWidth und window.innerHeight aufrufst, nachdem FBInstant.startGameAsync() aufgelöst wird.

Permalink

Du kannst Titel aus der Sound Collection von Facebook in deinen Spielen verwenden (und bearbeiten). Inhalte aus der Sound Collection können nur auf der Facebook-Plattform verwendet werden. Alle Versionen deines Spiels, die Inhalte aus der Sound Collection umfassen, können also nur auf unserer Plattform zur Verfügung gestellt werden.

Permalink

Hinzufügen von Funktionen zu einem Spiel

Unsere FBInstant.context.shareAsync()-Methode enthält einen intent-Parameter, der Werte wie 'INVITE', 'SHARE' usw. akzeptiert. Seit Version 4.0 dient der Parameter keinem bestimmten Zweck. Er wurde hinzugefügt, um das SDK für die Zukunft zu rüsten und Nutzern zukünftig Änderungen bereitstellen zu können.

Permalink

Wenn du einen anderen Spieler im Thread zum ersten Mal herausforderst, gibt es keine SDK-Methode, mit der du die Informationen über die herausgeforderte Person abrufen kannst. Wir empfehlen die Verwendung eines Platzhalternamens wie „Gegner“, bis der zweite Spieler auf die Einladung reagiert. Sobald der andere Spieler die Einladung zum Spielen angenommen hat, kannst du mit Hilfe von FBinstant.player dessen Bild und Namen ausfüllen.

Permalink

Spiele-Bots

Wenn ein Spiele-Bot keine Webhooks empfängt, liegt das meistens an einer falschen Konfiguration in der App. Auf der Seite Bot-Setup findest du einen vollständigen Leitfaden zur Einrichtung deines Spiele-Bots.

Überprüfe im Entwickler-Dashboard, ob Folgendes gegeben ist:

  1. Du hast eine App-Seite, die im Bereich „Instant Games“ konfiguriert ist
  2. Du hast Events für messages und messaging_game_plays im Messenger-Bereich abonniert.
  3. Die App-Seite wird im Bereich Abonnierte Seiten im Abschnitt „Messenger“ konfiguriert.
  4. Deine Seite muss als „App-Seite“ kategorisiert sein und ihr Name muss den Namen deines Spiels beinhalten.
Permalink

Wenn du als Antwort auf die Sendeaufrufe der Graph API Fehlermeldungen erhältst, liegt eine der folgenden Situationen vor:

- Du versuchst, Nachrichten zu senden, obwohl du die Begrenzung von 5 Nachrichten pro Nutzer innerhalb von 10 Tagen überschritten hast

- Du versuchst, Nachrichten an einen Nutzer zu senden, der deinen Bot gelöscht, blockiert oder stumm geschaltet hat

- Deine App befindet sich im Entwicklungsmodus und du versuchst, Nachrichten an Nutzer zu senden, die keine Administrator- oder Entwicklerrolle für deine App besitzen

Weitere Informationen findest du in der Send API-Dokumentation

Permalink

Datenmanagement

Die Facebook-App-Einstellungen bieten Nutzern die Möglichkeit, deine App aufzufordern, die aus Facebook über sie vorhandenen Daten zu löschen.

Als Reaktion auf die Nutzeranforderung solltest du bestätigen, dass eine Anforderung zur Löschung von Nutzerdaten mittels der von uns angebotenen technischen Möglichkeiten eingegangen ist, und einen Link und eine Bestätigungsnummer bereitstellen. Über den Link und die Bestätigungsnummer müssen Nutzer Zugriff auf eine für Menschen lesbare Erklärung des Status ihrer Anfrage erhalten, einschließlich einer rechtmäßigen Begründung aller Verweigerungen von Löschungen (wobei die Rechtmäßigkeit je nach Rechtsprechung und unserer fallbasierten Interpretation unserer Richtlinie im Zusammenhang mit den genannten Gründen unterschiedlich zu betrachten ist).

Zur Analyse und Beantwortung der Anfrage solltest du einen Rückruf zur Datenlöschungsanfrage implementieren. Für deinen Rückruf muss das sichere HTTPS-Protokoll verwendet werden und er muss im Feld URL für Datenlöschungsanforderung der Seite Instant Games > Details im App-Dashboard aufgelistet werden.

Permalink

Problembehebung

Wenn du unsere Leitfäden Kurzanleitung oder Testen, Veröffentlichen und Teilen liest, solltest du mit unserem Konzept des eingebetteten Players vertraut sein. Damit kannst du dein Instant Game über einen lokalen HTTP-Dienst auf deinem Computer mit Verknüpfungen zu allen Echtzeitfunktionen des Instant Games-SDK ausführen und testen.

Wenn du Methode anwendest, kann es vorkommen, dass dein Spiel sich beim Laden aufhängt. Manchmal werden keine Nachrichten in der Entwicklerkonsole des Browsers angezeigt oder es wird eine Nachricht des Typs Failed to execute 'postMessage' on 'DOMWindow' angezeigt. Diese stammen von der gleichen Art von Fehler, die meist dadurch verursacht werden, dass dein lokaler Server sich aufgrund einer Zertifikatsproblematik weigert, Vermögenswerte zu bedienen.

Wenn dies auftritt, navigiere zum Stamm deines lokalen Servers (in der Regel https://localhost:8000 oder https://127.0.0.1:8000) und befolge die Anweisungen für deinen Browser zum Annehmen von Zertifikaten bzw. zum Hinzufügen einer Sicherheitsausnahme für diese Webseite. Kehre danach zur URL des eingebetteten Players zurück. Jetzt sollte alles normal funktionieren.

Permalink

Dieser Fehler tritt auf, wenn du versuchst, eine Werbeanzeige über eine AdInstance zu laden, die früher bereits fehlgeschlagen ist. Wenn die loadAsync-Methode deiner AdInstance bereits einmal abgelehnt wurde, versuche nicht, sie erneut zu verwenden. Fordere stattdessen eine neue AdInstance an, indem du getInterstitialAsync oder getRewardedVideoAsync aufrufst.

Permalink

Since we removed "blob:" from our CSP configuration, some games made with Unity might encounter an issue at loading time. The error you might get in your web browser's console will look something like this: Refused to load the script 'blob:https://apps-xxx.apps.fb UnityLoader.js'

To solve this issue, you could try to:

  1. Upgrade to a newer version of Unity
  2. Replace the Unity Loader code to use this version of “loadCode” function: loadCode:function(e,t,r){var s=document.createElement("script");s.src="Build/"+r.url,s.onload=function(){t(r.url.split('.').slice(0,-1).join('.')),delete s.onload},document.body.appendChild(s)},
  3. Contact Unity support team
Permalink

Monetarisieren eines Spiels

Werbung

Zahlungen

Onboarding mit Facebook

Informationen zur Steuer findest du in Abschnitt 3.9 unserer Seite Zahlungsbedingungen.

Permalink

Verwendung von Informationen zu Auszahlungskonten

Auszahlungsstatus

Bei einem Verkaufsabschluss über deine Plattform schreibt Facebook den Erlös aus dem Abschluss abzüglich unserer Servicegebühr deinem Entwicklersaldo gut. Facebook erhebt für jede Facebook-Zahlungstransaktion auf unserer Plattform eine Servicegebühr in Höhe von 30 % zzgl. der jeweiligen Umsatzsteuer. Weitere Informationen dazu findest du unter Zahlungsbedingungen.

Permalink

Sende bei Problemen mit deinen letzten Auszahlungen eine Anfrage mit dem Formular für Support für Facebook-Zahlungen für Monetisierer. und wähle dann Spiel/App (Entwickler) > Auszahlungen > Ich habe eine Frage zu meiner letzten Auszahlung.

Wende dich bei Fragen im Zusammenhang mit Zahlungen und Berichten an Support für Facebook-Zahlungen.

Permalink

Die Eskalation des Problems an anderer Stelle und/oder das erneute Öffnen eines zusätzlichen Tickets führt zu einer zusätzlichen Verkomplizierung deiner bereits bestehenden Anfrage bei unserem Zahlungsabwicklungsteam. Wir empfehlen allen Partnern dringend, alle Nachverfolgungen über die bestehenden Kommunikationskanäle vorzunehmen, die bereits beim Zahlungsabwicklungsteam laufen.

Permalink

Privatsphäre und Sicherheit


Anfordern von Hilfe zu Zahlungen

Falls du bei der Aktualisierung der Informationen in deinem Konto Hilfe benötigst, kannst du Hilfeseite zu Zahlungen aufrufen. Bei der Aktualisierung deiner Finanzdaten versehen wir dein Konto mit einer 10-tägigen Sperre bis zur Verarbeitung der nächsten Zahlung. Wir können diese Sperre eventuell schneller aufheben, wenn du uns einen Inhabernachweis für das Bank- oder PayPal-Konto schickst. Als Nachweis kann ein Kontoauszug oder ein Schreiben einer Bank auf offiziellem Briefpapier beziehungsweise ein Screenshot von PayPal dienen.

Permalink

Wenn du Administrator des Kontos bist, kannst du das mit deinem Konto verknüpfte Finanzinstitut in deinem Business Manager Dashboard einsehen. Falls du als Finanzkontoadministrator hinzugefügt werden möchtest, wende dich an einen aktuellen Administrator deines Unternehmens. Sobald Ihr Facebook-Freunde seid, kannst du auf der Facebook Developers Site direkt hinzugefügt werden.

Permalink

Verwende bitte unser Formular Support für Zahlungen für Monetisierer und wähle dann Game / App (Entwickler) > Kontodaten aktualisieren > Das meiner App oder meiner Facebook-Seite zugewiesene Unternehmen ändern.

Permalink

Verwende unser Formular Support für Facebook-Zahlungen für Monetisierer und wähle dann Game / App (Entwickler) > Kontodaten aktualisieren > Das meiner App oder meiner Facebook-Seite zugewiesene Unternehmen ändern.

Permalink

Falls du Apps entwickelt hast, die Facebook-Zahlungen und Abonnementfunktionen verwenden, kannst du mit der Berichtsfunktion von Facebook-Zahlungen eine vollständige Aufschlüsselung deiner Rückerstattungen und Ausgleichsbuchungen abrufen. Eine vollständige Anleitung findest du auf unserer Seite Zahlungsberichte.

Permalink

Wir haben kein Benachrichtigungssystem, aber wir fügen Rückerstattungsinformationen in die Überweisungs-PDF ein, die wir jeden Monat versenden.

Permalink

Die Rückerstattungen werden monatlich gezahlt, aber die Auszahlungsfrist beträgt 60 Tage, d. h. die Auszahlungsaktivitäten des Monats Januar werden im März ausgezahlt.

Permalink

Jeder Spieler kann über die Einstellungen und insbesondere im Bereich Zahlungen darauf zugreifen. Empfehle deinen Spielern, mehr über Facebook-Zahlungen zu erfahren.

Permalink

Veröffentlichen eines Spiels

Allgemeine Informationen

So beschränkst du den Zugriff auf das Spiel auf eine benutzerdefinierte Liste an Ländern:

  1. Gehe im Dashboard der Anwendung zu Einstellungen/Erweitert.
  2. Aktiviere Landesbeschränkung.
  3. Wähle Länder unter Zugelassene Länder aus.
  4. Klicke auf Änderungen speichern.
Permalink

Wenn du ein Instant Game zum App Review einreichst, musst du gemäß den App Store Review Guidelines von Apple eine Apple Developer Team-ID angeben. Dadurch kann dein Spiel auf iOS bereitgestellt werden. Wenn du eine ungültige oder abgelaufene Developer Team-ID verwendest, wird dein Spiel möglicherweise entfernt.

Du kannst deine Team-ID finden, indem du dich in dein Apple Entwicklerkonto einloggst.

Permalink

Spiele von Entwicklern sind auf eine Einreichung/einen Start pro Woche begrenzt. Zwei Spiele kannst du über einen Zeitraum von zwei Wochen einreichen und veröffentlichen. Pro Woche kann ein Spiel von Facebook geprüft werden. Nach der Prüfung und Genehmigung kann das Spiel – ebenfalls eins pro Woche – veröffentlicht werden. Diese Grenze haben wir eingeführt, um dir beim Start deiner Spiele mehr Erfolg zu verschaffen.

Weitere Informationen zum Prüfprozess findest du im Abschnitt Einreichen zum Überprüfen in der Checkliste für den Launch.

Permalink

Überprüfungsprozess

Über den Tab Überprüfung im Entwickler-Dashboard kannst du dein Spiel an unser Überprüfungsteam einreichen.

Du musst dein Spiel für die folgenden Überprüfungen einreichen:

  1. Instant-Spiele
  2. In-App-Käufe
  3. Pages_messaging (für Bots)

Du brauchst einen Monetization Manager, um dein Spiel für die folgende Überprüfung einzureichen:

  1. Audience Network Werbeanzeigenmonetisierung.
Permalink

Bevor du dein Spiel zur IAP-Prüfung einreichst, muss die App für das Audience Network freigegeben werden.

Mehr zum Thema Einreichen deiner App zur Überprüfung.

Permalink

In der Regel benötigt unser Developer Operation Team weniger als eine Woche zur Bearbeitung deiner Einreichung.

Permalink

Der Zweck jeder Überprüfung ist es, sicherzustellen, dass die Qualitäts- und Integritätsstandards für das Onboarding auf der Instant Games-Plattform eingehalten werden.

Insbesondere prüfen wir Spiele auf die Einhaltung der Funktionalität und der Plattformrichtlinien.

Bevor du etwas zur Überprüfung einreichst, solltest du die Freigaberichtlinien überprüfen.

Permalink

Wenn für deine aktuelle Einreichung zusätzliche Informationen erforderlich sind, hast du 30 Tage nach Erhalt der Anfrage Zeit, auf diese zu reagieren und zur Überprüfung erneut einzureichen. Wenn für deine aktuelle Einreichung zusätzliche Informationen erforderlich sind, hast du 30 Tage nach Erhalt der Anfrage Zeit, auf diese zu reagieren und zur Überprüfung erneut einzureichen. Während dieser 30 Tage erhältst du vom App-Review-Team möglicherweise weitere Anfragen für zusätzliche Informationen. Während dieser 30 Tage erhältst du vom App-Review-Team möglicherweise weitere Anfragen für zusätzliche Informationen. Bitte beachte, dass das 30-Tage-Fenster in diesem Zeitraum nicht bei jeder Wiedervorlage zurückgesetzt wird.Bitte beachte, dass das 30-Tage-Fenster in diesem Zeitraum nicht bei jeder Wiedervorlage zurückgesetzt wird.

Permalink

Unser Überprüfungsteam testet die Facebook-Integrationen deiner App anhand deiner Anweisungen.

Wenn du der Ansicht bist, dass unser Überprüfer deine App fälschlicherweise abgelehnt hat, solltest du deine App erneut mit überarbeiteten Anweisungen, die mehr Informationen für den Überprüfer enthalten, einreichen.

Der Überprüfungsvorgang ist am besten geeignet, um mit deinem Überprüfer zu kommunizieren. Reiche dabei deine bearbeiteten Hinweise ein, um auf das erhaltene Feedback einzugehen.

Permalink

Die für dein Instant Game erstellte Facebook-App-ID kann nicht für eine andere Plattform verwendet werden. Weitere Informationen erhältst du in unserer Dokumentation.

Permalink

Bei einem App Review müssen eingereichte Spiele mit einem (geprüften oder ungeprüften) Unternehmen verknüpft sein.

Bei welt- und landesweiten Starts muss das mit der App verknüpfte Unternehmen daraufhin überprüft werden, ob das Spiel in unseren Übersichten (Spielelisten usw.) eingetragen wurde. Das Spiel kann nach der Überprüfung und Genehmigung weiter gespielt werden.

Zum Bestätigen eines Unternehmens musst du Einen Business Manager erstellen. Weitere Informationen zur Unternehmensbestätigung findest du hier.

Permalink

Du kannst jederzeit den Status der Geschäftsverifizierung und der Verträge und Schritte finden, die du im Bereich für die Unternehmensbestätigung im Tab „App Review“ des App-Dashboards vornehmen kannst. Wir senden dir während des gesamten Prozesses Benachrichtigungen, damit du weißt, welche Maßnahmen erforderlich sind.

Permalink

Wenn du bereits ein Business Manager-Konto hast, empfehlen wir dir, die App mit dem bestehenden Business Manager zu verbinden.

Wenn es mehrere Business Manager-Konten gibt, die zum Business gehören, empfehlen wir, die Gründe für mehrere Business Manager-Konten zu ermitteln und die App mit dem am besten geeigneten Business Manager abzustimmen. Wenn das Business über einen über den Business Manager eingerichteten Kreditrahmen verfügt, empfehlen wir, die App mit demjenigen zu verbinden, der über den Kreditrahmen verfügt.

Permalink