All Products
Search
Document Center

Quick Tracking:API Penyematan

Last Updated:Oct 15, 2025

Pilih API pelacakan yang sesuai berdasarkan skema pelacakan.

1. Bagaimana cara melihat solusi pelacakan?

Sebelum menanamkan titik, Anda perlu menentukan lokasi dan jenis titik yang akan ditanamkan, yaitu menyusun persyaratan eksplisit untuk penanaman titik. Di platform QuickTracking, persyaratan eksplisit dari titik pelacakan disebut skema titik pelacakan, dan templat spesifikasi dirancang untuk skema tersebut, seperti berikut: image.png

image.png

Dalam skema titik penguburan, titik yang diperlukan adalah sebagai berikut:

1. Subjek kejadian: "siapa" yang memicu kejadian. Kejadian dapat dibagi menjadi ID perangkat dan ID akun. Setiap kejadian harus memiliki salah satu dari keduanya.

  • ID Perangkat: Umumnya, ini adalah openid dalam applet. ID perangkat halaman h5 yang tertanam dalam applet juga harus diatur ke openid dari applet.

  • ID Akun: ID akun pengguna setelah masuk. Ketika pengguna masuk dari perangkat berbeda, ID perangkat berubah, tetapi ID akun tetap sama. Contohnya, seorang pengguna menggunakan ponsel dan tablet untuk masuk secara terpisah.

2. Atribut Pengguna: atribut dari ID akun, misalnya, pengguna dengan ID akun "testdemo@111", "tanggal lahir" dari "1999-02-13", "tingkat keanggotaan" dari "platinum", dll. "Tanggal lahir" dan "peringkat keanggotaan" adalah atribut pengguna.

3. Atribut Saluran: atribut pengiriman iklan, seperti saluran pengiriman, metode pengiriman, dan konten pengiriman.

4. Atribut Global: atribut yang dibawa oleh setiap acara setelah pengaturan global sekali.

5. Acara Penelusuran Halaman: acara yang dilaporkan selama pemuatan halaman (acara dengan kode halaman sama dengan kode acara dalam skema pelacakan juga merupakan acara yang ditandai dengan warna biru).

6. Klik, paparan, dan kejadian kustom: kejadian yang dilaporkan ketika pengguna klien berinteraksi dengan klien.

2. Atur ID perangkat dan ID akun

2.1 Pengaturan ID Perangkat

Setiap platform mini program memiliki logika pembuatan ID perangkatnya sendiri. Oleh karena itu, QuickTracking SDK tidak menghasilkan ID perangkat secara otomatis. Namun, log QuickTracking SDK bergantung pada ID perangkat. Anda harus mengatur ID perangkat sebelum melacak. Untuk mini program WeChat, SDK memungkinkan Anda mengotorisasi QuickTracking untuk mendapatkan OpenID secara otomatis. Sebagai alternatif, pengembang dapat mengambil ID resmi mini program seperti openid/unionid dan mengunggahnya secara manual sebagai ID perangkat. Jika tidak, QuickTracking SDK tidak dapat melaporkan log apa pun.

Metode unggah manual adalah sebagai berikut:

// Metode 1:
wx.aplus.setMetaInfo("_anony_id", ID yang diimplementasikan oleh sisi bisnis);

// Metode 2:
wx.aplus_queue.push({
  action: "aplus.setMetaInfo",
  arguments: ["_anony_id", ID yang diimplementasikan oleh sisi bisnis],
});

Catatan: Contoh kode digunakan untuk memanggil mini program WeChat. Platform mini program lainnya memiliki logika serupa.

// di dalam app.js
const aplusConfig = {
  metaInfo: {
    ... // Konfigurasikan SDK.
    '_hold: 'BLOCK', // Log pemblokiran dilaporkan. Log pemblokiran dilaporkan setelah openid dan unionid berhasil diperoleh.
    ... // Konfigurasikan SDK.
  },
};

// Inisialisasi qt_mini_sdk.
import { initQTSDK } from "./utils/qt_mini.umd.js";
initQTSDK(aplusConfig);

wx.login({
  success: (res) => {
    // Gunakan kode untuk menukar OpenID.
    if (res.code) {
      wx.request({
        url: antarmuka backend layanan pelanggan untuk mendapatkan openid,
        method: "post",
        data: {
          code: res.code,
        },
        success: (res) => {
          if (res.data && res.data.openid) {
            // Metode 1:
            wx.aplus.setMetaInfo("_anony_id", res.data.openid);

            // Metode 2:
            /**
              wx.aplus_queue.push({
                action: 'aplus.setMetaInfo',
                arguments: ['_anony_id', res.data.openid]
              });
              */
          } else {
            // Metode 1:
            wx.aplus.setMetaInfo("_anony_id", ID yang diimplementasikan oleh sisi bisnis);

            // Metode 2:
            /**
              wx.aplus_queue.push({
                action: 'aplus.setMetaInfo',
                arguments: ['_anony_id', id yang diimplementasikan oleh sisi bisnis]
              });
              */
          }
        },
      });
    }
  },
  fail: () => {
    // Pesan kegagalan.
  },
  complete: () => {
    // Metode 1:
    wx.aplus.setMetaInfo("_hold", "START");

    // Metode 2:
    /**
        wx.aplus_queue.push({
          action: 'aplus.setMetaInfo',
          arguments: ['_hold', 'START']
        });
        */
  },
});

PS: Saat ini, QuickTracking mendukung pengumpulan otomatis openid mini program WeChat, yang perlu diotorisasi dalam produk. Metode otorisasi adalah sebagai berikut. Klik dan isi konten sesuai kebutuhan.

image.png

image

Setelah otorisasi, atur mode kode ID perangkat menjadi:

const aplusConfig = {
  metaInfo: {
  ... // Konfigurasikan SDK.
  'autoGetOpenid': true // Aktifkan pengumpulan otomatis OpenID  
  ... // Konfigurasikan SDK.
  }
};
// Inisialisasi qt_mini_sdk.
import { initQTSDK } from './utils/qt_mini.umd.js';
initQTSDK(aplusConfig);    

Jika sebelumnya telah menggunakan openid manual, dan sekarang ingin beralih ke QuickTracking di atas untuk mengumpulkan openid mini program WeChat secara otomatis, Anda juga perlu memperhatikan hal-hal berikut:

  1. Hapus logika pelaporan blokir SDK dengan_hold=BLOCK di metainfo.

  2. Komentari kode logika untuk mengatur "_anony_id=openid" secara manual sebelumnya, yaitu, hapus kode untuk mendapatkan openid dari wx.login.

  3. Perhatikan bahwa penting untuk memastikan bahwa konten tentang pengaturan appKey dan penerimaan nama domain tidak terpengaruh.

Catatan

_hold=BLOCK hanya akan memblokir laporan perintah API yang dikirim oleh antrian perintah aplus_queue, dan tidak akan memblokir laporan API yang dipanggil langsung melalui variabel lingkungan aplus.

2.2 Pengaturan ID Akun

Anda harus menentukan ID akun saat masuk ke konsol Apsara Uni-Manager atau saat masuk ke konsol Apsara Uni-Manager. Ini karena setiap log setelah pengaturan akan membawa ID akun, tetapi acara yang dipicu setelah keluar dari mini program dan kemudian masuk tidak akan membawa ID akun. Oleh karena itu, Anda perlu mengatur ID akun saat pengguna masuk dan saat masuk ke mini program:

const { aplus } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

// Saat pengguna masuk, informasi akun pengguna diperoleh atau pengguna telah masuk, dan akun pengguna diperoleh menggunakan cookie atau localstorage.
function demoLogin() {
  /*************************** IF SYNCHRONIZING SCENE *************************************** /
  aplus.setMetaInfo("_user_id", 'ID akun');
  
  /************************* Jika ini adalah skenario asinkron *********************************** /
  // Set_hold=BLOCK untuk memblokir pengumpulan dan pelaporan. 
  aplus.setMetaInfo("_hold", 'BLOCK');

  ...
  function callback() {
    // Dapatkan ID akun pengguna dalam hasil callback asinkron.
    aplus.setMetaInfo("_user_id", 'ID akun');
    
    // Set_hold=START untuk mengizinkan pengumpulan dan pelaporan.
    aplus.setMetaInfo("_hold", 'START');
  };
  ...
};
// Reset ID akun pengguna saat pengguna keluar.
function demoLogOff() {
    aplus.setMetaInfo("_user_id", '');
};

2.3 ID perangkat dan ID akun

Untuk mendapatkan ID perangkat QuickTracking di mini program, gunakan _anony_id di metainfo. Contoh berikut menggunakan mini program WeChat:

const { aplus } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.
aplus.getMetaInfo('_anony_id');

Untuk mendapatkan ID akun QuickTracking di sisi mini program, gunakan _user_id di metainfo. Contoh berikut menggunakan mini program WeChat:

const { aplus } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.
aplus.getMetaInfo('_user_id');

3. Atur properti pengguna

Laporkan atribut pengguna menggunakan pengkodean acara preset $$_user_profile. Jenis acara adalah acara lainnya.

Sebelum Anda melaporkan atribut pengguna, Anda harus atur _user_id untuk melaporkan akun pengguna. Jika tidak, Quick Tracking tidak akan melakukan perhitungan korelasi pada atribut pengguna. Setelah Anda mengonfirmasi ID akun pengguna pelaporan, contoh pelaporan atribut pengguna adalah sebagai berikut:

const { aplus } =Variabel Lingkungan Platform Mini Program; // Misalnya, WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.
// Contoh
aplus.record("$$_user_profile", "OTHER", {
  name: "sss", // Atribut pengguna 1
  gender: "male", // Atribut pengguna 2
  class: "3", // Atribut pengguna 3
});

Dalam konten sebelumnya, tidak ada perubahan yang dapat dilakukan pada tiga baris pertama. Hanya baris 4, 5, dan 6 yang dapat disesuaikan.

4 Atribut saluran

Atribut saluran tidak perlu disematkan, tetapi URL mini program harus berisi atribut saluran ini, dan kunci atribut harus dimulai dengan "utm_" karena kata kunci yang dikenali oleh SDK adalah "utm_". Misalnya:

qaplus/product?utm_channel=gzh

PS: Jika Anda telah bekerja sama dengan perusahaan pengiriman saluran di pasar dan tidak dapat dimulai dengan utm_, Anda dapat menggunakan API Atribut Global untuk melaporkan atribut saluran. Kunci atribut harus dimulai dengan utm_.

5 Atribut global

Siklus hidup properti global adalah dari startup aplikasi hingga aplikasi disembunyikan.

5.1 Tambahkan Atribut Global (aplus.appendMetaInfo)

Saat Anda menggunakan aplus.appendMetaInfo untuk melaporkan atribut global, jika kunci atribut global sama dengan atribut global yang ada, nilai yang ada diperbarui. Jika kunci atribut global berbeda dari atribut global yang ada, atribut global baru dimasukkan.

Antarmuka:

const { aplus } =Variabel Lingkungan Platform Mini Program; // Misalnya, WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

aplus.appendMetaInfo("globalproperty", {
  // Tambahkan atribut global.
  xxx: xxx,
});

Contoh:

const { aplus } =Variabel Lingkungan Platform Mini Program; // Misalnya, WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

aplus.appendMetaInfo("globalproperty", {
  // Tambahkan atribut global.
  a: 3,
  b: 4,
});
// Properti global saat ini adalah a:3 dan b:4

aplus.appendMetaInfo("globalproperty", {
  // Tambahkan atribut global.
  b: 2,
  d: 4,
});
// Properti global saat ini adalah a:3, b:2, d:4 

5.2 Timpa Properti Global

Saat Anda menggunakan aplus.setMetaInfo untuk melaporkan properti global, hanya laporan terakhir yang berlaku. Artinya, semua atribut global yang ada dihapus terlebih dahulu, lalu atribut global yang ditetapkan oleh setMetaInfo ini ditambahkan.

Peringatan

Pastikan metode ini memenuhi logika bisnis sebelum Anda menggunakannya. Dalam skenario umum, bersihkan atribut global.

Perhatikan bahwa menggunakan metode ini juga akan menimpa properti saluran! ! !

Antarmuka:

const { aplus } =Variabel Lingkungan Platform Mini Program; // Misalnya, WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

aplus.setMetaInfo("globalproperty", {
  xxx: xxx,
});

Contoh:

const { aplus } =Variabel Lingkungan Platform Mini Program; // Misalnya, WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

aplus.setMetaInfo("globalproperty", {
  a: 1,
  b: 2,
});
// Properti global saat ini adalah a:1 dan b:2

aplus.setMetaInfo("globalproperty", {
  c: 1,
  d: 2,
});
// Properti global saat ini adalah c:1 dan d:2, "a:1 dan b:2 tidak ada lagi" 

6 API Acara Penelusuran Halaman

1. Anda dapat menggunakan SDK untuk menandai acara dan kode untuk menandai acara. Secara default, tag diaktifkan.

2. Berikut ini perlu disematkan untuk acara penelusuran halaman:

  • Kode Acara: kode halaman. Dalam acara penelusuran halaman, kode acara adalah kode halaman. image.png

  • Atribut Acara dari acara penelusuran halaman: lihat skema pelacakan untuk atribut spesifik.

  • image.png

6.1 pageConfig

pageConfig digunakan untuk mengatur mode pengkodean halaman secara global, seperti yang ditunjukkan dalam contoh berikut:

const aplusConfig = {
  metaInfo: {
    appKey: "", // AppKey yang Anda tentukan saat membuat aplikasi menggunakan QuickTracking. Parameter ini wajib.
    trackDomain: "", // Wajib. Nama domain untuk pengumpulan dan pelaporan log.
    _user_id: "testUserId", // ID akun masuk mini program. Jika Anda perlu menghitung dan menganalisis data lintang akun pengguna, Anda harus melaporkan
    _anony_id: "testOpenid", // Pengenal unik pengguna di platform mini program, yang digunakan untuk menghitung UV. Wajib.
    DEBUG: true, // Nyalakan log debug.
    appVersion: "Versi mini program Anda saat ini",

    // Konfigurasikan pengkodean halaman secara global.
    // Jika pengkodean halaman tidak diatur, jalur digunakan secara default.
    // Jika judul halaman tidak diatur, mini program WeChat default ke judul halaman, dan mini program lainnya default ke ""
    pageConfig: {
      "pages/index/index": {
        pageName: "page_name_test_index",
        pageTitle: "Beranda",
        skipMe: true, // Abaikan acara penelusuran halaman yang dilaporkan secara otomatis untuk halaman. Nilai defaultnya adalah undefined.
      },
      "pages/detail/detail": {
        pageName: "page_name_test_detail",
        pageTitle: "Halaman detail",
      },
    },
  },
};

Di antaranya:

  • pageName menunjukkan pengkodean halaman.

  • pageTitle menunjukkan judul halaman.

  • skipMe menentukan apakah akan menonaktifkan pengumpulan acara penelusuran otomatis untuk halaman (true menunjukkan bahwa itu dinonaktifkan dan false menunjukkan bahwa itu diaktifkan).

Catatan: Prioritas yang ditetapkan oleh skipMe adalah lebih rendah daripada saklar utama aplus-disable-apv yang menonaktifkan pengumpulan otomatis acara penelusuran halaman.

6.2 pelacakan halaman otomatis

Saat SDK mengidentifikasi halaman onHide, ia melaporkan acara penelusuran halaman. Isi yang dilaporkan adalah:

  • Waktu Klien Saat Ini.

  • Jalur Halaman.

  • Pengkodean Halaman (defaultnya adalah jalur halaman, jika pageConfig diatur, nilainya adalah page_name dari pemetaan pageConfig).

  • Judul halaman. Nilai defaultnya adalah judul halaman. Jika pageconfig diatur, nilainya adalah page_title dari pemetaan.

  • Durasi waktu di halaman: waktu dari onShow hingga onHide.

6.2.1 Nonaktifkan pelacakan halaman otomatis

Secara default, pelaporan halaman otomatis diaktifkan. Untuk menonaktifkan pelaporan halaman otomatis, panggil operasi API berikut:

const { aplus } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

aplus.setMetaInfo('aplus-disable-apv', true);

Untuk menonaktifkan pelaporan halaman otomatis hanya untuk satu halaman, atur skipMe ke true di pageconfig.

6.2.2 Tetapkan properti acara untuk acara penelusuran halaman otomatis

updatePageProperties dapat dipanggil untuk secara dinamis mengatur properti acara dari pengkodean halaman dan acara penelusuran halaman sebelum hook onhide di halaman.

Deskripsi API:

const { aplus } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

aplus.updatePageProperties($params, $page_path);

Di antaranya:

  • $params: koleksi atribut acara halaman, tipe objek, yang tidak mendukung bersarang multi-lapis. Bidang prefabrikasi page_name digunakan untuk secara dinamis mengatur kode halaman untuk acara halaman otomatis.

  • $page_path: bidang opsional, tipe string, jika tidak, defaultnya adalah jalur halaman saat ini.

Contoh:

onShow() {
  const { aplus } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

  aplus.updatePageProperties({
    page_name: '', //(Opsional) Bidang prefabrikasi untuk secara dinamis mengatur pengkodean halaman untuk acara halaman otomatis
    param1: '',
    param2: ''
  }, 'pages/home/home');
}

Pengumpulan manual 6.3 halaman

API

Metode sendPV mengirimkan log PV halaman. Definisi API-nya adalah sebagai berikut:

const { aplus } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

aplus.sendPV($pageEventConfig, $properties
)

Di antaranya:

  • $pageEventConfig adalah konfigurasi acara halaman, cukup tulis { is_auto: false }.

  • $properties adalah parameter ekstensi untuk acara halaman ini. Nilainya adalah tipe objek dan tidak dapat bersarang dalam beberapa lapis. Jika tidak ada objek kosong '{}' yang dapat dilewatkan.

    • durasi: Bidang durasi digunakan untuk mencatat durasi halaman yang ditelusuri dalam mode PV manual. Logika untuk menghitung durasi perlu dirancang dan diimplementasikan oleh pengembang berdasarkan skenario bisnis. Di bawah fungsi PV otomatis, logika komputasi durasi diimplementasikan oleh sdk

Contoh:

// Demo sederhana
const { aplus } =Variabel Lingkungan Platform Mini Program; // Misalnya, WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

aplus.sendPV(
  {
    is_auto: false,
  },
  {
    page_title: "halaman utama", // Nilai defaultnya adalah nilai dalam parameter pageConfig. Jika parameter ini diatur, nilai tersebut diatur di sini. Parameter ini wajib.
    page_name: "yourCurrentPageName", // Nilai defaultnya adalah nilai dalam pageConfig. Jika diatur di sini, itu adalah nilai yang diatur di sini (tidak wajib).

    // Jika Anda mengatur parameter durasi (dalam milidetik),QuickTracking digunakan sebagai "atribut acara-durasi (s)" untuk analisis.
    duration: 1111111,

    // Sesuaikan properti acara.
    x: 111,
    y: 222,
  }
);

Catatan:

Secara default, parameter page_title diatur ke nilai dalam parameter pageConfig. Jika parameter page_title diatur, nilainya diatur.

Secara default, parameter page_name diatur ke nilai yang ditentukan dalam parameter pageConfig. Jika parameter page_name diatur, parameter page_name diatur ke nilai yang ditentukan dalam parameter pageConfig.

7 Titik Penguburan Peristiwa

Semua event, kecuali event penjelajahan halaman, dicatat menggunakan 'action':'aplus.record'. Berikut adalah konten yang perlu dicatat:

  • Kode Acara: image.png

  • Properti Acara: image.png

  • Pengkodean Halaman (opsional): Secara default, SDK mengumpulkan jalur halaman. Jika jalur halaman dipetakan di pageConfig dan page_name diatur, nilainya adalah page_name di pageConfig. Jika page_name diatur dalam properti acara saat acara dikubur, nilainya diatur ke page_name dalam properti acara. Yaitu, prioritas nilai adalah:

    page_name dalam properti acara> page_name dalam pageConfig> jalur halaman image.png

  • Judul Halaman: SDK mengumpulkan judul halaman secara default. Jika jalur halaman dipetakan di pageConfig dan page_title diatur, nilainya adalah page_title di pageConfig. Jika Anda mengatur page_title dalam properti acara saat Anda menandai acara, nilai parameter page_title sama dengan properti acara. Yaitu, prioritas nilai adalah

page_title dalam properti acara > page_title dalam pageConfig > judul halaman.

Pelacakan acara dibagi menjadi pelacakan otomatis SDK (pelacakan penuh) dan pelacakan kode. Secara default, pelacakan penuh klik dan paparan dinonaktifkan.

7.1 Acara Paparan

EXP secara khusus mengacu pada acara paparan.

const { aplus } =Variabel Lingkungan Platform Mini Program; // Misalnya, WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

aplus.record("Kode acara dalam skema pelacakan", "EXP", {
  x: "111",
  y: "222",
  z: "333",
  page_name: "demoPageName", // Kode halaman kustom halaman saat ini. Parameter ini opsional.
});

7.2 Acara Klik

CLK secara khusus mengacu pada acara klik.

const { aplus } =Variabel Lingkungan Platform Mini Program; // Misalnya, WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

aplus.record("Kode acara dalam skema pelacakan", "CLK", {
  x: "111",
  y: "222",
  z: "333",
  page_name: "demoPageName", // Kode halaman kustom halaman saat ini. Parameter ini opsional.
});

7.3 Titik Pelacakan Acara Lainnya

Acara kustom lainnya kecuali acara klik dan paparan.

const { aplus } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

aplus.record ('Kode acara dalam skema pelacakan ', 'OTHER', {
  x: '111',
  y: '222',
  z: "333",
  page_name: "demoPageName", // Kode halaman kustom halaman saat ini. Parameter ini opsional.
});

7.4 paparan otomatis (titik penuh)

SDK secara internal membantu pengembang menangani waktu paparan dan secara otomatis mengumpulkan perilaku paparan elemen. Waktu pemicu adalah bahwa kontrol ditampilkan di area terlihat lebih dari 50% ms dan waktu melebihi 300ms.

Ambil WeChat sebagai contoh. Bagian UI:

// Node root file WXML di halaman. capture-bind:touchstart:
<view class="root" capture-bind:touchstart="onAplusTouch">
  
 // Tambahkan kelas dan data-tracker ke node yang akan diekspos (sesuai dengan konfigurasi klik otomatis di app.js), seperti:
 <view class="button-section">
    <button 
       class="auto-exposure"
       data-pagename="Kode halaman kustom untuk acara saat ini" 
       data-page_title="Judul halaman kustom untuk acara saat ini" 
       data-name="btn-navigator" 
       data-index="num1"
       bindtap="onNavigatorTap"> Navigasi </button>
   	<button 
       class="autotrack_exp" 
       data-itemName='Reading Stude' 
       data-itemzoon='abc' 
       data-itemid='a_product_id' 
       data-promotioninformation='abc' 
       data-pagename='Homepage'> autoExp</button>
  	<custom_component 
       class="custom_component"
       name="books"
       title="data-title"
       description="this is a custom_component"></custom_component>
  </view>
</view>

Bagian konfigurasi sdk:

const aplusConfig = {
  metaInfo: {
    "aplus-auto-exp": [
      {
        cssSelector: ".auto-exposure", // Kelas elemen yang ingin Anda ekspos.
        logkey: "auto-exp-id", // Kode acara yang sesuai dalam skema pelacakan.
        /**Catatan:
         * 1. Jika CSSselector dapat mencocokkan beberapa elemen, data-tracker harus ditanam di node halaman, jika tidak, aplusJS tidak dapat mengenali keunikan elemen, sehingga menyebabkan beberapa elemen dalam daftar memicu hanya satu paparan;
         * 2. Saat ini, mini program Alipay tidak mendukung pengumpulan atribut ini.
         */
        props: ["data-name", "data-index", "data-pagename", "data-page_title"],
      },
      {
        cssSelector: ".autotrack_exp", // Kelas elemen yang ingin Anda ekspos.
        logkey: "autotrack_exp", // Kode acara yang sesuai dalam skema pelacakan.
      },
    ],
    // Fungsi callback sebelum paparan otomatis, yang digunakan untuk mendukung pelaporan parameter kustom, seperti penulisan hump (atribut data HTML hanya mendukung huruf kecil secara default).
    // Nilai valid: 1.9.25 dan lebih baru.
    "aplus-auto-exp-userfn": function (e, selector) {
      if (selector.indexOf("autotrack_exp") != -1) {
        var dataset = e.dataset;
        var obj = {};
        obj.itemID = dataset.itemid;
        obj.itemName = dataset.itemname;
        obj.itemZoon = dataset.itemzoon;
        obj.promotionInformation = dataset.promotioninformation;
        obj.pageName = dataset.pagename;
        return obj;
      }
    },
  },
};

Fungsi callback pra-paparan otomatis. Nilai defaultnya adalah undefined. Untuk mengaktifkan fungsi ini, Anda harus menetapkan parameter berikut:

const { aplus } =Variabel Lingkungan Platform Mini Program // Seperti WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.
aplus.setMetaInfo('aplus-auto-exp-userfn', function(e, selector) { 
  /**
    * e: Elemen DOM
    * selector: pemilih elemen. Nilainya adalah cssSelector yang dilewatkan dalam klik otomatis.
    * @return Objek atribut kustom.
    */
});

Perhatikan bahwa Anda harus menggunakan sintaksis >>> untuk membantu SDK mendapatkan data DOM komponen kustom. Untuk informasi lebih lanjut, lihat.

// Node root file WXML di halaman. capture-bind:touchstart:
<view class="root" capture-bind:touchstart="onAplusTouch">
	// Tambahkan class dan data-tracker ke node yang akan diekspos (sesuai dengan konfigurasi klik otomatis di app.js), seperti:
	<view class="button-section">
		<custom_component 
        class="custom_component" 
        name="books" 
        title="data-title" 
        description="ini adalah custom_component">
		</custom_component>
	</view>
</view>
const aplusConfig = {
  metaInfo: {
    ...
    "aplus-auto-exp": [
      {
        cssSelector: ".root >>> .custom_component",
        logkey: "exp_custom_component",
        props: [],
      },
      {
        // Komponen tidak dikontrol oleh shadow root
        cssSelector: ".custom_component",
        logkey: "exp_custom_component",
        props: [],
      },
    ],
    ...
  },
};

7.5 klik otomatis (pelacakan penuh)

Mulai dari versi 1.1.0, untuk mengurangi beban kerja pengembang dalam melacak, sdk juga mendukung konfigurasi beberapa informasi untuk memungkinkan SDK secara otomatis mengumpulkan acara klik dalam halaman. (Alipay dan mini program Baidu didukung hanya ketika versi pustaka dasar adalah 2.x atau lebih baru)

Sebagai contoh, ambil WeChat. Bagian UI:

// catchtap dari node root file WXML di halaman:
<view catchtap="onAplusClk">
  
// Tambahkan kelas dan data-tracker ke node yang akan diekspos (sesuai dengan konfigurasi klik otomatis di app.js), seperti:
<view class="button-section">
  <button 
     class="auto-click" 
     data-pagename="Kode halaman kustom untuk acara saat ini" 
     data-page_title="Judul halaman kustom untuk acara saat ini" 
     bindtap="onNavigatorTap"> Navigasi </button>
  <button 
     class="autotrack_clk" 
     data-itemName='Reading Stude' 
     data-itemzoon='abc' 
     data-itemid='a_product_id' 
     data-promotioninformation='abc' 
     data-pagename='Homepage'> autoClk</button>
</view>

Bagian konfigurasi sdk:

const aplusConfig = {
  metaInfo: {
    ...
    "aplus-auto-clk": [
      {
        cssSelector: ".auto-click",
        logkey: "demoEventCode", // Kode acara dalam skema pelacakan.
        props: ["data-name", "data-pagename", "data-page_title"], // Atribut kustom dalam skema pelacakan.
      },
      {
        cssSelector: ".autotrack_clk",
        logkey: "autotrack_clk", // Kode acara yang sesuai dalam skema pelacakan.
      },
    ],
    // Fungsi callback sebelum klik otomatis. Fungsi ini digunakan untuk mendukung pelaporan parameter kustom, seperti camel case. Secara default, atribut data HTML hanya mendukung huruf kecil.
    "aplus-auto-clk-userfn": function (e, selector) {
      if (selector.indexOf("autotrack_clk") != -1) {
        var dataset = e.dataset;
        var obj = {};
        obj.itemID = dataset.itemid;
        obj.itemName = dataset.itemname;
        obj.itemZoon = dataset.itemzoon;
        // obj.promotionInformation = dataset.promotioninformation;
        obj.pageName = dataset.pagename;
        return obj;
      }
    },
    ...
  },
};

Fungsi callback pra-klik otomatis. Nilai defaultnya adalah undefined. Untuk mengaktifkan fungsi ini, Anda harus menetapkan parameter berikut:

const { aplus } =Variabel Lingkungan Platform Mini Program; // Misalnya, WeChat wx, Alipay my, Byte tt, Baidu Swan, dll.

/**
 * e: Elemen DOM
 * selector: pemilih elemen. Nilainya adalah cssSelector yang dilewatkan dalam klik otomatis.
 * @return Objek atribut kustom.
 */
aplus.setMetaInfo("aplus-auto-clk-userfn", function (e, selector) {
    
});

7.6 Klik Elemen Mini Program

Mulai dari versi 2.4.2, pengembang perlu mengumpulkan perilaku klik elemen yang terikat pada fungsi acara di halaman dalam beberapa skenario. Untuk mengurangi beban konfigurasi pengembang di bagian 7.5, sdk mendukung pengumpulan otomatis dalam skenario tersebut.

Secara default, perilaku klik elemen yang terikat pada fungsi acara tidak dikumpulkan. Untuk mengaktifkan fitur ini, Anda harus mendeklarasikannya dalam konfigurasi inisialisasi SDK:

Catatan: Melalui pengaturan aktif dinamis autotrackMethodEnable atau autotrackMethodFilterMap tidak akan berlaku, hanya deklarasi sebelum inisialisasi yang dapat dilakukan.

const aplusConfig = {
  metaInfo: {
    appKey: "", // AppKey yang Anda tentukan saat membuat aplikasi menggunakan QuickTracking. Parameter ini wajib.
    _user_id: "testUserId", // ID akun masuk mini program. Jika Anda perlu menghitung dan menganalisis data lintang akun pengguna, Anda harus melaporkan
    _anony_id: "testOpenid", // Pengenal unik pengguna di platform mini program, yang digunakan untuk menghitung UV. Wajib.
    DEBUG: true, // Nyalakan log debug.
    appVersion: "Versi mini program Anda saat ini",
    autotrackMethodEnable: true, // Berlaku bersama dengan fitur laju sampel berikut.
    autotrackMethodFilterMap, { // Metode laju sampel konfigurasi baru 2.4.4
      onClick: "0.5",
    }
  },
};

Skenario

Ambil skenario mini program WeChat sebagai contoh:

//wxml
<view class="bottomTab" 
      bindtap="onClick" 
      id="my_bottom_tab"
      data-custom_property="1111" 
      data-element_type="Jenis elemen, pengembang tambahkan sesuai kebutuhan"
      data-element_name="Nama elemen, pengembang tambahkan sesuai kebutuhan"
      data-element_class_name="kelas elemen, pengembang tambahkan sesuai kebutuhan"
      data-element_content="Konten elemen, pengembang tambahkan sesuai kebutuhan"
      data-element_selector="filter css, pengembang tambahkan sesuai kebutuhan"
      data-element_path="jalur elemen, pengembang tambahkan sesuai kebutuhan">
  <view class="iconfont icon-dibu"> Navigasi bawah </view>
</view>

//homePage.js
Page({
  // Klik tab di bagian bawah.
  onClick: function () {
    // Logika pemrosesan bisnis.
  }
})

Saat pengguna memicu acara onClick, sdk melaporkan acara yang dikodekan sebagai $$_mp_item_click. Bidang koleksi termasuk:

  • Properti Acara

    • (Koleksi Default) methodName:"onClick"

    • (Atribut Kustom Pengguna) custom_property:"1111"

  • Atribut Pemakaman Penuh

    • element_id: "my_bottom_tab"

    • element_type: "jenis elemen, yang ditambahkan pengembang sesuai kebutuhan"

    • element_name: "nama elemen, yang ditambahkan pengembang sesuai kebutuhan"

    • element_class_name: "kelas elemen, yang ditambahkan pengembang sesuai kebutuhan"

    • element_content: "Konten elemen, yang ditambahkan pengembang sesuai kebutuhan"

    • element_selector: "filter css, yang ditambahkan pengembang sesuai kebutuhan"

    • element_path: "jalur elemen, yang ditambahkan pengembang sesuai kebutuhan"

Catatan: Atribut pelacakan penuh hanya berlaku setelah pengembang mengonfigurasi atribut data data-element_xxx pada elemen.

8 Berbagi Berantai

Pembagian fisi adalah konsep kunci dari strategi pertumbuhan hacking. Ini bergantung pada hubungan sosial antara pengguna untuk mewujudkan transmisi informasi yang saling menguntungkan, sehingga mendorong akuisisi pengguna baru.

Setelah menyelesaikan integrasi fungsi SDK pembagian fisi, Anda akan dapat menggunakan platform QuickTracking untuk berbagi model tren dan mengukur manfaat peningkatan kampanye pemasaran dengan indikator terkait pembagian kembali.

  1. Mendukung melihat metrik efek pembagian kembali pengguna berbagi teratas dan tingkat pembagian kembali yang berbeda.

  2. Mendukung kombinasi fleksibel dan konfigurasi indikator kembali, melihat pengguna teratas dengan kemampuan penarikan fisi terbanyak dan kemampuan konversi pembagian kembali fisi, melacak hubungan antara pengguna berbagi tautan fisi dan pembagian kembali, dan dengan cepat menentukan konsumen pendapat kunci.

Dapatkan parameter berbagi sumber

aplus.getRefShareParams();

Persyaratan Versi

sdk mini program v2.2.0 atau lebih baru

Fitur

API yang digunakan untuk mendapatkan id berbagi sumber dan url berbagi sumber saat orang yang dibagikan membuka applet

Parameter Permintaan

Tidak ada

Parameter Kembalian

Tipe Objek

Parameter

Tipe

Nilai Default

Arti

Catatan

$$_ref_share_url

String

""

URL berbagi sumber yang tidak berisi id berbagi

Tidak ada

$$_ref_share_id

String

""

id berbagi sumber

Tidak ada

Contoh Panggilan:

Catatan: Mengingat perbedaan kemampuan platform applet dalam API onShareAppMessage dan onShareTimeline, SDK menyediakan dua metode penggunaan API untuk meminta parameter berbagi, yaitu, pengembalian Promise dan pengembalian fungsi callback. Anda dapat memilih berdasarkan platform yang produk Anda perlu sesuaikan.

Berdasarkan Promise:

/**
 * Ambil mini program WeChat sebagai contoh, skenario nilai kembalian Promise.
 */

Page({
  data: {
    // Bidang ID berbagi SDK.
    $$_share_id: "",
  },
  getShareId() {
    const { $$_ref_share_url, $$_ref_share_id } = wx.aplus.getRefShareParams();

    // Metode 1: Dapatkan ID berbagi dari fungsi yang ditentukan pengguna.
    wx.aplus
      .requestShareParams({
        title: "Bagikan halaman aktivitas",
        path: "/pages/share/shareCampaign?utm_test=test",
        campaign: "Ini adalah aktivitas berbagi",
        shareId: $$_ref_share_id,
      })
      .then((res) => {
        const { $sid } = res;
        if ($sid) {
          this.setData({
            $$_share_id: $sid,
          });
        } else {
          // Tentukan penyebab kesalahan. Dalam mode DEBUG SDK, konsol mini program mencetak kesalahan.
          console.log("Gagal mendapatkan parameter berbagi.");
        }
        return res;
      });
  },

  // Dengarkan perilaku pengguna mengklik tombol teruskan (tombol open-type="share") atau tombol "teruskan" di menu kanan atas di halaman dan sesuaikan konten teruskan.
  onShareAppMessage() {
    return {
      title: "Judul halaman aktivitas berbagi pengguna default",
      path: `/pages/share/shareCampaign?utm_test=test&$sid=${this.data.$$_share_id}`,
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi ID.
      $$_share_id: this.data.$$_share_id,
      // Tentukan ID aktivitas berbagi sesuai kebutuhan. Bidang ini adalah bidang prefabrikasi dalam SDK.
      $$_share_campaign_id: "Ini adalah aktivitas berbagi kustom",
      // Anda harus menentukan tautan berbagi asli. Ingatlah bahwa Anda tidak perlu menyambungkan ID berbagi.
      $$_ share_url: 'Bagikan ${this.route}?utm_source=Bagikan lingkaran teman',
    };
  },

  // Pantau perilaku tombol "Bagikan ke Teman" di sudut kanan atas dan sesuaikan konten berbagi. 
  onShareTimeline() {
    return {
      title: "Berbagi Teman",
      // Parameter dalam query ketika subjek berbagi berikutnya membuka applet. Ingatlah untuk menyambungkan $sid, jika tidak, rantai berbagi akan rusak.
      query: `$sid=${this.data.$$_share_id}`,
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi ID.
      $$_share_id: this.data.$$_share_id,
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi id aktivitas.
      $$_share_campaign_id: "Ini adalah aktivitas berbagi kustom",
      // Anda harus menentukan tautan berbagi asli. Ingatlah bahwa Anda tidak perlu menyambungkan ID berbagi.
      $$_ share_url: 'Bagikan ${this.route}?utm_source=Bagikan lingkaran teman',
    };
  },
  // Sesuaikan berbagi simulasi, seperti menghasilkan gambar berbagi dan konten clipboard berbagi.
  userCustomShare() {
    wx.aplus.record("$$_share", "CLK", {
      // Tentukan bidang sesuai kebutuhan. Bidang tersebut telah dibuat sebelumnya dalam SDK dan judul berbagi.
      $$_ share_title: "Ini adalah judul berbagi",
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi ID.
      $$_share_id: this.data.$$_share_id,
      // Tentukan ID aktivitas berbagi sesuai kebutuhan. Bidang ini adalah bidang prefabrikasi dalam SDK.
      $$_share_campaign_id: "Ini adalah aktivitas berbagi kustom",
      // Tentukan bidang yang ingin Anda bagikan dengan platform target.
      $$_ share_type: "Platform target berbagi yang ditentukan pengguna",
      // Anda harus menentukan tautan berbagi asli. Ingatlah bahwa Anda tidak perlu menyambungkan ID berbagi.
      $$_ share_url: 'The ${this.route}?utm_source=Berbagi kustom',
    });
  },
});

Penggunaan Berbasis Callback:

/**
* Ambil mini program WeChat sebagai contoh, skenario nilai kembalian Promise.
*/

Page({
  data: {
    // Bidang ID berbagi SDK.
    $$_share_id: "",
  },
  getShareId() {
    const {
      $$_ref_share_url,
      $$_ref_share_id,
    } = wx.aplus.getRefShareParams();

    // Metode 1: Dapatkan ID berbagi dari fungsi yang ditentukan pengguna.
    wx.aplus.requestShareParams({
      title: 'Bagikan halaman aktivitas',
      path: '/pages/share/shareCampaign?utm_test=test',
      campaign: 'Ini adalah kampanye berbagi',
      shareId: $$_ref_share_id,
    }).then((res) => {
      const { $sid } = res;
      if ($sid) {
        this.setData({
          $$_share_id: $sid,
        });
      } else {
        // Tentukan penyebab kesalahan. Dalam mode DEBUG SDK, konsol mini program mencetak kesalahan.
        console.log("Gagal mendapatkan parameter berbagi.");
      }
      return res;
    });
  },

  // Dengarkan perilaku pengguna mengklik tombol teruskan (tombol open-type="share") atau tombol "teruskan" di menu kanan atas di halaman dan sesuaikan konten teruskan.
  onShareAppMessage() {
    return {
      title: 'Judul halaman aktivitas berbagi pengguna default',
      path: `/pages/share/shareCampaign?utm_test=test&$sid=${this.data.$$_share_id}`,
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi ID.
      $$_share_id: this.data.$$_share_id,
      // Tentukan ID aktivitas berbagi sesuai kebutuhan. Bidang ini adalah bidang prefabrikasi dalam SDK.
      $$_share_campaign_id: "Ini adalah aktivitas berbagi kustom",
      // Anda harus menentukan tautan berbagi asli. Ingatlah bahwa Anda tidak perlu menyambungkan ID berbagi.
      $$_ share_url: 'Bagikan ${this.route}?utm_source=Bagikan lingkaran teman',
    };
  },

  // Pantau perilaku tombol "Bagikan ke Teman" di sudut kanan atas dan sesuaikan konten berbagi. 
  onShareTimeline() {
    return {
      title: "Berbagi Teman",
      // Parameter dalam query ketika subjek berbagi berikutnya membuka applet. Ingatlah untuk menyambungkan $sid, jika tidak, rantai berbagi akan rusak.
      query: `$sid=${this.data.$$_share_id}`,
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi ID.
      $$_share_id: this.data.$$_share_id,
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi id aktivitas.
      $$_share_campaign_id: "Ini adalah aktivitas berbagi kustom",
      // Anda harus menentukan tautan berbagi asli. Ingatlah bahwa Anda tidak perlu menyambungkan ID berbagi.
      $$_ share_url: 'Bagikan ${this.route}?utm_source=Bagikan lingkaran teman',
    };
  },
  // Sesuaikan berbagi simulasi, seperti menghasilkan gambar berbagi dan konten clipboard berbagi.
  userCustomShare() {
    wx.aplus.record("$$_share", "CLK", {
      // Tentukan bidang sesuai kebutuhan. Bidang tersebut telah dibuat sebelumnya dalam SDK dan judul berbagi.
      $$_ share_title: "Ini adalah judul berbagi",
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi ID.
      $$_share_id: this.data.$$_share_id,
      // Tentukan ID aktivitas berbagi sesuai kebutuhan. Bidang ini adalah bidang prefabrikasi dalam SDK.
      $$_share_campaign_id: "Ini adalah aktivitas berbagi kustom",
      // Tentukan bidang yang ingin Anda bagikan dengan platform target.
      $$_ share_type: "Platform target berbagi yang ditentukan pengguna",
      // Anda harus menentukan tautan berbagi asli. Ingatlah bahwa Anda tidak perlu menyambungkan ID berbagi.
      $$_ share_url: 'The ${this.route}?utm_source=Berbagi kustom',
    });
  }
})

Permintaan parameter berbagi

aplus.requestShareParams(Object params, Function callback);

Versi:

sdk mini program v2.2.0 atau lebih baru

Fitur

permintaan digunakan untuk membangun ID berbagi yang diperlukan untuk rantai berbagi

Parameter Permintaan

Parameter

Tipe

Nilai Default

Arti

Catatan

params

Object

Tidak ada

Bagikan API untuk mendapatkan parameter

  • Parameter wajib

path: jalur halaman yang dibagikan. Tipe String. Nilai defaultnya adalah jalur halaman yang dibagikan oleh mini program saat ini.

  • Parameter opsional

campaign: identitas kampanye berbagi. Tipe String, nilai defaultnya adalah undefined, panjang maksimumnya adalah 4*1024 karakter

title: Bagikan judul. Tipe String, nilai defaultnya adalah undefined, panjang maksimumnya adalah 4*1024 panjang

shareId: ID berbagi sumber. Tipe String. Nilai default: undefined.

callback

Function

undefined

Fungsi callback yang disediakan untuk platform applet yang tidak mendukung pengembalian promise

Jika parameter callback tidak ditentukan, API pengambilan parameter berbagi mengembalikan hasil sebagai promise secara default.

Jika parameter callback memiliki nilai dan merupakan parameter callback, fungsi callback mengembalikan hasil permintaan API pengambilan parameter berbagi.

Parameter Kembali

Jika parameter permintaan tidak berisi callback, kembalikan Promise.resolve(Object result)

Parameter

Tipe

Nilai Default

Arti

Catatan

$sid

String

undefined

ID Berbagi, yang mewakili pengenal unik dari perilaku berbagi subjek mini program saat ini.

Tidak ada

$scampaign

String

undefined

Identifikasi aktivitas berbagi

Bidang dalam SDK tidak perlu dimodifikasi. Jika tidak, akurasi data terpengaruh. ! !

$soriPath

String

Jalur yang dilewatkan saat API dipanggil.

Jika tidak ada nilai yang ditentukan, nilai defaultnya adalah jalur halaman tempat API dipanggil.

Tautan berbagi asli, yang mewakili URL berbagi asli.

Bidang dalam SDK tidak perlu dimodifikasi. Jika tidak, akurasi data terpengaruh. ! !

path

String

URL berbagi parameter $sid

URL Berbagi, yang mewakili alamat berbagi.

Bidang dalam SDK tidak perlu dimodifikasi. Jika tidak, akurasi data terpengaruh. ! !

title

String

undefined

Judul Berbagi

Tidak ada

Contoh Panggilan:

Catatan: Mengingat perbedaan kemampuan platform applet dalam API onShareAppMessage dan onShareTimeline, SDK menyediakan dua metode penggunaan API untuk meminta parameter berbagi, yaitu, pengembalian Promise dan pengembalian fungsi callback. Anda dapat memilih berdasarkan platform yang produk Anda perlu sesuaikan.

Berdasarkan Promise:

Metode 1: Dapatkan ID berbagi di metode kustom, lalu laporkan informasi berbagi melalui hasil yang dikembalikan di onShareAppMessage \ onShareTimeline.

Page({
  data: {
    $$_ share_id: "", // Bidang ID berbagi SDK.
  },
  getShareId() {
    // Metode 1: Dapatkan ID berbagi dari fungsi yang ditentukan pengguna.
    wx.aplus.requestShareParams({
      title: 'Bagikan halaman aktivitas',
      path: '/pages/share/shareCampaign?utm_test=test',
      campaign: 'Ini adalah kampanye berbagi',
      shareId: "Ini adalah id berbagi sumber"
    }).then(res => {
      const { $sid } = res;
      this.setData({
        $$_share_id: $sid
      });
      return res;
    });
  },
  // Dengarkan perilaku pengguna mengklik tombol teruskan (button open-type="share") atau tombol "teruskan" di menu kanan atas di halaman dan sesuaikan konten teruskan.
  onShareAppMessage(options) {
    return {
      title: 'Judul halaman aktivitas berbagi pengguna default',
      path: `/pages/share/shareCampaign?utm_test=test&$sid=${this.data.$$_share_id}`,
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi ID.
      $$_share_id: this.data.$$_share_id,
      // Tentukan ID aktivitas berbagi sesuai kebutuhan. Bidang ini adalah bidang prefabrikasi dalam SDK.
      $$_share_campaign_id: "Ini adalah aktivitas berbagi kustom",
      // Anda harus menentukan tautan berbagi asli. Ingatlah bahwa Anda tidak perlu menyambungkan ID berbagi.
      $$_ share_url: 'Bagikan ${this.route}?utm_source=Bagikan lingkaran teman', 
    }
  },
  ...
  // Pantau perilaku tombol "Bagikan ke Teman" di pojok kanan atas dan sesuaikan konten berbagi. 
  onShareTimeline(options) {
    return {
      title: "Berbagi Teman",
      // Parameter dalam query ketika subjek berbagi berikutnya membuka applet. Ingatlah untuk menyambungkan $sid, jika tidak, rantai berbagi akan terputus.
      query: `$sid=${this.data.$$_share_id}`,
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi ID.
      $$_share_id: this.data.$$_share_id,
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi id aktivitas.
      $$_share_campaign_id: "Ini adalah aktivitas berbagi kustom",
      // Anda harus menentukan tautan berbagi asli. Ingatlah bahwa Anda tidak perlu menyambungkan ID berbagi.
      $$_ share_url: 'Bagikan ${this.route}?utm_source=Bagikan lingkaran teman', 
    }
  },
  // Sesuaikan berbagi simulasi, seperti menghasilkan gambar berbagi dan konten clipboard berbagi.
  userCustomShare() {
    wx.aplus.record("$$_share", "CLK", { 
      // Tentukan bidang sesuai kebutuhan. Bidang tersebut telah dibuat sebelumnya dalam SDK dan judul berbagi.
      $$_ share_title: "Ini adalah judul berbagi",
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi ID.
      $$_share_id: this.data.$$_share_id,
      // Tentukan ID aktivitas berbagi sesuai kebutuhan. Bidang ini adalah bidang prefabrikasi dalam SDK.
      $$_share_campaign_id: "Ini adalah aktivitas berbagi kustom",
      // Tentukan bidang yang ingin Anda bagikan dengan platform target.
      $$_ share_type: "Platform target berbagi yang ditentukan pengguna",
      // Anda harus menentukan tautan berbagi asli. Ingatlah bahwa Anda tidak perlu menyambungkan ID berbagi.
      $$_ share_url: 'The ${this.route}?utm_source=Berbagi kustom', 
    });
  }
})

Metode 2: Panggil API pengambilan parameter berbagi di onShareAppMessage, lalu kembalikan hasilnya oleh promise di onShareAppMessage untuk melaporkan informasi berbagi.

Catatan: Metode onShareTimeline tidak mendukung pengembalian promise. Oleh karena itu, Anda onShareTimeline masih perlu menggunakan metode setState untuk mendapatkan ID berbagi.

Page({
  ...
  onShareAppMessage(options) {
    const promise = wx.aplus.requestShareParams({
      title: 'Bagikan halaman aktivitas',
      path: '/pages/share/shareCampaign?utm_test=test',
      campaign: 'Ini adalah kampanye berbagi',
      shareId: "Ini adalah id berbagi sumber"
    });

    return {
      title: 'Judul halaman aktivitas berbagi pengguna default',
      promise
    }
  },
  ...
  
})

Penggunaan Berbasis Callback:

Page({
  data: {
    $$_ share_id: "", // Bidang ID berbagi SDK.
  },
  getShareId() {
    wx.aplus.requestShareParams({
      title: 'Bagikan halaman aktivitas',
      path: '/pages/share/shareCampaign?utm_test=test',
      campaign: 'Ini adalah kampanye berbagi',
      shareId: "Ini adalah id berbagi sumber"
     }, (res) => {
      const { $sid } = res;
      this.setData({
        $$_share_id: $sid
      });
    });
  },
  ...
  // Dengarkan perilaku pengguna mengklik tombol teruskan (button open-type="share") atau tombol "teruskan" di menu kanan atas di halaman dan sesuaikan konten teruskan.
  onShareAppMessage(options) {
    return {
      title: 'Judul halaman aktivitas berbagi pengguna default',
      path: `/pages/share/shareCampaign?utm_test=test&$sid=${this.data.$$_share_id}`,
    	// Anda harus menentukan bidang prefabrikasi sdk untuk berbagi ID.
      $$_share_id: this.data.$$_share_id,
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi id aktivitas.
      $$_share_campaign_id: "Ini adalah aktivitas berbagi kustom",
      // Anda harus menentukan tautan berbagi asli. Ingatlah bahwa Anda tidak perlu menyambungkan ID berbagi.
      $$_ share_url: 'Bagikan ${this.route}?utm_source=Bagikan lingkaran teman', 
    }
  },
  // Pantau perilaku tombol "Bagikan ke Teman" di pojok kanan atas dan sesuaikan konten berbagi. 
  onShareTimeline(options) {
    return {
      title: "Berbagi Teman",
      // Parameter dalam query ketika subjek berbagi berikutnya membuka applet. Ingatlah untuk menyambungkan $sid, jika tidak, rantai berbagi akan terputus.
      query: `$sid=${this.data.$$_share_id}`,
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi ID.
      $$_share_id: this.data.$$_share_id,
      // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi id aktivitas.
      $$_share_campaign_id: "Ini adalah aktivitas berbagi kustom",
      // Anda harus menentukan tautan berbagi asli. Ingatlah bahwa Anda tidak perlu menyambungkan ID berbagi.
      $$_ share_url: 'Bagikan ${this.route}?utm_source=Bagikan lingkaran teman', 
     }
  },

  // Sesuaikan berbagi simulasi, seperti menghasilkan gambar berbagi dan konten clipboard berbagi.
  userCustomShare() {
     wx.aplus.record("$$_share", "CLK", {
        // Tentukan bidang sesuai kebutuhan. Bidang tersebut telah dibuat sebelumnya dalam SDK dan judul berbagi.
        $$_ share_title: "Ini adalah judul berbagi",
        // Anda harus menentukan bidang prefabrikasi sdk untuk berbagi ID.
        $$_share_id: this.data.$$_share_id,
       	// Tentukan ID aktivitas berbagi sesuai kebutuhan. Bidang ini adalah bidang prefabrikasi dalam SDK.
      	$$_share_campaign_id: "Ini adalah aktivitas berbagi kustom",
        // Tentukan bidang yang ingin Anda bagikan dengan platform target.
        $$_ share_type: "Platform target berbagi yang ditentukan pengguna",
        // Anda harus menentukan tautan berbagi asli. Ingatlah bahwa Anda tidak perlu menyambungkan ID berbagi.
      	$$_ share_url: 'The ${this.route}?utm_source=Berbagi kustom', 
      });
  }
})