厂商通道回执配置指南

为了帮助客户追踪和分析推送效果，不断改进优化推送策略，极光推送提供厂商通道送达、展示、点击等环节的数据统计和展示功能。但不同的厂商通道对送达、展示和点击数据回执的支持程度不同。华为、魅族和荣耀厂商通道抵达数据不能直接获取，需要开发者进行相应配置方可获取。

注意：目前极光 SDK 已支持统计厂商的点击数据，建议集成 4.2.2 及以上的 SDK 版本，即可支持通知消息的点击事件上报统计。

• OPPO 通道：仅在单推时有送达回执。
• FCM 通道：仅设备在前台活跃时有送达回执。
• vivo 通道：官方目前提供了新回执功能（官网老回执功能目前依旧可用，但未来可能下线），开发者如果在极光平台未配置，默认采用老回执；建议您尽快切换使用新回执功能。注意：使用新回执后，老回执功能将会失效。如果需要使用新回执，请参考下文完成极光平台侧配置。

华为通道送达回执配置指南

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

1.登录华为 AppGallery Connect网站。

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

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

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

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

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

• 回执名称：填写自定义名称。
• 回调地址： https://xpnscb.jpush.cn/v3/hpnsreport
• 支持版本：华为 V1、V2 版本，极光均已适配，不管 V1 版本还是 V2 版本，开发者均按上述提供信息配置即可。

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

魅族通道送达回调指南

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

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

2.在图中选择 打开应用 - 配置管理 - 回执管理，进入回执管理页面。

4.填写回调地址：https://xpnscb.jpush.cn/v3/mzpnsreport

5.激活回执：必须在完成上述步骤后，邮件联系极光技术支持 support@jiguang.cn 激活回执功能。

说明：

魅族通道激活回执必须在 Flyme 推送后台后配置回调地址后方可执行该操作，故需要开发者完成回调设置后，邮件联系极光官方技术支持在后台进行激活操作。邮件请注明：
appkey：您的极光 appkey 、申请事项：激活魅族回执、魅族官网完成配置的截图。

荣耀通道送达回执配置指南

完成荣耀厂商通道 SDK 集成后，需要开发者在荣耀开发者服务台开通并配置消息回执，方可把荣耀的送达统计数据回调到极光平台，具体操作如下：
1.登录 荣耀开发者服务台。
2.选择 开放能力 - 推送服务，进入推送服务页面。
3.选择需要配置回执的应用，点击“应用回执”，进入应用回执页面。

4.点击“新增回执”，进入回执配置页面。

5.进入回执配置页面后，需要填写回调名称和回调地址。

• 回执名称：填写自定义名称。
  

• 回调地址：https://xpnscb.jpush.cn/v3/honorreport
  

• 回执范围：“到达回执”、“点击回执”均勾选上
  

vivo通道送达回执配置指南

vivo 厂商提供了新回执功能接口，对比老接口回执数据更丰富，能统计到更多的数据指标，建议尽快升级使用新回执功能；
使用新回执后，老回执功能将会失效，参考 vivo消息回执说明；
新回执功能，需要开发者在 vivo 开放平台开通并配置消息回执（老接口不需要），方可把 vivo 厂商回执的送达统计等数据回调到极光平台，具体操作如下：

1.登录vivo vivo 开放平台。

2.在“全部应用”列表中找到您的应用，通过应用管理-应用信息-APP回执地址，选择“开通”APP回执功能。需要配置如下参数。

• 回调地址： https://xpnscb.jpush.cn/v3/vpnsreport

3. 「重要步骤」 完成上述操作后，请一定记得回到极光推送控制台-推送设置-Android集成设置-vivo厂商设置，开启vivo新回执功能（注意：此步骤完成后，必须同时完成第4步，否则回执功能不生效。）

4. 「重要步骤」 以上所有配置步骤均完成后，还要记得，在下发推送时必须指定 vivo 回执 ID 值，上述「步骤2」截图中标注的 ID 值（根据您实际值填写）。
   

webPortal 控制台方式推送的时候，也一定要记得填写vivo callback_id值，否则无法获取到厂商回执数据。

• 对应极光 Push API 的 options.third_party_channel.vivo.callback_id 字段。

示例如下：

          {
  "options":{
    "third_party_channel":{
      "vivo":{
        "callback_id":"vivo推送平台产生的回执ID值"
      }
    }
  }
}