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

IMPORTANT

Le SDK requiert iOS 8 ou une version ultérieure.

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 :

IMPORTANT

À compter de la version 4.21.0, le SDK est distribué par le biais de XCFrameworks. Si vous utilisez la version 4.21.0 ou une version ultérieure, suivez les étapes ci-dessous.

La version 4.21.0 du SDK requiert Xcode 12.0 ou une version ultérieure et, le cas échéant, Cocoapods 1.10.0 ou une version ultérieure.

  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).

IMPORTANT

Dans les versions antérieures à la version 4.21.0, le SDK est distribué par le biais de fichiers binaires. Si vous utilisez une version antérieure à la version 4.21.0, suivez les étapes ci-dessous.

  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).

IMPORTANT

Si vous téléchargez le SDK en dehors de l’interface utilisateur Adobe Mobile Services, le fichier ADBMobileConfig.json doit être configuré manuellement. Si vous découvrez Analytics et le SDK Mobile et que vous souhaitez configurer une suite de rapports de développement et télécharger une version préremplie du fichier de configuration, consultez la rubrique Avant de démarrer.

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

IMPORTANT

iOS enverra des informations relatives au cycle de vie que la fonction collectlifecycledata soit invoquée ou non, et collectlifecycledata permet uniquement d’initier le cycle de vie plus tôt dans la séquence de lancement de l’application.

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 :

IMPORTANT

Toute donnée transférée au SDK par l’intermédiaire de collectLifecycleDataWithAdditionalData: est conservée dans NSUserDefaults par le SDK. Le SDK retire du paramètre NSDictionary les valeurs qui ne sont pas de type NSString ou NSNumber.

- (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 :

Sur cette page