All Products
Search
Document Center

Quick Tracking:Memperkenalkan dan mengonfigurasi SDK

Last Updated:Jul 02, 2025

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 image

1.2 Temukan Organisasi Aplikasi image

1.3 temukan aplikasi image

1.4 klik "Untuk Mengintegrasikan"

image

1.5 Klik untuk mendapatkan kode integrasi eksklusif

image

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.

Penting

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 setup

Integrasi 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>' 
end

Catatan: 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:

  1. Pilih dan unduh komponen fungsional SDK. Dekompresi file .zip untuk mendapatkan paket komponen yang sesuai, seperti QTCommon.framework.

  2. Xcode File -> Tambahkan File ke "Proyek Anda", pilih paket komponen yang diunduh-> Tambahkan di Panel yang muncul. (Catatan: centang "Salin item jika diperlukan")

    image

  3. Tambahkan pustaka dependensi, dalam pengaturan proyek target -> tab General ->Linked Frameworks and Libraries

    sebagai berikut: 1615343052184-db860bef-a753-494f-92da-243a8c136b2d

  4. 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

  1. [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".) 1612266822165-29c8614c-00ce-4dd0-958e-76f02754d244

  2. 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.

  3. 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.