Cai đặt va khởi tạo
Dể cai đặt SDK của Finteza, hãy sử dụng trình quản lý goi CocoaPods hoặc Carthage hoặc tải về luu trữ tập tin từ GitHub theo cach thủ cong.
Cai đặt qua CocoaPods #
Dể kết nối SDK của Finteza, hãy them chuỗi duới đay vao Podfile của dự an:
pod 'FintezaSDK' |
Tiếp theo, chạy lệnh cai đặt:
cai đặt pod |
Khi lam việc với CocoaPods, hãy luon sử dụng tập tin .xcworkspace thay vì .xcodeproj. |
Cai đặt qua Carthage #
Dể kết nối SDK của Finteza, hãy them chuỗi duới đay vao Cartfile của dự an:
github "finteza/mobile-sdk-ios" |
Cai đặt thủ cong #
Tải về va giải nen tập tin FintezaSDK-X.X.X.framework.zip. Tiếp theo, chuyển FintezaSDK.framework vao dự an của bạn trong Xcode.
Bật tuy chọn "Copy items if needed" (Sao chep cac mục nếu cần) trong qua trình cai dặt.
Cai đặt SDK trong ứng dụng #
Mở tập tin của ủy nhiệm ứng dụng va nhập SDK của Finteza:
Objective-C:
#nhập <FintezaSDK/FintezaSDK.h> |
Swift:
nhập FintezaSDK |
Khởi tạo SDK trong phuong thức didFinishLaunchingWithOptions sử dụng ID va địa chỉ website:
Objective-C:
[Finteza initialize:@"{WEBSITE_ID}" site:@"{WEBSITE_URL}" product:@"{PRODUCT}"]; |
Swift:
Finteza.initialize("{WEBSITE_ID}", site: "{WEBSITE_URL}", sản phẩm: "{PRODUCT}") |
Dặt ID website ở dụng {WEBSITE_ID}. No co thể co đuợc trong phần cai đặt website (truờng ID) của bảng điều khiển Finteza. Tiếp theo, hãy đặt cac thong số:
Thong số |
Loại |
Mo tả |
||
---|---|---|---|---|
trang |
chuỗi |
Ten mienf của website, chẳng hạn, "my.site.com". |
||
chuỗi |
Ten sản phẩm co thể đuợc sử dụng nhu một tiền tố để dan nhãn cac sự kiện đuợc gửi tới Finteza bởi ứng dụng của bạn.
Bạn co thể cần no để tach cac sự kiện tren cac nền tảng khac nhau trong truờng hợp bạn co cac ứng dụng PC, iOS, Android, v.v. Chẳng hạn, nếu bạn định rõ sản phẩm "Ứng dụng iOS" va gửi sự kiện "Dang ký", ten sự kiện cuối cung trong Finteza sẽ la "Dang ký Ứng dụng iOS".
Dặt 'nil' để tranh sử dụng tiền tố.
Bạn co thể thay đổi ten sản phẩm sau đo sử dụng ham setProduct:
Objective-C:
Swift:
|
Cac sự kiện khởi chạy ứng dụng #
Them mã duới đay vao applicationDidBecomeActive:
Objective-C:
[Finteza activate]; |
Swift:
Finteza.activate() |
Khi gọi ra phuong thức kich hoạt, SDK gửi sự kiện "Hoan tất Cai đặt" (Install Finish) tới Finteza trong lần khởi chạy ứng dụng đầu tien (nếu tiền tố của sản phẩm đuợc đặt, thì sẽ la "{PRODUCT} Install Finish"").
Ngoai ra, khi gọi ra phuong thức kich hoạt, một phien lam việc mới sẽ bắt đầu va sự kiện "Bat đầu Phien" (Session Start) sẽ đuợc đang ký (nếu tiền tố sản phẩm đuợc đặt, thì sẽ la "{PRODUCT} labe").
Phien mới bắt đầu chỉ nếu tren ba phut đã troi qua kể từ lần truớc đo ứng dụng trở nen khong hoạt động. |
Thong bao gỡ lỗi #
Dể kiểm tra việc hoạt động với SDK, bạn co thể bật đầu ra của dữ liệu gỡ lỗi đuợc gửi tới bảng điều khiển của nha phat triển. Dữ liệu về sự kiện va hiển thị quảng cao đuợc hiển thị rieng rẽ.
Sự kiện
Objective-C:
[Finteza addLogging:FintezaLogModeEvents]; |
Swift:
Finteza.addLogging(FintezaLogModeEvents) |
Quảng cao
Objective-C:
[Finteza addLogging:FintezaLogModeBanner]; |
Swift:
Finteza.addLogging(FintezaLogModeBanner) |
Vi dụ
Thong bao gỡ lỗi duới đay chỉ ra một sự kiện gửi lỗi do sự vắng mặt của ham gọi ra phuong thức kich hoạt:
[event] khong thể gửi 'Book Load': gọi ra phuong thức 'kich hoạt' truớc tien |