QQ Mini Program SDK Predefined Events and Predefined Properties
|
Collect
1. Predefined Events
Event English Variable Name | Event Display Name | Property English Variable Name | Event Property Display Name | Property Value Type | Property Value Example or Description | Trigger Timing | Remarks |
---|---|---|---|---|---|---|---|
$MPLaunch | Mini Program Launch | $Preset Properties | When the mini program is killed and reopened, and sa.quick('appLaunch', options) is called in the corresponding mini program lifecycle function, it will be triggered | General collection of Mini Program SDK, automatically collected when the autoTrack interface is opened Refer to the Mini Program SDK: https://manual.sensorsdata.cn/sa/latest/tech_sdk_client_mp_qq-7537366.html | |||
$scene | Startup Scene | String | |||||
$url_path | Page Path | String | |||||
$is_first_time | Whether First Time | BOOL | |||||
$utm_source | String | Advertising Campaign Source | |||||
$utm_medium | String | Advertising Campaign Medium | |||||
$utm_term | String | Ad Campaign Keywords | |||||
$utm_content | String | Ad Campaign Content | |||||
$utm_campaign | String | Ad Campaign Name | |||||
$MPShow | Mini Program Show | $Preset Properties | The Mini Program is launched, or it is displayed from the background to the foreground and calls sa.quick('appShow', options) in the corresponding mini program lifecycle function | ||||
$scene | Launch Scene | String | |||||
$url_path | Page Path | String | |||||
$utm_source | String | Advertising Campaign Source | |||||
$utm_medium | String | Advertising Campaign Medium | |||||
$utm_term | String | Advertising Campaign Term | |||||
$utm_content | String | Advertising Campaign Content | |||||
$utm_campaign | String | Campaign Name | |||||
$MPHide | Miniprogram Goes to Background | $Preset Properties | When clicking the exit button in the upper right corner of the miniprogram, entering the background on QQ, entering the about page of the miniprogram, locking the phone screen, and the miniprogram process being killed and the sa.quick('Hide') is called in the corresponding miniprogram lifecycle function | ||||
$url_path | Page Path | String | |||||
$event_duration | Event Duration | Numeric | The time from $MPShow to $MPHide, when the miniprogram goes to background or is closed | ||||
$MPViewScreen | Mini Program Page View | $Preset Properties | Triggered when a Mini Program page is opened, opened within the Mini Program, or opened from the background to the foreground | Called every time a page is opened | Requires v0.5.0 and later versions | ||
$url_path | Page Path | String | |||||
$MPClick | Mini Program Element Click | $Preset Properties | Triggered when an element in a Mini Program page is clicked | Only collected when a clicked element has a bindtap/bindlongtap/bindlongpress listener attached | |||
$element_id | Element ID | String | |||||
$element_name | Element Name | String | |||||
$element_content | Element Content | String | |||||
$element_type | Element Type | String | |||||
$url_path | Page Path | String |
2. Predefined properties for all events
Field Name | Type | Description | Remark |
---|---|---|---|
$lib | String | SDK Type | The value of QQ Mini in the QQ Mini Program SDK |
$lib_version | String | SDK Version | |
$app_id | String | App ID of QQ Mini Program | Supported in version 0.6.0 and above |
$screen_height | Number | Screen height | |
$screen_width | Number | Screen Width | |
$model | String | Device Model | |
$manufacturer | String | Device Manufacturer | |
$os | String | Operating System | |
$os_version | String | Operating System Version | |
$is_first_day | Boolean | Whether it is the first day of visit (the value is true from the first visit of a new user to midnight between the first day and the next day, and false afterwards, indicating its existence in storage) | |
$is_login_id | Boolean | Is it a login ID (determined and added when data is stored) | |
$ip | String | Attributes carried when the SDK sends data requests | |
$timezone_offset | Number | Timezone offset | Supported in version 0.6.0 and above |
$country | String | Resolved from IP | |
$province | String | Resolved from IP | |
$city | String | Obtained from IP resolution | |
$network_type | String | Network type | |
$browser | String | Browser name, obtained from UA | |
$browser_version | String | Browser version, obtained from UA | |
$latest_utm_source | String | The most recent paid advertising campaign source, with the value from the most recent advertising campaign source. | |
$latest_utm_medium | String | The last paid campaign medium is the most recent paid campaign medium. | |
$latest_utm_term | String | The value of the most recent paid campaign term is the value of the most recent valuable campaign term. | |
$latest_utm_content | String | The last paid campaign content is the value of the last valuable campaign content. | |
$latest_utm_campaign | String | Name of the most recent paid campaign. The value is the name of the most recent paid campaign | |
$latest_scene | String | Last launched scene value in recent time. |
3. Preset user attribute
Property Name | Property Type | Default Display Name | Description | Remark |
---|---|---|---|---|
$first_visit_time | Time | First Visit Time | Assigned to this property when new users first visit the mini program. | Because these properties are set when new users first visit the mini program, they are generally used to track user behavior with anonymous ID. If the association between login ID and anonymous ID fails, the login ID will not have these property values. |
$utm_source | String | First Ad Campaign Source | These user properties are collected only when new users first visit the mini program using the mini program channel tracking, and when they access through a channel with utm parameters. If the users are existing users, even if they access the mini program through a channel, these user properties will not be set. For the identification of new and existing users, please refer to this document: New User and First-day First-time Marking | |
$utm_medium | String | First Ad Campaign Medium | ||
$utm_term | String | First Ad Campaign Term | ||
$utm_content | String | First ad campaign content | ||
$utm_campaign | String | First ad campaign name |
Note: The content of this document is a technical document that provides details on how to use the Sensors product and does not include sales terms; the specific content of enterprise procurement products and technical services shall be subject to the commercial procurement contract.