Premiers pas avec le kit de développement logiciel (SDK) BlackBerry Analytics pour iOS

Avant de commencer : BlackBerry Analytics ne peut être intégré qu'aux applications BlackBerry Dynamics. Pour en savoir plus sur les applications BlackBerry Dynamics, consultez la section « Prise en main du kit de développement logiciel BlackBerry Dynamics » .

1. Rendez-vous sur la page de téléchargement pour télécharger le kit de développement logiciel (SDK) BlackBerry Analytics pour Android ou iOS.

2. Suivez les étapes ci-dessous pour vérifier que vous avez droit à l'application BlackBerry Analytics :

   1. 
      

   2.  Connectez-vous à votre BlackBerry. UEM console de gestion.

   3. Cliquez sur Applications .

   4. Rechercher BlackBerry Analytics .

Si vous avez droit à l'utilisation de BlackBerry Analytics, l'application BlackBerry Analytics apparaît dans la liste des applications. Si vous ne la voyez pas, vous devez contacter votre représentant BlackBerry pour demander l'autorisation.

1. Dans le UEM Dans la console de gestion, cliquez sur Utilisateurs et sélectionnez l'utilisateur.

2. Dans la section Applications , cliquez sur l'icône plus.

3. Trouvez et sélectionnez le droit d'accès à BlackBerry Analytics.

4. Cliquez sur Suivant .

5. Dans la liste déroulante Disposition , sélectionnez Obligatoire .

6. Cliquez sur Attribuer .

1. Décompressez le cadre BlackBerry Analytics.

2. Dans les phases de compilation de la cible de l'application, ajoutez BAFBlackberryAnalytics.framework à la phase « Lier le binaire aux bibliothèques ».

3. Sous le Autres indicateurs de l'éditeur de liens configuration de construction du projet, ajouter-lstdc++ -lz –ObjC.

4. Dans AppDelegate, importez Analytics.
   
   

   Obj-C

   #import <BAFBlackberryAnalytics/BAFBlackberryAnalytics.h
   

   Rapide

   importer BAFBlackberryAnalytics

5. Initialisez le SDK dans la méthode didfinishlaunchingwithoptions.

   Obj-C

   [BAFBlackberryAnalytics setStage] ;

   Rapide

   BAFBlackberryAnalytics.setStage();

    

6. Transmettez les événements BlackBerry Dynamics au moteur BlackBerry Analytics en ajoutant ce code à la méthode handleEvent.

7. 
   Obj-C

    

   [AnalyticsBAFBlackberry sendGDAppEvent:anEvent];

   Rapide

   BAFBlackberryAnalytics.sendGDAppEvent(anEvent)

La mise à jour des données sur le tableau de bord de BlackBerry Analytics prend 24 heures.

Les événements suivants sont fournis pour être utilisés avec les API afin de suivre les indicateurs.

• Événements jumelés (fonctionnalité active/inactive) : Ces événements fournissent les tranches de temps permettant de suivre les événements de début/ouverture ou de fin/fermeture d’une tâche/fonctionnalité spécifique.

• Événements uniques (événement d'adoption) : cet événement représente de manière unique un événement/une tâche spécifique qui doit être suivi(e) dans le portail.

Les événements « Fonctionnalité active » et « Fonctionnalité inactive » sont limités au cycle de vie visible de l'application. Lorsque l'application passe en arrière-plan, la trousse de développement logiciel (SDK) BlackBerry Analytics marque toutes les fonctionnalités actives comme inactives. Les fonctionnalités actives avant le passage de l'application en arrière-plan ne seront plus suivies comme telles une fois l'application revenue au premier plan. L'application devra alors réactiver chaque fonctionnalité lorsqu'elle sera de nouveau au premier plan. De plus, il peut être nécessaire d'appeler l'API `trackFeatureEvent` pour enregistrer les événements « Fonctionnalité inactive » lors du changement d'affichage.

Si l'application appelle l'API trackFeatureEvent pour enregistrer un événement Feature Inactive après que l'application soit passée en arrière-plan, la réponse BAFFeaturetNotFound est renvoyée.

 Ces événements peuvent être réalisés avec le code suivant.

Obj-C

[BAFBlackberryAnalytics trackFeatureEvent:BAFFeatureActive
withFeatureName:@"EventName" completion:^(NSError *error) {
        NSLog(@"%@",[erreur localiséeDescription]);
    }];
[BAFBlackberryAnalytics trackFeatureEvent:BAFFeatureInactive
withFeatureName:@"EventName" completion:^(NSError *error) {
        NSLog(@"%@",[erreur localiséeDescription]);
    }];
[BAFBlackberryAnalytics trackApplicationEvent:BAFAdoptionEvent withValue:@"Value"
forKey:@"Key" completion:^(NSError *error) {
        NSLog(@"%@",[error localizedDescription]); }];

Rapide

BAFBlackberryAnalytics.trackApplicationEvent(.adoptionEvent, withValue: "Valeur", forKey:
"Key", completion: { (error) in           
    })       
    BAFBlackberryAnalytics.trackFeatureEvent(.featureActive, avecFeatureName:
"EventName", completion: { (error) in       
    })       
    BAFBlackberryAnalytics.trackFeatureEvent(.featureInactive, avecFeatureName:
"EventName", completion: { (error) in       
    })

Vous pouvez consulter les événements personnalisés sous l'onglet Suivi des fonctionnalités lorsque vous sélectionnez votre application dans la section Applications de la barre de navigation de gauche.

Félicitations pour l'ajout de BlackBerry Analytics à votre application sécurisée !