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.

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.

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

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.

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

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

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.

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

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.

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.

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.

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.

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

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.

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.

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.

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

Monetarisieren eines Spiels

Werbung

Zahlungen

Onboarding mit Facebook

To update your payment information:

  1. Go to the Facebook Developers site.
  2. Click My Apps and select Audience Network or Developer tab.
  3. Click the Payout tab.
  4. Select an existing Payout method or create a new one.

We can issue payouts to your bank or PayPal account (does not apply to Audience Netowrk users).

Voraussetzungen:

  • Informationen zum Auszahlungskonto (Adresse, Steuerart, Steuer-ID)
  • Informationen zum Inhaber (Name, Adresse, Geburtsdatum)
  • Bankdaten (Name der Bank, Kontonummer oder IBAN, Land, SWIFT-Code oder Bankleitzahl)
  • PayPal-Informationen (PayPal-E-Mail, Land, Händler-ID)

Government agencies use tax ID numbers to identify both individuals and businesses when assessing any taxes required by law. Where you live and how your run your business factors into which tax ID numbers you'll need.

  • If you represent a business in the United States or European Union, you'll need to provide a federal employer identification number (FEIN) or a value-added tax identification number (VAT.)
  • If you run your business individually as a sole proprietorship, you'll need to provide a social security number (SSN) or other tax identification (ex: country ID or passport number.)
  • If you live outside of the United States and European Union, you'll need to provide an applicable identification number issued by a government agency. This number should not only uniquely identify you or your business, but it should also be associated with your Audience Network Account.

Auszahlungskonto-Administratoren können Unternehmens- und Finanzdaten bearbeiten, während App- und Seitenadministratoren zwar Zugriff auf Funktionen auf App- und Seitenebene haben, jedoch keine finanziellen Informationen bearbeiten können.

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

Verwendung von Informationen zu Auszahlungskonten

To update your payout account and financial information, you must be the Financial Admin of your payout account.To update your account information:

  • Go to the Facebook Developers site.
  • Click your profile photo in the top right corner and select Company Settings.
  • Choose the appropriate tab to update your company or financial info. Scroll to the bottom and click Save Changes.

Please note, it may take a few days to finalize any changes you make to your company or financial information. Additionally, your ability to receive your payout may be affected if you edit any info before a payment is scheduled.

You must be the Financial Admin of your payout account to modify or add new users. To update or add someone as an admin:

  1. Visit the Facebook Developers site.
  2. Click your profile photo in the top right corner and select Company Settings.
  3. Click Admins.
  4. Enter the name of the new admin and then click Save Changes.

Facebook nimmt Zahlungen nur in US-Dollar (USD) vor. Wenn ein Zwischen- oder Korrespondenzkonto erforderlich ist, damit deine Bank Zahlungen in US-Dollar empfangen kann, gib bitte auch folgende Informationen an:

  • Name der Zwischenbank
  • Land der Zwischenbank
  • SWIFT-Code der Zwischenbank

Auszahlungsstatus

Facebook issues payments twice a month:

  1. A payment for activity between the 1st through 15th of the month.
  2. A payment for activity between the 16th and the end of the month.
  3. A payment for Google Play from two months ago.

Facebook will issue payments approximately 21 days after each bi-monthly period. Visit the Facebook Developer Payments Terms for more information.

Google Play payments will be made approximately 45 days after each monthly period.

To check the status of your payment:

  1. Visit the Facebook Developers Site.
  2. Click the Audience Network tab.
  3. Click the Payout tab.
  4. Select Payment Reports to view your app's payments status.

If the status shows "Rejected/Pending Payment", please confirm that your Payout Account Detail Information is accurate. Additionally, you can also contact us by clicking on the "Need Help?" button within the Audience Network Dashboard for further information.

Auf einer Rechnung werden deine Einnahmen im Laufe eines Monats angezeigt. Die Rechnung für dein Konto wird vor der Auszahlung von unserer Finanzabteilung erstellt. Bei der Kontonummer auf dieser Rechnung handelt es sich um eine interne Nummer für unsere Aufzeichnungen.

Ein Überweisungsbeleg zeigt den von Facebook an dein Konto gezahlten Betrag für einen Monat an. Wenn unsere Bank die Zahlung an dein Bankkonto einleitet, erhältst du etwa in der dritten Woche des Monats einen Überweisungsbeleg.

You can view your daily reports and payout reports to calculate your current balance by using our payments API. You can download daily reports for the previous 45 days. For details, see Payments Reports.

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.

Zahlungen werden an dein verknüpftes Konto überwiesen, wenn du mindestens 100 US-Dollar eingenommen hast. Wenn dein Zahlungsstand in einem Zahlungszeitraum unter 100 US-Dollar liegt, wird die Zahlung auf den nächsten Auszahlungszyklus übertragen. Der Übertrag erfolgt so lange, bis dein Zahlungsstand 100 US-Dollar erreicht.

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.

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.

Privatsphäre und Sicherheit

To verify you're the Financial Admin of your payout account, please visit the Facebook Developers site.

Wir bei Facebook wissen dein Vertrauen sehr zu schätzen und ergreifen die notwendigen Maßnahmen, um unberechtigten Zugriff auf deine Daten zu verhindern. Wir speichern deine Finanzdaten auf gesicherten Servern und unternehmen besondere Schritte, um diese Daten vor Hackern zu schützen.

Es kann zwar vorkommen, dass wir deine Kontaktdaten oder andere Profilinformationen gemäß unserer Datenrichtlinie teilen, es werden aber keine Bank- oder PayPal-Daten geteilt. Diese teilen wir ausschließlich, wenn es zum Tätigen von Zahlungen oder Einhalten gesetzlicher Bestimmungen erforderlich ist.

Facebook kann deine Informationen speichern, damit du sie bei künftigen Auszahlungen nicht erneut eingeben musst. Solltest du darüber hinaus Änderungen an deinen Zahlungsinformationen beantragen, können wir bestimmte Nachweise zu diesen Änderungen (wie Bankinformationen) beibehalten.

Wenn du Probleme oder Fragen zu Zahlungen hast, nimm Kontakt mit uns auf. Wir arbeiten dann zusammen mit dir an der Lösung des Problems.


Anfordern von Hilfe zu Zahlungen

Wenn du deine Zahlung nicht bis zum 21. des Monats erhalten hast, überprüfe bitte Folgendes, bevor du dich an den Support wendest:

  1. Stelle sicher, dass du mindestens 100 $ eingenommen hast.
  2. Wende dich an deine Bank, um sicherzustellen, dass die Zahlung nicht abgewiesen wurde und dass dein Bankkonto Zahlungen in US-Dollar empfangen kann.
  3. Überprüfe die Informationen zu deinem Auszahlungskonto, um zu bestätigen, dass diese korrekt sind.

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.

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.

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.

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.

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.

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

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.

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

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.

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.

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.


Ü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.

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.

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

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.

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.

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.

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.

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.

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.

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.