Jeux sur Facebook

    Évènements d’application pour les Jeux sur Facebook

    Cette API App Events du SDK Facebook (JS) a été abandonnée et n’est plus prise en charge depuis le 1er juillet 2022. Nous n’avons pas prévu d’ajouter des fonctionnalités à ce produit. Au lieu d’utiliser FB.AppEvents.LogEvent, nous vous recommandons de transmettre ces évènements via le Pixel Meta.

    Les évènements d’application vous permettent de mesurer les performances publicitaires et de constituer des audiences pour le ciblage publicitaire de votre jeu sur Facebook.

    Pour ce faire, vous devez envoyer un évènement à partir de votre application par l’intermédiaire du SDK Facebook pour JavaScript. Vous pouvez choisir un évènement parmi les évènements prédéfinis, tels que « ajouté au panier » dans une application de commerce ou « niveau atteint » dans un jeu.

    Conditions requises

    Avant d’inclure le code permettant de mesurer des évènements, vous devez enregistrer votre application sur Facebook. Si vous n’avez pas encore enregistré votre application sur Facebook, vous pouvez le faire ici : Démarrage rapide pour les jeux sur Facebook.

    Implémentation

    Votre jeu sur Facebook doit déjà inclure le SDK Facebook pour JavaScript. Si ce n’est pas le cas, lisez notre guide de démarrage rapide pour JavaScript.

    Pour voir les évènements enregistrés, utilisez le Gestionnaire d’évènements Facebook.

    Consignation automatique des évènements

    Nous consignons automatiquement les évènements suivants pour les Jeux sur Facebook :

    • Installation d’app : lorsqu’une personne accepte les conditions de service de votre application pour la première fois.
    • Lancement d’app : chaque fois qu’une personne ouvre la page web contenant votre application.

    Si vous avez activé les paiements via Facebook, les évènements suivants sont également consignés :

    • Paiement initié : une personne lance le processus de paiement pour effectuer un achat.
    • Achat : une personne réalise un paiement dans votre application.
    • Achat annulé : une personne a annulé son paiement (inclut les annulations manuelles et les échecs de paiement).

    Remarque : l’évènement Achat annulé peut ne pas être consigné si la personne ferme sa fenêtre de navigateur au cours de l’achat. C’est pourquoi le nombre d’évènements Achat annulé ne correspond pas toujours à la différence entre les évènements Paiement initié et les évènements Achat.

    Pour voir les évènements enregistrés, utilisez le Gestionnaire d’évènements Facebook.

    Consignation d’évènements avec des paramètres

    Vous pouvez ajouter des informations aux évènements consignés automatiquement pour affiner la mesure des performances de votre application sur Facebook.com. Par exemple, vous pouvez enregistrer un évènement chaque fois qu’un joueur ou une joueuse termine un niveau dans votre jeu.

    Voici un exemple de code permettant de consigner un évènement avec un paramètre qui décrit l’évènement :

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

    Nous vous recommandons d’utiliser l’un des évènements prédéfinis. Cependant, nous vous offrons également la possibilité de consigner des évènements personnalisés.

    Vous pouvez utiliser jusqu’à 1 000 noms d’évènements différents. Remarque : aucun nouveau type d’évènement ne peut être consigné une fois cette limite atteinte. Si vous la dépassez, une erreur 100 Invalid parameter s’affichera lors de la consignation. Pour en savoir plus sur les limites des évènements, consultez les Questions/réponses.

    Consignation des achats

    Le SDK Facebook comprend une fonction dédiée pour consigner les achats, qui nécessite la spécification d’une devise.

    Les paiements effectués via les Jeux sur Facebook sont consignés automatiquement en tant qu’évènements d’achat. Le code suivant est requis uniquement pour la vente d’articles physiques.

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

    Pour utiliser les paramètres prédéfinis, créez l’objet params, puis passez-le à la fonction comme indiqué ci-dessous.

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

    Évènements d’application personnalisés

    Vous pouvez également choisir de créer vos propres évènements personnalisés, en précisant leur nom sous forme de chaîne :

    FB.AppEvents.logEvent('battledAnOrc');

    Le nom d’un évènement personnalisé ne doit pas dépasser 40 caractères et ne peut comprendre que des caractères alphanumériques, des traits de soulignement ou des traits d’union.

    Détection des exceptions

    Si vous appelez la fonction du SDK JavaScript fournie avec des paramètres incorrects, elle générera une exception. Veillez à ce que votre code passe les bons paramètres et détecte les exceptions générées, le cas échéant.

    Débugage

    Pour améliorer les performances, le SDK JavaScript est chargé dans un format réduit. Vous pouvez également charger une version débuguée du SDK JavaScript qui intègre plus de consignation et une vérification plus poussée des arguments, le tout dans un format non réduit. Pour ce faire, définissez la valeur js.src de votre code de chargement comme suit :

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

    Référence