厂商参数申请指南

本文旨在指导用户获取厂商通道的推送参数，并完成EngageLab控制台上的厂商参数配置。

鸿蒙参数获取

注册华为开发者账号

进入 华为开发者联盟，注册华为开发者账号，详情参考 注册账号。

创建项目

是否新建项目，开发者需根据实际业务情况，酌情选择。如果不需要新建项目，则直接查看后续步骤。

如上图，如果您没有「PUSH」入口，也可以直接选择【上架及推广服务】-【AppGallery Connect】进入华为 AGC 控制台，然后选择【我的项目】-【添加项目】。以您实际情况为准，实际入口可能有多处，此步骤只是告知其中已知入口。

启用推送 API 服务

选择【我的项目】-【开发与服务】-【API 管理】如下入口启用。

你也可以进入 华为开发者联盟-管理中心首页，选择【API 服务】-【API 库】- 选择刚创建的项目 - 根据 API 名字查询“推送” - 选择【推送服务】-【启用】推送服务，效果相同。

获取服务密钥

进入 华为开发者联盟-管理中心首页，选择【凭证】- 创建【服务账号密钥】-【下载保存】服务账号密钥 JSON 文件。

项目下创建鸿蒙应用

如果您在华为官网还未创建项目，请先创建项目，参考 创建项目。

进入 华为开发者联盟-管理中心首页，选择【上架及推广服务】-【AppGallery Connect】进入华为 AGC 控制台 - 选择您的项目 -【项目设置】-【添加应用】，按照官方步骤完成鸿蒙应用新增即可；记得根据官方引导步骤，给刚添加的应用【开通】推送服务。

特别注意，鸿蒙应用创建完成后，您一定要记得配置应用「SHA256 证书/公钥指纹」：点击“SHA256 证书/公钥指纹”后的“添加公钥指纹（HarmonyOS API 9 及以上）”，选择您集成 SDK 时「配置签署」对应的证书文件。

鸿蒙通道回执配置指南

完成鸿蒙厂商通道 SDK 集成后，需要开发者在华为开放平台开通并配置消息回执，方可把鸿蒙的送达统计等数据回调到极光平台，具体操作如下：

1. 登录华为 AppGallery Connect 网站。
2. 点击“我的项目”，在项目列表中找到您的项目，通过增长-推送服务-配置导航到“配置”页签。
3. 在该页面可以选择配置项目级回执或者应用级回执，需要注意的是项目级回执消息接收 URL 地址，对该项目下所有应用生效。如果您同时配置了项目级回执和应用级回执地址，则优先获取应用级回执地址信息。

4. 这里以应用级回执举例，选择需要配置回执的应用，点击“开通”应用回执状态。
   

5. 进入回执参数配置，新建回执。
   

6. 点击“新建回执”后，需要配置如下参数。
   

• 回执名称：填写自定义名称。
• 回调地址：根据您的业务区域选择对应地址。
  • 新加坡：https://pushcb-sgp.engagelab.com/callback/hmos
  • 中国香港：https://pushcb-hk.engagelab.com/callback/hmos
  • 美国弗吉尼亚：https://pushcb-usva.engagelab.com/callback/hmos
  • 德国法兰克福：https://pushcb-defra.engagelab.com/callback/hmos
  • 日本东京：https://pushcb-jpn.engagelab.com/callback/hmos
  • 巴西圣保罗：https://pushcb-bra.engagelab.com/callback/hmos
• 支持版本：请一定选择华为 V2 版本。

7. 点击“测试回执”可以对回执地址进行功能测试，点击“提交”完成回执的创建。