Giochi su Facebook

    Eventi nell'app per Giochi su Facebook

    Questa API App Events dell'SDK di Facebook (JS) è stata dichiarata obsoleta e non è più supportata dal 1° luglio 2022. Non è prevista l'aggiunta di nuove funzioni a questo prodotto. Invece di usare FB.AppEvents.LogEvent, ti consigliamo di inviare questi eventi tramite il Pixel di Meta.

    Gli eventi nell'app permettono di misurare le prestazioni delle inserzioni e costruire gruppi di pubblico per la targetizzazione delle inserzioni per i tuoi Giochi su Facebook.

    Puoi farlo inviando un evento dalla tua app tramite l'SDK di Facebook per JavaScript. L'evento può essere uno degli eventi predefiniti, ad esempio "articolo aggiunto al carrello" in un'app di e-commerce o "livello raggiunto" in un gioco, oppure un evento personalizzato.

    Prerequisiti

    Prima di includere il codice per la misurazione degli eventi, devi registrare l'app con Facebook. Se non hai registrato l'app con Facebook, puoi farlo qui: Guida rapida ai Giochi su Facebook.

    Implementazione

    I tuoi Giochi su Facebook dovrebbero già includere l'SDK di Facebook per JavaScript. In caso contrario, leggi la nostra guida rapida a JavaScript.

    Puoi vedere gli eventi registrati usando Gestione eventi di Facebook.

    Registrazione automatica degli eventi

    Registriamo automaticamente i seguenti eventi per i Giochi su Facebook:

    • Installazione dell'app: la prima volta che una persona accetta le condizioni d'uso della tua app.
    • Avvio dell'app: ogni volta che una persona apre la pagina web che contiene la tua app.

    Se hai abilitato i pagamenti tramite Facebook, vengono registrati anche i seguenti eventi:

    • Inizio di acquisto: una persona avvia la procedura di pagamento per effettuare un acquisto.
    • Acquisto effettuato: una persona completa un pagamento nella tua app.
    • Acquisto annullato: una persona ha annullato il proprio pagamento (sono inclusi i pagamenti annullati manualmente e i tentativi non riusciti con il metodo di pagamento).

    Nota: un evento Acquisto annullato potrebbe non essere registrato se la persona chiude il browser durante la procedura di pagamento. Per questo motivo, gli eventi Acquisto annullato potrebbero non corrispondere alla differenza tra gli eventi Inizio di acquisto e quelli Acquisto effettuato.

    Puoi vedere gli eventi registrati usando Gestione eventi di Facebook.

    Registrazione di eventi con i parametri

    Puoi decidere se registrare informazioni aggiuntive oltre agli eventi registrati automaticamente per misurare meglio le prestazioni della tua app su Facebook.com. Ad esempio, potresti voler registrare un evento ogni volta che qualcuno completa un livello nel gioco.

    Ecco un esempio di come registrare un evento insieme a un parametro che lo descrive:

    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
);

    Consigliamo di usare uno degli eventi predefiniti. Tuttavia, supportiamo anche la registrazione di eventi personalizzati.

    È possibile attribuire massimo 1000 nomi diversi agli eventi. Nota: non saranno registrati nuovi tipi di evento una volta raggiunto questo tetto e, se superi questo limite, potresti visualizzare l'errore 100 Invalid parameter al momento della registrazione. Per scoprire di più sui limiti degli eventi, consulta la sezione FAQ.

    Registrazione degli acquisti

    L'SDK di Facebook include una funzione dedicata per registrare gli acquisti, per cui è necessario specificare una valuta.

    I pagamenti effettuati tramite i Giochi su Facebook vengono registrati automaticamente come eventi di acquisto. Il codice seguente è necessario solo per le vendite di articoli fisici.

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

    Per usare i parametri predefiniti, crea l'oggetto params e quindi passalo alla funzione come indicato di seguito.

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

    Eventi nell'app personalizzati

    Puoi anche creare eventi personalizzati specificandone il nome come stringa:

    FB.AppEvents.logEvent('battledAnOrc');

    La lunghezza massima del nome degli eventi personalizzati è 40 caratteri e dovrebbe includere solo caratteri alfanumerici, trattini o trattini bassi.

    Gestire le eccezioni

    Se effettui una chiamata alla funzione dell'SDK per JavaScript con parametri errati, la funzione genererà un'eccezione. Assicurati che il codice passi i parametri corretti e sia in grado di gestire eventuali eccezioni.

    Debug

    Per migliorare le prestazioni, l'SDK per JavaScript viene caricato minimizzato. Puoi anche caricare una versione di debug dell'SDK per JavaScript non minimizzato che include più opzioni di registrazione e una verifica più rigida degli argomenti. Per farlo, modifica il valore js.src nel codice di caricamento in:

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

    Riferimento