[Huawei Developers] HMS Community:
Introduction​

If you are new to series of this article, follow the below article.

In this article, we will learn how to integrate Analytics kit and Crash Service in Smart Glove application.

Adding Events with Huawei Analytics Kit

This guide walks you through the process of building application that uses Huawei Analytics Kit to trigger event and can find data on the console.

What You Will Build

You will build an application that triggers events, setting user properties, logging custom event etc.

Prerequisite​

About 10 minutes

A favorite text editor or IDE(For me Android Studio)

JDK 1.8 or later

Gradle 4+

SDK platform 19

Analytics Kit

What is Mobile analytics?

Mobile analytics captures data from mobile app, website, and web app visitors to identify unique users, track their journeys, record their behaviour, and report on the app’s performance. Similar to traditional web analytics, mobile analytics are used to improve conversions, and are the key to crafting world-class mobile experiences.

How to complete this guide

When a person says that I know theoretical concept, only when he/she knows the answer for all WH questions. To complete this guide, let’s understand all WH questions.

1. Who has to use analytics?

2. Which one to use?

3. What is Huawei Analytics kit?

4. When to use HMS Analytics kit?

5. Why to use analytics kit?

6. Where to use analytics Kit?

Once you get answer for all the above questions, then you will get theoretical knowledge. But to understand with result you should know answer for below question.

1. How to integrate Huawei analytics kit?

Who has to use the analytics kit?

The answer is very simple, the analytics kit will be used in the mobile/web application. So off course software developer has to use analytics kit.

Which one to use?

Since there are many analytics vendors in the market. But for mobile application I recommend Huawei analytics kit. Now definitely you will have question why? To answer this I’ll give some reasons.

Very easy to integrate.

Documentation is too good.

Community is too good. Response from community is so fast.

Moreover, it is very similar to other vendors, so no need to learn new things.

You can see events in real time.

What is Huawei Analytics kit?

Flutter Analytics plugin enables the communication between HMS Core analytics SDK and Flutter platform. This plugin exposed all the functionality which is provided by HMS core analytics SDK.

Huawei Analytics kit offers you a range of analytics models that helps you to analyse the users’ behaviour with predefined and custom events, you can gain a deeper insight into your users, products and content. It helps you to gain insight into that how users behave on different platforms based on the user behaviour events and user attributes reported through apps.

Huawei Analytics kit, our one-stop analytics platform provides developers with intelligent, convenient and powerful analytics capabilities, using this we can optimize apps performance and identify marketing channels.

Collect and report custom events.

Set a maximum of 25 user attributes.

Automate event collection and session calculation.

Preset event IDs and parameters.

When to use HMS Analytics kit?

Mobile app analytics are a developer’s best friend. It helps you gain understanding about that how users’ behaviour and app can be optimized to reach your goals. Without mobile app analytics, you would be trying out different things blindly without any data to back up your experiments.

That’s why it’s extremely important for developers to understand their mobile app analytics to track their progress while working towards achieving their goals.

Why to use analytics kit?

Mobile app analytics are essential to development process for many reasons. They give you insights into that how users are using your app, which parts of the app they interact with, and what actions they take within the app. You can use these insights to come up with an action plan to improve your product in future, like adding new features that the users seem to need, or improve existing ones in a way that would make the users lives easier, or removing features that the users don’t seem to use.

You’ll also gain insights into whether you’re achieving your goals for your mobile app, whether its revenue, awareness, or other KPIs, and then take the data you have to adjust your strategy and optimize your app to reach your further goals.

When it comes to why? Always everyone thinks about benefits.

Benefits of Analytics

App analytics helps you to drive ROI over every aspect of performance.

App analytics helps you to gather accurate data to better serve for customers.

App analytics allows you to drive personalized and customer-focused marketing.

App analytics allows you to track individual and group achievements of marketing goals from campaigns.

App analytics offers data-driven insights into issues concerning churn and retention.

Where to use analytics Kit?

This is very important question, because you already know that why to use the analytics kit. So, wherever you want understand about user behaviour, which part of the application users are using regularly, which functionality of the application users are using more. In the scenario you can use analytics kit in either mobile/web application you can use the analytics kit.

Crash Service

What is Huawei Crash service?

In this article, we will learn how to integrate Crash services of AppGallery in Pygmy collection finance application.

Huawei Crash is a realtime crash reporting tool that helps in tracking, prioritizing, and fix stability issues that compromise the quality of your app. Crashlytics also helps in troubleshooting and saves the debugging.

The AppGallery Connect Crash service provides a powerful lightweight solution to app crash problems. With the service, you can quickly detect, locate and resolve app crashes (unexpected exits of apps), and have access to highly readable crash reports in real time, without the need to write any code.

To ensure stable running of your app and prevent user experience deterioration caused by crashes, you are advised to monitor the running status of your app on each device, which is the key. The Crash service provides real-time reports, revealing any crash of your app on any device. In addition, the Crash service can intelligently aggregate crashes, providing context data when a crash occurs, such as environment information and stack, for you to prioritize the crash easily for rapid resolution.

Why do we need the crash service?

Although apps have gone through rounds the tests before release considering the large user base diverse device models and complex network environment. It’s inevitable for apps to crash occasionally. Crashes compromise user experience, users may even uninstall app due to crashes and your app is not going to get good reviews.

You can’t get sufficient crash information from reviews to locate crashes, therefore you can’t resolve them shortly. This will severely harm your business. That’s why we need to use the crash services in our apps to be more efficient.

Now start with practical

Till now you understood theoretical concept of the analytics kit. Now let’s start with the practical example, to understand about practical we should get answer for the below question.

How to integrate Huawei analytics kit in Android finance application?

To achieve this you need to follow the steps.

1. Configure application on the AGC.

2. Client application development process.

Configure application on the AGC

Follow the steps.

Step 1: We need to register as a developer account in AppGallery Connect. If you are already developer ignore this step.

Step 2: Create an app by referring to Creating a Project and Creating an App in the Project

Step 3: Set the data storage location based on current location.

Step 4: Enabling Analytics Kit. Project setting > Manage API > Enable analytics kit toggle button.

Step 5: Generating a Signing Certificate Fingerprint.

Step 6: Configuring the Signing Certificate Fingerprint.

Step 7: Download your agconnect-services.json file, paste it into the app root directory.

Step 8: Choose Quality > Crash > Enable the crash service.

Client application development process

Follow the steps.

Step 1: Create Android application in the Android studio (Any IDE which is your favorite)

Step 2: Add the App level gradle dependencies. Choose inside project Android > app > build.gradle.

How to integrate Analytics Kit and Crash Service

1. Configure the application on the AGC.

2. Client application development process.

3. Testing a Splash Ad.

Client application development process

Follow the steps.

Step 1: Create an Android application in the Android studio (Any IDE which is your favorite).

Step 2: Add the App level Gradle dependencies. Choose inside project Android > app > build.gradle.

apply plugin: 'com.android.application'
apply plugin: 'com.huawei.agconnect'
dependencies {
implementation 'com.huawei.hms:hianalytics:5.1.0.300'
implementation "com.huawei.agconnect:agconnect-crash:1.6.0.300"
}

Root level gradle dependencies.

maven { url 'https://developer.huawei.com/repo/' }
classpath 'com.huawei.agconnect:agcp:1.4.1.300'

Step 3: To allow HTTP and HTTPS network requests on devices with targetSdkVersion 28 or later, configure the following information in the AndroidManifest.xml file:

<application
...
android:usesCleartextTraffic="true">
...
</application>

Analytics kit

HuaweiLog.kt

package com.huawei.navigationglove.analytics

import com.huawei.navigationglove.analytics.HuaweiLog
import android.os.Bundle
import android.util.Log
import java.lang.Exception
import java.util.ArrayList
import java.util.HashMap

class HuaweiLog {
var eventName: String? = null
private val data: HashMap<String, String>? = HashMap()
fun setEventName(eventName: String?): HuaweiLog {
this.eventName = eventName
return this
}

fun setKeyAndValue(key: String, value: String): HuaweiLog {
data!![key] = value
return this
}

fun toBundle(): Bundle {
val bundle = Bundle()
try {
if (data != null && data.size > 0) {
for ((key, value) in data) {
bundle.putString(key, value)
Log.d("Huawei", "$key $value")
}
}
} catch (e: Exception) {
e.printStackTrace()
}
return bundle
} /*
public HuaweiLog setTestDescription(ArrayList list) {
testdata.put(HuaweiEventParams.Key.DESCRIPTION.textValue(), list);
return this;
}*/
}

HuaweiAnalyticsClient.kt

package com.huawei.navigationglove.analytics

import android.content.Context
import android.util.Log
import com.huawei.hms.analytics.HiAnalytics
import com.huawei.hms.analytics.type.ReportPolicy
import com.huawei.hms.analytics.HiAnalyticsInstance
import java.lang.Exception
import java.lang.RuntimeException
import java.util.HashSet

class HuaweiAnalyticsClient private constructor() {

fun initAnalytics(context: Context?) {
mHuaweiAnalyticsClient = HiAnalytics.getInstance(context)
if (mHuaweiAnalyticsClient == null) {
Log.e(TAG, "Analytics Client could not be initialized.")
return
}
mHuaweiAnalyticsClient!!.setAnalyticsEnabled(true)
mHuaweiAnalyticsClient!!.setUserId("UserId")
mHuaweiAnalyticsClient!!.setAutoCollectionEnabled(true)

// Used to report an event upon app switching to the background.
val moveBackgroundPolicy = ReportPolicy.ON_MOVE_BACKGROUND_POLICY
// Used to report an event at the specified interval.
val scheduledTimePolicy = ReportPolicy.ON_SCHEDULED_TIME_POLICY
// Set the event reporting interval to 600 seconds.
scheduledTimePolicy.threshold = 600
val reportPolicies: MutableSet<ReportPolicy> = HashSet()
// Add the ON_SCHEDULED_TIME_POLICY and ON_MOVE_BACKGROUND_POLICY policies.
reportPolicies.add(scheduledTimePolicy)
reportPolicies.add(moveBackgroundPolicy)
// Set the ON_MOVE_BACKGROUND_POLICY and ON_SCHEDULED_TIME_POLICY policies.
mHuaweiAnalyticsClient!!.setReportPolicies(reportPolicies)
}

fun logEvent(log: HuaweiLog) {
if (mHuaweiAnalyticsClient == null) {
throw RuntimeException("HuaweiAnalyticsClient is not initialized. Please call initAnalytics().")
}
try {
mHuaweiAnalyticsClient!!.onEvent(log.eventName, log.toBundle())
Log.d("Huawei", log.eventName!!)
} catch (e: Exception) {
Log.d(TAG, "Huawei analytics failed" + e.message)
}
}

/* public void putHuaweiUserProperty(HuaweiUserProperty.KeyName propertyKey, String value) {
if (mHuaweiAnalyticsClient == null) {
throw new RuntimeException("HuaweiAnalyticsClient is not initialized. Please call initAnalytics().");
}
try {
mHuaweiAnalyticsClient.setUserProfile(propertyKey.textValue(), value);
} catch (Exception e) {
Log.d(TAG, "Huawei analytics failed", e);
}
}*/
fun setHuaweiUserId(userId: String?) {
if (mHuaweiAnalyticsClient == null) {
throw RuntimeException("HuaweiAnalyticsClient is not initialized. Please call initAnalytics().")
}
if (userId == null) {
mHuaweiAnalyticsClient!!.setUserId(null)
return
}
mHuaweiAnalyticsClient!!.setUserId(userId)
}

companion object {
private val TAG = HuaweiAnalyticsClient::class.java.simpleName
private var ourInstance: HuaweiAnalyticsClient? = null
private var mHuaweiAnalyticsClient: HiAnalyticsInstance? = null
val instance: HuaweiAnalyticsClient?
get() {
if (ourInstance == null) {
ourInstance = HuaweiAnalyticsClient()
}
return ourInstance
}
}
}

AnalyticUtils.kt

package com.huawei.navigationglove.analytics

import android.util.Log
import java.lang.Exception

object AnalyticUtils {
private val TAG = AnalyticUtils::class.java.simpleName
fun logHuaweiAnalyticEvent(huaweiLog: HuaweiLog) {
try {
HuaweiAnalyticsClient.instance!!.logEvent(huaweiLog)
Log.d(TAG, "Huawei analytics $huaweiLog")
} catch (e: Exception) {
Log.d(TAG, "Huawei analytics failed")
}
}
}

Crash Report

//AGConnectCrash.getInstance().testIt(this)
AGConnectCrash.getInstance().enableCrashCollection(true)
AGConnectCrash.getInstance().setUserId("Add user ID");
AGConnectCrash.getInstance().log(Log.DEBUG, "set debug log.");
AGConnectCrash.getInstance().log(Log.INFO, "set info log.");
AGConnectCrash.getInstance().log(Log.WARN, "set warning log.");
AGConnectCrash.getInstance().log(Log.ERROR, "set error log.");
AGConnectCrash.getInstance().setCustomKey("stringKey", "Hello world");
AGConnectCrash.getInstance().setCustomKey("booleanKey", false);
AGConnectCrash.getInstance().setCustomKey("doubleKey", 1.1);
AGConnectCrash.getInstance().setCustomKey("floatKey", 1.1f);
AGConnectCrash.getInstance().setCustomKey("intKey", 0);
AGConnectCrash.getInstance().setCustomKey("longKey", 11L);

Result​

Analytics​

Crash Service​

Tips and Tricks​

Make sure you are already registered as a Huawei developer.

Make sure you have added the agconnect-services.json file to the app folder.

Make sure you have added the SHA-256 fingerprint without fail.

Make sure all the dependencies are added properly.

Make sure you added agconnect-service.json file.

Add internet permission in AndroidManifest.xml

Add the below code to download the HMS core apk

Conclusion​

In this article, we have learnt the integration of the Huawei Analytics kit and Crash service in Smart Glove application using Android Studio and Kotlin. And also we have learned how to download crash report and also we have learnt the tracking the analytics data on the console.

Reference​

Analytics Kit - Official document

Huawei Crash – Official document

Analytics Kit – Training Video

Huawei Crash – Training Video