快速集成华为 AGConnect 应用内消息服务

PHP小丑

华为 AppGallery Connect 提供了一个应用内消息的服务。应用内消息服务可以在用户使用应用时，基于用户使用情景向用户发送有针对性的消息，鼓励用户使用应用的某些关键功能，也可以借助应用内消息发送更具吸引力的营销内容，增强用户粘性。今天就来教大家如何接入 AppGallery Connect 的应用内消息服务。
1、在 AGC 上开通应用内消息并创建新的消息:
在我的项目下选择你的开发项目，在增长下面，找到应用内消息服务，点击开通：
没有 Android 项目的话，可以先自己创建一个。

开通后我们就可以创建新的消息了。
1.1. 首先点击右上角“添加应用内消息”

1.2. 配置消息名称和消息描述。


1.3. 设置样式和内容，完成后点击“下一步”。在“消息种类”下拉框中选择需要创建的消息类型，然后设置对应的样式和内容。当前支持的消息类型包括：弹框消息、图片消息、Banner消息。


4. 设置发送目标，完成后点击“下一步”。

• 在“应用”栏选择需要发布应用内消息的应用包名。
  
• 点击“新增条件”可以灵活设置消息发送的用户，例如应用版本、OS版本、语言、国家地区、受众群组等。其中，“用户属性”条件需要在“华为分析 -> 管理 -> 用户属性管理”中提前定义，“预测”条件需要在“我的项目->增长->预测”创建预测任务。
  

5. 设置发送时间。

这里可以设置触发事件，除了默认的几个触发事件外还可以通过华为高级分析进行自定义，具体指导可以参考官方文档：
https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-appmessage-create-android-0000001072054882

最后设置转化事件，这一步是可选的。在设置转化事件前，需要将对应事件的转化事件开关打开。操作步骤如下：
在左侧导航栏中选择“华为分析 > 管理 > 事件管理”，将需要转换的事件对应的“标记为转化事件” 和“事件开关”打开。除SDK自动采集的事件外，还可以通过新建“预置事件”或“自定义事件”进行埋点分析
6. 最后点击保存或发布按钮就可以完成消息设置了

2、在 Android 项目里集成 SDK
a) 集成 SDK
1、在项目级的 gradle 文件中添加华为 Maven，即配置下面标红的内容

buildscript {
  repositories {
    google()
    jcenter()
    maven {url 'https://developer.huawei.com/repo/'}
  }
  dependencies {
    classpath 'com.android.tools.build:gradle:4.0.1'
    classpath 'com.huawei.agconnect:agcp:1.5.2.300'
  }
}
allprojects {
  repositories {
    google()
    jcenter()
    maven {url 'https://developer.huawei.com/repo/'}
  }
}
task clean(type: Delete) {
  delete rootProject.buildDir
}

2、打开应用级的 build.gradle 文件，配置好云存储的 SDK 和华为认证服务的 SDK，配置下面标红的内容即可。  注意别落了上面的 agcp 插件

apply plugin: 'com.android.application'
apply plugin: 'com.huawei.agconnect'
android {…..}
dependencies {
  implementation fileTree(include: ['*.jar'], dir: 'libs')
  implementation 'androidx.appcompat:appcompat:1.1.0'
  implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
  testImplementation 'junit:junit:4.12'
  androidTestImplementation 'androidx.test.ext:junit:1.1.1'
  androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
  implementation 'com.huawei.agconnect:agconnect-appmessaging:1.5.2.300'
}

b) 下载 json 文件，并且配置默认存储实例
1、在 AGC 界面上，选择 我的项目 -> 项目设置–> 常规 下面，下载 agconnect-services.json 文件到你的 Android 项目的 app 路径下。

3、功能开发：
如果开发者对消息的样式等信息没有要求，那应用内消息完全可以0代码集成。但是应用内消息 SDK 还提供了自定义消息布局等功能供开发者使用。
1、设置自定义布局
想要设置自定义布局，首先我们需要有一个自定义的布局。我们需要先实现一个布局类继承 SDK 中的 AGConnectAppMessagingDisplay，并复写其中的 displayMessage 方法

public class CustomDisplayView implements AGConnectAppMessagingDisplay {
  @Override
   public void displayMessage (
     @NonNull AppMessage appMessage,
     @NonNull AGConnectAppMessagingCallback callback) {
   }
}

在 displayMessage 中我们可以定义一个 AlertDialog 然后将布局文件应用进去即可。这是我写的逻辑：

@Override
public void displayMessage(@NonNull AppMessage appMessage, @NonNull AGConnectAppMessagingCallback callback) {
  Log.d(TAG, appMessage.getId() + "");
  showDialog(appMessage, callback);
}
private void showDialog(@NonNull final AppMessage appMessage, @NonNull final AGConnectAppMessagingCallback callback) {
  View view = LayoutInflater.from(activity).inflate(R.layout.custom_view, null, false);
  final AlertDialog dialog = new AlertDialog.Builder(activity).setView(view).create();
  Button click = view.findViewById(R.id.click);
  Button dismiss = view.findViewById(R.id.dismiss);
  TextView id = view.findViewById(R.id.id);
  id.setText("MessageID: " + appMessage.getId());
  click.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
      // set button callback
      callback.onMessageClick(appMessage);
      callback.onMessageDismiss(appMessage, AGConnectAppMessagingCallback.DismissType.CLICK);
      dialog.dismiss();
    }
  });
  dismiss.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
      //set button callback
      callback.onMessageDismiss(appMessage, AGConnectAppMessagingCallback.DismissType.CLICK);
      dialog.dismiss();
    }
  });
  dialog.show();
  dialog.getWindow().setLayout((getScreenWidth(activity) / 4 * 3), LinearLayout.LayoutParams.WRAP_CONTENT);
  callback.onMessageDisplay(appMessage);
}

布局设置好后，我们就可以调用 addCustomView 方法来应用我们的布局了

CustomView customView = new CustomView(MainActivity.this);
appMessaging.addCustomView(customView);

2、调试消息
在消息没有正式发布之前，我们可以对消息进行调试。调试有几个步骤
a) 获取调试设备的 AAID。AAID 是应用匿名标识符，标识运行在移动智能终端设备上的应用实例，只有该应用实例才能访问该标识符，它只存在于应用的安装期。与无法重置的设备级硬件 ID 相比，AAID 具有更好的隐私权属性。我们可以通过代码来获取这个 AAID

HmsInstanceId inst  = HmsInstanceId.getInstance(this);
Task<AAIDResult> idResult =  inst.getAAID();
idResult.addOnSuccessListener(new OnSuccessListener<AAIDResult>() {
  @Override
  public void onSuccess(AAIDResult aaidResult) {
    String aaid = aaidResult.getId();
    textView.setText(aaid);
    Log.d(TAG, "getAAID success:" + aaid );
  }
}).addOnFailureListener(new OnFailureListener() {
  @Override
  public void onFailure(Exception e) {
    Log.d(TAG, "getAAID failure:" + e);
  }
});

b) 通过以上的方法我们就可以获取到这个 AAID 了，我们可以将这个参数保存下来，后续会使用到。
c) 来到应用内消息管理台，找到刚刚我们创建的消息在操作一栏我们点击三个点的图标，找到调测

d) 点击“新增测试用户”然后将我们刚刚获取的AAID输入进去即可。

e) 最后点击保存测试即可。完成后我们就可以使用相应的手机进行消息调测了，消息将在应用打开后展示。
应用内消息服务开发指南：
https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-appmessage-getstarted-android-0000001072532718