Untuk mengumpulkan dan menganalisis informasi pengguna dalam mini program Anda—seperti penggunaan aplikasi, riwayat penjelajahan, dan perilaku pembelian—gunakan WebTracking JavaScript SDK untuk mengunggah log pengguna langsung ke Logstore. SDK ini mengirimkan log langsung dari klien mini program, melewati server aplikasi Anda sehingga mengurangi beban pada server tersebut. Topik ini menjelaskan cara mengunggah log menggunakan WebTracking JavaScript SDK.
Prasyarat
Fitur WebTracking telah diaktifkan untuk Logstore. Untuk informasi selengkapnya tentang WebTracking dan cara mengaktifkannya, lihat Gunakan WebTracking untuk mengumpulkan log front-end.
Untuk keamanan data, platform mini program mengharuskan Anda mengonfigurasi daftar domain permintaan yang diizinkan. Tambahkan domain komunikasi aman untuk WebTracking ke daftar tersebut. Domain harus dalam format
https://${project}.${host}. Istilahprojectdanhostdijelaskan di bawah ini.
Batasan
WebTracking JavaScript SDK untuk mini program membatasi ukuran setiap unggahan log hingga 10 MB.
WebTracking mendukung berbagai mini program, seperti WeChat Mini Program, WeChat Mini Game, Alipay Mini Program, ByteDance Mini Program, DingTalk Mini Program, QQ Mini Program, QQ Mini Game, dan Baidu Mini Program.
Langkah 1: Instal dan konfigurasi SDK
Node.js telah diinstal.
Jalankan kode berikut di server Anda untuk menginstal dependensi.
npm install --save @aliyun-sls/web-track-miniTambahkan kode berikut ke program Anda untuk mengonfigurasi SDK.
PentingSaat mengembangkan quick app, tambahkan opsi konfigurasi tambahan untuk modul request sebelum membuat objek SlsTracker. Misalnya, untuk menggunakan modul
requesttask:// Definisikan objek quickappSDK untuk membungkus API request. const quickappSDK = { request: requesttask.request } const tracker = new SlsTracker({ ...opts, platformSDK: quickappSDK, platformRequestName: 'request', })import SlsTracker from '@aliyun-sls/web-track-mini' const opts = { host: '${host}', // Titik akhir wilayah. Contoh: cn-hangzhou.log.aliyuncs.com. project: '${project}', // Nama proyek. logstore: '${logstore}', // Nama Logstore. time: 10, // Interval pengiriman log, dalam detik. Default: 10. count: 10, // Jumlah log yang dikirim dalam setiap batch. Default: 10. topic: 'topic',// Topik log kustom. source: 'source', tags: { tags: 'tags', }, } const tracker = new SlsTracker(opts) // Buat objek SlsTracker.Parameter
Wajib
Deskripsi
host
Ya
Titik akhir Layanan Log Sederhana di wilayah Anda. Contoh ini menggunakan titik akhir untuk wilayah China (Hangzhou). Untuk informasi lebih lanjut tentang titik akhir di wilayah lain, lihat Titik Akhir.
project
Ya
Nama proyek.
logstore
Ya
Nama Logstore.
time
Tidak
Interval, dalam detik, untuk pengiriman log. Nilai default adalah 10.
count
Tidak
Jumlah log yang dikirim dalam setiap batch. Nilai default adalah 10.
topic
Tidak
Topik log. Tentukan topik kustom untuk mengidentifikasi log.
source
Tidak
Sumber log. Tentukan sumber kustom untuk mengidentifikasi log.
tags
Tidak
Tag log. Tentukan tag kustom untuk mengidentifikasi log.
Langkah 2: Unggah log
Saat Anda mengunggah satu log, data tersebut diperlakukan sebagai satu Object. Saat Anda mengunggah beberapa log, struktur datanya berupa Array yang berisi beberapa Object.
Satu log diunggah sebagai
Object. Contoh:tracker.send({ eventType:'view_product', productName: 'Tablet', price: 500 })Untuk unggahan log tunggal secara langsung, parameter
timedancountdiabaikan dan tipe datanya adalahObject. Contoh:tracker.sendImmediate({ eventType:'view_product', productName: 'Tablet', price: 500 })Untuk unggahan log batch, tipe datanya adalah
Array. Contoh:tracker.sendBatchLogs([ { eventType: 'view_product', productName: 'Tablet', price: 500 }, { eventType: 'view_product', productName: 'Laptop', price: 1200 } ])Unggah log batch secara langsung (parameter time dan count diabaikan), dan tipe datanya adalah
Array. Contoh:tracker.sendBatchLogsImmediate([ { eventType:'view_product', productName: 'Tablet', price: 500 }, { eventType:'view_product', productName: 'Laptop', price: 1200 } ])
Langkah 3: Lihat hasil unggahan
Setelah log diunggah ke Logstore, Anda harus membuat indeks agar dapat melakukan kueri dan analisis terhadap log tersebut.
Tampilan Cepat
Jika Anda belum membuat indeks, Anda dapat membuka halaman Quick Start untuk Search & Analysis di Logstore Anda dan klik Preview untuk melihat log secara cepat.
Kueri dan analisis log
Untuk membuat indeks teks penuh atau indeks bidang, panggil operasi Create-Index. Jika Anda ingin menggunakan Pernyataan SQL untuk kueri, Anda harus membuat indeks bidang.
Panggil operasi GetLogs untuk melakukan kueri data log di Logstore. Operasi ini mengembalikan array log, di mana setiap elemen merupakan satu entri log.
Referensi
Tanggapan error menunjukkan kegagalan panggilan API. Untuk informasi selengkapnya tentang cara menangani error API umum, lihat kode kesalahan API.
Selain SDK buatan sendiri, Simple Log Service juga mendukung SDK Alibaba Cloud lainnya. Untuk informasi selengkapnya tentang cara menggunakan SDK Alibaba Cloud, lihat Simple Log Service di SDK Center - Portal Pengembang OpenAPI Alibaba Cloud.
Simple Log Service menyediakan Command Line Interface (CLI) untuk konfigurasi otomatis. Untuk informasi selengkapnya, lihat Command Line Interface (CLI) Simple Log Service.