Εγκατάσταση και αρχικοποίηση

Η λειτουργία του SDK της Finteza απαιτεί Android 4.3 (API Level 18) ή νεότερη έκδοση και βιβλιοθήκη com.android.installreferrer:installreferrer . Το SDK μπορεί να εγκατασταθεί χρησιμοποιώντας το Gradle ή χειροκίνητα, κάνοντας λήψη του πακέτου στη διεύθυνση https://repo1.maven.org/maven2/net/metaquotes/finteza/finteza-sdk/.

Εγκατάσταση μέσω Gradle #

Για να συνδέσετε το SDK της Finteza, προσθέστε την ακόλουθη εξάρτηση στην ενότητα dependencies του αρχείου build.gradle του έργου σας:

dependencies {
   //... other dependencies
    implementation 'net.metaquotes.finteza:finteza-sdk:+'
}

Add the following line to the repositories section:

repositories {
    //...
    mavenCentral()
    }

Χειροκίνητη εγκατάσταση #

Κάντε λήψη της τελευταίας έκδοσης του SDK ως αρχείο aar και αντιγράψτε το στον κατάλογο libs του έργου σας. Στη συνέχεια, προσθέστε το αρχείο aar SDK στο έργο ως βιβλιοθήκη.

Προσθέστε την ακόλουθη υπηρεσία στη διακήρυξη του έργου:

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

Προσθήκη δικαιωμάτων:

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

Στη συνέχεια, προσθέστε την ακόλουθη εξάρτηση στο αρχείο build.gradle :

dependencies {
   //... other dependencies
    implementation 'com.android.installreferrer:installreferrer:2.2'
}

Αρχικοποίηση SDK στην εφαρμογή #

Για να κάνετε αρχικοποίηση, καλέστε τη μέθοδο Finteza.initialize στο πρόγραμμα χειρισμού Application.onCreate ή Activity.onCreate :

Finteza.initialize(getApplication(), "{WEBSITE_ID}", "{WEBSITE_URL}", "{PRODUCT}");

Ορίστε το ID ιστοσελίδας ως {WEBSITE_ID}. Μπορείτε να το βρείτε στις ρυθμίσεις ιστοσελίδας (πεδίο ID) του πίνακα της Finteza. Στη συνέχεια, ορίστε τις παραμέτρους:

Παράμετρος

Τύπος

Περιγραφή

ιστοσελίδα

συμβολοσειρά

Όνομα τομέα ιστοσελίδας, για παράδειγμα, «my.site.com».

προϊόν

συμβολοσειρά

Το όνομα προϊόντος που θα χρησιμοποιείται ως πρόθεμα για την επισήμανση των συμβάντων που αποστέλλονται στη Finteza από την εφαρμογή σας.

 

Μπορεί να το χρειαστείτε για να διαχωρίσετε τα συμβάντα σε διαφορετικές πλατφόρμες σε περίπτωση που έχετε εφαρμογές για PC, iOS, Android κλπ. Για παράδειγμα, εάν καθορίσετε το προϊόν «Android App» και κάνετε αποστολή του συμβάντος «Εγγραφή», το τελικό όνομα συμβάντος στη Finteza θα είναι «Εγγραφή Android App».

 

Καθορίστε null για να αποφύγετε τη χρήση του προθέματος.

 

Συμβάντα εκκίνησης εφαρμογής #

Προσθέστε τον ακόλουθο κώδικα στο Activity.onCreate:

Finteza.activate()

Κατά την κλήση της activate το SDK στέλνει στη Finteza το συμβάν «Τέλος εγκατάστασης» κατά την πρώτη εκκίνηση της εφαρμογής (εάν έχει καθοριστεί το πρόθεμα του προϊόντος, τότε αποστέλλεται «Τέλος εγκατάστασης {PRODUCT}»).

Επίσης, κατά την κλήση της activate, ξεκινά μια νέα συνεδρία και καταχωρείται το συμβάν «Έναρξη συνεδρίας» (εάν έχει οριστεί το πρόθεμα του προϊόντος, τότε «Έναρξη συνεδρίας {PRODUCT}»).

Εάν ένας χρήστης αποχωρήσει από την εφαρμογή, η τρέχουσα περίοδος λήγει. Την επόμενη φορά που θα ξεκινήσει/ενεργοποιηθεί η εφαρμογή, ξεκινά μια νέα συνεδρία.

Μηνύματα εντοπισμού σφαλμάτων #

Για να ελέγξετε πώς λειτουργεί το SDK, μπορείτε να ενεργοποιήσετε την έξοδο πληροφοριών εντοπισμού σφαλμάτων στην κονσόλα προγραμματιστή με φιλτράρισμα κατά τύπο μηνύματος:

Μόνο συμβάντα

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

Πλήρης καταγραφή

Finteza.addLogging(LogUtil.LogLevel.ALL);

Μόνο σφάλματα

Finteza.addLogging(LogUtil.LogLevel.ERROR);

Για να απενεργοποιήσετε τα μηνύματα εντοπισμού σφαλμάτων, καλέστε:

Finteza.addLogging(LogUtil.LogLevel.NONE);

Παράδειγμα

Το ακόλουθο μήνυμα εντοπισμού σφαλμάτων υποδεικνύει ένα σφάλμα αποστολής συμβάντος λόγω απουσίας της μεθόδου κλήσης activate :

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