การทำงานร่วมกันFinteza SDKอุปกรณ์มือถือแอนดรอยด์การติดตั้งและการเริ่ม

การติดตั้งและการเริ่มต้น

การดำเนินการของ Finteza SDK ต้องการ แอนดรอยด์ 4.0.3 (API Level 15) หรือสูงกว่า และไลบรารี่ com.android.installreferrer:installreferrer SDK สามารถติดตั้งโดยใช้ Gradle หรือติดตั้งด้วยตนเองโดยการดาวน์โหลดแพ็คเกจที่ https://bintray.com/finteza/maven/finteza-sdk

การติดตั้งผ่าน Gradle #

เพื่อเชื่อมต่อ Finteza SDK เพิ่ม dependency ต่อไปนี้ไปยังส่วน dependencies ของไฟล์ build.gradle ของโปรเจกต์ของคุณ:

dependencies {
   //... dependencies อื่นๆ
    การดำเนินการ 'net.metaquotes.finteza:finteza-sdk:+'
}

การติดตั้งด้วยตนเอง#

ดาวน์โหลด SDK เวอร์ชั่นล่าสุด เป็นไฟล์ jar และคัดลอกมันไปยังไดเรกทอรี่ libs ของโปรเจกต์ของคุณ ถัดไป เพิ่มไฟล์ SDK jar ไปยังโปรเจกต์เป็นไลบรารี่

เพิ่มเซอร์วิสต่อไปนี้ไปยังไฟล์ manifest ของโปรเจกต์:

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

เพิ่มการอนุญาต:

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

ถัดไป เพิ่ม dependency ต่อไปนี้ยังไปยังไฟล์ build.gradle:

dependencies {
   //... dependencies อื่นๆ
    การดำเนินการ 'com.android.installreferrer:installreferrer:1.0'
}

การเริ่มต้น SDK ในแอปพลิเคชั่น #

เพื่อเริ่มต้น เรียก method Finteza.initialize ใน handler Application.onCreate หรือ Activity.onCreate handler:

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

ตั้งค่า ID เว็บไซต์เป็น {WEBSITE_ID} มันสามารถพบได้ในการตั้งค่าของเว็บไซต์ (ฟิลด์ ID) ของ แผงควบคุม Finteza ถัดไป ตั้งค่าพารามิเตอร์:

พารามิเตอร์

ประเภท

คำอธิบาย

site

string

ชื่อโดเมนของเว็บไซต์ ตัวอย่างเช่น "my.site.com".

product

string

ชื่อผลิตภัณฑ์เพื่อใช้เป็น prefix สำหรับการติดป้ายเหตุการณ์ซึ่งถูกส่งไปยัง Finteza โดยแอปพลิเคชั่นของคุณ

 

คุณอาจต้อการให้มันแยกเหตุการณ์ระหว่างแพลตฟอร์มที่ต่างกันในกรณีที่คุณมีแอปสำหรับพีซี iOS แอนดรอยด์ ฯลฯ ตัวอย่างเช่น ถ้าคุณระบุผลิภภัณฑ์ "Android App" และ ส่งเหตุการณ์ "Registration" ชื่อเหตุการณ์ใน Finteza จะเป็น "Android App Registration"

 

ตั้งค่าเป็น null เพื่อหลีกเลี่ยงการใช้ prefix

เหตุการณ์การเริ่มแอปพลิเคชั่น #

เพิ่มโค้ดต่อไปนี้ไปยัง Activity.onCreate:

Finteza.activate()

เมื่อ activate ถูกเรียกเมื่อเริ่มแอปพลิเคชั่นครั้งแรก SDK จะส่งเหตุการณ์ "Install Finish" ไปยัง Finteza (ถ้า prefix ผลิตภัณฑ์ ถูกระบุไว้ "{PRODUCT} Install Finish" จะถูกส่ง)

นอกจากนี้ เมื่อเรียก activate ช่วงเวลาการทำงานใหม่จะเริ่มต้นและเหตุการณ์ "Session Start" ถูกบันทึก (ถ้า prefix ผลิตภัณฑ์ถูกตั้งไว้ จะเป็น "{PRODUCT} Session Start")

ถ้าผู้ใช้ออกจากแอปพลิเคชั่น ช่วงเวลาปัจจุบันจะสิ้นสุด ครั้งถัดไปที่แอปพลิเคชั่นเริ่มต้น/ถูกเปิดใช้งาน ช่วงเวลาใหม่จะเริ่มต้น


ข้อความ Debugging #

เพื่อทดสอบการดำเนินการของ SDK คุณสามารถเปิดใช้งานเอาท์พุตของข้อมูลการ debug ไปยังคอนโซลของนักพัฒนาซึ่งกรองโดยประเภทข้อความ:

เหตุการณ์เท่านั้น

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

การบันทึกแบบเต็ม

Finteza.addLogging(LogUtil.LogLevel.ALL);

การขัดข้องเท่านั้น

Finteza.addLogging(LogUtil.LogLevel.ERROR);

เพื่อปิดการใช้งานข้อความการ debug เรียก:

Finteza.addLogging(LogUtil.LogLevel.NONE);

ตัวอย่าง

ข้อความการ debug ต่อไปนี้แสดงการขัดข้องในการส่งเหตุการณ์เนื่องจากการขาดการเรียก method activate:

[event] ไม่สามารถส่งเหตุการณ์ 'Book Load': เรียก method 'activate' ก่อน