All Products
Search
Document Center

Quick Tracking:Integrasi Dasar

Last Updated:Jun 29, 2025

Kepatuhan SDK macOS

Pernyataan Kepatuhan

  • Kepatuhan MIIT mengharuskan aplikasi untuk tidak mengumpulkan informasi pribadi sebelum pengguna menyetujui kebijakan privasi. Oleh karena itu, Anda harus menampilkan "Kebijakan Privasi" saat aplikasi diluncurkan untuk pertama kalinya guna mendapatkan persetujuan pengguna.

  • Anda perlu memberi tahu pengguna bahwa aplikasi Anda mengintegrasikan layanan SDK QuickTracking dan menambahkan istilah referensi berikut ke dalam Kebijakan Privasi:

    • Produk kami mengintegrasikan Quick Tracking SDK. Quick Tracking SDK mengumpulkan OS/OSVERSION/TIMEZONE/LANGUAGE/RESOLUTION/produsen perangkat/model perangkat/merek perangkat/jaringan untuk menyediakan layanan analisis statistik.

  • Pastikan pengguna menyetujui Kebijakan Privasi sebelum menginisialisasi QuickTracking SDK. Jika pengguna tidak menyetujui Kebijakan Privasi, QuickTracking SDK tidak dapat diinisialisasi.

Inisialisasi SDK

Catatan: Inisialisasi SDK harus dilakukan di utas utama titik masuk program. Jika tidak, beberapa data acara mungkin hilang.

Memperoleh appkey

Saat menginisialisasi SDK, Anda harus menentukan parameter appkey. Appkey adalah ID unik aplikasi di QuickTracking yang dibuat saat aplikasi dibuat. Untuk informasi lebih lanjut tentang cara memperoleh atau melihat appkey, lihat Manajemen Aplikasi.

Memperoleh nama domain penerimaan

Nama domain koleksi adalah alamat server nama domain untuk pelaporan log SDK, yang diperoleh dari "Latar Belakang Manajemen QuickTracking-Konsol Manajemen-Kumpulkan Informasi-Nama Domain Koleksi".

Inisialisasi SDK

#import <QuickTrackingSDK/QuickTrackingSDK.h>

- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
    QTSDKConfig *sdkConfig;
    // Inisialisasi konfigurasi SDK.
    sdkConfig = [[QTSDKConfig alloc] initWithAppkey:@"Pengenal unik aplikasi Anda"
                                        trackDomain:@"https:// Nama domain Anda"
                                      launchOptions:nil];
                                      
    // Tentukan saluran tempat aplikasi dipublikasikan. Contoh: appstore.
    sdkConfig.channel = @"Saluran rilis aplikasi Anda";
    
    // Atur interval minimum (dalam milidetik) untuk pengiriman batch. Nilai default: 3s.
    sdkConfig.batchSendInterval = 3000;
    
    // Aktifkan pencetakan log SDK, yang dinonaktifkan secara default.
    sdkConfig.enableLog = YES; 
    
    // Pastikan SDK tidak dinonaktifkan. Nilai default adalah NO.
    // sdkConfig.disableSDK = NO;
    
    // Tunggu hasil pengiriman data saat aplikasi masuk ke latar belakang. Nilai default adalah NO.
    // sdkConfig.enableSendLogsBeforeEnterBackground = YES;
    
    // "Latar belakang manajemen QuickTracking -- pengumpulan data -- verifikasi pelacakan -- verifikasi aplikasi PC"
    // sdkConfig.debugKey = @"97052112091876_xxxxx";
    
    // Atur jumlah maksimum acara cache lokal. Nilai default adalah 10000. Jika jumlah acara cache lokal melebihi batas, beberapa acara akan dihapus.
    // sdkConfig.maxCacheSize = 10000;
      
    // Menentukan apakah akan mengaktifkan pemantauan acara jembatan H5. Secara default, pemantauan acara jembatan H5 dinonaktifkan.
    // sdkConfig.enableJSBridge = YES;
    
    // Inisialisasi SDK.
    [QuickTrackingSDK initWithConfig:sdkConfig];
}

Deskripsi parameter QTSDKConfig

Parameter

tipe

Deskripsi

Diperlukan

appkey

nonnull NSString

Pengkodean unik aplikasi, yaitu appkey aplikasi.

Ya

trackDomain

nonnull NSString

Nama domain pengumpulan data, yang digunakan untuk menentukan tujuan data yang dikirim.

Ya

launchOptions

nullable id

Opsi startup, yang biasanya berisi properti konfigurasi (yang bisa nil) saat aplikasi dimulai.

Tidak

Daftar properti QTSDKConfig

Parameter

tipe

Deskripsi

Diperlukan

batchSendInterval

NSInteger

Interval waktu minimum antara dua transmisi data, dalam milidetik. Nilai default adalah 3 detik. Nilai minimum adalah 3 detik.

Tidak

maxCacheSize

NSInteger

Jumlah maksimum acara cache lokal. Nilai default adalah 10000. Jika jumlah acara melebihi batas, beberapa acara akan dihapus.

Tidak

batchSendQueueSize

NSInteger

Jumlah maksimum log cache yang dapat diunggah. Nilai default: 100. Jika Anda mengatur parameter ini ke nilai besar, mungkin terjadi kehilangan paket permintaan jaringan.

Tidak

enableLog

BOOL

Apakah akan mengaktifkan pencetakan log. Nilai default adalah NO.

Tidak

disableSDK

BOOL

Apakah akan menonaktifkan SDK. Nilai default: NO. Setelah Anda menonaktifkan SDK, SDK tidak memicu acara dan tidak mengirim permintaan jaringan.

Tidak

enableSendLogsBeforeEnterBackground

BOOL

Apakah akan menunggu hasil pengiriman data saat aplikasi masuk ke latar belakang. Nilai default adalah NO. Jika Anda mengatur YA, sistem menunggu hasil pengiriman data.

Tidak

cacheFilePath

NSString

Jalur tempat data pelacakan kustom disimpan. Jalur ini hanya berlaku untuk lingkungan pengembangan macOS.

Tidak

channel

NSString

Saluran rilis aplikasi. Digunakan untuk mengidentifikasi saluran rilis aplikasi.

Tidak

debugKey

NSString

Pengenal verifikasi titik pelacakan digunakan untuk memberikan pengenal konfirmasi dalam proses aliran data verifikasi.

Tidak

enableJSBridge

Boolean

Saklar jembatan H5, digunakan untuk mendengarkan acara jembatan H5, dinonaktifkan secara default

Tidak