Mise en œuvre principale et cycle de vie

Ces informations vous aideront à mettre en œuvre la bibliothèque iOS et à collecter les mesures de cycle de vie, telles que les lancements, les mises à niveau, les sessions, les utilisateurs actifs, etc.

Téléchargement du kit SDK

Condition requise

Avant de télécharger le SDK, suivez les étapes de la section Création d’une suite de rapports dans Mise en œuvre principale et cycle de vie pour configurer une suite de rapports de développement et télécharger une version préremplie du fichier de configuration.

Pour télécharger le kit SDK :

1. Téléchargez, décompressez le fichier [Your_App_Name_]AdobeMobileLibrary-4.*-iOS.zip et vérifiez que vous disposez des composants logiciels suivants dans le répertoire AdobeMobileLibrary :

   • ADBMobile.h : fichier d’en-tête Objective-C utilisé pour le SDK iOS.

   • ADBMobileConfig.json : fichier de configuration du SDK personnalisé pour votre application.

   • AdobeMobile.xcframework : contient deux fichiers binaires FAT, un pour les appareils (armv7, armv7s, arm64) et un pour les simulateurs (i386, x86_64, arm64) iOS.

     Ce XCFramework doit être lié lors du ciblage d’une application iOS.

   • AdobeMobileExtension.xcframework : contient deux fichiers binaires FAT, un pour les appareils (armv7, armv7s, arm64) et un pour les simulateurs (i386, x86_64, arm64) iOS.

     Ce XCFramework doit être lié lors du ciblage d’une extension iOS.

   • AdobeMobileWatch.xcframework : contient deux fichiers binaires FAT, un pour les appareils (arm64_32, armv7k) et un pour les simulateurs (i386, x86_64, arm64) watchOS.

     Ce XCFramework doit être lié lors du ciblage d’une application Apple Watch (watchOS).

   • AdobeMobileTV.xcframework : contient deux fichiers binaires FAT, un pour les appareils (arm64) et un pour les simulateurs (x86_64, arm64) tvOS.

     Ce XCFramework doit être lié lors du ciblage d’une application Apple TV (tvOS).

1. Téléchargez, décompressez le fichier [Your_App_Name_]AdobeMobileLibrary-4.*-iOS.zip et vérifiez que vous disposez des composants logiciels suivants :

   • ADBMobile.h : fichier d’en-tête Objective-C utilisé par AppMeasurement pour iOS.

   • ADBMobileConfig.json : fichier de configuration du SDK personnalisé pour votre application.

   • AdobeMobileLibrary.a : binaire gras en bytecode contenant les versions de bibliothèque pour les appareils (armv7, armv7s et arm64) et les simulateurs (i386 et x86_64) iOS.

     Ce binaire gras doit être lié lorsque la cible est destinée à une application iOS.

   • AdobeMobileLibrary_Extension.a : binaire gras en bytecode contenant les versions de bibliothèque pour les appareils (armv7, armv7s et arm64) et les simulateurs (i386 et x86_64) iOS.

     Ce binaire gras doit être lié lorsque la cible est destinée à une extension iOS.

   • AdobeMobileLibrary_Watch.a : binaire gras en bytecode contenant les versions de bibliothèque pour les appareils (armv7k) et les simulateurs (i386, x86_64) Apple Watch.

     Ce binaire gras doit être lié lorsque la cible est destinée à une application d’extension Apple Watch (watchOS 2).

   • AdobeMobileLibrary_TV.a : binaire gras en bytecode contenant les versions de bibliothèque pour les nouveaux appareils (arm64) et le nouveau simulateur (x86_64) Apple TV.

     Ce binaire gras doit être lié lorsque la cible est destinée à une application Apple TV (tvOS).

Ajout du SDK et du fichier de configuration au projet

1. Lancez Xcode IDE et ouvrez votre application.

2. Dans Navigateur de projets, faites glisser le répertoire AdobeMobileLibrary sous votre projet.

3. Vérifiez les éléments suivants :

   • La case à cocher Copier les éléments si nécessaire est sélectionnée.
   • L’option Créer des groupes est sélectionnée.
   • Aucune des cases à cocher de la section Ajouter aux cibles n’est sélectionnée.

   

4. Cliquez sur Terminer.

5. Dans le Navigateur de projets, sélectionnez ADBMobileConfig.json.

6. Dans Inspecteur de fichiers, ajoutez le fichier JSON à toute cible de votre projet qui utilisera le SDK Adobe.

   

7. Dans Navigateur de projets, accomplissez les étapes suivantes :

   1. Cliquez sur votre application.
   2. Sous l’onglet Général, sélectionnez vos cibles et liez les structures et bibliothèques requises dans les sections Structures liées et Bibliothèques.

   • Cibles d’une application iOS

     • SystemConfiguration.framework
     • WebKit.framework
     • libsqlite3.0.tbd
     • AdobeMobileLibrary.a
     • CoreLocation.framework (facultatif, mais requis pour les fonctionnalités de géolocalisation)

   • Cibles d’une extension iOS

     • SystemConfiguration.framework
     • libsqlite3.0.tbd
     • AdobeMobileLibrary\_Extension.a

   • Cible d’une application Apple Watch (watchOS 2)

     • libsqlite3.0.tbd
     • AdobeMobileLibrary\_Watch.a

   • Cible d’une application Apple TV (tvOS)

     • SystemConfiguration.framework
     • libsqlite3.0.tbd
     • AdobeMobileLibrary\_TV.a
   ATTENTION

   Le fait de lier plusieurs fichiers AdobeMobileLibrary*.a à la même cible risque d’entraîner un comportement inattendu ou d’empêcher la création de votre application.

   IMPORTANT

   Si vous utilisez la version 4.21.0 ou une version ultérieure, vérifiez que les XCFrameworks Adobe ne sont pas incorporés.

   

8. Vérifiez qu’aucune erreur n’est générée lors de la création de votre application.

Mise en œuvre des mesures de cycle de vie

Une fois que vous avez activé le cycle de vie, chaque fois que l’application est lancée, un accès est envoyé permettant de mesurer les lancements, les mises à niveau, les sessions, les utilisateurs actifs et d’autres mesures de cycle de vie.

Ajoutez un appel collectLifecycleData/collectLifecycleDataWithAdditionalData dans application:didFinishLaunchingWithOptions :

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
 [ADBMobile collectLifecycleData];
    return YES;
}

Inclusion des données supplémentaires aux appels du cycle de vie

Pour ajouter des données aux appels de mesures de cycle de vie, utilisez collectLifecycleDataWithAdditionalData :

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    NSMutableDictionary *contextData = [NSMutableDictionary dictionary];
    [contextData setObject:@"Game" forKey:@"myapp.category"];
    [ADBMobile collectLifecycleDataWithAdditionalData:contextData];
    return YES;
}

Les valeurs des données contextuelles supplémentaires envoyées avec collectLifecycleDataWithAdditionalData doivent être mises en correspondance avec les variables personnalisées dans Adobe Mobile Services :

Les autres mesures de cycle de vie sont collectées automatiquement. Pour en savoir plus, voir la section Mesures de cycle de vie.

Étapes suivantes

Exécutez les tâches ci-après :

• Suivi des états de l’application
• Suivi des actions de l’application