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.

Permalink

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.

Permalink

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.

Permalink

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.

Permalink

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.

Permalink

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

Permalink

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

Permalink

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.

Permalink

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.

Permalink

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.

Permalink

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

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.

Permalink

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.

Permalink

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.

Permalink

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.

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

Monetizzazione di un gioco

Pubblicità

Pagamenti

Registrazione con Facebook

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

Permalink

Uso delle informazioni sull'account per i pagamenti

Stato del pagamento

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.

Permalink

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.

Permalink

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.

Permalink

Privacy e sicurezza


Assistenza per i pagamenti

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.

Permalink

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.

Permalink

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.

Permalink

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.

Permalink

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.

Permalink

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

Permalink

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.

Permalink

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

Permalink

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
Permalink

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.

Permalink

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.

Permalink

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

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.

Permalink

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

Permalink

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.

Permalink

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.

Permalink

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.

Permalink

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

Permalink

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.

Permalink

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.

Permalink

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.

Permalink