Quick Tracking:SDK uniapp

1. Unduh Plugin

URL Unduhan Plugin QuickTracking uniapp

Kompatibilitas Platform

Prosedur:

1.1 Klik Beli untuk Pengemasan Cloud

1.2 Pilih proyek untuk mengintegrasikan plugin asli

1.3 Masukkan nama paket aplikasi, lalu konfirmasi

Harap perhatikan bahwa nama paket di sini harus sama dengan nama paket yang diisi nanti saat melakukan pengemasan cloud dengan alat HBuilder X.

2. Konfigurasikan plugin asli

Buka alat HBuilder X, pilih file manifest.json dari proyek yang perlu mengintegrasikan plugin, dan ikuti langkah-langkah untuk memeriksa konfigurasi Plugin Asli App.

3. API Pelacakan

3.1 Inisialisasi SDK

App.vue

<script>
  // #ifdef APP-PLUS
  const QtAnalytics = uni.requireNativePlugin('qt-analytics-plugin');
  // #endif
  export default {
    onLaunch: function() {
      // #ifdef APP-PLUS
      QtAnalytics.setCustomDomain ('Setel nama domain Anda');
      if (uni.getSystemInfoSync().platform === 'ios') {
        /**
        * @description QtAnalytics.initWithAppkey(String appkey, String channel, int deviceType, String pushSecret)
        * @param {appkey} Pengenal unik yang diterbitkan oleh platform aplikasi saat ini dalam format QT.
        * @param {channel} Pasar aplikasi tempat aplikasi diluncurkan. 
        * @param {deviceType} tipe perangkat, 1-mobile; 2-box (integer)
        * @param {pushSecret} disediakan tetapi tidak digunakan. Masukkan string kosong. (Tipe String)  
        * */
        QtAnalytics.initWithAppkey ('Setel appKey iOS', 'Setel saluran ', 1, '');
      } else {       
        /**
        * @description QtAnalytics.preInit(String appkey, String channel, int deviceType, String pushSecret)
        * @param {appkey} Pengenal unik yang diterbitkan oleh platform aplikasi saat ini dalam format QT.
        * @param {channel} Pasar aplikasi tempat aplikasi diluncurkan. 
        * @param {deviceType} tipe perangkat, 1-mobile; 2-box (integer)
        * @param {pushSecret} disediakan tetapi tidak digunakan. Masukkan string kosong. (Tipe String)  
        * */
        QtAnalytics.preInit ('Setel appKey Android', 'Setel saluran ', 1, '');
        // Android perlu memanggil QtAnalytics.init setelah otorisasi privasi disetujui. 
        QtAnalytics.init ('Setel appKey Android', 'Setel saluran ', 1, '');
      }
      // #endif
    },
    onShow: function() {
      console.log('Aplikasi Ditampilkan')
    },
    onHide: function() {
      console.log('Aplikasi Disembunyikan')
    }
  }
</script>

Untuk metode integrasi H5, lihat dokumen: Web SDK.

Untuk informasi lebih lanjut tentang cara mengintegrasikan mini program, lihat Mini Program SDK.

3.2 Set Properti Global

1. Daftarkan API Properti Global

/**
 * @description QtAnalytics.registerGlobalProperties(String params)
 * @params adalah pasangan nilai kunci parameter global level -1. Tidak mendukung nesting. Keys bertipe null dan "" tidak didukung di iOS.
 * @return void
 */
registerGlobalProperties(string params)

Contoh:

QtAnalytics.registerGlobalProperties(JSON.stringify({
  "param_1":"value_1",
  "param_2":"value_2",
  "param_3":"value_3",
  "param_4":"undefined"
}));

2. Hapus API Properti Global

/**
 * @@description Menghapus properti global.
 * @param {key} Nama properti global Tipe String
 * @return void
 */
unregisterGlobalProperty(String key)

Contoh:

 QtAnalytics.unregisterGlobalProperty('a');

3. Dapatkan semua API Properti Global

/**
 * @description Mendapatkan semua properti global.
 * @return Semua nilai properti global yang terdaftar.
 */
getGlobalProperties

Contoh:

const gp = QtAnalytics.getGlobalProperties();

4. Hapus semua API Properti Global

/**
 * @description Menghapus semua properti global.
 * @return void
 */ 
clearGlobalProperties

Contoh:

QtAnalytics.clearGlobalProperties();

3.3 Peristiwa Penelusuran Halaman

/**Statistik durasi halaman otomatis untuk mencatat durasi tampilan halaman.
 Gunakan fungsi onPageStart dan onPageEnd untuk menyelesaikan statistik otomatis. Jika hanya satu fungsi yang dipanggil, data valid tidak akan dihasilkan. 
 Panggil onPageStart saat halaman ditampilkan, dan panggil onPageEnd saat halaman keluar.
 @ param viewName Nama halaman tempat statistik dikumpulkan.
 */
onPageStart(String viewName) // Mulai halaman.
onPageEnd(String viewName) // Akhir halaman. 

Catatan: Anda harus memanggil fungsi onPageStart() dan onPageEnd() secara berpasangan untuk menyelesaikan statistik otomatis. Jika hanya satu fungsi yang dipanggil, data valid tidak akan dihasilkan.

Contoh:

//page.vue
const QtAnalytics = uni.requireNativePlugin('qt-analytics-plugin')

export default {
   onShow() {
     ...
     QtAnalytics.onPageStart ('Kode halaman halaman saat ini');
     ...
   }, 
   onHide() {
     ...
     QtAnalytics.onPageEnd ('Kode halaman halaman saat ini');
     ...
   },
}

Perbarui properti halaman

Antarmuka pengaturan properti halaman setPageProperty(), mendukung melampirkan properti kustom ke halaman saat ini.

/**
 * @pageName Nama halaman target, yang harus sama dengan nama halaman saat ini. Jika tidak, eksekusi fungsi tidak valid
 * @pageProperty Parameter pasangan nilai kunci k-v yang terkait dengan halaman. Nilainya hanya mendukung string dan angka, dan tidak mendukung objek bersarang multi-lapis.
 *
 * @warning Deskripsi pemanggilan: Anda harus memanggil operasi ini sebelum onHide.
 */
setPageProperty(String pageName, Object pageProperty)

Catatan: Tetapkan properti halaman setelah Anda memanggil operasi onPageStart.

Contoh:

//page.vue
const QtAnalytics = uni.requireNativePlugin('qt-analytics-plugin')

export default {
   onShow() {
     ...
     QtAnalytics.onPageStart ('Kode halaman halaman saat ini');
     QtAnalytics.setPageProperty ('Kode halaman halaman saat ini', {
      "pageparam_1":"value_1",
      "pageparam_2":"value_2",
      "pageparam_3":"value_3"
     })
     ...
   }, 
   onHide() {
     ...
     QtAnalytics.onPageEnd ('Kode halaman halaman saat ini');
     ...
   },
}

3.4 Peristiwa Kustom

/**
 * @description QtAnalytics.onEventObject(String eventId, String params)
 * @eventId Nama peristiwa kustom (tipe string)
 * @params Tiles pasangan nilai kunci parameter kustom pada satu level. Tidak mendukung nesting.
 */
onEventObject(String eventId, String params)

Contoh:

QtAnalytics.onEventObject(
  'test_clk', 
  JSON.stringify({
      "product":"Gelas air",
      "productColor":"Kuning",
      "productId":"003"
  })
);

3.5 Login Pengguna

onProfileSignIn(String puid, String provider = "") Parameter kedua defaultnya adalah string kosong.

QtAnalytics.onProfileSignIn('testUserId', 'testOrganization')

Keluar Pengguna

QtAnalytics.onProfileSignOff()

Konfigurasikan properti pengguna

Anda harus terlebih dahulu memanggil fungsi login pengguna untuk menyetel ID pengguna, lalu memanggil API Set Properti Pengguna. Sejenis peristiwa kustom. Kode peristiwa harus disetel ke $$_user_profile.

Contoh:

/**
 * @description QtAnalytics.onEventObject(String eventId, String params)
 * @eventId harus ditulis sebagai $$_ user_profile
 * @params Tiles pasangan nilai kunci parameter kustom pada satu level. Tidak mendukung nesting. 
 */

QtAnalytics.onEventObject(
  '$$_user_profile', 
  JSON.stringify({
    "gender":"laki-laki",
    "_user_nick":"a_nick",
    "province":"Beijing"
  })
);

4. Jalankan

1. Kemas basis kustom, pilih plugin, dapatkan basis kustom, lalu jalankan waktu pilih basis kustom, uji output log.

2. Pengemasan cloud formal setelah pengembangan

Plugin asli berbayar saat ini tidak mendukung pengemasan offline.

Dokumentasi Plugin Asli Pengemasan Offline Android

Dokumentasi Plugin Asli Pengemasan Offline iOS

Catatan: Jika beberapa nama paket dibeli dan diikat di bawah plugin yang sama dan appid yang sama saat menggunakan HBuilder X2.7.14 atau yang lebih baru, dan antarmuka pengemasan cloud meminta bahwa pengikatan nama paket tidak konsisten, Anda perlu menghapus plugin dari manifest.json-> Konfigurasi Plugin Asli App-> daftar plugin cloud di proyek HBuilder X dan memilihnya kembali.

5. Pernyataan Privasi dan Izin

1. Daftar izin sistem yang perlu diminta oleh plugin.

Android

• android.permission.ACCESS_NETWORK_STATE

• android.permission.ACCESS_WIFI_STATE

• android.permission.INTERNET

iOS

2. Data yang dikumpulkan oleh plugin, alamat server ke mana plugin dikirim, dan deskripsi penggunaan data:

Android

QuickTracking Android SDK mengidentifikasi pengguna secara unik dengan mengumpulkan kode identifikasi perangkat unik (seperti ID Android, Serial (nomor seri perangkat ponsel Android), IMEI, IMSI, OAID, GAID, Mac, MCC (kode negara seluler), MNC (nomor jaringan seluler)), sehingga membuat statistik data seperti penambahan pengguna. Dalam keadaan khusus (seperti ketika pengguna menggunakan perangkat tablet atau kotak TV), perangkat tidak dapat diidentifikasi oleh kode identifikasi perangkat unik. Kami akan menggunakan alamat Mac perangkat sebagai identifikasi unik pengguna untuk menyediakan layanan analisis statistik normal.

iOS

QuickTracking iOS SDK mengidentifikasi pengguna secara unik dengan mengumpulkan kode identifikasi perangkat unik (seperti IDFA, IDFV, MCC (Kode Negara Seluler), MNC (Nomor Jaringan Seluler), IP, UTDID) untuk statistik data seperti penambahan pengguna.

Alamat server produk ini harus ditentukan oleh pengembang (penyebaran privat). Parameter diperoleh sebagai berikut:

appkey: diperoleh dari daftar aplikasi

Nama domain koleksi: diperoleh di modul "Konsol Manajemen-Kumpulkan Informasi"

Tautan SDK: diperoleh di modul "Konsol Manajemen-Kumpulkan Informasi".

Alamat Protokol Privasi

6. Verifikasi konfigurasi pelacakan

Android

Di file manifest.json, buka "Pengaturan Lainnya Aplikasi Umum", temukan "Pengaturan Android", dan tambahkan "atm" ke "UrlSchemes": appKey aplikasi Android Anda untuk mengaktifkan aplikasi agar dapat dipanggil oleh skema koneksi tertentu.

iOS

Dalam file manifest.json, buka "Pengaturan Lainnya Aplikasi Umum", temukan "Pengaturan iOS", dan tambahkan "atm" ke "UrlSchemes": appKey aplikasi iOS Anda untuk mengaktifkan aplikasi agar dapat dipanggil oleh skema koneksi tertentu.

Untuk informasi lebih lanjut tentang cara memverifikasi titik pelacakan mini program dan aplikasi web, lihat Verifikasi Pelacakan.

7. Fungsi pelacakan otomatis