すべてのプロダクト
Search

このプロダクト

    Quick Tracking:トラッキング検証詳細ガイド

    ドキュメントセンター

    Quick Tracking:トラッキング検証詳細ガイド

    最終更新日:Jun 09, 2025

    1. トラッキングの検証方法

    研究開発：IDE コンソールで、SDK はレポート ログを出力します

    テスト：QT バックグラウンドは「トラッキングポイント検証」ツールを提供します

    ビジネス：QT バックグラウンドで提供される「分析」モジュールは、ビジネス指標を構築できます。計算結果がビジネスロジックに準拠しているかどうかを確認する必要があります。

    上記の具体的な操作は次のとおりです。

    1.1 IDE コンソールでトラッキング ログを出力する

    1.1.1 Android

    UMConfigure.setLogEnabled(boolean) インターフェイスを使用して、LOG の出力を制御できます。

    説明

    注：アプリを正式にリリースする前に、SDK の実行ログとデバッグログを無効にしてください。無関係なログ出力を回避します。

    ログエクスポート機能を有効にする

    次のメソッドを呼び出して、SDK 実行デバッグログを出力するかどうかを制御できます。デフォルトでは、SDK 実行デバッグログは無効になっています。ユーザーが手動で開く必要があります。

    /**
* コンポーネントベースのログのスイッチを設定します。
* パラメーター：boolean はデフォルトで false に設定されています。 LOG を表示する場合は、true に設定します。
*/
UMConfigure.setLogEnabled(true);

    説明

    注：初期化中に LOG を表示する場合は、初期化メソッドを呼び出す前に必ず LOG スイッチをオンにしてください。

    次のログエントリが表示されます：

    image.png

    ログレベル

    • ログは、見やすくするために 4 つのレベルに分類されます。

    • エラー（SDK 統合または実行時エラーメッセージを出力します）。

    • 警告（SDK 警告情報を出力します）。

    • 情報（SDK プロンプト情報を出力します）。

    • デバッグ（SDK デバッグ情報を出力します）。

    1.1.2 iOS

    iOS では、ログモジュールは独立したプラグインであり、統合後にのみ使用できます。

    ログプラグインのインポート

    pod インポート

    pod 'UMCCommonLog'

    ローカルインポート

    1. SDK 機能コンポーネントを選択してダウンロードします。 .zip ファイルを解凍して、対応するコンポーネントパッケージ（UMCommonLog.framework、UMCommonLog.bundle）を取得します。

    2. XcodeFile -> 「プロジェクトに追加」ファイルを選択し、ダウンロードしたコンポーネントパッケージ -> ポップアップパネルで追加を選択します。（注：「必要に応じて項目をコピー」をチェックしてください）

    ログの切り替え

    UMCommon.framwork ヘッダーファイルの UMConfigure.h API を使用して、ロギングを有効にします。

    API：

    /**コンソールに SDK のログ情報を出力するかどうかを指定します。
 @ param bFlag デフォルト NO（ログ出力なし）。デバッグリファレンスのログ情報を出力するには、YES に設定します。製品を公開するときは、NO に設定します。
 */
+ (void)setLogEnabled:(BOOL)bFlag;

    例

    #import <UMCommon/UMCommon.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// ロギングシステムを動作させるには、開発者はこの関数を明示的に呼び出す必要があります。
[UMCommonLogManager setUpUMCommonLogManager];
[UMConfigure setLogEnabled:YES];// ロギングを有効にするように指定します。
[UMConfigure setCustomDomain:@"https://www.umeng.com" standbyDomain:nil];// ドメイン名を設定します。
[UMConfigure initWithAppkey:@"Your appkey" channel:@"App Store"];
}

    次のログエントリが表示されます：

    image.png

    ログレベル

    たとえば、ユーザーが渡した AppKey が空の場合、ログは次の図のように出力されます。

    • 2018-02-08 20:19:44：現在の印刷時間を指します。

    • UMengCommon：コンポーネントベースの SDK（UMCommon.framework）の名前。

    • <1.4.3>：コンポーネントベースの SDK（UMCommon.framework）のバージョン番号。

    • (Error)：ログレベルが Error のログを指します。

    • [CIE10001]：ログ FAQ のコードを指します。 FAQ ドキュメントからも対応するソリューションを見つけることができます。

    • 指定された AppKey は無効です。アプリの統計情報に影響を与えないように、公式 Web サイトで AppKey を申請してください。：開発者にエラーの原因を見つけるのに役立つエラーメッセージを示します。

    1.1.3 ミニプログラム

    ログエクスポート機能を有効にする

    aplus.aplus_queue.push({
  action: 'aplus.setMetaInfo',
  arguments: ['DEBUG', true]
});

    • IDE に移動し、デバッグツールでコンソールオプションを開きます。次の図に示すように、ログレポートが表示されます。

    image.png

    1.1.4 Web

    ログエクスポート機能を有効にする

    aplus.aplus_queue.push({
  action: 'aplus.setMetaInfo',
  arguments: ['DEBUG', true]
});

    次のログエントリが表示されます：

    image.png

    1.2 QT バックグラウンド「トラッキング検証」ツール

    トラッキング検証場所は次のとおりです：image.png

    1.2.1 アプリ検証

    1. Android

    Android は現在、スキャンコード検証とAPI 検証の 2 つの方法をサポートしています

    image

    1.1 スキャンコード検証

    アプリを統合するときは、manifest.xml ファイルでレスポンスandroid.intent.action.MAIN のactivity（つまり、アプリケーションを外部から呼び出すことができる最初の Activity）を見つけ、次のコードを追加して、アプリケーションを指定された接続スキームで呼び出すことができるようにします。

    <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. Your appkey" />
 </intent-filter>
    説明

    1. 別の intent-filter を使用し、他の intent-filter と並べて配置してください。上記のコードを他の intent-filter に入力しないでください。 2. 「your appkey」を実際の appkey に置き換えてください。以下も同じです。

    1. モジュールで「atm. Your appkey」を入力し、QR コードを生成して、ブラウザを使用してスキャンします

    image

    image

    image.png

    1. ブラウザでコードをスキャンすると、Web ページが開きます。「埋め込みテストを開始（イントラネット有効）」をクリックします

    image.png

    1. クリックすると、トラッキング検証モジュールは自動的に次のページにジャンプします

    image

    1.2 API 検証

    API 検証オプションをクリックし、赤いボックスにカスタムDebugKey を入力して、「次へ」をクリックします

    image

    「次へ」をクリックすると、関連するコードフラグメントが生成され、プロジェクトの初期化メソッドに貼り付けられます。

    image

            ...
        QtConfigure.preInit(this, Constant.DEFAULT_APPKEY, Constant.DEFAULT_CHANNEL);

         // QtConfigure が存在しない場合は、UMConfigure に変更します。
        QtConfigure.setDebugKey("13062007216102_Rabby_Test");
        ...

    アプリケーションを再コンパイルして実行する

    Web ページの「検証開始」ボタンをクリックして、アプリ検証ページにジャンプし、トラッキングを検証します。

    image

    1. iOS

    1. 呼び出しコードを構成する

    URL スキームをプロジェクトに追加します。 URL スキームは、プロジェクト設定の target -> タブ情報 -> URL タイプにあります。入力されたスキーム：atm. Your 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. Your appkey」を入力し、QR コードを生成して、ブラウザを使用してスキャンします

    image.png

    image.png

    image.png

    1. ブラウザでコードをスキャンすると、Web ページが開きます。「トラッキングテストを開始（イントラネット有効）」をクリックします

    image.png

    1. クリックすると、トラッキング検証モジュールは自動的に次のページにジャンプします

    image.png

    1. Web

    1. 検証する Web ページリンクを入力ボックスに入力し、「検証アドレスを生成」をクリックします

    image.png

    1. 必要に応じてコードをスキャン/リンクをクリックします

    image.png

    1. PC 側でリンクをクリックすると、ブラウザは新しいタブを開いて、入力した URL リンクの内容を表示します。ここで「トリガーポイントを追跡」し、「トラッキング検証」に戻ってリアルタイムログを表示できます。 image.png

    1. ミニプログラム image.png

    ページの「miniappDebugId」を「起動パラメーター」に入力します

    WeChat ミニプログラムを例にとります。例：

    1.1. まず、ここで「コンパイルモードを追加」を選択します。 1.2. 上記のコードを「起動パラメーター」に追加します。 1.3. 「OK」をクリックします。 image.png

    1.2.2 ログ検証

    トリガーポイントが app、mini、または qt によって生成された Web ページにある場合、対応するログがここに表示されます。具体的な内容と領域については、「2 トラッキング検証内容」を参照してください

    2 トラッキング検証内容

    2.1 トラッキングトリガーレポートログガイド

    トラッキング計画は次のとおりです。

    image.png

    トラッキングが開発された後、イベントタイプがクリック、公開、またはカスタムの場合、次のログがトリガーされます。

    {
    ユーザーアカウント。
    デバイス ID。
    システムプロパティ。
    グローバル属性。
    イベント：
    {
        イベントコーディング。
        イベントプロパティ。
        クライアントのタイムスタンプ。
        それが配置されているページ。
        アプリケーションの使用期間。 // アプリケーション終了イベントのみ
    }
}

    「ページ閲覧」タイプのイベントをトリガーするログは次のとおりです。

    {
    ユーザーアカウント。
    デバイス ID。
    システムプロパティ。
    グローバル属性。
    イベント：
    {
        イベントコード =「$$_ page_start」または「$$_ page_end」
        イベントプロパティ。
        クライアントのタイムスタンプ。
        Page =ページエンコーディング
        ページアクセス期間。 // ページ終了イベントのみ
    }
}

    ユーザープロパティのレポートは、「カスタム」イベントタイプのログを使用してレポートされます。

    {
    ユーザーアカウント。
    デバイス ID。
    システムプロパティ。
    グローバル属性。
    イベント：
    {
        イベントコード= $$_ user_profile
        イベント属性 =ユーザー属性
        クライアントのタイムスタンプ。
    }
}

    2.2 ユーザーアカウントとデバイス ID の検証 image.png

    ログに含まれるユーザーアカウント情報とデバイス ID 情報がここに表示されます。

    2.3 ユーザー属性検証 image.png

    イベントコード「$$_ user_profile」のイベントをレポートします。そのイベント属性はユーザー属性です

    2.5 グローバル属性検証

    グローバル属性列の下では、clear API が呼び出されない限り、グローバルプロパティは設定後に各イベントに含まれます。

    image.png

    image.png

    2.5 ページイベント検証

    image.png

    ページエンコーディングはイベントエンコーディングと同じであり、トラッキング計画と一致しています。これはページイベントです。有効な値：1〜9。

    1. アプリ側のページイベントは、ページが終了したときにレポートされます。

    2. ミニプログラムのページイベントが自動的に追跡される場合、ページが終了したときにレポートされます。手動トラッキングポイントの場合は、ページイベントが呼び出されたときにレポートされます。

    3. Web ページイベントのイベントコードは、ページイベントが呼び出されたときにレポートされます。

    2.6 その他のイベント検証

    イベントコードはページコードとトラッキング計画と一致しています。

    2.7 すぐに使えるイベント検証

    プリセットイベントのイベントコードは固定です。詳細については、プリセットイベントリストを参照してください。