华为AGC-推送通知类AB测试实战指导

华为AppGallery Connect服务，提供有AB测试功能，可以已经正常使用的Push通知或者远程配置，创建对照试验测试，用于对比不同方案的区别，可以帮助产品或者运营的同事，通过科学数据选择最佳方案。

下面是在华为AGC平台，从零开始使用推送通知类AB测试的实战指导教程。如有不对的地方，还请多多指导。

一、集成Push

首先，使用推送通知类AB测试之前，需要完成华为Push服务的集成，该步骤属于前置条件，属于必须集成的步骤。 部分同学的应用可能使用的是三方平台提供的合一的Push服务，例如个推友盟极光等三方平台，只要正确完成集成即可，对于该场景下的可以无需执行如下步骤。

下面介绍最简单的，在Android平台第一方集成华为Push的步骤，大家也可以直接参考华为Push的官方文档进行集成。

https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-app-quickstart-0000001071490422

1、在项目级的build.gradle中添加Maven仓库地址：

buildscript {
    repositories {
        maven { url 'https://developer.huawei.com/repo/'}
    }
    dependencies {
        classpath 'com.huawei.agconnect:agcp:1.5.2.300'
    }
}
allprojects {
    repositories {
        maven { url 'https://developer.huawei.com/repo/'}
    }
}
 

2、添加AGCP插件与agc配置文件

1、在应用级build.gradle添加如下agcp插件

apply plugin: 'com.huawei.agconnect'

2、在AGC控制台的 我的项目 –> 项目设置 下，下载agconnect-services.json文件，将其下载到项目的app路径下

3、在应用级build.gradle添加SDK依赖

dependencies {
implementation 'com.huawei.hms:push:5.3.0.301'
implementation 'com.huawei.hms:hianalytics:5.3.1.300'
}

4、在代码中申请Push Token

如下为简单的Android代码，我只是在一个完全新建的Android工程中，添加了一个申请Token按钮。

@Override
protected void onCreate(Bundle savedInstanceState) {
	super.onCreate(savedInstanceState);
	setContentView(R.layout.activity_main);
 
	findViewById(R.id.button).setOnClickListener(view -> {
		getToken();
	});
 
}
 
private void getToken() {
	// 创建一个新线程
	new Thread() {
		@Override
		public void run() {
			try {
				// 从agconnect-service.json文件中读取appId
				String appId = "your_APPId";
				// 输入token标识"HCM"
				String tokenScope = "HCM";
				String token = HmsInstanceId.getInstance(MainActivity.this).getToken(appId, tokenScope);
				Log.i(TAG, "get token: " + token);
				// 判断token是否为空
				if(!TextUtils.isEmpty(token)) {
					sendRegTokenToServer(token);
				}
			} catch (ApiException e) {
				Log.e(TAG, "get token failed, " + e);
			}
		}
	}.start();
}
private void sendRegTokenToServer(String token) {
	Log.i(TAG, "sending token to server. token:" + token);
}

5、配置签名文件

需要在应用的build.gradle文件中配置相应的签名文件，如果没有签名文件，可以手动生成一个，步骤如下：

点击Build –> 选择Generate Signed Bundle or APK –> 选择APK –> 下一步选择Create New，添加签名文件。

生成签名文件以后，对应的应用级build.gradle文件的配置的相关配置如下：

android {
     signingConfigs {
         config {
             // xxx替换为您自己的签名文件
             keyAlias 'xxx'
             keyPassword 'xxxx'
             storeFile file('xxx.jks')
             storePassword 'xxxx'
         }
     }
 
     buildTypes {
         debug {
             signingConfig signingConfigs.config
         }
         release {
             signingConfig signingConfigs.config
             minifyEnabled false
             proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
         }
     }
 }

6、生成并且配置SHA256签名

6.1 执行keytool命令

keytool -list -v -keystore <keystore-file>，其中 <keystore-file>为应用签名证书的完整路径，命令示例如下

6.2 将SHA256配置到AGC界面

二、集成华为分析

生成AB测试的报告，需要使用华为分析服务，因此需要在代码中集成华为分析SDK，由于AB测试事件属于华为分析的自动采集事件，因此华为分析的集成步骤非常简单：

1、在应用级build.gradle添加SDK依赖

dependencies {
implementation 'com.huawei.hms:hianalytics:5.3.1.300'
}

2、在OnCreate中初始化华为分析

HiAnalyticsTools.enableLog();
HiAnalyticsInstance instance = HiAnalytics.getInstance(this);

三、运行App，获取Push Token

App运行与获取Push Token的相关日志如下

四、创建Push作为测试。

在AGC界面，选择我的项目，在项目上选择推送服务 – 选择 添加推送通知；

https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/

按要求随便查看一个Push测试，并且定向推动到指定设备，此时填入上一个步骤申请的Token。 点击提交以后，可以看到相应的测试效果。

五、创建AB测试。

在AGC界面，选择我的项目 –> 选择 AB测试 – 右上角选择创建通知实验。

https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/

需要注意的是：

• 当前实验目标用户只能选择 受众群组， 但是受众群组是来自于华为分析，并且该数据是每日计算，隔天生成。

也就是说，今天选择的受众群组，只能覆盖到昨天的用户。所以要注意隔天进行测试。

• 创建好的AB测试，可以通过最右侧的操作，选择 调测 来进行Push效果的调测。调测所使用的aaid的获取如下

  public void getAAID() {
  	Task<AAIDResult> idResult = HmsInstanceId.getInstance(this).getAAID();
  	idResult.addOnSuccessListener(new OnSuccessListener<AAIDResult>() {
  		@Override
  		public void onSuccess(AAIDResult aaidResult) {
  			// 获取AAID方法成功
  			String aaid = aaidResult.getId();
  			Log.d(TAG, "getAAID successfully, aaid is " + aaid );
  		}
  	}).addOnFailureListener(new OnFailureListener() {
  		@Override
  		public void onFailure(Exception myException) {
  			// 获取AAID失败
  			Log.d(TAG, "getAAID failed, catch exceptio : " + myException);
  		}
  	});
  }
  

六、查看实验报告：

对于已运行的实验，可以在右侧操作栏点击 报告 查看相应的AB测试数据报告，界面参考如下：

七、参考文档：

1、华为AGC AB测试操作文档

https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-abtest-introduction-0000001058210679

2、华为Push SDK开发指南：

https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides-V5/android-app-quickstart-0000001071490422-V5

3、华为分析服务SDK 开发指南：

https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-dev-process-0000001050163813