All Products
Search
Document Center

Quick Tracking:Tracking Verification Detailed Guide

Last Updated:Mar 28, 2025

1. Verification method of tracking

R&D: In the IDE console, the SDK outputs reporting logs

Test: QT background provides "tracking point verification" tool

Business: In the QT background, the "analysis" module provided can build business indicators, and you need to verify whether the calculation results conform to the business logic.

The above specific operation is as follows.

1.1 Output tracking logs in the IDE console

1.1.1 Android

You can use the UMConfigure.setLogEnabled(boolean) interface to control the output of LOG.

Note

Note: Before the app is officially launched, disable the SDK running and debugging logs. Avoid irrelevant log output.

Enable the log exporting feature

You can call the following method to control whether the SDK running debug log is output. By default, the SDK running debug log is disabled. Requires the user to manually open it.

/**
* Set the switch for component-based logs.
* Parameter: boolean is set to false by default. If you want to view LOG, set it to true.
*/
UMConfigure.setLogEnabled(true);

Note

Note: If you view the LOG during initialization, be sure to turn on the LOG switch before calling the initialization method.

The following log entries are displayed:

image.png

Log levels

  • Logs are classified into four levels for easy viewing:

  • Error (print SDK integration or run time error message).

  • Warn (print SDK warning information).

  • Info (print SDK prompt information).

  • Debug (print SDK debugging information).

1.1.2 iOS

In iOS, the log module is an independent plug-in and can be used only after it is integrated.

Import Log Plug-in

pod import

pod 'UMCCommonLog'

Local Import

  1. Select and download the SDK functional components. Decompress the. zip file to obtain the corresponding component package (UMCommonLog.framework,UMCommonLog.bundle).

2. XcodeFile -> Add Files to "Your Project" and select the downloaded component package-> Add in the pop-up Panel. (Note: check "Copy items if needed")

Log Toggle

Use the UMConfigure.h API of the UMCommon.framwork header file to enable logging.

API:

/**Specify whether to output the log information of the SDK in the console.
 @ param bFlag Default NO (no log output); Set to YES to output log information for debugging reference. When publishing the product, set it to NO.
 */
+ (void)setLogEnabled:(BOOL)bFlag;

Example

#import <UMCommon/UMCommon.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Developers need to explicitly call this function for the logging system to work.
[UMCommonLogManager setUpUMCommonLogManager];
[UMConfigure setLogEnabled:YES];// Specify to enable logging.
[UMConfigure setCustomDomain:@"https://www.umeng.com" standbyDomain:nil];// Set the domain name.
[UMConfigure initWithAppkey:@"Your appkey" channel:@"App Store"];
}

The following log entries are displayed:

image.png

Log levels

For example, if the AppKey passed in by the user is empty, the log is printed as shown in the following figure:

  • 2018-02-08 20:19:44: Refers to the current printing time;

  • UMengCommon: the name of the component-based SDK(UMCommon.framework).

  • <1.4.3>: the version number of the component-based SDK(UMCommon.framework).

  • (Error): refers to logs whose log level is Error;

  • [CIE10001]: refers to the code of the log FAQ. You can also find the corresponding solution through the FAQ document.

  • The specified AppKey is invalid. Apply for an AppKey on the official website to avoid affecting the statistics of your app. : indicates the error message that prompts the developer to help the developer find the cause of the error.

1.1.3 Small program

Enable the log exporting feature

aplus.aplus_queue.push({
  action: 'aplus.setMetaInfo',
  arguments: ['DEBUG', true]
});
  • Go to the IDE and open the console option in the debugging tool. You can see the log report as shown in the following figure.

image.png

1.1.4 Web

Enable the log exporting feature

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

The following log entries are displayed:

image.png

1.2 QT background "tracking verification" tool

The tracking verification locations are as follows: image.png

1.2.1 APP verification

  1. Android

Android currently supports two methods: scan code verification and API verification

image

1.1 scan code verification

When integrating app, find the activity of the response android.intent.action.MAIN (that is, the first Activity that the application can be evoked externally) in the manifest.xml file, and add the following code so that the application can be evoked by the specified connection 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. Your appkey" />
 </intent-filter>
Note

1. Please use a separate intent-filter, juxtaposed with other intent-filters, and do not fill the above code into other intent-filters; 2. Please replace "your appkey" with your real appkey, the same below;

  1. In the module, enter "atm. Your appkey", generate a QR code and scan it using a browser

image

image

image.png

  1. After scanning the code with the browser, a web page will be opened and click "Start Burial Test (Intranet Valid)"

image.png

  1. After clicking, the tracking verification module will automatically jump to the following page

image

1.2 API verification

Click the API verification option, enter your custom DebugKey in the red box, and click Next

image

After clicking Next, relevant code fragments will be generated and pasted into the project initialization method.

image

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

         // If QtConfigure does not exist, change it to UMConfigure.
        QtConfigure.setDebugKey("13062007216102_Rabby_Test");
        ...

Recompile and run applications

Click the Start Verification button of the web page to jump to the APP verification page to verify the tracking.

image

  1. iOS

  1. Configure evocation codes

Add your URL Scheme to the project. The URL Scheme is located in the project settings target - > tab Info - > URL Types. The filled scheme:atm. Your appkey. Call function [MobClick handleUrl:url] in AppDelegate to receive URL

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

    return YES;
}

  1. In the module, enter "atm. Your appkey", generate a QR code and scan it using a browser

image.png

image.png

image.png

  1. After scanning the code with the browser, a web page will be opened and click "Start Tracking Test (Intranet Valid)"

image.png

  1. After clicking, the tracking verification module will automatically jump to the following page

image.png

  1. Web

  1. Fill in the web page link to be verified into the input box and click "Generate Verification Address"

image.png

  1. Scan code /click link as required

image.png

  1. After clicking the link on the pc side, the browser will open a new tab to display the content of the URL link you entered. You can "track the trigger point" here and return to "track verification" to view real-time logs. image.png

  1. Mini Program image.png

Enter "miniappDebugId" on the page into "Startup Parameters"

Take the WeChat mini program as an example. Example:

1.1. First, please select "add compilation mode" here; 1.2. Add the above code to "startup parameters"; 1.3. Click OK. image.png

1.2.2 Log verification

The corresponding log will be displayed here when the trigger point is on the Web page generated by app, mini or qt. For specific contents and areas, see "2 Tracking Verification Contents"

2 Tracking Verification Contents

2.1 Tracking triggering reporting logs guide

The tracking plan is as follows:

image.png

After the tracking is developed, the following log is triggered when the event type is Click, Expose, or Custom:

{
    User accounts;
    Device ID;
    System properties;
    Global attributes;
    Events:
    {
        Event coding;
        Event properties;
        The timestamp of the client.
        The page where it is located;
        Application usage duration; // Only the application exit event
    }
}

A log that triggers an event of the type "page browsing" is as follows:

{
    User accounts;
    Device ID;
    System properties;
    Global attributes;
    Events:
    {
        Event code="$$_ page_start" or "$$_ page_end"
        Event properties;
        The timestamp of the client.
        Page=Page Encoding
        Page access duration; // Only page exit events
    }
}

Reporting of user properties is reported using a log with an event type of "Custom" event:

{
    User accounts;
    Device ID;
    System properties;
    Global attributes;
    Events:
    {
        Event code =$$_ user_profile
        Event Attributes=User Attributes
        The timestamp of the client.
    }
}

2.2 User account&device ID verification image.png

The user account information and device ID information carried in the log are displayed here.

2.3 User Attribute verification image.png

Reports an event with the event code "$$_ user_profile" whose event attribute is the user attribute

2.5 Global Attribute verification

Under the global attribute column, the global property is carried in each event after it is set, unless the clear API is called.

image.png

image.png

2.5 Page Event verification

image.png

The page encoding is equal to the event encoding and is consistent with the tracking plan, which is the page event. Valid values: 1 to 9.

  1. Page events on the app side are reported when the page exits.

  2. If the page event of the mini program is automatically tracked, it is reported when the page exits. If it is a manual tracking point, it is reported when the page event is called.

  3. The event codes for Web page events are reported when the page event is called.

2.6 Other Events verification

The event code is consistent with the page code and the tracking plan.

2.7 Out-of-box event verification

The event code of the preset event is fixed. For more information, see the preset event list.