華為AGC-遠端配置類AB測試實戰指導

華為AppGallery Connect服務，提供有AB測試功能，可以已經正常使用的Push通知或者遠端配置，建立對照試驗測試，用于檢查對比不同方案的差別，可以幫助産品或者營運的同僚，更加資料充足的選擇最佳方案。

下面是在華為AGC平台，從零開始使用遠端配置類AB測試的實戰指導教程。如有不對的地方，還請多多指導。

一、前置要求：內建遠端配置

首先，使用遠端配置的AB測試，前置要求是在應用中已經正确內建遠端配置的SDK，并且在應用内已經預留好進行遠端配置的參數。

下面是最簡單的從零開始內建遠端配置SDK并且預留參數的相關步驟

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配置檔案

在應用級build.gradle添加如下agcp插件

apply plugin: 'com.huawei.agconnect'      

3、在AGC控制台的 我的項目 – 項目設定 下，下載下傳agconnect-services.json檔案，将其下載下傳到項目的app路徑下

4、在應用級build.gradle添加SDK依賴

dependencies {
implementation 'com.huawei.agconnect:agconnect-remoteconfig:1.5.2.300'
implementation 'com.huawei.hms:hianalytics:5.3.1.300'
}      

5、代碼預留遠端配置參數

如下為簡單的Android代碼，我隻是在一個完全建立的Android工程中，添加了一個擷取遠端配置的按鈕。

在該按鈕中設定對應的參數預設值，并且通過fetch擷取雲側的遠端配置參數

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_main);

  HiAnalyticsTools.enableLog();
  HiAnalyticsInstance instance = HiAnalytics.getInstance(this);
  getAAID();
  findViewById(R.id.button).setOnClickListener(view -> {
    getRemoteCongfig();
  });

}
public void getRemoteCongfig() {
  // 擷取遠端配置執行個體
  config = AGConnectConfig.getInstance();
  Map<String, Object> defaultValue = new HashMap<>();
  // 添加鍵值對
  defaultValue.put("welcome_string", "this is a default welcome_slogan");
  config.applyDefault(defaultValue);

  config.fetch(10).addOnSuccessListener(configValues -> {
    config.apply(configValues);
    String newSlogan = config.getValueAsString("welcome_string");
    Log.i(TAG, "RemoteConfig Success: " + newSlogan);
  }).addOnFailureListener(e1 ->
      Log.e(TAG, "getRemoteConfig failed: " + e1.getMessage())
  );
}      

二、前置要求：內建華為分析

生成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);      

三、在AGC界面建立遠端配置

在AGC界面，選擇我的項目，在項目上選擇 遠端配置 – 選擇 添加配置項目；

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

需要注意的是，配置項名稱必須和代碼中預留的參數名稱保持一緻。插件儲存好以後，傳回上一個層級，點選 釋出，釋出該配置項。

四、建立遠端配置類AB測試。

在AGC界面，選擇我的項目，在項目上選擇AB測試 – 選擇 建立遠端配置實驗；

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

按要求随便建立一個測試，注意此時最好目标使用者的比例調高一些，激活事件建議不選。

此處我為了友善檢視測試效果，過濾語言條件選擇語言，并且全選了所有語言，大家自己測試的時候可以按需選擇哈。

配置原始組和實驗組的時候，可以下拉選擇對應的配置項。​

最後一步的選擇跟蹤名額，我這裡就選擇一個最簡單的 點選率。 四個步驟都配置完成以後，即可點選儲存

五、運作實驗，在App中執行fetch擷取

1、在操作欄，選擇 啟動，啟動實驗 。

2、運作App，并且點選按鈕擷取雲端配置。

相應的日志如下：

需要注意的是：

• 建立好的AB測試，可以通過最右側的操作，選擇 調測 來進行實驗效果的調測。調測所使用的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測試資料報告，界面參考如下：

參考文檔連結：

• 華為AGC AB測試操作文檔

• 華為遠端配置 SDK開發指南：

• 華為分析服務SDK 開發指南：