FAQ su Giochi istantanei

Risposte alle domande sullo sviluppo, sulla gestione e sulla monetizzazione di Giochi istantanei.

Informazioni generali

Accedi a Facebook.com e fai clic sul segnalibro Giochi a sinistra o visita https://www.facebook.com/games/instantgames.

Sviluppo di un gioco

Assicurati che la tua app sia nella categoria Giochi. Il prodotto Giochi istantanei non verrà visualizzato per le app esterne a questa categoria.

Sebbene non siano imposti limiti rigidi alle dimensioni del gioco, è consigliabile che il tempo di download iniziale non superi i 5 secondi. I bundle di giochi possono avere dimensioni fino a 200 MB, ma nel caricamento iniziale sono necessari solo i file necessari. Per maggiori dettagli, visita la nostra sezione Best practice.

Le opzioni disponibili per la memorizzazione delle tue informazioni sono diverse:

  1. Predisponi un back-end di terzi con cui il tuo gioco comunica tramite XMLHttpRequest, fetch, WebSocket o EventSource. Questa soluzione offre maggiore flessibilità ma comporta l'aumento dei costi di hosting che sono proporzionali al pubblico del tuo gioco.

  2. Usa le nostre soluzioni basate su SDK che abilitano diverse funzionalità lato server, già pronte all'uso. Per la memorizzazione di informazioni specifiche del giocatore, usa i nostri metodi player.getDataASync e player.setDataAsync. Per le classifiche, consulta la nostra guida all'API Leaderboard.

  3. Servizi di terzi come PlayFab forniscono piattaforme backend-as-a-service completamente multipiattaforma create per supportare LiveOps, matchmaking e analisi. Scopri altri strumenti.

I requisiti minimi di sistema per giocare ai giochi istantanei sono iOS 8 o Android 5.0.

Consulta la nostra Guida sui giochi leggeri per ulteriori informazioni.

Puoi segnalare i problemi direttamente sulla pagina Github Howler.js. Inserisci "[IG]" nel titolo del problema per aiutare gli sviluppatori ad assegnare le priorità.

Dovresti assicurarti di chiamare window.innerWidth e window.innerHeight dopo la risoluzione di FBInstant.startGameAsync().

Puoi usare (e modificare) i brani della raccolta audio di Facebook nei tuoi giochi. I contenuti della raccolta audio possono essere utilizzati solo sulla piattaforma Facebook, quindi qualsiasi versione del tuo gioco che incorpori i contenuti della raccolta audio può essere distribuita solo sulla nostra piattaforma.

Aggiunta di funzioni a un gioco

Il nostro metodo FBInstant.context.shareAsync() contiene un parametro intent che accetta valori quali 'INVITE', 'SHARE' e così via. A partire dalla versione 4.0, questo parametro non ha uno scopo specifico. È stato aggiunto per rendere l'SDK "a prova di futuro" e fornirà modifiche rivolte all'utente in futuro.

Quando stai sfidando un altro giocatore nel thread per la prima volta, non esiste un metodo SDK per recuperare informazioni sulla persona sfidata. È consigliabile utilizzare un nome segnaposto come "avversario" finché il secondo giocatore non risponde all'invito. Quando l'altro giocatore avrà accettato l'invito a giocare, puoi usare FBinstant.player per inserire immagine e nome.

Bot del gioco

La causa più comune per il mancato ricevimento dei webhook da parte di un bot è l'errata configurazione nell'app. Visita la pagina Configurazione del bot per una guida completa su come configurare il bot del tuo gioco.

Controlla la dashboard per gli sviluppatori per assicurarti:

  1. Di avere una Pagina dell'app configurata nella sezione dei giochi istantanei
  2. Di esserti iscritto per ricevere gli aggiornamenti nelle azioni messages e messaging_game_plays nella sezione Messenger
  3. La Pagina dell'app è configurata nel riquadro Pagine a cui è stata effettuata l'iscrizione nella sezione Messenger
  4. La tua Pagina deve essere della categoria Pagina dell'app e il nome deve contenere quello del gioco.

Se ricevi degli errori in risposta alle chiamate Send all'API Graph, si sta verificando una delle seguenti situazioni:

- Stai tentando di inviare messaggi oltre il limite di 5 messaggi per utente in 10 giorni

- Stai tentando di inviare messaggi a un utente che ha eliminato, bloccato o silenziato il tuo bot

- La tua app è in modalità sviluppo e stai tentando di inviare messaggi a un utente che non dispone del ruolo di amministratore o sviluppatore nell'app.

Per maggiori informazioni, consulta la documentazione dell'API Send.

Gestione dei dati

Le impostazioni dell'app Facebook consentono agli utenti di richiedere all'app di eliminare i dati che li riguardano acquisiti da Facebook.

In risposta alla richiesta dell'utente, devi confermare la ricezione di una richiesta di eliminazione di dati dell'utente attraverso i mezzi tecnici forniti e fornire un link e un numero di conferma. Il link e il numero di conferma devono consentire all'utente l'accesso a una spiegazione leggibile dallo stato della richiesta, compresa una giustificazione legittima per qualsiasi rifiuto all'eliminazione (dove il significato "legittima" può variare in base alla giurisdizione e alla nostra interpretazione caso per caso della nostra Normativa in relazione alle ragioni dichiarate).

Per analizzare e rispondere alla richiesta, devi implementare una callback di "richiesta eliminazione dati". La callback deve utilizzare il protocollo HTTPS sicuro e deve essere elencata nel campo URL richiesta eliminazione dati della pagina Giochi istantanei > Dettagli nella dashboard gestione app.

Risoluzione dei problemi

Se stai seguendo le guide di Avvio rapido o di Test, pubblicazione e condivisione, devi avere familiarità con il nostro concetto di strumento di riproduzione incorporato. Si tratta di un modo per testare il tuo gioco istantaneo in esecuzione da un servizio HTTP locale nel tuo computer, collegato a tutte le funzioni attive dell'SDK di Giochi istantanei.

A volte, quando provi questo approccio, il caricamento del gioco potrebbe bloccarsi. A volte non verrà visualizzato alcun messaggio nella console per sviluppatori del browser o verrà visualizzato il messaggio Failed to execute 'postMessage' on 'DOMWindow'. Questi derivano dallo stesso tipo di errore, più comunemente causato dal rifiuto del server locale di mostrare le risorse a causa di un problema con il certificato.

Se il caso è proprio questo, accedi alla cartella root del server locale (di solito https://localhost:8000 o https://127.0.0.1:8000) e segui le istruzioni del browser per accettare i certificati o per aggiungere un'eccezione di sicurezza per il sito Web. Dopo aver eseguito questa operazione, torna all'URL dello strumento di riproduzione incorporato e tutto dovrebbe funzionare normalmente.

Questo errore si verifica quando cerchi di caricare un'inserzione da un'AdInstance che ha già restituito errori in precedenza. Se il metodo loadAsync della tua AdInstance è già stato rifiutato una volta, non provare a riutilizzarlo. Piuttosto, richiedi una nuova AdInstance chiamando getInterstitialAsync o getRewardedVideoAsync.

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

Monetizzazione di un gioco

Pubblicità

Per maggiori informazioni, visita la nostra pagina Risorse aziendali.

Pagamenti

Registrazione con 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).

Ecco cosa ti servirà:

  • Informazioni sull'account per i pagamenti (indirizzo, tassazione, codice di identificazione fiscale)
  • Informazioni sul titolare (nome, indirizzo, data di nascita)
  • Informazioni bancarie (nome della banca, numero di conto o IBAN, paese, codice SWIFT o codice di avviamento bancario)
  • Informazioni PayPal (e-mail PayPal, paese, ID commerciante)

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.

Gli amministratori degli account per i pagamenti hanno la possibilità di modificare le informazioni aziendali e finanziarie, mentre gli amministratori di app e Pagine hanno accesso alle funzioni a livello di app e Pagina, ma non possono modificare le informazioni finanziarie.

I dettagli fiscali sono disponibili nella sezione 3.9 della pagina Termini di pagamento.

Uso delle informazioni sull'account per i pagamenti

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 invia solo pagamenti in dollari statunitensi (USD). Se la tua banca richiede un conto intermedio o corrispondente per ricevere pagamenti in USD, includi quanto segue:

  • Nome della banca intermediaria
  • Paese della banca intermediaria
  • Codice SWIFT della banca intermediaria

Stato del pagamento

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.

Una fattura indica i ricavi che hai ottenuto nel corso di un mese. La fattura del tuo account viene generata dal nostro team finanziario prima del pagamento. Il numero di conto su questa fattura è un numero interno per i nostri record.

Una dichiarazione di versamento indica l'importo pagato da Facebook sul tuo account per i ricavi che hai ottenuto nel corso di un mese. Quando la banca avvia il pagamento sul tuo conto corrente, ricevi una dichiarazione di versamento intorno alla terza settimana del mese.

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.

Ogni volta che completi una vendita sulla nostra piattaforma, Facebook accrediterà i proventi di tale vendita meno la nostra commissione di servizio sul tuo saldo sviluppatore. Facebook guadagnerà una commissione di servizio pari al 30%, più eventuali imposte di vendita o IVA applicabili, in relazione a ogni transazione Pagamenti Facebook completata sulla nostra piattaforma. Consulta i nostri Termini di pagamento per ulteriori dettagli.

I pagamenti vengono trasferiti sul tuo conto collegato quando raggiungi almeno 100 $ di ricavi. Se il tuo saldo di pagamento è inferiore a $ 100 per un determinato periodo di pagamento, il pagamento verrà trasferito al ciclo di pagamento successivo. Il trasferimento continuerà fino a quando il saldo del pagamento non raggiungerà $ 100.

Per problemi relativi ai pagamenti recenti, invia una richiesta tramite il modulo Supporto per i pagamenti di Facebook per i monetizzatori e seleziona Gioco / App (Sviluppatore) > Pagamenti > Ho una domanda su un mio pagamento recente.

Per domande relative a pagamenti e reporting, contatta il Supporto per i pagamenti di Facebook.

Inoltrare il problema o riaprire un ticket aggiuntivo complicherà la richiesta esistente inoltrata al nostro team dedicato alle operazioni di pagamento. Consigliamo vivamente a tutti i partner di canalizzare tutti i follow-up attraverso il canale di comunicazione esistente con il team dedicato alle operazioni di pagamento.

Privacy e sicurezza

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

Per Facebook è molto importante la fiducia che riponi in noi, pertanto agiamo nel modo necessario per impedire gli accessi non autorizzati ai tuoi dati. Le tue informazioni finanziarie vengono archiviate su server sicuri e vengono protette dagli hacker tramite l'adozione di misure aggiuntive.

Anche se potremmo condividere il tuo contatto o altre informazioni sul tuo profilo in base alla nostra normativa sui dati, nessuna informazione bancaria o inerente a PayPal verrà mai condivisa, tranne quando necessario per effettuare i pagamenti o per il rispetto dei requisiti legali.

Facebook potrebbe memorizzare i tuoi dati affinché tu non debba reinserirli per i pagamenti successivi. Inoltre, nel caso in cui dovessi richiedere modifiche alle tue informazioni di pagamento da parte di Facebook, potremmo conservare alcune prove a supporto di tali modifiche (es. i dati bancari).

In caso di problemi o domande sui pagamenti, comunicacelo e collaboreremo con te per risolvere il problema.


Assistenza per i pagamenti

Se non hai ricevuto il pagamento entro il 21 del mese, tieni presenti le seguenti indicazioni prima di contattare l'assistenza:

  1. Verifica di aver accumulato almeno 100 $ di ricavi.
  2. Contatta la tua banca per assicurarti che non abbia rifiutato il pagamento e che il tuo conto bancario possa ricevere pagamenti in USD.
  3. Controlla le informazioni sul tuo account per i pagamenti per verificare che siano accurate.

Se dovessi riscontrare problemi o avere domande riguardo al tuo account per i pagamenti, contattaci.

Se hai bisogno di aiuto per aggiornare le informazioni presenti nel tuo account, visita nostra pagina della guida ai pagamenti. Ogni volta che vengono aggiornate informazioni finanziarie, viene effettuata una sospensione di 10 giorni dell'account prima di elaborare un pagamento. Questa sospensione potrebbe essere rimossa più rapidamente se ci invii una prova della titolarità del conto bancario o su PayPal. Come prova, puoi inviarci un estratto conto bancario o una lettera della banca su carta intestata, oppure uno screenshot da PayPal.

Se sei l'amministratore dell'account, potrai visualizzare l'entità finanziaria associata al tuo account nella dashboard del Business Manager. Se desideri essere aggiunto come amministratore di un account finanziario, chiedi a un amministratore corrente della tua organizzazione. Dopo essere diventati amici su Facebook, potrà aggiungerti direttamente sul sito per gli sviluppatori di Facebook.

Consulta il modulo Supporto per i pagamenti di Facebook per i monetizzatori e seleziona Gioco / App (sviluppatore) > Aggiorna record account > Modifica l'organizzazione associata alla mia app o alla Pagina Facebook.

Consulta il modulo Supporto per i pagamenti di Facebook per i monetizzatori, quindi seleziona Gioco / App (sviluppatore) > Aggiorna record account > Modifica l'organizzazione associata alla mia app o alla Pagina Facebook.

Se hai sviluppato app che utilizzano i pagamenti e le funzionalità di abbonamento di Facebook, puoi ottenere dettagli completi delle attività di rimborso e chargeback utilizzando la funzione di reporting dei pagamenti di Facebook. Una guida completa può essere consultata nella pagina Report dei pagamenti.

Non è disponibile un sistema di notifica, ma le informazioni sui rimborsi sono incluse nel file .pdf delle rimesse inviato ogni mese.

I rimborsi vengono pagati mensilmente, ma il periodo di invio del pagamento è di 60 giorni, ovvero le attività di pagamento di gennaio saranno pagate a marzo.

Ogni giocatore può accedervi da Impostazioni, e in particolare nella sezione Pagamenti. Suggerisci ai giocatori di acquisire maggiori informazioni nei Pagamenti di Facebook.

Pubblicazione di un gioco

Informazioni generali

Per limitare l'accesso al gioco a un elenco personalizzato di Paesi:

  1. Nella dashboard dell'app, accedi a Impostazioni/Avanzate
  2. Abilita Limitazioni per Paese
  3. Seleziona i Paesi tramite lo strumento di selezione Paesi autorizzati.
  4. Clicca su Salva modifiche

Durante l'invio dell'analisi dell'app per il gioco istantaneo, devi fornire un ID del team di sviluppatori Apple, secondo le linee guida per l'analisi dell'App Store di Apple. Ciò rende possibile la distribuzione del tuo gioco su iOS. Un ID del team di sviluppatori non valido o scaduto potrebbe determinare la rimozione del tuo gioco.

Puoi trovare l'ID del team accedendo al tuo Account sviluppatore Apple.

Invii e lanci di giochi di sviluppatori sono limitati a uno a settimana. Puoi inviare e pubblicare due giochi nel corso di due settimane. Facebook può rivedere un gioco a settimana ed è possibile pubblicare un gioco a settimana, dopo che è stato rivisto e approvato. Abbiamo creato questo limite per aiutarti ad avere successo nel lancio del gioco.

Per maggiori informazioni sul processo di revisione, consulta la sezione Invio per l'analisi nell'Elenco di controllo di lancio.


Procedura di controllo

La tab Analisi della dashboard per sviluppatori ti consente di inviare il tuo gioco al nostro team preposto all'analisi.

Devi inviare il tuo gioco per le seguenti analisi:

  1. Giochi istantanei
  2. Acquisti nell'app
  3. Pages_messaging (per bot)

Hai bisogno della Gestione della monetizzazione per inviare il tuo gioco per:

  1. Monetizzazione delle inserzioni Audience Network.

Prima di inviare il tuo gioco per l'analisi IAP, l'app deve essere approvata per Audience Network.

Acquisisci maggiori informazioni riguardo all'invio della tua app per l'analisi.

Solitamente il nostro team Developer Operation impiega meno di una settimana per elaborare la richiesta.

Lo scopo di ogni analisi è garantire che siano soddisfatti gli standard di qualità e integrità per l'inclusione nella piattaforma dei giochi istantanei.

Nello specifico, controlliamo i giochi per garantire la conformità con la funzionalità e le Linee guida della Normativa della Piattaforma.

Prima di inviare per l'analisi, assicurati di controllare le Linee guida di rilascio.

Se per il tuo invio sono necessarie ulteriori informazioni, avrai 30 giorni dalla ricezione della richiesta per soddisfare i requisiti e inviare nuovamente per l'analisi. Durante questi 30 giorni, il team di analisi dell'app ti potrebbe chiedere di fornire ulteriori informazioni. La finestra di 30 giorni non si azzererà con eventuali nuovo invii eseguiti durante questo periodo.

Il nostro team di analisi userà le istruzioni che fornisci per testare le integrazioni della tua app con Facebook.

Se pensi che la tua app sia stata rifiutata per motivi sbagliati, effettua nuovamente l'invio con istruzioni aggiornate che forniscano maggiori informazioni a chi esegue l'analisi.

Il processo di analisi è il miglior modo per comunicare con chi effettua l'analisi, aggiornando le tue note secondo le indicazioni ricevute nell'esito.

L'ID app Facebook creato per il tuo gioco istantaneo non può essere usato per altre piattaforme. Puoi trovare maggiori informazioni nella nostra documentazione.

Per l'analisi dell'app, le presentazioni dei giochi devono essere collegate a un'azienda (verificata o non verificata).

Per i lanci globali e nazionali, è necessario verificare l'azienda collegata all'app per avviare il gioco nelle nostre superfici di scoperta (elenco di giochi, ecc.). Dopo l'approvazione dell'analisi, sarà ancora possibile riprodurre il gioco.

Per verificare la tua azienda, devi creare un Business Manager. Scopri di più sulla verifica aziendale qui.

Puoi sempre consultare lo stato della verifica aziendale, i contratti e i passaggi da eseguire nella tab della verifica aziendale che si trova nella tab di analisi dell'app della dashboard gestione app. Ti invieremo notifiche durante tutto il processo per comunicarti le azioni necessarie.

Se disponi già di un account Business Manager, ti consigliamo di connettere l'app al Business Manager esistente.

Se ci sono più account Business Manager appartenenti all'azienda, è consigliabile determinare la motivazione alla base dell'esistenza di più account Business Manager e di allineare l'app con il Business Manager più appropriato. Se l'azienda ha una linea di credito configurata tramite il Business Manager, è consigliabile connettere l'app con quello che ha la linea di credito.