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.
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 :
À 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.
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).
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.
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).
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.
Lancez Xcode IDE et ouvrez votre application.
Dans Navigateur de projets, faites glisser le répertoire AdobeMobileLibrary
sous votre projet.
Vérifiez les éléments suivants :
Cliquez sur Terminer.
Dans le Navigateur de projets, sélectionnez ADBMobileConfig.json
.
Dans Inspecteur de fichiers, ajoutez le fichier JSON à toute cible de votre projet qui utilisera le SDK Adobe.
Dans Navigateur de projets, accomplissez les étapes suivantes :
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
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.
Si vous utilisez la version 4.21.0 ou une version ultérieure, vérifiez que les XCFrameworks Adobe ne sont pas incorporés.
Vérifiez qu’aucune erreur n’est générée lors de la création de votre application.
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;
}
Pour ajouter des données aux appels de mesures de cycle de vie, utilisez collectLifecycleDataWithAdditionalData
:
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.
Exécutez les tâches ci-après :