All Products
Search

This Product

    Quick Tracking:Fungsi Dasar

    Document Center

    Quick Tracking:Fungsi Dasar

    Last Updated:Jun 29, 2025

    1 Tinjauan Prinsip SDK

    1.1 Prinsip

    SDK menyediakan metode pelacakan berbasis perintah. Anda dapat mengirimkan perintah ke antrian perintah aplus_queue dari variabel lingkungan aplus. Variabel lingkungan aplus mengeksekusi perintah untuk memenuhi kebutuhan Anda. Format perintah adalah sebagai berikut:

    aplus_queue.push({
    'action': "$APIName", 
    'arguments': [$arguments] // Argumen adalah parameter input dari API yang ditentukan, 
})

    • Parameter action mewakili nama API yang mengirimkan instruksi. Parameter inputnya adalah string dan nilainya adalah nilai enumerasi. Nilai enumerasi yang tersedia adalah sebagai berikut:

      • setMetaInfo: menimpa pengaturan default yang ada dari SDK

      • appendMetaInfo: Konfigurasi default untuk append SDK

      • getMetaInfo: mendapatkan konfigurasi saat ini dari SDK

      • record: digunakan untuk mengirim log acara

      • sendPV: digunakan untuk mengirim log halaman

    • Parameter arguments adalah parameter input dari API yang ditentukan dalam action. Formatnya adalah array. Urutan elemen dalam array sama dengan urutan parameter input yang didefinisikan oleh API.

    1.2 Contoh

    // Mengubah pengaturan default SDK.
aplus_queue.push({
    action: 'aplus.setMetaInfo',
    arguments: [metaName, metaValue]
});

// Mendapatkan konfigurasi saat ini dari SDK.
aplus.getMetaInfo(metaName);

// Digunakan untuk mengirim log acara.
aplus_queue.push({
    action: 'aplus.record',
    arguments: [trackerEventCode, eventType, eventParams]
});

// Digunakan untuk mengirim log halaman.
aplus_queue.push({
    action: 'aplus.sendPV',
    arguments: [pageEventConfig, userData]
});

    2 Pencetakan Log

    aplus_queue.push({
    action: 'aplus.setMetaInfo',
    arguments: ['DEBUG', true]
});

    3 Strategi Pengiriman Log

    Ketika acara dipicu, laporan dikirim secara real-time.

    4. Konfigurasikan informasi aplikasi dasar

    Pada bagian pengenalan SDK, Anda dapat memodifikasi atau menambah beberapa pengaturan default.

    // AppKey dari aplikasi terintegrasi.
aplus_queue.push({
    action: 'aplus.setMetaInfo',
    arguments: ['appKey', 'xxxxxxx']
})

aplus_queue.push({
    action: 'aplus.setMetaInfo',
    arguments: ['aplus-rhost-v', 'quickaplus-Web-api.xxx.com.cn']
});

// Aktifkan mode debugging.
aplus_queue.push({
    action: 'aplus.setMetaInfo',
    arguments: ['DEBUG', true]
});

    MetaName

    Deskripsi konfigurasi Meta

    Deskripsi penugasan MetaValue

    Versi MongoDB yang didukung

    DEBUG

    Saat diaktifkan, konsol akan menampilkan log pelacakan SDK

    true untuk membuka log, false untuk menutup log

    semua

    appVersion

    Tetapkan versi Web saat ini

    Masukkan versi Web saat ini

    semua

    appKey

    Appkey yang Anda masukkan saat membuat aplikasi di sistem platform

    Anda perlu mendapatkan appkey yang sesuai dengan aplikasi Web yang disematkan di platform.

    semua

    aplus-rhost-v

    Domain Pelacakan dan Pelaporan (Tidak digunakan lagi)

    Anda bisa mendapatkan informasi yang dilacak oleh platform.

    semua

    trackDomain

    Domain Pelacakan dan Pelaporan

    Anda bisa mendapatkan informasi yang dilacak oleh platform.

    Mulai dengan v2.0.0

    _dev_id

    ID Perangkat Kustom

    Mode ini menimpa ID perangkat yang dihasilkan otomatis oleh QuickTracking SDK.

    semua

    _user_id

    Tetapkan userid

    ID akun login kustom.

    semua

    _hold

    Kirim sinyal tahan. Anda dapat mengatur _hold beberapa kali selama siklus hidup SDK. BLOCK dan START harus digunakan berpasangan. Jika tidak, pengiriman log terpengaruh.

    Jenis enumerasi. Nilai dan deskripsi yang tersedia adalah sebagai berikut:

    • "START": mengaktifkan pengiriman log.

    • "BLOCK": mencegah log dikirim. Anda dapat menyelesaikan persiapan sebelum mengirim log sebelum status BLOCK.

    semua

    Catatan: Parameter ini hanya berlaku untuk pemanggilan API aplus_queue.push.

    aplus-jsbridge-only

    Saklar log pelaporan H5

    • true: menonaktifkan pengiriman log H5. Secara umum, hanya log bridging yang dapat dikirim dalam skenario bridging.

    • false: mengaktifkan pengiriman log H5. Nilai default adalah false.

    semua

    aplus-utm-expire-days

    tetapkan waktu kedaluwarsa parameter utm

    Secara default, periode sesi saat ini valid. Anda dapat menyesuaikan waktu kedaluwarsa parameter utm berdasarkan hari. Hasilnya disimpan dalam cookie. Pengaturan waktu kedaluwarsa maksimum bergantung pada waktu kedaluwarsa maksimum aktual cookie yang didukung oleh setiap browser.

    Mulai v2.0.7

    aplus-preset-events-disabled

    Acara prefabrikasi digunakan untuk menonaktifkan pelacakan default SDK

    Nilai defaultnya adalah undefined. Anda dapat memberikan nilai ke array. Contoh:

    aplus_queue.push({
    action: 'aplus.setMetaInfo',
    arguments: ['aplus-preset-events-disabled', [
        '$$_page_leave', // Acara keluar halaman prefabrikasi
    ]] 
});

    Mulai v2.0.9