Quick Tracking:Quick Application SDK

Quick App SDK mendukung pelacakan peristiwa dan properti umum, seperti peristiwa startup, peristiwa keluar, peristiwa halaman, peristiwa kustom, properti pengguna, dan properti global.

1. Impor dan konfigurasikan SDK

Untuk mengintegrasikan layanan Quick Tracking ke dalam proyek aplikasi cepat Anda, unduh SDK aplikasi terbaru dari alamat online berikut atau rujuk langsung ke file SDK versi terbaru:

Alamat online SDK aplikasi cepat: https://g.alicdn.com/dt-f2e/qt-quickapp-sdk/1.0.0/qt_quickapp.js

1. Masuk ke platform QuickTracking dan buka Konsol Manajemen -- Informasi Pengumpulan -- Informasi SDK Mini Program.

   

   Letakkan file qt_quickapp.js di direktori yang sesuai dengan proyek (contoh: src/assets/js).

   Di file entri aplikasi app.ux, tambahkan:

   // Tambahkan header ke file app.ux.
   import qt from './assets/js/qt_quickapp.js';

2. Konfigurasikan parameter SDK.

   Panggil setParams untuk menginisialisasi SDK setelah SDK diperkenalkan.

   // Tambahkan header ke file app.ux.
   import qt from './assets/js/qt_quickapp.js';
   qt.setParams({
     /************ Bidang Wajib ************* /
     appKey: 'AppKey' dari aplikasi saat ini', 
     trackDomain: 'Nama domain dari aplikasi saat ini',
     /************ Bidang Opsional ************* /
     showLog: true, // Menentukan apakah akan menampilkan log SDK. true. false.
     userId: 'test_user', // Akun pengguna. Anda juga dapat memanggil operasi login untuk mengonfigurasi
     globalproperty: { // Properti global dari peristiwa.
       a:1,
       b:2
     }
   });

2. Inisialisasi SDK

Setelah mengonfigurasi parameter SDK, panggil metode init untuk menginisialisasi SDK.

// Metode onCreate dari file app.ux
export default {
  onCreate(options) {
    // Inisialisasi SDK.
    qt.init(); // Daftarkan qt secara global
  }
}

3. Tambahkan pelacakan

3.1 Pelacakan startup aplikasi

API: qt.appLaunch('Parameter untuk memulai aplikasi')

// Panggil metode qt.appLaunch() di metode onCreate di file app.ux.
export default {
  onCreate(options) {
    qt.init();
    qt.appLaunch(options);
  },
  ...
}

3.2 Pelacakan keluar aplikasi

API: qt.appHide()

// Panggil metode qt.appHide() di metode onHide di file app.ux.
export default {
	onHide() {
    qt.appHide();
  }
}

3.3 Pelacakan peristiwa penelusuran halaman

API: qt.sendPageStart('Objek properti peristiwa')

Objek properti peristiwa mewakili parameter kustom dari peristiwa. Nilainya adalah objek JSON sederhana (tidak bersarang). Nilai parameternya bisa berupa string, angka, atau boolean dalam JavaScript. Jika nilai parameternya kosong, berikan nilai "".

Contoh:

// Halaman uji pages/TestPage/index.ux
export default {
  ...
  onShow() {
    qt.sendPageStart({
      page_name: 'test_page', // Opsional. Pengkodean halaman.
      page_title: 'Judul halaman', // (Opsional) Nama halaman.
      param1: 'xxx',
      param2: 'xxx'
    });
  }
	...
}

3.4 Pelacakan peristiwa

API: qt.sendEvent('Kode peristiwa', 'Objek properti peristiwa')

Kode Peristiwa adalah kode peristiwa kustom seperti klik, eksposur, dan lainnya yang terdaftar di platform manajemen QuickTracking. Hanya format string Inggris yang didukung, dengan panjang maksimum 128 karakter.

Objek properti peristiwa mewakili parameter kustom dari peristiwa. Nilainya adalah objek JSON sederhana (tidak bersarang). Nilai parameternya bisa berupa string, angka, atau boolean dalam JavaScript. Jika nilai parameternya kosong, berikan nilai "".

Contoh:

// Halaman uji pages/TestPage/index.ux
export default {
  ...
  onTestButtonClick() {
  	qt.sendEvent('test_clk', {
      page_name: 'test_page', // Opsional. Pengkodean halaman.
      page_title: 'Judul halaman', // (Opsional) Nama halaman.
      param1: 'xxx',
      param2: 'xxx'
    });
  }
	...
}

4. Konfigurasikan atribut global

API: qt.setGlobalProperty('objek atribut global')

// Metode 1.
qt.setGlobalProperty({
  param1: '1111',
  param2: 2222,
  param3: true
});

// Metode 2
qt.setParams({
	....
  globalproperty: {
    param1: '1111',
    param2: 2222,
    param3: true
  }
});

globalproperty setelah pemanggilan sebelumnya adalah: { param1: '1111', param2: 2222, param3: true }

Tambahkan Atribut Global

API: qt.appendGlobalProperty('objek atribut global')

qt.appendGlobalProperty({
  param4: '4444',
  param5: 55555
});

globalproperty setelah pemanggilan sebelumnya adalah:

{ param1: '1111', param2: 2222, param3: true, param4: '4444', param5: 55555 }

5. Setel akun pengguna

API: qt.login('id akun pengguna')

qt.login ('id akun') // Laporkan akun dan cache akun.

API: qt.logoff()

qt.logoff() // Bersihkan cache akun pengguna

6. Laporkan atribut pengguna

API: qt.sendUserProfile('objek atribut pengguna')

Catatan: Sebelum melaporkan atribut pengguna, Anda perlu melaporkan akun pengguna.

qt.sendUserProfile({
  name: 'Jack',
  age: '25',
  level: 'vip3'
});

7. Kumpulkan berbagai jenis ID.

API: qt.setIds('Objek yang terdiri dari beberapa ID')

Catatan: Pastikan bahwa kunci setiap ID ditulis dengan benar.

qt.setIds({
  openId: 'xxxx',
  unionid: 'xxxxx',
  androidId: 'xxxxx',
  advertisingId: 'xxxxx',
  phonenumber: 'xxxxx',
  mac: 'xxxxx',
  oaid: 'xxxxx',
  serial: 'xxxxx',
  deviceId: 'xxxxx'
});

Untuk informasi lebih lanjut tentang arti bidang ID di atas, lihat dokumentasi resmi Quick Application.

https://doc.quickapp.cn/features/service/account.html?h=openid

https://doc.quickapp.cn/features/system/device.html?h=deviceId

8. Lihat log SDK

Setel parameter showLog menjadi true untuk SDK.

qt.setParams({
  ...
  showLog: true
})

9. Verifikasi Pelacakan

Setelah menyelesaikan fungsi pelacakan, pengembang dapat memverifikasi pelacakan yang ada melalui fitur verifikasi pelacakan platform QuickTracking. Pertama, dapatkan debugId dalam format log_xxxx dan tambahkan ke parameter konfigurasi SDK untuk mengaktifkan pelaporan log dalam mode verifikasi pelacakan.

Sisipkan debugId untuk mengonfigurasi pelacakan.

// Tambahkan header ke file app.ux.
import qt from './assets/js/qt_quickapp.js';
qt.setParams({
  ...
  debugId: 'log_xxxxxxxx', // Digunakan untuk verifikasi pelacakan
  ....
});