Pemasangan dan permulaan

Untuk memasang Finteza SDK, gunakan CocoaPods atau Carthage pengurus pakej atau muat turun arkib fail dari GitHub secara manual.

Memasang melalui CocoaPods #

Untuk menyambungkan Finteza SDK, tambah string berikut kepada Podfile projek anda:

pod 'FintezaSDK'

Seterusnya, jalankan arahan pemasangan:

memasang pod

Apabila bekerja dengan CocoaPods, sentiasa gunakan .xcworkspace fail dan bukannya .xcodeproj.


Pasang melalui Carthage #

Untuk menyambungkan Finteza SDK, tambah string berikut kepada Cartfile projek anda:

github "finteza/mobile-sdk-ios"

Manual pemasangan #

Muat turun dan unzip fail FintezaSDK-X.X.X.framework.zip. Seterusnya, pindahkan FintezaSDK.framework pada projek anda di Xcode.

Dayakan pilihan "Copy items if needed" semasa pemasangan.

Memasang Finteza SDK untuk iOS

Memulakan SDK dalam aplikasi #

Buka fail perwakilan aplikasi anda dan import Finteza SDK:

Objective-C:

#import <FintezaSDK/FintezaSDK.h>

Swift:

import FintezaSDK

Mulakan SDK dalam didFinishLaunchingWithOptions kaedah menggunakan ID dan alamat laman web:

Objective-C:

[Finteza initialize:@"{WEBSITE_ID}" laman:@"{WEBSITE_URL}" produk:@"{PRODUCT}"];

Swift:

Finteza.initialize("{WEBSITE_ID}", laman: "{WEBSITE_URL}", produk: "{PRODUCT}")

Tetapkan ID laman web sebagai {WEBSITE_ID}. Ia boleh diperolehi dalam tetapan laman web (medan ID) dari Finteza panel. Seterusnya, tetapkan parameter:

Parameter

Jenis

Penerangan

laman

string

Nama domain laman web, sebagai contoh, "my.site.com".

produk

string

Nama produk yang akan digunakan sebagai awalan untuk acara pelabelan dihantar ke Finteza oleh permohonan anda.

 

Anda mungkin memerlukannya untuk memisahkan peristiwa pada platform yang berbeza sekiranya anda mempunyai aplikasi untuk PC, iOS, Android, dll. Sebagai contoh, jika anda menyatakan produk "iOS App" dan hantar Peristiwa "Registration", nama peristiwa akhir di Finteza akan menjadi "iOS App Registration".

 

Tetapkan 'nil' untuk mengelakkan penggunaan awalan.

 

Anda boleh menukar nama produk kemudian menggunakan setProduct fungsi:

 

Objective-C:

 

[Finteza setProduct:@"{PRODUCT}"];

 

 

Swift:

 

Finteza.setProduct("{PRODUCT}")

 

Peristiwa pelancaran aplikasi #

Tambah kod berikut applicationDidBecomeActive:

Objective-C:

[Finteza activate];

Swift:

Finteza.activate()

Apabila memanggil aktifkan, SDK menghantar acara "Install Finish" ke Finteza semasa pelancaran aplikasi pertama (jika awalan produk ditetapkan, kemudian "{PRODUCT} Install Finish").

Juga, ketika memanggil aktifkan, sesi kerja baru bermula dan acara "Session Start" didaftarkan (jika awalan produk ditetapkan, maka "{PRODUCT} Session Start").

Sesi baru bermula hanya jika lebih daripada tiga minit telah berlalu sejak masa sebelumnya permohonan menjadi tidak aktif.


Mesej penyahpepijatan #

Untuk menguji operasi dengan SDK, anda boleh mendayakan output penyahpepijat data ke konsol pembangun. Data pada peristiwa dan iklan yang dipaparkan dipaparkan secara berasingan.

Peristiwa

Objective-C:

[Finteza addLogging:FintezaLogModeEvents];

Swift:

Finteza.addLogging(FintezaLogModeEvents)

Iklan

Objective-C:

[Finteza addLogging:FintezaLogModeBanner];

Swift:

Finteza.addLogging(FintezaLogModeBanner)

Contoh

Mesej penyahpepijatan berikut menunjukkan ralat penghantaran peristiwa disebabkan tiada aktifkan kaedah panggilan:

[event] tidak dapat menghantar 'Book Load' peristiwa: hubungi kaedah 'aktifkan' dahulu