Évènements d’application Meta

Démarrer – Unity

Ce guide vous indique comment ajouter des évènements d’application à votre application nouvelle ou existante à l’aide du SDK Facebook Unity.

Avant de commencer

Consigner les lancements de l’application

Le SDK fournit l’assistant FB.ActivateApp pour consigner les lancements de l’application. Vous devez initialiser le SDK avec FB.Init avant de pouvoir appeler FB.ActivateApp.

Utilisez la fonction Awake du MonoBehavior pour consigner tout lancement de votre application.

void Awake ()
{
  if (FB.IsInitialized) {
    FB.ActivateApp();
  } else {
    //Handle FB.Init
    FB.Init( () => {
      FB.ActivateApp();
    });
  }
}

Utilisez la fonction OnApplicationPause du MonoBehavior pour consigner le moment où une personne revient dans votre application.

// Unity will call OnApplicationPause(false) when an app is resumed
// from the background
void OnApplicationPause (bool pauseStatus)
{
  // Check the pauseStatus to see if we are in the foreground
  // or background
  if (!pauseStatus) {
    //app resume
    if (FB.IsInitialized) {
      FB.ActivateApp();
    } else {
      //Handle FB.Init
      FB.Init( () => {
        FB.ActivateApp();
      });
    }
  }
}

Consigner manuellement les évènements

Les exemples de code suivants montrent comment consigner manuellement les évènements.

Consigner un achat intégré

Dans cet exemple, priceCurrency est une chaîne contenant le ISO code de trois lettres pour la devise utilisée, priceAmount est un float contenant le prix de l’article acheté et packageName est une chaîne contenant votre SKU code pour l’article acheté.

var iapParameters = new Dictionary<string, object>();
iapParameters["mygame_packagename"] = packageName;
FB.LogPurchase(
  priceAmount,
  priceCurrency,
  iapParameters
);

Suivre un évènement dans un jeu

Dans le deuxième exemple, nous suivons le nombre de crédits qu’une personne a dépensés dans un jeu. numGold est un storeItem contenant le nombre de crédits dépensés et float est une chaîne contenant le nom de l’article acheté.

var softPurchaseParameters = new Dictionary<string, object>();
softPurchaseParameters["mygame_purchased_item"] = storeItem;
FB.LogAppEvent(
  Facebook.Unity.AppEventName.SpentCredits,
  (float)numGold,
  softPurchaseParameters
);

Désactiver les évènements automatiquement consignés

Après avoir intégré le SDK Facebook, certains évènements d’application sont automatiquement consignés et collectés pour le Gestionnaire d’évènements, à moins que vous ne désactiviez la consignation automatique des évènements d’application. Vous pouvez effectuer ce changement dans le code de votre application ou en sélectionnant l’option correspondante sous Gestionnaire d’évènements dans Espace App, ou dans le Gestionnaire d’évènements. Si l’option sélectionnée et la valeur de l’indicateur AutoLogAppEventsEnabled ne correspondent pas, nous appliquerons l’option sélectionnée pour « Consignation automatique des évènements pour le SDK Facebook ». Pour en savoir plus sur les informations collectées et sur la façon de désactiver la consignation automatique des évènements d’application, consultez la page Consignation automatique des évènements d’application.

Par défaut, notre SDK Unity active les évènements automatiquement consignés. Pour désactiver ou activer la consignation automatique des évènements, accédez à Facebook -> Modifier les paramètres dans la barre de menu d’Unity IDE et sélectionnez ou désélectionnez l’option Consignation automatique des évènements d’application dans la section Paramètres des évènements d’application.

Vous pouvez désactiver les évènements consignés automatiquement par programmation en définissant la méthode SetAutoLogAppEventsEnabled() de Fb.Mobile sur false.

FB.Mobile.SetAutoLogAppEventsEnabled(false);

Si, dans certains cas, vous souhaitez réactiver la consignation automatique après avoir obtenu l’accord de la personne concernée, définissez la méthode SetAutoLogAppEventsEnabled() sur true.

FB.Mobile.SetAutoLogAppEventsEnabled(true);

Désactiver la collecte des ID d’annonceur

Par défaut, notre SDK active la collecte des ID d’annonceur. Pour activer ou désactiver la collecte des ID d’annonceur, accédez à Facebook -> Modifier les paramètres dans la barre de menu d’Unity IDE, puis sélectionnez ou désélectionnez l’option Collecte des ID des annonceurs dans la section Paramètres des évènements d’application.

Vous pouvez désactiver la collecte des ID d’annonceur par programmation en définissant la méthode SetAdvertiserIDCollectionEnabled () de Fb.Mobile sur false.

FB.Mobile.SetAdvertiserIDCollectionEnabled (false);

Si, dans certains cas, vous souhaitez réactiver la collecte des ID d’annonceur après avoir obtenu l’accord de la personne concernée, définissez la méthode SetAdvertiserIDCollectionEnabled() sur true.

FB.Mobile.SetAdvertiserIDCollectionEnabled (true);

En savoir plus