一般的なシナリオとトラッキングポイントの提案 - Quick Tracking

1 ページジャンプ前のイベント送信

説明

ユーザーがページ上の「すぐにページをジャンプするボタンをクリックする」と、トリガーされたクリックイベントはページがすぐにジャンプするため送信されない場合があります。このシナリオでデータが可能な限り送信されるようにするには、ページのジャンプを遅らせます。 WeChat ミニプログラムのコードを例にとります。

// リンクをクリックします。
function targetLinkCLK(url) {
  // ページのリダイレクトを遅らせ、SDK がページを送信するための時間を確保します。
  setTimeOut(function(){
    wx.navigateTo({
      url: `/pages/goods/details/index`,
    });
  }, 500);
  const { aplus } = ミニプログラムプラットフォーム環境変数 // WeChat wx、Alipay my、Byte tt、Baidu Swan など。
  aplus.record('track_navigate_clk', 'CLK', { 
    param1: xxxx, 
    param2: xxxx
  });
}

2 アプリケーション起動時に別のページにリダイレクトする

説明

ミニプログラムのスタートアップページが固定されておらず、いくつかのビジネスロジックに基づいて他のページに再起動したい場合があります。この場合、アプリケーション起動イベントのページコードとページタイトルは、pageConfig のマッピングと一致しない場合があります。このシナリオが存在する場合は、redirectTo API 呼び出しを遅らせることができます。 WeChat ミニプログラムのコードを例にとります。

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

3 WeChat ミニプログラムプラグインの追跡方法

シナリオの説明

シナリオによっては、WeChat アプレット開発者は、独立した再利用可能なページとコンポーネントを WeChat アプレットプラグインにパッケージし、WeChat アプレットメインパッケージを介して WeChat アプレットプラグインを統合することで、アプリケーション開発全体を完了する必要があります

3.1 ホストアプレット QuickTracking アプレット SDK の統合と構成

3.2 プラグイン呼び出し用の SDK 環境変数のエクスポート

exportToPlugin.js ファイルを作成し、次のロジックを実装します

次に、app.json でプラグインに公開する必要がある js ファイルをエクスポートします。

ページビューイベントの例:

const aplus = require('../utils/aplus.js');
Page({
  data: {},
  onLoad() {
    console.log('これはプラグインページです！', aplus); // これはプラグインページです！
  },
  onShow() {
    aplus.sendPV({is_auto: false}, {page_name: 'plugin_page'});
  },
})

クリックイベントの例:

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

注: ミニプログラムプラグインの SDK には次の制限が適用されます。

1. 自動 PV はサポートされていません。

2. 自動クリックや露出などの自動追跡はサポートされていません。

3. ビジュアルトラッキングポイントはサポートされていません。

4. SDK はプラグイン内のページアドレスをカウントできないため、プラグイン内のページレポートイベントでは、イベント属性で page_name を指定する必要があります。指定しないと、統計の相関計算を実行できません。

4 ミニプログラムシナリオの意味

Quick Tracking は、各プラットフォームの公式シーン値を収集します。次のリンクは、マッピングドキュメントを示しています。

Baidu シーン値: https://smartprogram.baidu.com/docs/data/scene/

WeChat シーン値: https://developers.weixin.qq.com/minigame/dev/reference/scene-list.html

Byte シーン値: https://microapp.bytedance.com/docs/zh-CN/mini-game/develop/framework/scene-value/

Alipay シーン値: https://opendocs.alipay.com/mini/framework/scene

QQ シーン値: https://q.qq.com/wiki/develop/game/frame/scene/

5 ミニプログラム共有の反復定義

QuickTracking のバックグラウンドでは、反復メトリックはシーン値に基づいて定義されます。次の表でパラメーターについて説明します。

WeChat：「1 対 1 チャットセッションのミニプログラムメッセージカード」、「グループチャットセッションのミニプログラムメッセージカード」、「アプリ共有メッセージカード」、「shareTicket 付きミニプログラムメッセージカード」、「チャットレコード、ミニプログラムを開く」、「#トピックページでミニプログラムを開く」、「フレンドサークルで単一ページモードを開く」
Alipay：「1 対 1 チャットセッションのミニプログラムメッセージカード（共有）」
Byte：「WeChat ダイアログ」、「WeChat フレンドサークル」、「QQ ダイアログ」、「Qzone」、「DingTalk」、「システム共有」、「リンクのコピー」、「パスワード共有」、「共有マイクロヘッドライン」
Baidu：「共有」、「元のインターミディエイトページを共有」、「Web ベースのインターミディエイトページを共有」、「Baidu フレンドチャットページ反復ポータル」

6 1.X から 2.X へのアップグレード操作ドキュメント

SDK の置き換え

2. バージョン X SDK のダウンロードアドレスは、対応するインターフェース担当者に連絡して入手できます。

アドレスを開いたら、空白をクリックし、[右クリック] して SDK をローカルに保存し、新しい SDK ファイルをプロジェクトにドラッグします。

SDK の導入:

受信ドメイン名フィールドが aplus-rhost-v から trackDomain' に変更されました。

const aplus=require ('./utils/aplus_mini')(aplusConfig); 次のように置き換えます。

// initQTSDK 関数が実行されると、SDK はミニプログラムのコンテキスト（WeChat wx、byte tt、Alipay my など）にマウントされます。
// aplus および aplus_queue 環境変数
import { initQTSDK } from './utils/qt_mini.umd.js';
initQTSDK(aplusConfig);

SDK 2.x は、2 つの API 呼び出し方法を提供します:

aplus 環境変数を使用して API を直接呼び出す
SDK の aplus_queue に API コマンドを送信する

注: 2 つの方法のいずれかを選択し、混在させることができます。

1. aplus 環境変数を使用して API 操作を呼び出す

直接 API 呼び出しのコードは、次の形式でより簡潔になります。

const { aplus } = ミニプログラムプラットフォーム環境変数 // WeChat wx、Alipay my、Byte tt、Baidu Swan など。
aplus.${APIName}($arguments) // arguments は指定された API の入力パラメーターです。

ヒント: WordPress のバージョン 4.7 以降では、REST API がデフォルトで有効になっています。

APIName には以下が含まれます。

setMetaInfo: SDK の既存のデフォルト設定を上書きします
appendMetaInfo: append SDK のデフォルト構成
getMetaInfo: SDK の現在の構成を取得します。
record: イベントログの送信に使用されます
sendPV: ページログの送信に使用されます

arguments は、各 API 呼び出しの入力パラメーターです

2. aplus_queue キューに API コマンドを送信する

SDK に API コマンドを送信するには、SDK のコマンドキュー aplus_queue にコマンドを送信します。 SDK はコマンドを実行します。コマンド形式は次のとおりです。

const { aplus_queue } = ミニプログラムプラットフォーム環境変数; // WeChat wx、Alipay my、byte tt、Baidu Swan など。
aplus_queue.push({
  action: "$APIName",
  arguments: [$arguments], // arguments は指定された API の入力パラメーターです。
});

action パラメーターは、命令を送信する API の名前を表します。入力パラメーターは文字列で、値は列挙値です。使用可能な列挙値は次のとおりです
- aplus.setMetaInfo: SDK の既存のデフォルト設定を上書きします
- aplus.appendMetaInfo: append SDK のデフォルト構成
- aplus.getMetaInfo: SDK の現在の構成を取得します。
- aplus.record: イベントログの送信に使用されます
- aplus.sendPV: ページログの送信に使用されます
arguments パラメーターは、action で指定された API の入力パラメーターです。形式は配列です。配列内の要素の順序は、API で定義されている入力パラメーターの順序と同じです。

7. その他のフレームワークサポート機能

WeChat ミニプログラムフレームワークは、プラットフォームによって動作が一貫していません。一部の PC 環境では、失われた事前作成済みの page exit イベントと application exit イベントが使用されます。

8. フックについて

SDK 自体は、システム onAppHide イベントをフックします。事前作成済みのイベント page exit、page usage duration、application exit、application usage duration が正しく収集されるようにするには、wx.onAppHide イベントで時間のかかる操作を実行しないでください。