Before developing your app, you can follow instructions in the codelab to experience how to quickly integrate this kit into an app.
Development Environment
- JDK version: 1.7 or later
- Android Studio version: 3.6.1 or later
- minSdkVersion: 19 or later
- targetSdkVersion: 33 (recommended)
- compileSdkVersion: 33 (recommended)
- Gradle version: 5.4.1 or later (recommended)
If you need to use multiple HMS Core kits, use the latest versions required for these kits.
Test device: a Huawei phone running EMUI 3.0 or later, or a non-Huawei phone running Android 4.4 or later
Background
You can integrate Analytics Kit and DTM into your app to implement tag tracking and event reporting. You need to integrate Analytics Kit before integrating DTM.
Events reported by the DTM SDK fall into the following scopes:
- Events automatically collected by the Analytics SDK
- Events tracked using the onEvent method of the Analytics SDK
- Visual events added on the DTM portal
By default, these events are reported to HUAWEI Analytics. You can configure a tag using the HUAWEI Analytics extension template on the DTM portal to add parameters to or change parameter values in reported events, as well as block some events.
- For details about how to obtain automatically collected events, event parameters, and user attributes of Analytics Kit, please refer to How can I obtain the automatically collected events, event parameters, and user attributes of Analytics Kit?.
- For details about how to modify event parameters and prevent some events from being reported to Analytics Kit, please refer to How can I modify event parameters and block some events so that they will not be reported to Analytics Kit?.
- You can modify parameters for code dotting events (including both preset and custom events) of Analytics Kit and visual events added on the DTM portal, as well as block these events so they will not be reported. However, automatically collected events of Analytics Kit cannot be modified or blocked.
[h2]Visual Event Tracking
Step | Operation | Description |
|---|---|---|
1 | Configure app information in AppGallery Connect, including creating an app, generating a signing certificate fingerprint, configuring the signing certificate fingerprint, and enabling required services. | |
2 | Integrate the SDK into your app. | |
3 | Before building the APK, configure the obfuscation configuration file to prevent the SDK from being obfuscated. | |
4 | Synchronize your app screen to the DTM portal, and click relevant elements on the portal to add visual events for them. | |
5 | Manage your configuration versions. Versions are used to record different phases of a configuration. You can create a version for a configuration anytime to save the latest configuration. | |
6 | Manage your configuration. A configuration is a policy file containing visual events, tags, conditions, and variables. It can be downloaded and executed by an app or website. | |
7 | (Optional) Review version release applications. If a user with limited permission wants to release a version, the version release must be reviewed by another user with the review permission. The version can be released only after the release application is approved. | |
8 | Implement event reporting based on your service needs. | |
9 | Use the tool offered by Huawei to automatically check your app before release. | |
10 | Complete your app information in AppGallery Connect, and submit your app for release. |
[h2]Tag-based Event Tracking
Step | Operation | Description |
|---|---|---|
1 | Configure app information in AppGallery Connect, including creating an app, generating a signing certificate fingerprint, configuring the signing certificate fingerprint, and enabling required services. | |
2 | Integrate the SDK into your app. | |
3 | Before building the APK, configure the obfuscation configuration file to prevent the SDK from being obfuscated. | |
4 | Manage your tags, including setting parameters and trigger conditions for tags. A tag is used in your app to track events. | |
5 | Manage your conditions. A condition is the prerequisite for triggering a tag and determines when the tag is executed. A tag must contain at least one trigger condition. | |
6 | Manage your variables before creating tags or conditions. A variable is a placeholder used in a condition or tag. | |
7 | (Optional) Sort the created variables, conditions, and tags and add them to different groups based on their logical relationships. | |
8 | Manage your configuration versions. Versions are used to record different phases of a configuration. You can create a version for a configuration anytime to save the latest configuration. | |
9 | Manage your configuration. A configuration is a policy file containing visual events, tags, conditions, and variables. It can be downloaded and executed by an app or website. | |
10 | (Optional) Review version release applications. If a user with limited permission wants to release a version, the version release must be reviewed by another user with the review permission. The version can be released only after the release application is approved. | |
11 | Implement event reporting based on your service needs. | |
12 | Use the tool offered by Huawei to automatically check your app before release. | |
13 | Complete your app information in AppGallery Connect, and submit your app for release. |
[h2]Tag-based Event Tracking + Visual Event Tracking
Step | Operation | Description |
|---|---|---|
1 | Configure app information in AppGallery Connect, including creating an app, generating a signing certificate fingerprint, configuring the signing certificate fingerprint, and enabling required services. | |
2 | Integrate the SDK into your app. | |
3 | Before building the APK, configure the obfuscation configuration file to prevent the SDK from being obfuscated. | |
4 | Synchronize your app screen to the DTM portal, and click relevant elements on the portal to add visual events for them. | |
5 | Manage your tags, including setting parameters and trigger conditions for tags. A tag is used in your app to track events. | |
6 | Manage your conditions. A condition is the prerequisite for triggering a tag and determines when the tag is executed. A tag must contain at least one trigger condition. | |
7 | Manage your variables before creating tags or conditions. A variable is a placeholder used in a condition or tag. | |
8 | (Optional) Sort the created variables, conditions, and tags and add them to different groups based on their logical relationships. | |
9 | Manage your configuration versions. Versions are used to record different phases of a configuration. You can create a version for a configuration anytime to save the latest configuration. | |
10 | Manage your configuration. A configuration is a policy file containing visual events, tags, conditions, and variables. It can be downloaded and executed by an app or website. | |
11 | (Optional) Review version release applications. If a user with limited permission wants to release a version, the version release must be reviewed by another user with the review permission. The version can be released only after the release application is approved. | |
12 | Implement event reporting based on your service needs. | |
13 | Use the tool offered by Huawei to automatically check your app before release. | |
14 | Complete your app information in AppGallery Connect, and submit your app for release. |
HMS Toolkit provides end-to-end tools (including those for app creation, free real-device debugging, and releasing) that you need to develop your own HMS Core-integrated app and release it, with lower costs and higher efficiency.