Quick Tracking:Skenario Umum dan Saran Pelacakan

1 Pengiriman event sebelum lompatan halaman

Deskripsi

Ketika pengguna 「mengklik tombol yang akan segera melompat ke halaman lain」 di halaman, event klik yang terpicu mungkin tidak terkirim karena halaman langsung berpindah. Untuk memastikan bahwa data dikirim sebanyak mungkin dalam skenario ini, Anda dapat menunda lompatan halaman. Berikut adalah contoh kode dari program mini WeChat:

// Klik tautan.
function targetLinkCLK(url) {
  // Tunda pengalihan halaman dan sisihkan waktu untuk SDK mengirim halaman.
  setTimeOut(function(){
    wx.navigateTo({
      url: `/pages/goods/details/index`,
    });
  }, 500);
  const { aplus } =Variabel Lingkungan Platform Program Mini // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.
  aplus.record('track_navigate_clk', 'CLK', { 
    param1: xxxx, 
    param2: xxxx
  });
}

2 Aplikasi startup mengarahkan ulang ke halaman lain

Deskripsi

Dalam beberapa skenario, halaman startup program mini tidak tetap, dan Anda ingin meluncurkan ulang ke halaman lain berdasarkan logika bisnis tertentu. Dalam kasus ini, kode halaman dan judul halaman dari event startup aplikasi mungkin tidak sesuai dengan pemetaan di pageConfig. Jika skenario ini ada, Anda dapat menunda pemanggilan API redirectTo. Berikut adalah contoh kode dari program mini WeChat:

App({
    onLaunch(){
    setTimeout(()=>{
      wx.redirectTo({
        url: 'test?id=1'
      });
    }, 500);
  },
    onShow(){},
    onHide(){}
})

3 Cara melacak plugin program mini WeChat

Deskripsi Skenario

Dalam beberapa skenario, pengembang applet WeChat perlu mengemas beberapa halaman dan komponen independen serta dapat digunakan kembali menjadi plugin applet WeChat, kemudian menyelesaikan pengembangan aplikasi secara keseluruhan dengan mengintegrasikan plugin applet WeChat melalui paket utama applet WeChat.

3.1 Integrasi dan konfigurasi SDK applet QuickTracking host

3.2 Ekspor variabel lingkungan SDK untuk panggilan plugin

Buat file exportToPlugin.js dan implementasikan logika berikut:

Kemudian ekspor file js yang perlu diekspos ke plugin di app.json.

Contoh event tampilan halaman:

const aplus = require('../utils/aplus.js');
Page({
  data: {},
  onLoad() {
    console.log('Ini adalah halaman plugin!', aplus);
  },
  onShow() {
    aplus.sendPV({is_auto: false}, {page_name: 'plugin_page'});
  },
})

Contoh event klik:

const aplus = require('../utils/aplus.js');
Page({
  data: {},
  testCLK() {
    aplus.record('test_plugin_clk', 'CLK', {a: 1, b:2})
  }
})

Perhatikan bahwa batasan berikut berlaku untuk SDK di plugin program mini:

1. PV otomatis tidak didukung.

2. Pelacakan otomatis seperti klik otomatis dan eksposur otomatis tidak didukung.

3. Titik pelacakan visual tidak didukung.

4. Karena SDK tidak dapat menghitung alamat halaman di plugin, event pelaporan halaman di plugin harus menentukan page_name dalam atribut event, jika tidak, perhitungan korelasi statistik tidak dapat dilakukan.

4 Makna skenario program mini

Quick Tracking mengumpulkan nilai skenario resmi dari setiap platform. Tautan berikut menunjukkan dokumentasi pemetaan:

Nilai skenario Baidu: https://smartprogram.baidu.com/docs/data/scene/

Nilai skenario WeChat: https://developers.weixin.qq.com/minigame/dev/reference/scene-list.html

Nilai skenario Byte: https://microapp.bytedance.com/docs/zh-CN/mini-game/develop/framework/scene-value/

Nilai skenario Alipay: https://opendocs.alipay.com/mini/framework/scene

Nilai skenario QQ: https://q.qq.com/wiki/develop/game/frame/scene/

5 Definisi Berulang Berbagi Program Mini

Di latar belakang QuickTracking, metrik berulang didefinisikan berdasarkan nilai skenario. Tabel berikut menjelaskan parameter tersebut.

1. WeChat: "kartu pesan program kecil dalam sesi obrolan tunggal", "kartu pesan program kecil dalam sesi obrolan grup", "Kartu pesan berbagi aplikasi", "kartu pesan program kecil dengan shareTicket", "catatan obrolan, buka program kecil", "# halaman topik buka program kecil", "buka mode halaman tunggal di lingkaran teman"

2. Alipay: "Kartu pesan program kecil (berbagi) dalam sesi obrolan satu orang"

3. Byte: "Dialog WeChat", "Lingkaran Teman WeChat", "Dialog QQ", "Qzone", "DingTalk", "Berbagi Sistem", "Salin Tautan", "Berbagi Kata Sandi", "Berbagi Micro Headlines"

4. Baidu: "Berbagi", "Bagikan halaman perantara asli", "Bagikan halaman perantara berbasis web", "Halaman Obrolan Teman BaiduBerulang Portal"

6 Dokumen Operasi Peningkatan 1.X ke 2.X

Ganti SDK

2. Alamat unduhan SDK versi X dapat diperoleh dengan menghubungi orang yang bertanggung jawab atas antarmuka Anda.

Setelah membuka alamat, klik ruang kosong, klik kanan, simpan SDK ke lokal, dan seret file SDK baru ke proyek.

Pengantar SDK:

Bidang nama domain penerimaan diubah dari aplus-rhost-v menjadi trackDomain.

const aplus=require ('./utils/aplus_mini')(aplusConfig); Ganti dengan:

// Setelah fungsi initQTSDK dijalankan, SDK dipasang di bawah konteks program mini, seperti WeChat wx, byte tt, dan Alipay my.
// Variabel lingkungan aplus dan aplus_queue
import { initQTSDK } from './utils/qt_mini.umd.js';
initQTSDK(aplusConfig);

SDK 2.x menyediakan dua metode pemanggilan API:

• Panggil API secara langsung menggunakan variabel lingkungan aplus

• Kirim perintah API ke antrian aplus_queue dari SDK

Catatan: Pilih salah satu dari dua metode dan bisa dicampur.

1. Panggil operasi API menggunakan variabel lingkungan aplus

Kode untuk panggilan API langsung lebih ringkas dalam format berikut:

const { aplus } =Variabel Lingkungan Platform Program Mini // 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

2. Kirim perintah API ke antrian aplus_queue

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

const { aplus_queue } =Variabel lingkungan platform program mini; // seperti WeChat wx, Alipay my, byte tt, dan Baidu Swan.
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 event

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

7. Kemampuan dukungan kerangka kerja lainnya

Kerangka kerja program mini WeChat tidak konsisten pada platform yang berbeda. Di beberapa lingkungan PC, event keluar halaman dan keluar aplikasi yang hilang digunakan.

8. Tentang hook

SDK itu sendiri mengaitkan sistem pada event onAppHide. Untuk memastikan bahwa event pra-pembuatan keluar halaman, durasi penggunaan halaman, keluar aplikasi, dan durasi penggunaan aplikasi dikumpulkan dengan benar, pastikan Anda tidak melakukan operasi yang memakan waktu di event wx.onAppHide.