:quality(90):no_upscale())
DÉVELOPPEURS BLACKBERRY
Premiers pas avec le SDK BlackBerry Analytics pour iOS
Intégrez BlackBerry Analytics aux applications iOS Dynamics grâce aux conditions préalables, aux autorisations et aux instructions de configuration du SDK.
Avant de commencer : BlackBerry Analytics ne peut être intégré qu'aux applications BlackBerry Dynamics. Pour plus d'informations sur les applications BlackBerry Dynamics, consultez la section « Premiers pas avec le SDK BlackBerry Dynamics ».
Accédez à la page de téléchargement pour télécharger le SDK BlackBerry Analytics pour Android ou iOS.
Suivez les étapes ci-dessous pour vérifier que vous êtes bien autorisé à utiliser l'application BlackBerry Analytics :
Connectez-vous à la console de gestion BlackBerry UEM .
Cliquez sur « Apps ».
Recherchez « BlackBerry Analytics ».
Si vous disposez d'un droit d'accès à BlackBerry Analytics, l'application BlackBerry Analytics apparaît dans la liste des applications. Si vous ne voyez pas l'application BlackBerry Analytics dans la liste des applications, vous devez contacter votre représentant BlackBerry pour en faire la demande.
:quality(90):no_upscale())
Installation et configuration
1. Dans la console d'administration d'UEM , cliquez sur « Utilisateurs » puis sélectionnez l'utilisateur.
:quality(90):no_upscale())
2. Dans la section « Applications », cliquez sur l'icône « + ».
3. Recherchez et sélectionnez le droit d'accès à BlackBerry Analytics.
:quality(90):no_upscale())
4. Cliquez sur « Suivant ».
5. Dans la liste déroulante « Disposition », sélectionnez « Obligatoire ».
6. Cliquez sur « Attribuer ».
Développer et déployer
Décompressez le framework BlackBerry Analytics.
Dans les phases de compilation de la cible d'application, ajoutez BAFBlackberryAnalytics.framework à la phase « Lier le binaire aux bibliothèques ».
En vertu de la Autres options de l'éditeur de liens Dans les paramètres de compilation du projet, ajoutez
-lstdc++ -lz –ObjC.Dans AppDelegate, importez Analytics.
Obj-C
#import <BAFBlackberryAnalytics/BAFBlackberryAnalytics.hSwift
import BAFBlackberryAnalyticsInitialisez le SDK dans la méthode `didfinishlaunchingwithoptions`.
Obj-C
[BAFBlackberryAnalytics setStage];Swift
BAFBlackberryAnalytics.setStage();Transmettez les événements BlackBerry Dynamics au moteur BlackBerry Analytics en ajoutant ce code à la méthode `handleEvent`.
Obj-C[BAFBlackberryAnalytics sendGDAppEvent:anEvent];Swift
BAFBlackberryAnalytics.sendGDAppEvent(anEvent)
Il faut 24 heures pour que les données soient mises à jour sur le tableau de bord BlackBerry Analytics.
:quality(90):no_upscale())
Événements personnalisés
La bibliothèque BlackBerry Analytics propose deux API permettant de suivre les événements personnalisés dans les applications.
Les événements suivants sont fournis pour être utilisés avec les API afin de suivre les indicateurs.
Événements appariés (fonctionnalité active/inactive) : ces événements fournissent les tranches de temps permettant de suivre le début/l'ouverture ou la fin/la fermeture d'une tâche ou d'une fonctionnalité spécifique.
Événements ponctuels (événement d'adoption) : cet événement correspond à un événement ou à une tâche spécifique devant faire l'objet d'un suivi sur le portail.
Les événements « Feature Active » et « Feature Inactive » sont limités au cycle de vie visible de l’application. Lorsque l’application passe en arrière-plan, le SDK BlackBerry Analytics marque toutes les fonctionnalités actuellement actives comme inactives. Les fonctionnalités qui étaient actives avant que l’application ne passe en arrière-plan ne seront plus suivies en tant que fonctionnalités actives une fois que l’application sera revenue au premier plan. L’application devra marquer une fonctionnalité comme active lorsqu’elle sera à nouveau au premier plan. De plus, les applications peuvent être amenées à appeler l’API trackFeatureEvent pour enregistrer des événements « Feature Inactive » lorsque la vue ou l’écran de l’application passe à une autre vue ou un autre écran.
Si l'application appelle l'API trackFeatureEvent pour enregistrer un événement « Feature Inactive » après être passée en arrière-plan, la réponse « BAFFeatureNotFound » est renvoyée.
Type d'événement | iOS (BAFAnalyticsEvent) | Description |
Fonctionnalité active | BAFFeatureActive | Pour enregistrer un événement lié à une fonctionnalité active |
Fonctionnalité inactive | BAFFeatureInactive | Pour enregistrer un événement lié à une fonctionnalité inactive |
Événement consacré à l'adoption | Événement d'adoption de la BAFA | Pour immortaliser un événement lié à l'adoption. |
Ces événements peuvent être mis en œuvre à l'aide du code suivant.
Obj-C
[BAFBlackberryAnalytics trackFeatureEvent:BAFFeatureActivewithFeatureName:@"EventName" completion:^(NSError *error) { NSLog(@"%@", [error localizedDescription]); }];[BAFBlackberryAnalytics trackFeatureEvent:BAFFeatureInactivewithFeatureName:@"EventName" completion:^(NSError *error) { NSLog(@"%@", [error localizedDescription]); }];[BAFBlackberryAnalytics trackApplicationEvent:BAFAdoptionEvent withValue:@"Value"forKey:@"Key" completion:^(NSError *error) { NSLog(@"%@", [error localizedDescription]); }];
Swift
BAFBlackberryAnalytics.trackApplicationEvent(.adoptionEvent, withValue: "Value", forKey:"Key", completion: { (error) in }) BAFBlackberryAnalytics.trackFeatureEvent(.featureActive, withFeatureName:"EventName", completion: { (error) in }) BAFBlackberryAnalytics.trackFeatureEvent(.featureInactive, withFeatureName:"EventName", completion: { (error) in })
Vous pouvez consulter les événements personnalisés dans l'onglet « Suivi des fonctionnalités » lorsque vous sélectionnez votre application dans la section « Applications » de la barre de navigation de gauche.
:quality(90):no_upscale())
Félicitations pour l'intégration de BlackBerry Analytics à votre application sécurisée !
:quality(90):no_upscale())