Premiers pas avec les évènements d’application (Android)

Ce guide vous indique comment ajouter des évènements d’application à votre application nouvelle ou existante en intégrant le SDK Facebook avant de consigner ces évènements.

Avant de commencer

Vous aurez besoin des éléments suivants :

• Un compte de développeur·se Meta
• Un ID d’application Meta
• Un compte publicitaire associé à votre application
• Le SDK Facebook pour Android implémenté

Ajouter des évènements d’application

Les évènements sont suivis de trois manières dans votre application :

• Évènements automatiquement consignés : les installations d’application, les lancements et les achats intégrés sont automatiquement consignés avec le SDK Facebook.
• Outil App Events sans code : cet outil permet d’ajouter des évènements standard sans ajouter de code à votre application.
• Évènements consignés manuellement : vous pouvez ajouter du code à votre application pour suivre les évènements standard et personnalisés.

Évènements automatiquement consignés

Lorsque vous utilisez le SDK Facebook, certains évènements de votre application sont automatiquement consignés et collectés pour Facebook, à moins que vous ne désactiviez la consignation automatique des évènements. Ces évènements sont pertinents pour tous les cas d’utilisation : ciblage, mesure et optimisation. Trois évènements clés sont collectés dans le cadre de la consignation automatique des évènements d’application : les installations d’app, les lancements d’applications et les achats. Lorsque la consignation automatique est activée, les annonceurs peuvent désactiver ces évènements, ainsi que d’autres évènements Facebook internes, tels que l’impression de connexion. Toutefois, si vous avez désactivé la consignation automatique, mais souhaitez toujours consigner des évènements spécifiques, tels que les installations et les achats, implémentez manuellement leur consignation dans votre application.

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
           android:value="false"/>
  ...
</application>

setAutoLogAppEventsEnabled(true);

setAutoLogAppEventsEnabled(false);

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AutoInitEnabled"
           android:value="false"/>
  ...
</application>

FacebookSdk.setAutoInitEnabled(true)
FacebookSdk.fullyInitialize()

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AdvertiserIDCollectionEnabled"
           android:value="false"/>
  ...
</application>

setAdvertiserIDCollectionEnabled(true);

setAdvertiserIDCollectionEnabled(false);

AppEventsLogger logger = AppEventsLogger.newLogger(this);

logger.logEvent(AppEventsConstants.EVENT_NAME_X);

Bundle params = new Bundle();
params.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT, "[{\"id\": \"1234\", \"quantity\": 2}, {\"id\": \"5678\", \"quantity\": 1}]");

logger.logEvent(AppEventsConstants.EVENT_NAME_PURCHASE,
                54.23,
                params);
Bundle params = new Bundle();
params.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "HDFU-8452");

logger.logEvent(AppEventsConstants.EVENT_NAME_ADDED_TO_CART,
                54.23,
                params);

Pour enregistrer un évènement personnalisé, il suffit de passer le nom de l’évènement sous forme de chaîne. Cette fonction suppose que le logger est une instance d’AppEventsLogger et a été créé à l’aide de l’appel AppEventsLogger.newLogger().

public void logBattleTheMonsterEvent () {
    logger.logEvent("BattleTheMonster");
}

Paramètres d’évènement

Chacun de ces évènements peut être consigné avec valueToSum et un ensemble de 25 paramètres maximum. Ces derniers passent par un Bundle, dans lequel la clé conserve le nom du paramètre et sa valeur, à savoir une chaîne (String) ou une int. Si vous indiquez un autre type de valeur qui n’est pas conforme, tel que boolean, le SDK consigne un avertissement dans LogginBehavior.APP_EVENT.

Consultez le guide de référence des paramètres d’évènements standard pour les paramètres généralement utilisés avec des évènements standards. Ces paramètres sont destinés à servir de guide, mais vous pouvez également fournir vos propres paramètres. Votre application doit consigner les paramètres que vous souhaitez voir répartis dans les statistiques.

N’utilisez pas « évènement » ou « event » comme nom de paramètre. Les paramètres personnalisés nommés ainsi ne seront pas consignés. Utilisez un autre nom ou ajoutez-y un préfixe ou un suffixe (par exemple my_custom_event).

Tester la consignation d’un évènement

L’Assistant publicitaire des apps vous permet de tester les évènements dans votre application pour vous assurer que cette dernière les envoie à Facebook.

1. Ouvrez l’Assistant publicitaire des apps.
2. Dans Sélectionner une application, choisissez votre application, puis Envoyer.
3. Faites défiler l’écran jusqu’au bas de la page et choisissez Tester App Events.
4. Lancez votre application et envoyez un évènement. L’évènement apparaît sur la page Web.

Activation des journaux de débogage

Activez les journaux de débogage pour vérifier l’utilisation d’App Event côté client. Les journaux de débogage contiennent les demandes et les réponses détaillées au format JSON. Activez les journaux de débogage en ajoutant le code suivant après avoir initialisé le SDK Facebook pour Android :

FacebookSdk.setIsDebugEnabled(true);
FacebookSdk.addLoggingBehavior(LoggingBehavior.APP_EVENTS);

Cette opération est uniquement destinée au débogage. Veuillez désactiver les journaux de débogage avant de déployer votre application pour le public.

En savoir plus

Pour plus d’informations et de conseils utiles sur App Events, consultez les ressources suivantes :

• Documentation de référence sur le SDK Facebook pour Android.
• Guide des recommandations pour visualiser un large éventail d’exemples d’applications et la façon dont chacune gère App Events.
• Questions/réponses pour consulter les questions fréquemment posées.
• Gestionnaire de publicités pour consulter les informations relatives à vos publicités.
• Gestionnaire d’évènements pour afficher des informations sur les évènements que vous suivez.
• Cours Meta Blueprint : Configurer le SDK et les évènements d’application pour Android
• Cours Meta Blueprint : Utiliser les évènements d’application pour cibler, optimiser et mesurer

Exemples d’applications

Nous avons créé des exemples pour les différents types d’applications afin de vous montrer comment utiliser les évènements d’application. Chaque exemple fournit une répartition écran par écran des différents évènements ainsi que des exemples de code. Notez que ces exemples sont un point de départ pour votre application et que vous devez donc les personnaliser.