All Products
Search
Document Center

Simple Log Service:WebTracking JavaScript SDK untuk mini program

Last Updated:Apr 11, 2026

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}. Istilah project dan host dijelaskan 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

  1. Node.js telah diinstal.

  2. Jalankan kode berikut di server Anda untuk menginstal dependensi.

    npm install --save @aliyun-sls/web-track-mini
  3. Tambahkan kode berikut ke program Anda untuk mengonfigurasi SDK.

    Penting

    Saat 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 time dan count diabaikan dan tipe datanya adalah Object. 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

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

  2. Panggil operasi GetLogs untuk melakukan kueri data log di Logstore. Operasi ini mengembalikan array log, di mana setiap elemen merupakan satu entri log.

Referensi