نصب و راه اندازی

عملکرد Finteza SDK به کتابخانه Android نسخه 4.3 (سطح API 18) یا بالاتر و com.android.installreferrer:installreferrer  نیاز دارد. SDK را می توان با استفاده از Gradle یا به صورت دستی با بارگیری بسته در https://repo1.maven.org/maven2/net/metaquotes/finteza/finteza-sdk/.

نصب از طریق Gradle #

برای اتصال Finteza SDK ، وابستگی زیر را به بخش وابستگی ها   از پرونده 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 or Activity.onCreate فراخوانی کنید:

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

شناسه وب سایت را به عنوان {WEBSITE_ID}  تنظیم کنید. می توان آن را در تنظیمات وب سایت (فیلد شناسایی) از پانل Finteza  دریافت کرد. سپس پارامترها را تنظیم کنید:

پارامتر

نوع

توصیف

site

رشته

نام دامنه وب سایت ، به عنوان مثال ، "my.site.com".

product

رشته

نام محصول به عنوان پیشوند رویدادهای برچسب گذاری شده توسط برنامه شما به Finteza ارسال می شود.

 

در صورت داشتن برنامه هایی برای رایانه های شخصی ، iOS ، Android و غیره ، ممکن است شما به آن نیاز داشته باشید تا رویدادها را در سیستم عامل های مختلف جدا کنید. به عنوان مثال ، اگر محصول "برنامه Android" و send  "ثبت نام" را مشخص کنید ، نام رویداد نهایی در Finteza "ثبت نام برنامه Android" خواهد بود.

 

برای جلوگیری از استفاده از پیشوند nullرا تنظیم کنید.

رویدادهای راه اندازی برنامه #

کد زیر را به Activity.onCreate  اضافه کنید:

Finteza.activate()

هنگامی که activate  در اولین برنامه درخواست فراخوانی می شود ، SDK رویداد "نصب پایان" را به Finteza می فرستد (اگر پیشوند محصول  مشخص شده است ، "{PRODUCT} Install Finish" ارسال شده است).

همچنین هنگامی که activate, فراخوانی می شود، یک سشن کاری جدید شروع می شود و رویداد "Session Start" ثبت می شود (اگر پیشوند محصول ست شده باشد، آنگاه سشن "{PRODUCT} شروع میشود").

اگر کاربر برنامه را ترک کند ، سشن فعلی به پایان می رسد. دفعه دیگر که برنامه راه اندازی و فعال می شود ، جلسه جدید شروع می شود.

پیامهای عیب یابی #

برای آزمایش عملکرد SDK ، می توانید خروجی اطلاعات اشکال زدایی را به کنسول توسعه دهنده ، که با نوع پیام فیلتر شده است ، فعال کنید:

فقط رویدادها

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

لاگ کردن کامل

Finteza.addLogging(LogUtil.LogLevel.ALL);

فقط خطاها

Finteza.addLogging(LogUtil.LogLevel.ERROR);

برای غیرفعال کردن پیام های اشکال زدایی ، فراخوانی کنید:

Finteza.addLogging(LogUtil.LogLevel.NONE);

مثال

پیام اشکال زدایی زیر نشانگر خطای ارسال رویداد به دلیل عدم وجود فراخوانی روش activate  است:

[event] نمی تواند رویداد "Book Load" را ارسال کند: ابتدا روش "activate" را فراخوانی کنید
← 
 →