厂商通道回执配置指南
最近更新:2022-12-29

厂商通道回执配置指南

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

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

厂商通道 是否支持送达 是否支持展示 是否支持点击 是否需要配置
华为通道
魅族通道
荣耀通道
小米通道
OPPO 通道
vivo 通道(老回执)
vivo 通道(新回执)
FCM 通道
华硕通道
  • 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推送平台,选择需要开通推送服务的应用,点击打开应用

jpush_android_3m

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

jpush_android_3m

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


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


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


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

  • 对应极光 Push API 的 options.third_party_channel.vivo.callback_id 字段。
关键字 类型 选项 含义 说明
callback_id string 可选 vivo回执 ID
  • 仅vivo通道有效。
  • 输入一个唯一的回执 ID 指定本次下行消息的回执地址及配置,该回执 ID 可以在 vivo回执参数配置 中查看。
  • 示例如下:

    { "options":{ "third_party_channel":{ "vivo":{ "callback_id":"vivo推送平台产生的回执ID值" } } } }
              {
      "options":{
        "third_party_channel":{
          "vivo":{
            "callback_id":"vivo推送平台产生的回执ID值"
          }
        }
      }
    }
    
            
    此代码块在浮窗中显示
    文档内容是否对您有帮助?

    Copyright 2011-2022, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

    在文档中心打开