Installation et initialisation

Pour installer le SDK Finteza, utilisez les gestionnaires de packages CocoaPods ou Carthage ou téléchargez le fichier manuellement depuis GitHub.

Installation via CocoaPods #

Pour vous connecter au SDK Finteza, ajoutez la chaîne Podfile à votre projet :

pod 'FintezaSDK'

Ensuite, exécutez la commande d'installation :

pod install

Lors de l'utilisation de CocoaPods, utilisez toujours le fichier .xcworkspace au lieu de .xcodeproj.

Installation via Carthage #

Pour vous connecter au SDK Finteza, ajoutez la chaîne Cartfile à votre projet :

github "finteza/mobile-sdk-ios"

Installation manuelle #

Téléchargez et décompressez le fichier FintezaSDK-X.X.X.framework.zip. Ensuite, transférez le FintezaSDK.framework dans votre projet dans Xcode.

Activez l'option "Copier les éléments si nécessaire" lors de l'installation.

Initialisation du SDK dans l'application #

Ouvrez le fichier du délégué de votre application et importez le SDK Finteza :

Objective-C :

#import <FintezaSDK/FintezaSDK.h>

Swift :

import FintezaSDK

Initialisez le SDK dans la méthode didFinishLaunchingWithOptions en utilisant l'identifiant du site web et son adresse :

Objective-C :

[Finteza initialize:@"{WEBSITE_ID}" site:@"{WEBSITE_URL}" product:@"{PRODUCT}"];

Swift :

Finteza.initialize("{WEBSITE_ID}", site: "{WEBSITE_URL}", product: "{PRODUCT}")

Définissez l'identifiant du site web sur {WEBSITE_ID}. Vous pouvez l'obtenir dans les paramètres du site Web (champ ID) du panneau Finteza. Définissez ensuite les paramètres :

Paramètre

Type

Description

site

chaîne de caractères

Nom de domaine du site web, par exemple, "my.site.com".

product

chaîne de caractères

Nom du produit à utiliser comme préfixe pour l'étiquetage des événements envoyés à Finteza par votre application.

Vous en aurez peut-être besoin pour séparer les événements sur différentes plateformes si vous avez des applications pour PC, iOS, Android, etc. Par exemple, si vous spécifiez le produit "iOS App" et que vous envoyezl'événement "Enregistrement", le nom de l'événement final dans Finteza sera "Enregistrement de l'application iOS".

Utilisez 'nil' pour ne pas utiliser de préfixe.

Vous pouvez ultérieurement changer le nom du produit en utilisant la fonction setProduct :

Objective-C :

[Finteza setProduct:@"{PRODUCT}"];

Swift :

Finteza.setProduct("{PRODUCT}")

Evènements de lancement de l'application #

Ajoutez le code suivant à applicationDidBecomeActive :

Objective-C :

[Finteza activate];

Swift :

Finteza.activate()

Lors de l'appel à activate, le SDK envoie l'évènement "Fin de l'installation" à Finteza au premier lancement de l'application (si le préfixe produit est défini, alors "{PRODUCT} Fin de l'installation").

Lors de l'appel à activate, une nouvelle session de travail est également démarrée et l'évènement "Début de Session" est enregistré (si le préfixe du produit est défini, alors "{PRODUCT} Début de Session").

La nouvelle session ne commence que si plus de trois minutes se sont écoulées depuis le dernier moment où l'application est devenue inactive.

Messages de débogage #

Afin de tester le fonctionnement du SDK, vous pouvez activer la sortie des données de débogage sur la console du développeur. Les données relatives aux événements et aux annonces affichées sont affichées séparément.

Evènements

Objective-C :

[Finteza addLogging:FintezaLogModeEvents];

Swift :

Finteza.addLogging(FintezaLogModeEvents)

Annonces

Objective-C :

[Finteza addLogging:FintezaLogModeBanner];

Swift :

Finteza.addLogging(FintezaLogModeBanner)

Exemple

Le message de débogage suivant indique une erreur lors de l'envoi de l'événement en raison de l'absence de la méthodeactivate :

[event] cannot send event 'Book Load': call the 'activate' method first