All Products
Search
Document Center

Quick Tracking:Fungsi Dasar

Last Updated:Oct 15, 2025

1 Tinjauan Prinsip SDK

Prinsip 1.1

SDK menyediakan dua metode pemanggilan API:

  • Pemanggilan API secara langsung menggunakan variabel lingkungan aplus.

  • Pengiriman perintah API ke antrian aplus_queue dari SDK.

Catatan: Pilih salah satu dari kedua cara ini; keduanya dapat digabungkan.

1.1.1 Gunakan variabel lingkungan aplus untuk memanggil Operasi API

Kode untuk panggilan API langsung lebih ringkas dalam format berikut:

const { aplus } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.
aplus.${APIName}($arguments) // Argumen adalah parameter input 
dari API yang ditentukan.

APIName mencakup:

  1. setMetaInfo: Menimpa pengaturan default yang ada dari SDK.

  2. appendMetaInfo: Konfigurasi default dari append SDK.

  3. getMetaInfo: Mendapatkan konfigurasi saat ini dari SDK.

  4. record: Digunakan untuk mengirim log event.

  5. sendPV: Digunakan untuk mengirim log halaman.

Argumen adalah parameter input untuk setiap pemanggilan API.

1.1.2 Kirim instruksi API ke antrian instruksi aplus_queue

Untuk mengirim perintah API ke SDK, Anda dapat mengirim perintah ke antrian perintah aplus_queue dari SDK. SDK akan mengeksekusi perintah tersebut. Format perintah adalah sebagai berikut:

const { aplus_queue } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.
aplus_queue.push({
 	'action': "$APIName", 
  'arguments': [$arguments] // Argumen adalah parameter input dari API yang ditentukan.
})
  • Parameter action mewakili nama API yang mengirim instruksi. Input parameternya adalah string dan nilainya adalah nilai enumerasi. Nilai enumerasi yang tersedia adalah sebagai berikut:

    • aplus.setMetaInfo: Menimpa pengaturan default yang ada dari SDK.

    • aplus.appendMetaInfo: Konfigurasi default dari append SDK.

    • aplus.getMetaInfo: Mendapatkan konfigurasi saat ini dari SDK.

    • aplus.record: Digunakan untuk mengirim log peristiwa.

    • aplus.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

1.2.1 Gunakan variabel lingkungan aplus untuk memanggil operasi API

const { aplus } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

// Menimpa pengaturan default dari SDK.
aplus.setMetaInfo(metaName, metaValue);

// Pengaturan default dari append SDK. Parameter ini hanya valid ketika parameter metaValue bertipe Array atau Object.
aplus.appendMetaInfo(metaName, metaValue)

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

// Digunakan untuk mengirim log peristiwa.
aplus.record(trackerEventCode, eventType, eventParams);

// Digunakan untuk mengirim log halaman.
aplus.sendPV(pageEventConfig, userData);

1.2.2 Kirim perintah API ke antrian perintah aplus_queue

const { aplus_queue, aplus } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, byte tt, Baidu Swan, dll.

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

// Pengaturan default dari append SDK. Parameter ini hanya valid ketika parameter metaValue bertipe Array atau Object.
aplus_queue.push({
  action: 'aplus.appendMetaInfo',
  arguments: [metaName, metaValue]
});

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

// Digunakan untuk mengirim log peristiwa.
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-hari pencetakan log

const aplusConfig = {
	metaInfo: {
		...
		'DEBUG': true, // Aktifkan mode debugging.
  	...
	}
};

Contoh log keluaran: image

3-hari Kebijakan Pengiriman Logo

Kebijakan pelaporan event default untuk SDK applet QuickTracking adalah:

  • Non-agregasi pelaporan log permintaan normal.

  • Log permintaan dikirim setiap 1 detik.

  • Secara default, maksimum 1 saluran permintaan jaringan untuk mini program digunakan.

  • Periode timeout permintaan default adalah 3 detik. Prioritas periode timeout permintaan default lebih rendah daripada beberapa platform applet. Atur networkTimeout di app.json (contoh tautan adalah applet WeChat).

Opsional. 3.1 untuk mengaktifkan agregasi dan pelaporan log

Dalam beberapa skenario, Anda ingin menggabungkan pelaporan permintaan SDK. Anda dapat menambahkan item konfigurasi SDK max-queue-count untuk menyelesaikan fungsi pelaporan agregasi. Contoh:

const aplusConfig = {
	metaInfo: {
		...
    // Opsional. Jumlah entri log yang akan digabungkan. Secara default, entri log tidak digabungkan. Kami merekomendasikan agar Anda menentukan maksimal 1 hingga 5.
		'max-queue-count': 1,  
  	...
	}
};

Sebagaimana ditunjukkan pada gambar berikut: Jika max-queue-count disetel ke 5, permintaan hanya dikirim ke server ketika lima entri log terkumpul.

Jika jumlahnya kurang dari 5, itu akan dilaporkan secara otomatis ketika Anda keluar dari mini program.

image

Catatan:

  1. Mini program WeChat mensyaratkan bahwa "memulai terlalu banyak permintaan dalam waktu singkat akan memicu batas jumlah data permintaan paralel mini program. Pada saat yang sama, terlalu banyak permintaan juga dapat menyebabkan masalah seperti lambatnya loading. Kita harus mengontrol jumlah permintaan dengan wajar dan bahkan menggabungkan permintaan." Oleh karena itu, kami merekomendasikan Anda menggunakan "Laporan Log Agregat" sebelumnya.

  2. Kami merekomendasikan Anda agar tidak menyetel nilai max-queue-count terlalu besar. Semakin besar jumlah catatan yang di-aggregasi dan dilaporkan, semakin besar bandwidth yang digunakan oleh log permintaan tunggal. Ada risiko kehilangan jaringan.

Opsional. 3.2 Ubah jumlah saluran yang digunakan oleh permintaan jaringan SDK

Beberapa platform mini program, seperti mini program WeChat, mensyaratkan bahwa jika terlalu banyak permintaan jaringan dimulai dalam waktu singkat, kinerja halaman mungkin terpengaruh. Kami merekomendasikan Anda mengontrol jumlah permintaan dan bahkan menggabungkan permintaan. Untuk informasi lebih lanjut, lihat deskripsi SDK 3.1. Saluran permintaan jaringan default dari Quick Tracking mini program maksimal satu. Contoh berikut menunjukkan cara memodifikasi saluran permintaan:

const aplusConfig = {
	metaInfo: {
		...
    // Opsional. Jumlah maksimum saluran permintaan bersamaan. Nilai default: 1. Nilai valid: 1 hingga 5.
		'aplus-mini-requests-limit': 1,  
  	...
	}
};

Opsional. 3.3 Ubah periode timeout permintaan default SDK

Periode timeout permintaan jaringan default bervariasi di antara platform mini program. Beberapa platform, seperti WeChat, Douyin, Alipay, dan DingTalk, mendukung periode timeout permintaan kustom. Anda dapat memodifikasi item konfigurasi SDK aplus-request-timeout untuk menyesuaikan periode timeout permintaan SDK. Periode timeout default adalah 3000ms. Contoh konfigurasi adalah sebagai berikut:

const aplusConfig = {
	metaInfo: {
		...
    // Opsional. Periode timeout permintaan default. Unit: milidetik.
		'aplus-request-timeout': 3000,
  	...
	}
};

Catatan: Semua platform applet juga mendukung pengaturan seragam networkTimeout di app.json. Jika pengembang menerapkan konfigurasi networkTimeout di app.json, konfigurasi seragam memiliki prioritas lebih tinggi. Screenshot berikut menunjukkan dokumen resmi applet WeChat. Untuk applet platform lainnya, silakan merujuk pada dokumen resmi masing-masing platform.

image

4. Konfigurasikan informasi aplikasi dasar

Dalam bagian pengenalan SDK, Anda dapat memodifikasi atau menambahkan beberapa pengaturan default.

const aplusConfig = {
	metaInfo: {
    'appKey': '', // Appkey yang Anda masukkan saat membuat aplikasi di QuickTracking. Parameter ini wajib.
    'trackDomain': '', // Wajib. Nama domain untuk pengumpulan dan pelaporan log.
    '_user_id': 'testUserId', // Laporkan ID akun login mini program sesuai kebutuhan. Jika Anda perlu menghitung dan menganalisis data lintas pengguna
    'autoGetOpenid': true, // Secara otomatis memperoleh pengaturan openid (direkomendasikan! Saat ini, hanya applet WeChat yang didukung)
    'DEBUG': true, // Nyalakan logging debug.
    // '_hold': 'BLOCK', // Dalam skenario asinkron, Anda harus memblokir pelaporan log. Setelah Anda menyetel parameter OpenID, Anda dapat melaporkan log.
    'appVersion': ''// Opsional. Versi mini program Anda. Nilai default: devtools.
	}
};

import { initQTSDK } from './utils/qt_mini.umd.js';
initQTSDK(aplusConfig);

MetaName

Deskripsi konfigurasi Meta

Deskripsi penugasan MetaValue

Versi yang didukung

DEBUG

Setelah Anda mengaktifkan fitur ini, log pelacakan SDK dikembalikan di konsol.

true untuk membuka log, false untuk menutup log

semua

appVersion

Tetapkan versi applet saat ini

Masukkan versi mini program saat ini.

semua

appKey

Appkey yang Anda masukkan saat membuat aplikasi di sistem platform

Anda perlu mendapatkan appkey yang sesuai dengan mini program pelacakan di platform.

semua

aplus-rhost-v

Nama Domain Pengumpulan dan Pelaporan (Tidak digunakan lagi)

Anda bisa mendapatkan informasi yang dikumpulkan oleh platform.

semua

trackDomain

Kumpulkan dan laporkan nama domain

Anda bisa mendapatkan informasi yang dikumpulkan oleh platform.

Mulai dengan v2.0.0

autoGetOpenid

Kumpulkan openid secara otomatis

Nilai Boolean. Nilai default adalah false.

Anda dapat menggunakan kode untuk mendapatkan OpenID.

semua

_anony_id

Tetapkan pengenal unik perangkat

ID pengguna anonim yang ditentukan bisnis

, alipayid untuk Alipay, openid untuk WeChat

semua

_dev_id

Tetapkan unionid di mini program WeChat

Tetapkan unionid di mini program WeChat

semua

_user_id

Tetapkan userid

ID akun login kustom.

semua

_hold

Kirim sinyal hold. Anda dapat menyetel _hold beberapa kali selama siklus hidup SDK. Namun, Anda harus menyetel pengaturan BLOCK dan START secara berpasangan. Jika tidak, pelaporan log terpengaruh.

Catatan

BLOCK hanya mengontrol perintah API yang dikirim oleh antrian perintah aplus_queue, dan tidak berlaku pada API yang dipanggil langsung oleh aplus variabel lingkungan.

Tipe 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

max-queue-count

Aktifkan agregasi log SDK

Nilai angka. Nilai default adalah undefined. Anda dapat mengonfigurasi angka 1 hingga 5.

semua

aplus-request-timeout

Tetapkan periode timeout permintaan default SDK

Nilai angka. Unit: milidetik. Nilai default adalah 3000ms. Platform yang didukung termasuk WeChat, Douyin, Alipay, dan DingTalk.

Mulai dengan v2.0.0

aplus-mini-requests-limit

Tetapkan jumlah maksimum saluran permintaan jaringan yang digunakan secara bersamaan oleh SDK

Nilai angka. Nilai default adalah 1. Nilai 1 hingga 5 didukung.

Mulai dengan v2.0.8

aplus-preset-events-disabled

Gunakan event prefabrikasi untuk menonaktifkan pengumpulan default SDK

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

'aplus-preset-events-disabled': [
 '$$_share', // Buat peristiwa berbagi.
 '$$_reach_bottom', // Peristiwa prefabrikasi bottoming
 '$$_perf_warning', // Peristiwa performa jaringan prefabrikasi
 '$$_user_profile', // Peristiwa pelaporan atribut pengguna.
 ]

Mulai dengan v2.0.8