すべてのプロダクト
Search
ドキュメントセンター

Quick Tracking:一般的なシナリオとトラッキングポイントに関する推奨事項

最終更新日:Nov 19, 2025

1. ページリダイレクト前のイベント送信

シナリオの説明

ユーザーが Web ページ上の href 属性を持つタグ www.xxxx.com をクリックすると、ページがすぐにリダイレクトされるため、トリガーされたクリックイベントが送信されない場合があります。このシナリオでデータが確実に送信されるようにするには、ページがリダイレクトされる前にクリックイベントをレポートします。

例:

// リンクをクリックします。
function targetLinkCLK(url) {
  aplus_queue.push({
    action: 'aplus.record',
    arguments:['track_alink_clk', 'CLK', {
      param1: "xxxx",
      param2: "xxxx",
    }],
  });
  window.location.href = url;
};

極端なケースでは、イベントが正常に送信できない場合、ページの遅延ジャンプを実行できます。サンプルコードは次のとおりです:

// リンクをクリックします。
function targetLinkCLK(url) {
  // ページのリダイレクトを遅延させ、SDK がページを送信するための時間を確保します。
  setTimeout(function(){
    window.location.href = url;
   }, 500);
  aplus_queue.push({
    action: 'aplus.record',
    arguments:[ 'track_alink_clk', 'CLK', {
      param1: "xxxx",
      param2: "xxxx",
    }],
  });
}

2. App に H5 を埋め込む方法

Android での H5 トラッキングの詳細については、以下をご参照ください。

Android アプリ H5 ブリッジ操作ドキュメント

iOS での H5 トラッキングに関する詳細については、以下をご参照ください。

iOS アプリの H5 ブリッジ

3. ミニプログラムに H5 を埋め込む方法

ミニプログラムにおける H5 トラッキングポイントの詳細については、以下をご参照ください。

ミニプログラムでの H5 埋め込みトラッキング操作ドキュメント

4. H5 自動トラッキングポイント

フル埋め込みポイント機能

機能の意味

操作ドキュメント

ページイベント

ページが読み込まれ、ライフサイクル内の onload 関数がトリガーされると、ページ閲覧イベントが自動的にレポートされます。そのデフォルトのイベントパラメーターは次のとおりです:

url: パラメーター付きのページ URL

ref_url: document.referrer

page_name: パラメーターを含まないページ URL

page_title: document.title

ページのトラッキングを有効化/無効化/設定する

クリックイベント

タグタイプを指定します。このタイプのタグがクリックされると、コントロールクリックイベントが自動的にレポートされます。イベント発生時のデフォルトのイベントパラメーターは次のとおりです:

url: パラメーター付きのページ URL

ref_url: document.referrer

page_name: パラメーターを含まないページ URL。

page_title: document.title

およびコントロール ID、コントロールタイプ、コントロールフィルター、コントロールの場所、コントロールのコンテンツ、コントロール名、コントロールのスタイル名

任意のコントロールクリックの自動キャプチャ

要素クラスを指定します。このクラスの要素がクリックされると、コントロールクリックイベントが自動的にレポートされます。イベント発生時のデフォルトのイベントパラメーターは次のとおりです:

url: パラメーター付きのページ URL

ref_url: document.referrer

page_name: パラメーターを含まないページ URL

page_title: document.title

指定された要素の自動クリック

タグタイプを指定します。このタイプのタグが露出 (表示領域に表示) されると、コントロール露出イベントが自動的にレポートされます。イベント発生時のデフォルトのイベントパラメーターは次のとおりです:

url: パラメーター付きのページ URL

ref_url: document.referrer

page_name: パラメーターを含まないページ URL

page_title: document.title

要素の自動露出を指定する

5. SDK によって書き込まれる Cookie の有効期限のカスタマイズ

プライバシーコンプライアンスポリシーが厳格化する傾向にあるため、一部のリージョンでは Cookie のデフォルトの有効期限が 1 年を超えてはならないと定められています。そのため、SDK は、SDK が Cookie を書き込むためのカスタム有効期限を日数単位で追加します。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="qt-cookie-expires" content="180">
    ....js
</head>
<body></body>
</html>

コードに示されているように、SDK によって書き込まれる Cookie の有効期限をカスタマイズする場合は、qt-cookie-expires という名前の meta タグを追加する必要があります。

詳細な説明:

パラメーター

意味

ドキュメント

qt-cookie-expires

SDK カスタム Cookie 有効期限

現在のアクセス時間の開始に基づいて有効期限が切れるまでの日数を表します。

数値の最小値: 1

数値の最大値: 20*365

デフォルトの有効期限は 365 日です。