Informasi dasar SDK
SDK | Nomor versi. | Nilai md5. | Nama paket aplikasi. |
QuickTracking iOS SDK | Versi terbaru: 1.6.6.PX Catatan pembaruan: Catatan pembaruan iOS SDK | 4670509ae0c6ec3373147d380fd89530 | com.quicktracking.sdk.ios.QTCommon |
1 Integrasi cepat
Di latar belakang QuickTracking, kode integrasi khusus dihasilkan untuk setiap Aplikasi yang dapat diintegrasikan sesuai dengan panduan dalam produk. Periksa apakah Anda telah menggunakan Umeng + SDK. Jika Anda telah menggunakannya, ubah jalur file SDK tepat waktu. Untuk informasi lebih lanjut, lihat 1.6 dalam dokumen ini.
1.1 masuk ke latar belakang produk 
1.2 Temukan Organisasi Aplikasi 
1.3 temukan aplikasi 
1.4 klik "Untuk Mengintegrasikan"

1.5 Klik untuk mendapatkan kode integrasi eksklusif

1.6 periksa apakah ada konflik dengan Umeng + SDK
Catatan bahwa Anda perlu memeriksa apakah Anda sudah menggunakan Umeng + SDK. Jika Anda sudah menggunakannya, pastikan untuk menyetel ulang jalur file SDK.
Ubah mode jalur file SDK:
Anda telah mengintegrasikan Umeng + SDK. Anda perlu mengintegrasikan QT SDK: Tambahkan [QTConfigure resetStorePath];
Anda telah mengintegrasikan QT SDK. Jika Anda perlu mengintegrasikan Youmeng SDK, tambahkan [UMConfigure resetStorePath] di depan semua kode QT dan Youmeng. Ini setidaknya lebih awal daripada penerimaan nama domain.
Jika tidak dipanggil berdasarkan logika sebelumnya, Umeng + SDK dan QT SDK menggunakan jalur penyimpanan yang sama, menyebabkan kebingungan log. Logika spesifiknya adalah: metode inisialisasi SDK mana yang dipanggil pertama kali, atur ulang jalur file dari SDK lain, misalnya, panggil [QTConfigure resetStorePath] untuk Umeng + SDK yang diinisialisasi pertama kali;, jika itu adalah QT SDK yang diinisialisasi pertama kali, Anda perlu memanggil [UMConfigure resetStorePath];
Catatan: Jika Anda menyetel ulang jalur QT SDK, nilai kunci toko informasi fitur yang disetel secara aktif untuk SDK, seperti akun pengguna dan versi aplikasi, akan berubah. Jika Anda perlu menggunakan bidang ini untuk pemrosesan bisnis, kami sarankan Anda menyetel ulang bidang ini. Kami sarankan Anda mengonfigurasi bidang ini saat Anda mengintegrasikan QT SDK untuk pertama kalinya untuk menghindari kehilangan data.
2 Detail kode integrasi
Jika halaman sebelumnya tidak dapat dijangkau karena alasan tertentu, Anda perlu melihat dokumen sebelum dapat mengintegrasikannya. Kode integrasi spesifik adalah sebagai berikut:
2.1 Persiapan Parameter
appkey: diperoleh dari daftar aplikasi
Nama domain koleksi: diperoleh di modul "Konsol Manajemen-Kumpulkan Informasi"
2.2 memperkenalkan SDK
Jika Anda menjalankan perintah pod setup di terminal, dibutuhkan waktu lama untuk menarik perpustakaan pod terbaru.
$ pod setupIntegrasi Cocoapods dapat mengonfigurasi SDK yang diperlukan secara fleksibel. Jika target proyek bernama "QuickTrackingDemo", SDK berikut dapat ditambahkan, seperti format direktori root Podfile proyek:
target 'QuickTrackingDemo' do
pod '<Nama SDK Pelacakan Cepat>'
endCatatan: Kami sarankan Anda menggunakan perintah pod update untuk langsung memperbarui item baru karena perintah pod search mungkin gagal menemukan item baru.
Perpustakaan Dasar Pelacakan Cepat
//SDK analisis statistik QuickTracking
pod 'QTCommon', '~> 1.6.6.PX'// Tentukan nomor versi.
// Anda dapat menambahkan UMCCommonLog di Logstore dasar ke proyek untuk pengembangan dan debugging.
pod 'UMCCommonLog'Catatan: UMCCommonLog digunakan untuk men-debug SDK dan fitur terkait selama fase pengembangan. Anda dapat menghapus SDK sebelum menerbitkan aplikasi.
2.3 integrasi manual
Pustaka dependensi:
Dapatkan ID operator oleh
CoreTelephony.framework
libz.tbd Kompresi Data
libsqlite3.tbd Cache Data
SystemConfiguration.framework untuk menentukan status jaringan
libc++.tbd Pustaka Standar C++ Konfigurasi Teknik:
Pilih dan unduh komponen fungsional SDK. Dekompresi file .zip untuk mendapatkan paket komponen yang sesuai, seperti QTCommon.framework.
Xcode
File->Tambahkan File ke "Proyek Anda", pilih paket komponen yang diunduh->Tambahkandi Panel yang muncul. (Catatan: centang "Salin item jika diperlukan")
Tambahkan pustaka dependensi, dalam pengaturan proyek
target-> tab General ->Linked Frameworks and Librariessebagai berikut:

Di Targets->BuildSettings, Anda Other Linker Flags tambahkan -ObjC. Anda harus menambahkan item ini. Catatan bahwa C ditulis, bukan C.
2.4 memperkenalkan file header
#import <QTCommon/QTCommon.h>
# import <UMCommonLog/UMCommonLogManager.h> // Anda perlu menambahkan itu
3 Verifikasi konfigurasi tag
Tambahkan URL Scheme Anda ke proyek. URL Scheme terletak di pengaturan proyek target -> tab Info ->Jenis URL. Skema: atm.yourappkey. Panggil fungsi [QTMobClick handleUrl:url] di AppDelegate untuk menerima URL
Panggilan AppDelegate:
- (BOOL)application:(UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
if ([QTMobClick handleUrl:url]) {
return YES;
}
return YES;
}Panggilan SceneDelegate:
- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions {
for (UIOpenURLContext *context in connectionOptions.URLContexts) {
[QTMobClick handleUrl:context.URL];
}
}
- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
[QTMobClick handleUrl:URLContexts.allObjects.firstObject.URL];
}4 Deskripsi IDFA
[Pelacakan Cepat] Secara default, SDK mengumpulkan pengenal IDFA untuk menganalisis dan memverifikasi data dengan lebih akurat. Untuk kasus di mana aplikasi itu sendiri tidak mendapatkan idfa, disarankan untuk mengonfigurasi aplikasi sebagai berikut saat mengirimkannya ke AppStore: (untuk menghindari ditolak oleh Apple dengan alasan bahwa "aplikasi tidak berisi fungsi iklan tetapi mendapatkan pengenal iklan IDFA".)

Quick Tracking SDK tidak secara aktif mengajukan izin IDFA. Jika aplikasi Anda tidak mengajukan izin IDFA, Quick Tracking tidak akan memicu pop-up jendela aplikasi izin klien. Oleh karena itu, Anda harus mengonfigurasi aplikasi di aplikasi Anda.
Jika pengguna tidak setuju untuk mengumpulkan IDFA, setel bidang kustom atau kembalikan string kosong. Untuk informasi lebih lanjut, lihat 2.1 Pengaturan ID Perangkat. Dengan cara ini, Quick Tracking SDK tidak mengumpulkan IDFA.