Évènements d’application sans code

Les évènements d’application sans code, introduits dans la version 4.34, vous permettent d’utiliser le Gestionnaire d’évènements pour ajouter ou supprimer des évènements d’application sans mettre en œuvre de code ni lancer une nouvelle version de votre application.

Android

Conditions requises

Vous devez disposer de l’une des versions suivantes :

• SDK Facebook pour Android - Version intégrale v4.34 ou ultérieure
• SDK Facebook pour Android - Version Core v4.38 ou ultérieure
• SDK Facebook pour Android - Version Core v4.34 à 4.37, plus le kit Marketing

N’hésitez pas à consulter le guide de prise en main des évènements d’application pour Android pour installer la dernière version du SDK Facebook pour Android et le guide de mise à niveau pour passer à la version la plus récente du SDK. De même, si vous avez installé une version entre la 4.34 et la 4.37, ajoutez le kit Marketing en ouvrant <your_app> | Gradle Scripts | build.gradle (Module: app) et en ajoutant le code suivant à la section dependencies{}.

implementation 'com.facebook.android:facebook-marketing:[4,5)' 

N’oubliez pas de reconstruire votre projet.

Mettre en œuvre la fonctionnalité d’évènements d’application sans code

Pour activer l’évènement de débogage sans code, ajoutez les lignes suivantes dans AndroidManifest.xml :

<meta-data
    android:name="com.facebook.sdk.CodelessDebugLogEnabled"
    android:value="true" />

Ajouter vos évènements d’application

Rendez-vous dans le Gestionnaire d’évènements pour ajouter sans code les évènements d’application que vous voulez suivre.

1. Dans le Gestionnaire d’évènements, cliquez sur Ajouter une source de données, puis sélectionnez Évènements d’application dans le menu déroulant.
2. Cliquez sur Utiliser notre outil de configuration d’évènement sans code, puis sélectionnez l’application pour laquelle vous souhaitez ajouter des évènements.
3. Choisissez la plateforme en cliquant sur Démarrer la configuration.
4. S’il s’agit de votre première utilisation du processus sans code, un petit tutoriel apparaîtra. Après l’affichage du tutoriel, ouvrez une nouvelle session de l’application sur votre appareil mobile.
5. Secouez votre téléphone jusqu’à ce qu’une version de votre application apparaisse.
6. Cliquez sur un élément au choix pour ajouter un évènement d’application. Parcourez les différentes pages de votre application pour en sélectionner des éléments.
7. Cliquez sur Enregistrer dans le menu contextuel ou sur Annuler pour ne pas ajouter l’évènement.
8. Une fois tous les évènements ajoutés, cliquez sur Examiner et terminer.
9. Cliquez sur Tester les évènements ou sur Enregistrer et quitter.

Remarque : jusqu’à 30 minutes sont parfois nécessaires avant que les évènements apparaissent dans votre Gestionnaire d’évènements.

Vérifier votre intégration

Rendez-vous dans l’Assistant publicitaire des apps.

• Sélectionnez une application et cliquez sur Soumettre.
• Faites défiler l’écran vers le bas jusqu’à la section Outils pour les développeur·euses, puis cliquez sur Tester les évènements d’application.
• Si votre application envoie des évènements fb_codeless_debug, les évènements de test que vous avez sélectionnés figureront dans le tableau.

Remarque : cela ne fonctionne que pour le SDK Facebook v4.35 et versions ultérieures.

iOS

Conditions requises

• SDK Facebook complet pour iOS - version 4.34 à v7.1.1
• SDK Facebook Core pour iOS - version 4.38 à v7.1.1
• SDK Facebook Core pour iOS, version 4.34 - 4.37 à 7.1.1, plus le kit Marketing

Limites

• Cette fonctionnalité n’est pas disponible dans les versions 8.0.0 et ultérieures. En savoir plus

N’hésitez pas à consulter le guide de prise en main des évènements d’application pour iOS pour installer la dernière version du SDK pour iOS et le guide de mise à niveau pour passer à la version la plus récente du SDK. De même, si vous avez installé une version entre la 4.34 et la 4.37 du SDK Core uniquement, ajoutez le kit Marketing en insérant le code suivant à votre Podfile.

pod 'FBSDKMarketingKit' 

N’oubliez pas d’exécuter pod update, puis pod install --repo-update.

Mettre en œuvre la fonctionnalité d’évènements d’application sans code

Activez la consignation des évènements de débogage sans code en ouvrant le fichier .plist de l’application en tant que code dans Xcode et ajoutez l’extrait XML suivant au dictionnaire de propriétés :

<key>FacebookCodelessDebugLogEnabled</key>
<true/>

Ajouter vos évènements d’application

Rendez-vous dans le Gestionnaire d’évènements pour ajouter sans code les évènements d’application que vous voulez suivre.

1. Dans le Gestionnaire d’évènements, cliquez sur Ajouter une source de données, puis sélectionnez Évènements d’application dans le menu déroulant.
2. Cliquez sur Utiliser notre outil de configuration d’évènement sans code, puis sélectionnez l’application pour laquelle vous souhaitez ajouter des évènements.
3. Choisissez la plateforme en cliquant sur Démarrer la configuration.
4. S’il s’agit de votre première utilisation du processus sans code, un petit tutoriel apparaîtra. Après l’affichage du tutoriel, ouvrez une nouvelle session de l’application sur votre appareil mobile.
5. Secouez votre téléphone jusqu’à ce qu’une version de votre application apparaisse.
6. Cliquez sur un élément au choix pour ajouter un évènement d’application. Parcourez les différentes pages de votre application pour en sélectionner des éléments.
7. Cliquez sur Enregistrer dans le menu contextuel ou sur Annuler pour ne pas ajouter l’évènement.
8. Une fois tous les évènements ajoutés, cliquez sur Examiner et terminer.
9. Cliquez sur Tester les évènements ou sur Enregistrer et quitter.

Remarque : jusqu’à 30 minutes sont parfois nécessaires avant que les évènements apparaissent dans votre Gestionnaire d’évènements.

Vérifier votre intégration

Rendez-vous dans l’Assistant publicitaire des apps.

• Sélectionnez une application et cliquez sur Soumettre.
• Rendez-vous en bas de la page et choisissez Testeur d’évènements d’application.
• Si votre application envoie des évènements fb_codeless_debug, ils figureront dans le tableau.

Unity

Nous vous demandons d’utiliser le SDK Facebook pour Unity version 4.34 ou ultérieure.

Consultez le guide de prise en main du SDK Facebook pour Unity pour installer la dernière version du SDK Facebook pour Unity, puis suivez les paramètres spécifiques à la plateforme pour Unity iOS ou Unity Android.

Activer les évènements d’application sans code

Pour activer cette option, allez dans Unity Editor, sélectionnez Facebook | Edit Settings, puis Auto Logging App Events :

Ajouter des évènements d’application

À ce stade, vous pouvez ajouter des évènements d’application avec le Gestionnaire d’évènements :

1. Sous Add Data Source, sélectionnez App Events.

2. Cliquez sur User our codeless event setup tool.

3. Sélectionnez l’application à laquelle vous souhaitez ajouter des évènements.

4. Cliquez sur Start Setup pour sélectionner la plateforme. S’il s’agit de votre première utilisation du processus sans code, un petit tutoriel s’affichera.

5. Après l’affichage du tutoriel, ouvrez une nouvelle session de l’application sur votre appareil mobile.

6. Secouez votre appareil mobile jusqu’à ce qu’une version de votre application apparaisse.

7. Cliquez sur un élément au choix dans votre application pour ajouter un évènement d’application. Parcourez les différentes pages de votre application pour en sélectionner des éléments.

8. Dans Unity Editor, cliquez sur Save pour enregistrer l’évènement.

9. Une fois tous les évènements ajoutés, cliquez sur Review and Finish.

10. Cliquez sur Test Events ou sur Save and Exit.

Jusqu’à 30 minutes sont parfois nécessaire pour que les évènements apparaissent dans votre Gestionnaire d’évènements. Répétez cette procédure pour chacune des plateformes (par exemple, iOS ou Android) de votre jeu.

Vérifier votre intégration

Rendez-vous dans l’Assistant publicitaire des apps.

• Sous Select an App, cliquez sur Submit.

• Choisissez App Events Tester.

• Si votre application envoie des évènements fb_codeless_debug, ils figureront dans le tableau.

Questions/réponses

GÉNÉRALITÉS

Android

Android SDK build Error:Execution failed for task ':app:processDebugManifest'.> Manifest merger failed : 
Attribute activity#com.facebook.FacebookActivity@theme value=(@android:style/Theme.Translucent.NoTitleBar) 
from AndroidManifest.xml:69:13-72is also present at [com.facebook.android:facebook-android-sdk:4.16.0] 
AndroidManifest.xml:32:13-63 value=(@style/com_facebook_activity_theme).Suggestion: add
'tools:replace="android:theme"' to <activity> element at AndroidManifest.xml:66:9-70:47 to override.

<manifest>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>

<activity>
  ...
  tools:replace="android:theme"
  ...
</activity>

iOS

[!] Unable to find a specification for FBSDKMarketingKit