التكاملالتثبيت والتهيئة

التثبيت والتهيئة

تتطلب عملية Finteza SDK أندرويد 4.0.3 (API المستوى 15) أو أعلى ومكتبة com.android.installreferrer:installreferrer. يمكن تثبيت SDK باستخدام Gradle أو يدويًا عن طريق تحميل الحزمة من على https://bintray.com/finteza/maven/finteza-sdk.

التثبيت عبر Gradle #

لتوصيل Finteza SDK، أضف التبعية التالية إلى  قسم التبعيات من ملف build.gradle لمشروعك:

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

التثبيت اليدوي #

قم بتحميل أحدث إصدار من SDK في صورةملف jar وانسخه إلى دليل libs الخاص بمشروعك. بعد ذلك ، أضف ملف SDK jar إلى المشروع في صورة مكتبة.

أضف الخدمة التالية إلى بيان المشروع:

<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:1.0'
}

تهيئة SDK في التطبيق #

للتهيئة، اتصل بـ  طريقة Finteza.initialize في Application.onCreate أو معالج Activity.onCreate:

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

قم بتعيين معرف الموقع الإلكتروني في صورة {WEBSITE_ID}. يمكن الحصول عليها من إعدادات الموقع الإلكتروني (حقل المعرف) في لوحة Finteza. بعد ذلك، قم بتعيين المعلمات:

المعلمة

النوع

الوصف

site

السلسلة

اسم نطاق الموقع الإلكتروني، على سبيل المثال، "my.site.com".

product

السلسلة

اسم المنتج الذي سيتم استخدامه كبادئة لتصنيف الأحداث المرسلة إلى Finteza بواسطة التطبيق الخاص بك.

 

قد تحتاجها لفصل الأحداث عبر منصات مختلفة في حال كان لديك تطبيقات لأجهزة الكمبيوتر، iOS ، أندرويد، إلخ. على سبيل المثال، إذا حددت منتج "تطبيق iOS" وأرسلت حدث "تسجيل"، فسيكون اسم الحدث النهائي في Finteza هو "تسجيل تطبيق أندرويد".

 

اضبط "لا شيء" لتجنب استخدام البادئة.

أحداث إطلاق التطبيق #

أضف الرمز التالي إلى Activity.onCreate:

Finteza.activate()

عندما يتم الاتصال بـ تنشيط  في بداية التطبيق الأول، يرسل SDK حدث "Install Finish" إلى Finteza (إذا تم تحديد بادئة المنتج، فسيتم إرسال "{PRODUCT} Install Finish").

أيضًا، عند الاتصال بـ تنشيط، تبدأ جلسة عمل جديدة ويتم تسجيل حدث "Session Start" (إذا تم تعيين بادئة المنتج، إذن "بدأت جلسة {PRODUCT}".

في حالة مغادرة المستخدم للتطبيق، تنتهي الجلسة الحالية. في المرة التالية التي يتم فيها تشغيل/تنشيط التطبيق، تبدأ جلسة جديدة.


رسائل التصحيح #

<t0>لاختبار العمل باستخدام SDK، يمكنك تمكين إخراج بيانات تصحيح الأخطاء إلى وحدة تحكم المطور، تصفيتها حسب نوع الرسالة:

الأحداث فقط

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

تسجيل كامل

Finteza.addLogging(LogUtil.LogLevel.ALL);

الأخطاء فقط

Finteza.addLogging(LogUtil.LogLevel.ERROR);

لتعطيل رسائل تصحيح الأخطاء، اتصل بـ:

Finteza.addLogging(LogUtil.LogLevel.NONE);

مثال

تشير رسالة تصحيح الأخطاء التالية إلى خطأ في إرسال حدث بسبب عدم وجود تنشيط  طريقة الاتصال:

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