全部產品
Search
文件中心

Quick Tracking:埋點驗證

更新時間:Jun 07, 2025

概述

支援App、小程式、Web三個端的埋點驗證。通過掃碼等方式建立點對點連結,線下操作後線上即可即時展示上報日誌。對埋點的基礎資訊、觸發位置、上報時機全面驗證,確保埋點品質。同時,埋點驗證支援驗證裝置基礎資訊,包括裝置ID、使用者帳號、應用版本號碼、渠道等。

1) 日誌明細模式可以清晰查看對應正確或錯誤的日誌詳情

2) 埋點方案模式可以清晰查看哪些埋點已經被驗證,哪些埋點還需要操作觸發。

image

埋點驗證位置如下:image.png

進入埋點驗證

Android

  1. 配置喚起碼

整合app時,在AndroidManifest.xml檔案中找到響應android.intent.action.MAIN的activity(也就是應用可以被外部喚起的第一個Activity),加上如下代碼,讓應用能被指定串連scheme喚起。

<intent-filter>
 <action android:name="android.intent.action.VIEW"/>
 <category android:name="android.intent.category.DEFAULT" />
 <category android:name="android.intent.category.BROWSABLE" />
 <data android:scheme="atm.你的appkey" />
 </intent-filter>

1、請使用單獨intent-filter,和其他intent-filter並列,不要將上述代碼填入其他intent-filter裡;

2、請將“你的appkey”替換成你真實appkey,下同;

  1. 在模組中輸入"atm.你的appkey",產生二維碼,並使用瀏覽器掃描image.pngimage.png

image

  1. 用瀏覽器掃碼後,會開啟一個網頁,點擊“開始埋點測試(內網有效)”

image

  1. 點擊後,埋點驗證模組會自動跳轉到下述頁面image.png

iOS

  1. 配置喚起碼

添加您的 URL Scheme 到專案中,URL Scheme 位於專案設定 target -> 選項卡 Info - > URL Types。填入的scheme:atm.你的appkey。在AppDelegate中調用函數[MobClick handleUrl:url]來接收 URL

- (BOOL)application:(UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options { if ([MobClick handleUrl:url]) { return YES; } return YES; }

  1. 在模組中輸入"atm.你的appkey",產生二維碼,並使用瀏覽器掃描image.pngimage.png

image

  1. 用瀏覽器掃碼後,會開啟一個網頁,點擊“開始埋點測試(內網有效)”

image

  1. 點擊後,埋點驗證模組會自動跳轉到下述頁面image.png

Web

  1. 將需要驗證的網頁連結填入輸入框,點擊“產生驗證地址”image.png

  1. 根據需求進行掃碼/點選連結image.png

  1. 點擊pc端連結後,瀏覽器會開啟新的tab,展示您輸入的URL連結內容,您在這裡“埋點觸發點位”,返回“埋點驗證”可以查看即時日誌。image.png

小程式image.png

將頁面上的“miniappDebugId”填寫進“啟動參數”

以微信小程式為例,在IDE裡添加參數的樣本如:

1.1. 首先請在此處選擇「添加編譯模式」;1.2. 添加以上代碼至「啟動參數」中;1.3. 點擊確定。image.png

日誌驗證

在APP、Web、小程式對接過Quick Tracking SDK的頁面上觸發點位,對應的日誌就會顯示在這裡。具體內容請查看「埋點驗證內容」

埋點驗證內容

埋點觸發上報日誌說明

埋點方案如下:image.pngimage.png

研發埋點後,觸發一個事件類型為“點擊”“曝光”“自訂”事件的日誌如下:

{ 使用者帳號; 裝置ID; 系統屬性; 全域屬性; 事件: { 事件編碼; 事件屬性; 用戶端時間戳記; 所在頁面; 應用使用時間長度;//只有應用退出事件才有 } }

觸發一個事件類型為“頁面瀏覽”事件的日誌如下:

{ 使用者帳號; 裝置ID; 系統屬性; 全域屬性; 事件: { 事件編碼=“$$_page_start”或者“$$_page_end” 事件屬性; 用戶端時間戳記; 所在頁面=頁面編碼 頁面訪問時間長度;//只有頁面退出事件才有 } }

使用者屬性的上報,是使用一個事件類型為“自訂”事件的日誌上報的:

{ 使用者帳號; 裝置ID; 系統屬性; 全域屬性; 事件: { 事件編碼=$$_user_profile 事件屬性=使用者屬性 用戶端時間戳記; } }

使用者帳號&裝置ID驗證image.png

這裡會展示日誌所攜帶的使用者帳號資訊和裝置ID資訊

使用者屬性驗證image.png

上報一個事件編碼為“$$_user_profile”的事件,其事件屬性即為使用者屬性

全域屬性驗證

全域屬性列下的即為全域屬性,設定後每個事件都會攜帶,除非調用清空介面

image

image

頁面事件驗證

image

頁面編碼與事件編碼相等,且和埋點方案一致,即為頁面事件。其中:

  1. app端的頁面事件在頁面退出時上報。

  2. 小程式端的頁面事件,如果為自動埋點在頁面退出時上報。如果為手動埋點在頁面事件被調用時上報。

  3. web的頁面事件編碼都為頁面事件被調用時上報。

其他事件驗證

事件編碼與頁面編碼與埋點方案一致即可。

預置事件驗證

預置事件的事件編碼是固定,具體可見預置事件列表。

驗證報告

概述

針對上述埋點驗證內容產生驗證報告,以便開發人群和業務人員做內容確認。

操作說明

驗證報告會以每次驗證的方式展示在這裡,點擊具體的報告就可以看下本次驗證的完整資訊

image

image

點擊驗證記錄可以查看詳細的資訊

image