Démarrer avec les évènements d’application sur iOS

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 Facebook
• Un compte publicitaire Facebook
• Un portefeuille business Facebook (créez-en un si vous n’en avez pas encore)
• Une application Facebook

Étape 1 : Configurer votre application Facebook

Accédez à l’Espace App, cliquez sur Mes applications, puis créez une application si vous n’en avez pas déjà une. Cliquez sur Paramètres > Général pour accéder au panneau Détails de l’application comportant l’ID d’application, la clé secrète et d’autres informations sur votre application.

Faites défiler la page jusqu’en bas, puis cliquez sur Ajouter une plateforme. Choisissez iOS, ajoutez les détails de votre application, puis enregistrez vos modifications.

Configurez votre application pour la publicité, en ajoutant les informations suivantes :

• Domaines d’application : indiquez l’URL App Store de votre application.
• URL de la politique de confidentialité : indiquez l’URL de la politique de confidentialité. Doit être fournie pour rendre votre application publique.
• URL des conditions de service : indiquez l’URL des Conditions de service.
• Plateforme : faites défiler le panneau Paramètres jusqu’en bas pour ajouter la plateforme iOS.

Pour en savoir plus sur l’ajout d’informations à votre application, telles qu’une icône ou une catégorie, consultez les documents sur le développement d’applications.

Étape 2 : Associer votre compte publicitaire et vos portefeuilles business

Pour diffuser des publicités et mesurer les installations dans le Gestionnaire de publicités, vous devez associer au moins un compte publicitaire et un portefeuille business à votre application.

1. Dans l’Espace App, cliquez sur Paramètres > Avancés.
2. Dans ID des comptes publicitaires autorisés, ajoutez les ID de vos comptes publicitaires. Vous pouvez obtenir les ID de vos comptes publicitaires depuis le Gestionnaire de publicités.
3. Dans le panneau Comptes publicitaires, cliquez sur Démarrer et suivez les instructions pour associer l’application à une entreprise.

Étape 3 : Configurer votre environnement de développement

Dans la procédure suivante, Swift Package Manager est utilisé pour configurer votre environnement de développement dans Xcode.

1. Dans Xcode, cliquez sur File > Swift Packages > Add Package Dependency (Fichier > Packages Swift > Ajouter une dépendance de package).
2. Dans la boîte de dialogue qui s’affiche, saisissez l’URL de dépôt suivante : https://github.com/facebook/facebook-ios-sdk.
3. Dans Dependency Rule (Règle de dépendance), sélectionnez Up to Next Major Version (Jusqu’à la prochaine version majeure). La version la plus récente est indiquée sur la page https://github.com/facebook/facebook-ios-sdk/releases/.
4. Choisissez les bibliothèques que vous avez l’intention d’utiliser et les cibles que vous souhaitez ajouter à ces bibliothèques.
5. Cliquez sur Add Package (Ajouter un package) pour terminer votre configuration.

Étape 4 : Enregistrer et configurer votre application avec Facebook

Ajoutez l’identifiant de votre pack et activez l’authentification unique pour votre application.

Étape 5 : Configurer votre projet

Étape 6 : Associer votre App Delegate à votre Scene Delegate

    
// AppDelegate.swift
import UIKit
import FacebookCore

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {          
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )

        return true
    }
          
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {
        ApplicationDelegate.shared.application(
            app,
            open: url,
            sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
            annotation: options[UIApplication.OpenURLOptionsKey.annotation]
        )
    }  
}

// SceneDelegate.swift
import FacebookCore
  ...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }

    ApplicationDelegate.shared.application(
        UIApplication.shared,
        open: url,
        sourceApplication: nil,
        annotation: [UIApplication.OpenURLOptionsKey.annotation]
    )
}

Étape 7 : Ajouter des App Events

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

Obtenir le consentement de l’appareil

À partir d’iOS 14.5, vous devez définir isAdvertiserTrackingEnabled et procéder à la consignation chaque fois que vous autorisez un appareil à partager des données avec Facebook.

Si l’appareil accorde le consentement, définissez Settings.shared.isAdvertiserTrackingEnabled = true.

S’il n’autorise pas le suivi, définissez Settings.shared.isAdvertiserTrackingEnabled = false.

<key>FacebookAutoLogAppEventsEnabled</key>
<false/>

<key>FacebookAdvertiserIDCollectionEnabled</key>
<false/>

Consigner manuellement les évènements

Pour consigner un évènement personnalisé, il suffit de transférer son nom en tant que AppEvents.Name :

AppEvents.shared.logEvent(AppEvents.Name("battledAnOrc"))

Paramètres d’évènement

Facebook a créé un ensemble de paramètres d’évènement utiles à inclure dans les évènements standard ou à vos propres évènements personnalisés. Vous pouvez également fournir vos propres paramètres.

Ces paramètres prédéfinis sont destinés à fournir des conseils sur les séquences de consignation courantes et peuvent s’avérer plus lisibles dans les rapports et autres UI. Enregistrez l’ensemble de paramètres dont vous souhaitez voir le détail. La description recommandée est fournie à titre indicatif uniquement. Vous pouvez utiliser ces paramètres lorsqu’ils vous paraissent utiles pour votre application.

Les paramètres sont transmis via un dictionnaire dans lequel la clé conserve le nom du paramètre en tant que AppEvents.ParameterName et la valeur doit être un String ou un nombre (Int, Double, etc.).

Étape 8 : Tester vos évènements

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

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

En savoir plus

• Guide des recommandations : visualisez un large éventail d’exemples d’applications et la façon dont chacune gère App Events.
• Questions/réponses : consultez les questions/réponses.
• Cours Meta Blueprint : Configurer le SDK et les évènements d’application pour iOS
• 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 aider à comprendre comment utiliser les évènements d’application. Chacun des exemples d’application fournit une répartition écran par écran des différents évènements et paramètres pouvant être recueillis. À la fin de chaque section, un tableau répertorie les évènements et paramètres recommandés pour chaque application. Si nécessaire, vous pouvez également créer vos propres évènements et paramètres.