AI 助理
备案控制台
文档
输入文档关键字查找
首页 移动研发平台 移动推送 实践教程 厂商通道消息回执最佳实践

厂商通道消息回执最佳实践

更新时间：
产品详情
我的收藏

在接入厂商通道后，部分厂商的应用需要进行额外的回执配置。若不进行配置，将无法确认推送的送达状态，并且在推送失败时，也无法明确失败的具体原因。因此，我们强烈建议您为这些厂商的应用配置回执。

配置回执后，您可以：

  1. 确认推送消息的送达状态，提高推送的成功率。

  2. 在EMAS控制台的排查工具和回执日志中查看推送失败的详细原因。

  3. 根据失败原因优化推送策略，从而减少推送成本。

本文将为您提供各厂商通道应用回执配置的最佳实践，帮助您更有效地管理推送服务。

各厂商回执信息说明

厂商通道

是否支持到达回执

是否支持点击回执

是否需要额外配置

说明

小米

✅

✅

❌

/

华为

✅

❌

✅

配置见详情。

荣耀

✅

✅

✅

配置见详情。

vivo

老回执

✅

❌

❌

  • 官方已于2023年1月10日上线新回执功能，建议您参考下文详情开通配置新回执功能。

  • 官方老回执功能目前虽依旧可用，但未来可能下线。

  • 新老回执不可同时使用，使用新回执后，老回执将失效。

新回执

✅

❌

✅

OPPO

✅

❌

❌

/

魅族

✅

✅

✅

配置见详情。

谷歌 FCM

❌

❌

❌

/

鸿蒙

✅

✅

✅

配置见详情。

苹果 APNs

❌

❌

❌

  • 苹果官方没有提供到达回执功能，也没有提供查询机制。

  • 苹果官方没有提供点击回执功能，但是可以调用通知上报相关接口自行上报。

说明

  1. 安卓端仅部分厂商通道提供了点击回执功能，如果要准确监控所有厂商通道的点击数据并处理点击跳转事件，需进行辅助弹窗接入。

  2. 海外厂商（如谷歌、苹果）因为没有提供到达回执功能，所以无法监控端上是否真正接收到推送，目前送出成功就默认推送成功。

  3. 回执配置成功后，将在15分钟后生效。

各厂商回执配置步骤

华为

要确保华为厂商通道的消息回执功能正常工作，您需要在集成华为厂商通道SDK后进行额外配置。请按照以下步骤操作，以便将华为的回执信息成功回调至EMAS平台。

华为平台配置

  1. 登录华为 AppGallery Connect。

  2. 点击我的项目，在项目列表中找到您的项目，通过增长-推送服务-配置导航到配置页签。

  3. 在该页面可以选择配置项目级回执或者应用级回执，需要注意的是项目级回执通知接收 URL 地址，对该项目下所有应用生效。如果您同时配置了项目级回执和应用级回执地址，则优先获取应用级回执地址信息。

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

image.png

  1. 在选择回执弹窗页面，点击新建回执。

image.png

  1. 进入回执配置页面，进行如下参数配置，点击测试回执可以对回执地址进行功能测试，点击提交完成回执的创建。

  • 回调地址：https://amspush-ack.aliyuncs.com/hw/

  • 支持版本：建议选择V2版本。

image.png

  1. 若有多条回执，请将EMAS平台的回执勾选为默认回执，并获取回执配置ID，点击确定即可开通应用回执。

image.png

EMAS控制台配置

前往EMAS控制台，在用户增长-移动推送-应用配置-厂商通道中，选择对应的安卓应用，填写华为厂商应用的默认回执ID，点击保存即可配置完成。

image.png

常见问题

Q：移动推送，华为的厂商通道支持多个回执地址配置，如果配了多个，EMAS的推送是否可以收到回执？

A：当前有两种解决方案：

  1. 在华为厂商通道的回执中，把默认回执配置成EMAS移动推送的回执；

  2. 在推送中配置AndroidHuaweiReceiptId参数，配置成华为厂商通道中的回执ID。

荣耀

要确保荣耀厂商通道的消息回执功能正常工作，您需要在集成荣耀厂商通道SDK后进行额外配置。请按照以下步骤操作，以便将荣耀的回执信息成功回调至EMAS平台。

荣耀平台配置

  1. 登录 荣耀开发者服务台，进入管理中心。

  2. 在应用服务中，选择开发服务 - 推送服务，进入推送服务页面。

image.webp

  1. 在推送服务列表中，选择需要配置回执的应用，点击应用回执，进入应用回执页面。

image.png

  1. 在应用回执页面，点击新增回执，进入回执配置页面。

image.png

  1. 进入回执配置页面后，填写回执名称和回调地址，勾选回执范围，点击提交。

  • 回执地址：https://amspush-ack.aliyuncs.com/ho/

  • 回执范围：到达回执、点击回执，均勾选上。

image.png

vivo

要确保vivo厂商通道的消息回执功能正常工作，您需要在集成vivo厂商通道SDK后进行额外配置。请按照以下步骤操作，以便将vivo的回执信息成功回调至EMAS平台。

vivo通道回执说明

vivo 厂商目前提供了新老回执两套接口，相比老接口，新回执可以统计到更多的数据指标，建议优先使用新回执功能。具体数据指标见：vivo消息回执。 使用vivo新回执功能，需要开发者在 vivo 开放平台开通并配置消息回执（老接口不需要），才能把 vivo 厂商回执的信息数据回调到EMAS平台。

说明

  1. 使用新回执后，老回执功能将会失效。

  2. 若不开通app回执地址，移动推送仅能统计到达量，无法感知推送失败的信息和原因，建议开通。

  3. 回执地址添加成功后，将在1小时后生效。如存量app从无回执地址到配置回执地址，可能存在一个中间时间段无法统计，请切换前知悉此问题。

  4. 配置完回执地址，请记录界面中的回执ID，配置到EMAS控制台。

vivo平台配置

  1. 登录 vivo 开放平台。

  2. 在应用列表页找到对应应用，点击应用操作列的应用信息：

image.png

  1. 在应用信息页面，点击APP回执地址处的开通按钮。

image.png

  1. 提示弹框点确定。

image.png

  1. 在选择回执页面，点击新建回执。

image.png

  1. 输入回执地址后点击确定。

  • 回执地址：https://amspush-ack.aliyuncs.com/vivo/

image.png

  1. 点击确定保存回执地址。

image.png

  1. 获取回执ID后，点击返回。

image.png

  1. 可以看到APP回执地址处显示已开通，表示已完成回执配置。

image.png

EMAS控制台配置

前往EMAS控制台，在用户增长-移动推送-应用配置-厂商通道中，选择对应的安卓应用，填写vivo 厂商应用的消息回执ID，点击保存即可配置完成。

image.png

魅族

要确保魅族厂商通道的消息回执功能正常工作，您需要在集成魅族厂商通道SDK后进行额外配置。请按照以下步骤操作，以便将魅族的回执信息成功回调至EMAS平台。

魅族平台配置

  1. 登录 魅族 Flyme 推送平台，选择需要开通推送回执的应用，点击打开应用。

image.png

  1. 选择配置管理-回执管理，进入回执管理页面；在回执管理页面，新增如下两个回执，若不设置消息回执，将不会使用魅族通道推送，可能会导致收不到推送消息。

  • 回执地址：http://amspush-ack.aliyuncs.com/mz/ 及 https://amspush-ack.aliyuncs.com/mz/ 两个地址均需要配置。

image.png

鸿蒙

要确保鸿蒙厂商通道的消息回执功能正常工作，您需要在集成鸿蒙厂商通道SDK后进行额外配置。请按照以下步骤操作，以便将鸿蒙的回执信息成功回调至EMAS平台。

鸿蒙应用配置

  1. 登录华为 AppGallery Connect。

  2. 点击我的项目，在项目列表中找到您的鸿蒙项目，通过增长-推送服务-配置导航到配置页签。

  3. 在该页面可以选择配置项目级回执或者应用级回执，需要注意的是项目级回执通知接收 URL 地址，对该项目下所有应用生效。如果您同时配置了项目级回执和应用级回执地址，则优先获取应用级回执地址信息。

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

image.png

  1. 在选择回执弹窗页面，点击新建回执。

image.png

  1. 进入回执配置页面，进行如下参数配置，点击测试回执可以对回执地址进行功能测试，点击提交完成回执的创建。

  • 回调地址：https://amspush-ack.aliyuncs.com/hm/

  • 支持版本：选择 V2 版本。

image.png

  1. 若有多条回执，请将EMAS平台的回执勾选为默认回执，并获取回执配置ID，点击确定即开通应用回执。

image.png

EMAS控制台配置

前往EMAS控制台，在用户增长-移动推送-应用配置-厂商通道中，选择对应的鸿蒙应用，填写鸿蒙厂商应用的消息回执ID，点击保存即可配置完成。

image.png

上一篇：阿里云移动推送+Unity框架最佳实践下一篇：厂商通道推送限制及消息分类最佳实践
文档推荐