IntégrationsInstallation et initialisation

Installation et initialisation

L'utilisation du SDK Finteza nécessite Android 4.0.3 (API Level 15) ou supérieur et la bibliothèque com.android.installreferrer:installreferrer. Le SDK peut être installé en utilisant Gradle ou manuellement en téléchargeant le package depuis https://bintray.com/finteza/maven/finteza-sdk.

Installation via Gradle #

Pour vous connecter au SDK Finteza, ajoutez les dépendences suivantes dans la section dependencies du fichier build.gradle de votre projet :

dependencies {
   //... autres dépendances
    implementation 'net.metaquotes.finteza:finteza-sdk:+'
}

Installation manuelle #

Téléchargez la dernière version du SDK sous la forme d'un fichier jar dans le répertoire libs de votre projet. Ajoutez ensuite le fichier jar du SDK au projet comme une bibliothèque.

Ajoutez le service suivant au manifest du projet :

<service android:name="net.metaquotes.FintezaService" />

Ajoutez les permissions :

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Ajoutez ensuite la dépendence suivante au fichier build.gradle :

dependencies {
   //... autres dépendances
    implementation 'com.android.installreferrer:installreferrer:1.0'
}

Initialisation du SDK dans l'application #

Pour l'initialisation, appelez la méthode Finteza.initialize dans les handlers Application.onCreate ou Activity.onCreate :

Finteza.initialize(getApplication(), "{WEBSITE_ID}""{WEBSITE_URL}""{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 "Android App" et que vous envoyez l'évènement "Enregistrement", le nom final de l'évènement sera "Android App Registration".

 

Utilisez null pour ne pas utiliser de préfixe.

Evènements de lancement de l'application #

Ajoutez le code suivant à Activity.onCreate:

Finteza.activate()

Lorsque activate est appelée au premier lancement de l'application, le SDK envoie l'évènement "Install Finish" à Finteza (si le préfixe du produit est spécifié, "{PRODUCT} Install Finish" est envoyé).

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

Si un utilisateur quitte l'application, la session en cours se termine. La prochaine fois que l'application est lancée/activée, une nouvelle session commence.


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, filtrée par type de message.

Uniquement les évènements

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

Journal complet

Finteza.addLogging(LogUtil.LogLevel.ALL);

Uniquement les erreurs

Finteza.addLogging(LogUtil.LogLevel.ERROR);

Pour désactiver les messages de débogage, appelez :

Finteza.addLogging(LogUtil.LogLevel.NONE);

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