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

Quick Tracking:Quick Tracking の基本概念

最終更新日:Jun 26, 2025

Quick Tracking をすぐに使い始めるには、コレクション SDK とトラフィック分析製品の基本概念を理解することをお勧めします。これらの基本概念は、データ収集からデータ分析までの全プロセスを通して一貫しています。

行動収集

行動収集では、理解すべき 4 つの基本概念があります。

システム イベント

システム イベントは、アプリケーションの統計を収集するために SDK によって送信される最も基本的なメトリクスです。すべてのシステム イベント コード (SDK メッセージの ID フィールドに対応) は "$$_" で始まります。

イベント名

アプリ

ミニプログラム

ウェブ

アプリケーション起動($$_app_start)

サポート対象

許可

許可しない

アプリケーション終了($$_app_end)

サポート対象

許可

許可しない

共有($$_share)

なし。

提供

許可しない

システム イベント メッセージ プロトコルのデモは次のとおりです。

{
  "ekv": [
    {
      "9A62BBB3B0B1CD2BEB3F2E21CABED8C3": [
        {
          "id": "ss_app_start",// eventid は変更されず、アプリの起動イベントを表します。
          "ts": 1610420984378,// トリガーがトリガーされた時刻。
          "ds": 0,
          "pn": "UMMobCLick",// プロセスの名前。
          "status": 1,// イベントはイベントの前と最中にマークされます。
          "start_type": 1,// 起動タイプ (コールド 1、ホット 0)
          "rank": 1,// イベント トリガー ソート番号 (同じセッション内では、イベントは累積され、上限は 10w で、リセットは超過されます)
          "page_name": "cn.cctv.video",// イベントがトリガーされたときのページの名前。
          "url": "cn.cctv.video",
           // スーパー属性。ローカルに永続化されます。
            "gp": {
            "umsp_1": "val1111",
            "gp": {
            "umsp_1": "val1111",
          }
        }
      ]
    }
  ]
}

ページイベント

ページ イベントは、ページ閲覧行動を収集するために使用されるイベントです。ページ イベントのログには、ページ イベント識別コードとページ コードの 2 つの要素が含まれています。

  • ページイベント識別コード:イベントをページイベントとして識別するために使用され、SDK メッセージの ID フィールドに対応します。値はシステムによって指定されます。$$_page_start および $$_page_end。$$_page_start はページに入ったときにページイベントがトリガーされることを示し、$$_page_end はページから出たときにページイベントがトリガーされることを示します。

  • ページ コード: ページの一意の識別子。SDK メッセージの page_name フィールドに対応します。たとえば、商品詳細ページにタグを付けたい場合は、Page_Detail などのコードを使用してページを商品詳細ページとして指定する必要があります。ページ コードに特別な要件はありません。文字化けを防ぐため、小文字または小文字とアンダースコア(_) を使用することをお勧めします。

ページイベントメッセージのデモは次のとおりです。

{
  "ekv": [
    {
      "9A62BBB3B0B1CD2BEB3F2E21CABED8C3": [
        {
          "id": "$s_page_end",// eventid は変更されません。
          "ts": 1610420984370,// トリガーがトリガーされた時刻。
          "ds": 0,
          "pn": "UMMobCLick",// プロセスの名前。
          "status": 1,// イベントはイベントの前と最中にマークされます。
          "duration": 720,// ページアクセス時間
          "type": 1,// ページ収集モード。
          "rank": 1,// イベント トリガー シーケンス番号 (同じセッション、イベントも追加、上限 10W、リセット以上)
          "page_name": "cn.cctv.video",// イベントがトリガーされたときのページの名前。
          "urt": "cn.cctv.video",
          "page_start": 1611213614016,//Android はページの露出時間を記録し、i0S は記録しません。

          // スーパー属性。ローカルに永続化されます。
          "sp": {
            "umsp_1": "val1111"
          },
             // グローバル属性。ライフサイクルで 1 回有効です。
          "gp": {
            "umsp_i": "val1111"
          },
       // ページ プロパティ パススルー
          "transp": {
            "page_arg1": "super_man"// イベント (ページ) プロパティ 1 (ユーザーは複数設定できます)
          },
            // ページ プロパティをカスタマイズします。
          "cusp": {
            "page_arg1": "super_man"// イベント (ページ) プロパティ 1 (ユーザーは複数設定できます)
          }
        }
      ]
    }
  ]
}

カスタム イベントのレポート

カスタム イベントは、ページ イベント以外のイベントです。一般的に、露出やクリックなどのユーザー操作を収集するために使用されます。イベント追跡の前に、イベントのコードを指定する必要があります。これは、SDK メッセージの ID フィールドに対応します。イベント コードは必須ではありません。文字化けを防ぐため、小文字の英語または小文字の英語とアンダースコアをイベント コードとして使用することをお勧めします。

カスタムイベントメッセージのデモは次のとおりです。

{
  "ekv": [
    {
      "9A62BBB3B0B1CD2BEB3F2E21CABED8C3": [
        {
          "id": "User-defined",// eventid は変更されません。
          "ts": 1610420984370,// トリガーがトリガーされた時刻。
          "ds": 0,
          "pn": "UMMobCLick",// プロセスの名前。
          "status": 1,// イベントはイベントの前と最中にマークされます。
          "rank": 1,// イベント トリガーのシーケンス番号。イベントが同じセッション内にある場合、シーケンス番号も追加されます。
          "page_name": "cn.cctv.video",// イベントがトリガーされたときのページの名前。
           // スーパー属性。ローカルに永続化されます。
          "sp": {
            "umsp_1": "val1111"
          },
            // グローバル属性。ライフサイクルで 1 回有効です。
          "gp": {
            "umsp_1": "val1111"
          },
          "cusp": {
            "page_arg1": "super_man"// イベント プロパティ 1 (複数のプロパティを指定できます)
          },
          "url": "cn.cctv.video",
          "ref_url": "https://xxx.taobao.com",
          "ref_page_name": "cn.cctv.main",
          "spm_cnt": "b.c.d",//b=page_name。 c と d はユーザーによって渡されます。 b はユーザーによって渡されません。 bcd 個別のコーディング
          "spm_url": "x.x.",
          "spm_pre": "x.x.x"
        }
      ]
    }
  ]
}

プロパティ

イベントの種類に関係なく、イベントの発生シナリオを識別するために、イベントのプロパティを分類する必要があります。たとえば、商品詳細ページの回数や人数などの基本データを追跡した後、商品詳細ページの異なるイベント カテゴリの回数をさらに知りたい場合は、商品詳細ページのイベントに商品カテゴリ プロパティを追加する必要があります。

Quick Tracking のプロパティは、次の 2 つのタイプに分類されます。

  • グローバル属性:

地理位置情報など、各イベントによって伝達される属性。グローバル属性のメッセージ プロトコルのデモは次のとおりです。

{
  "ekv": [
    {
      "9A62BBB3B0B1CD2BEB3F2E21CABED8C3": [
        {
          "id": "User-defined",// eventid は変更されません。
          "ts": 1610420984370,// トリガーがトリガーされた時刻。
          "ds": 0,
          "pn": "UMMobCLick",// プロセスの名前。
          "status": 1,// イベントはイベントの前と最中にマークされます。
          "rank": 1,// イベント トリガーのシーケンス番号。イベントが同じセッション内にある場合、シーケンス番号も追加されます。
          "page_name": "cn.cctv.video",// イベントがトリガーされたときのページの名前。
           // スーパー属性。ローカルに永続化されます。
          "sp": {
            "umsp_1": "val1111"
          },
            // グローバル属性。ライフサイクルで 1 回有効です。
          "gp": {
            "umsp_1": "val1111"
          },
          "cusp": {
            "page_arg1": "super_man"// イベント プロパティ 1 (複数のプロパティを指定できます)
          },
          "url": "cn.cctv.video",
          "ref_url": "https://xxx.taobao.com",
          "ref_page_name": "cn.cctv.main",
          "spm_cnt": "b.c.d",//b=page_name。 c と d はユーザーによって渡されます。 b はユーザーによって渡されません。 bcd 個別のコーディング
          "spm_url": "x.x.",
          "spm_pre": "x.x.x"
        }
      ]
    }
  ]
}
  • イベント プロパティ:

ショッピング カートに追加された商品価格属性など、このイベントによって伝達される属性のみが、次のメッセージ プロトコルのデモに含まれています。

{
  "ekv": [
    {
      "9A62BBB3B0B1CD2BEB3F2E21CABED8C3": [
        {
          "id": "User-defined",// eventid は変更されません。
          "ts": 1610420984370,// トリガーがトリガーされた時刻。
          "ds": 0,
          "pn": "UMMobCLick",// プロセスの名前。
          "status": 1,// イベントはイベントの前と最中にマークされます。
          "rank": 1,// イベント トリガーのシーケンス番号。イベントが同じセッション内にある場合、シーケンス番号も追加されます。
          "page_name": "cn.cctv.video",// イベントがトリガーされたときのページの名前。
           // スーパー属性。ローカルに永続化されます。
          "sp": {
            "umsp_1": "val1111"
          },
            // グローバル属性。ライフサイクルで 1 回有効です。
          "gp": {
            "umsp_1": "val1111"
          },
          "cusp": {
            "page_arg1": "super_man"// イベント プロパティ 1 (複数のプロパティを指定できます)
          },
          "url": "cn.cctv.video",
          "ref_url": "https://xxx.taobao.com",
          "ref_page_name": "cn.cctv.main",
          "spm_cnt": "b.c.d",//b=page_name。 c と d はユーザーによって渡されます。 b はユーザーによって渡されません。 bcd 個別のコーディング
          "spm_url": "x.x.",
          "spm_pre": "x.x.x"
        }
      ]
    }
  ]
}

ユーザー識別子

すべての行動分析は、行動をつなぐために使用される主体に焦点を当てる必要があります。クイックトラッキングは、次の 2 つのタイプの分析主体をサポートしています。

  • デバイス: デバイスの一意の識別子。SDK パケットの umid フィールドに対応します。デバイスは、ハードウェア デバイス識別子に基づいてコレクション SDK によって生成され、一意のデバイスを識別するために使用されます。

  • ユーザー:ユーザーの一意の識別子で、プロダクトのアカウントシステムに直接接続されます。ユーザーがログインして SDK を呼び出すと、アカウントが一意のユーザーを識別するために使用されます。