EntegrasyonlarKurulum ve başlatma

Kurulum ve başlatma

Finteza SDK, Android 4.0.3 (API Level 15) veya daha yüksek sürümleri ve com.android.installreferrer:installreferrer kütüphanesini gerektirir. SDK Gradle kullanarak veya manuel olarak https://bintray.com/finteza/maven/finteza-sdk adresinden indirilerek kurulabilir.

Gradle ile kurulum #

Finteza SDK'yı bağlamak için, projenizin build.gradle dosyasının bağımlılıklar bölümüne aşağıdaki bağımlılığı ekleyin:

dependencies {
   //... diğer bağımlılıklar
    implementation 'net.metaquotes.finteza:finteza-sdk:+'
}

Manuel kurulum #

En son SDK sürümünü bir jar dosyası olarak indirin ve projenizin libs dizinine kopyalayın. Ardından, SDK jar dosyasını projeye bir kütüphane olarak ekleyin.

Projenin manifest dosyasına aşağıdaki hizmeti ekleyin:

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

İzinleri ekleyin:

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

Ardından, build.gradle dosyasına şu bağımlılığı ekleyin:

dependencies {
   //... diğer bağımlılıklar
    implementation 'com.android.installreferrer:installreferrer:1.0'
}

Uygulamada SDK'yı başlatma #

Başlatmak için, Application.onCreate veya Activity.onCreate işleyicisindeki Finteza.initialize metodunu çağırın:

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

{WEBSITE_ID} yerine web sitesi ID'sini belirtin. Finteza panelinin web sitesi ayarlarından (ID alanı) elde edilebilir. Ardından, parametreleri ayarlayın:

Parametre

Tip

Açıklama

site

string

Web sitesi alan adı, örneğin "my.site.com".

product

string

Uygulamanız tarafından Finteza'ya gönderilen olayları etiketlemek için ön ek olarak kullanılacak ürün adı.

 

Bu parametre; PC, iOS, Android vb. için uygulamalarınız olması durumunda olayları farklı platformlarda olacak şekilde ayırmak için kullanılabilir. Örneğin, ürün olarak "Android Uygulaması" ve olay adı olarak "Kayıt" belirtirseniz, olay gönderildiği vakit Finteza'daki son olay adı "Android Uygulaması Kayıt" olur.

 

Ön eki kullanmamak için null olarak ayarlayın.

Uygulama başlatma olayları #

Activity.onCreate'e aşağıdaki kodu ekleyin:

Finteza.activate()

İlk uygulama başlatması sırasında activate çağrılır ve SDK, Finteza'ya "Install Finish" olayını gönderir (ürün ön eki ayarlanmışsa, "{PRODUCT} Install Finish" olayı gönderilir).

Ayrıca, activate çağrıldığında yeni bir çalışma oturumu başlar ve "Session Start" olayı kaydedilir (eğer ürün ön eki ayarlanmışsa, "{PRODUCT} Session Start" olayı kaydedilir).

Eğer kullanıcı uygulamadan çıkarsa, geçerli oturum sona erer. Bir sonraki uygulama başlatılışında/etkinleştirilişinde, yeni bir oturum başlar.


Hata ayıklama mesajları #

SDK ile çalışmayı test etmek için, mesaj türüne göre filtrelemeyle hata ayıklama verilerinin geliştirici konsoluna çıktısını etkinleştirebilirsiniz:

Sadece olaylar

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

Tam günlük kaydı

Finteza.addLogging(LogUtil.LogLevel.ALL);

Sadece hatalar

Finteza.addLogging(LogUtil.LogLevel.ERROR);

Hata ayıklama mesajlarını devre dışı bırakmak için şunu çağırın:

Finteza.addLogging(LogUtil.LogLevel.NONE);

Örnek

Aşağıdaki hata ayıklama mesajı, activate metodu çağrısının bulunmaması nedeniyle bir olay gönderme hatası olduğunu gösterir:

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