跳到主要内容

上报推送数据

融云提供推送统计数据功能,您可以在控制台推送成功率统计页面查看推送服务的统计数据。

提示

推送数据统计功能仅针对已上线应用的生产环境。如果是海外数据中心的应用,请根据 SDK 版本完成配置,确保数据上报到正确的数据中心,详见知识库文档融云海外数据中心使用指南

推送数据统计包括:

  • 推送总量:表示实际需要推送的通知条数,包括厂商推送和融云推送。
  • 推送成功总量:表示成功推送到第三方 Push 厂商、融云 Push 服务的通知数,推送成功并不代表实际已推送到了目标设备上。
  • 推送失败总量:表示推送到第三方 Push 厂商、融云 Push 服务失败的通知数。
  • 推送到达总量(需配置):表示手机设备实际已经收到的通知数,部分系统手机需要终端主动上报达到数据。暂仅支持上报单聊、群聊会话类型的推送到达数据,不支持上报超级群推送和不落地推送到达数据。
  • 推送点击总量(需配置):表示终端用户点击通知总数,部分系统手机需要终端主动上报点击数据。

因为不同手机厂商推送服务设计差异,融云无法直接获取部分厂商的推送到达和推送点击数据,需要您在第三方推送平台进行配置或者客户端自行上报。

检查 SDK 初始化时机

如果用户点击推送通知时融云 SDK 尚未完成初始化,SDK 将无法上报推送数据。

建议您在集成时检查 App 中需要初始化的组件,将融云 SDK 初始化尽量提前,确保融云可准确上报推送相关数据。

采集推送到达数据

推送到达是指通知已发送到第三方厂商推送通道或融云推送服务后,推送通知成功下发到目标设备。

鸿蒙平台已支持采集。

配置鸿蒙推送回执

提示

在配置之前,请确保已完成鸿蒙推送集成。

完成鸿蒙推送通道配置集成后,需要开发者在鸿蒙开放平台开通并配置消息回执,才能获取到鸿蒙推送送达设备数据。详细可参考鸿蒙开放平台消息回执,配置流程如下:

  1. 登录AppGallery Connect,在 Push 开发服务中选择对应的应用,进入推送配置页面。

  2. 进入配置界面后,开通应用回执状态

  3. 点击新建回执后,需要配置如下参数。

    (width=400)

    • 回执名称:填写自定义名称。
    • 回调地址:请务必根据应用所属数据中心配置对应的推送回执回调地址。
      • 国内(北京)数据中心:https://callback.rong-edge.com/push/callback/harmony
      • 新加坡数据中心回调地址: https://callback.sg-light-edge.com/push/callback/harmony
      • 新加坡 B 企业合作数据中心: https://callback.sg-b-light-edge.com/push/callback/harmony
      • 北美数据中心回执地址: https://callback.us-light-edge.com/push/callback/harmony
      • 沙特数据中心回执地址:https://callback.sau-light-edge.com/push/callback/harmony
    • 回调用户名:请留空
    • 回调密钥:请留空
    • 支持版本:鸿蒙平台配置仅支持 V2 版本。
  4. 配置完成后,点击测试回执,提示成功后可点提交配置完成。

采集推送点击数据

推送点击数据是指表示终端用户点击通知的总数。

目前鸿蒙 SDK 暂不支持该功能。

附录:融云回调服务 HTTPS 证书

如有推送平台要求提供回调服务器的 HTTPS 证书,您可以使用以下证书。

  • (推荐)更新北京数据中心回执地址为 https://callback.rong-edge.com/push/callback/harmony,对应 HTTPS 证书如下(有效期至 2024-11-28):

    -----BEGIN CERTIFICATE-----
    MIIHFDCCBXygAwIBAgIQD7iyosOKQGwk/WonYz+eQDANBgkqhkiG9w0BAQwFADBZ
    MQswCQYDVQQGEwJDTjElMCMGA1UEChMcVHJ1c3RBc2lhIFRlY2hub2xvZ2llcywg
    SW5jLjEjMCEGA1UEAxMaVHJ1c3RBc2lhIFJTQSBPViBUTFMgQ0EgRzIwHhcNMjMw
    NDI2MDAwMDAwWhcNMjQwNDI1MjM1OTU5WjBwMQswCQYDVQQGEwJDTjESMBAGA1UE
    CAwJ5YyX5Lqs5biCMTMwMQYDVQQKDCrljJfkuqzkupHkuK3ono3kv6HnvZHnu5zn
    p5HmioDmnInpmZDlhazlj7gxGDAWBgNVBAMMDyoucm9uZy1lZGdlLmNvbTCCASIw
    DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJ+eS+CUXovisSlSEYeP+jz3Ufr1
    XkMnkFCyZ8nHoitVgrzyUUQFrcrFW4vRaeo0FeqPs38C/KrW8fut78LEOnyoIu6w
    hVgPACpA+p6mlBEhLzYwEIvI9cmJrr0IuXjZiVzcgQysCCUdrWo+E0T3kPFGdCu1
    DrVT2qVMywBwfxokOvZKZKCAt3PPy8jxBxq/sprFghUvCAMAFtWCD507N216W2Vf
    143NxpOWvARriA7n2UnzmcY1Qr/4rZre1cqX3LC/BK37bCrHVUIGcEr8JI8zdF7G
    YPIlxtn0stbxjuriRJO938rvxH9pD/ynP5VejDRRmran9s4StYQu73QNyZECAwEA
    AaOCAz8wggM7MB8GA1UdIwQYMBaAFMoxITcM3jm30istVZpcqalcUPomMB0GA1Ud
    DgQWBBT8RqJ49OUDOqSVbFY6bxgiFOxrqzAOBgNVHQ8BAf8EBAMCBaAwDAYDVR0T
    AQH/BAIwADAdBgNVHSUEFjAUBggrBgEFBQcDAQYIKwYBBQUHAwIwSQYDVR0gBEIw
    QDA0BgsrBgEEAbIxAQICMTAlMCMGCCsGAQUFBwIBFhdodHRwczovL3NlY3RpZ28u
    Y29tL0NQUzAIBgZngQwBAgIwRwYDVR0fBEAwPjA8oDqgOIY2aHR0cDovL2NybC50
    cnVzdC1wcm92aWRlci5jbi9UcnVzdEFzaWFSU0FPVlRMU0NBRzIuY3JsMH0GCCsG
    AQUFBwEBBHEwbzBCBggrBgEFBQcwAoY2aHR0cDovL2NydC50cnVzdC1wcm92aWRl
    ci5jbi9UcnVzdEFzaWFSU0FPVlRMU0NBRzIuY3J0MCkGCCsGAQUFBzABhh1odHRw
    Oi8vb2NzcC50cnVzdC1wcm92aWRlci5jbjApBgNVHREEIjAggg8qLnJvbmctZWRn
    ZS5jb22CDXJvbmctZWRnZS5jb20wggF8BgorBgEEAdZ5AgQCBIIBbASCAWgBZgB1
    AHb/iD8KtvuVUcJhzPWHujS0pM27KdxoQgqf5mdMWjp0AAABh7s7gZAAAAQDAEYw
    RAIgN0nP0OHS1Sn6Fot7rzhFDv8vIz3iBCK+ju4Gu4TPqV0CIHQtkwAMuiwVumvT
    7FSch3+RKjA3Rt9CWAfawmFgH0FQAHUA2ra/az+1tiKfm8K7XGvocJFxbLtRhIU0
    vaQ9MEjX+6sAAAGHuzuB7AAABAMARjBEAiAecnn4wh/hbLT0/be0ueJGRGK6ZA06
    HG0y1DL5K6NgCwIgDvgnFB19naHWLMchaajAvCWV3xupAYeCEdnSpzX/2uYAdgDu
    zdBk1dsazsVct520zROiModGfLzs3sNRSFlGcR+1mwAAAYe7O4H8AAAEAwBHMEUC
    IQDqlr+hSMGYcxO1pMqgpYHXt+g8VkrF6ZF1IeGAaV1mIgIgLqn1vQoeuzLgWrZ2
    BKnYtTes3DHqUg3iSN53/rGTsT4wDQYJKoZIhvcNAQEMBQADggGBALFCFyIGc7rZ
    24kuAsU9fUkH/98RnVOkbmBaXqotGoSGm6iPE4sM0Ow88SDP2saeu41r5DKYp7eL
    yY+3EuOpuFbaoG43xt2JxLXTFdypxRPFj48dVW31y64M2Jxi2kCjvExXrrRAoSTk
    HMbPc4klOGWHvMglaKTdc7oiN1xF9gL8ZQB4Y6S8Dj4aQS7+WqvhQmkX9NKpdnxU
    6rpA8xLloCamAiwB414ZIFbALFCW6CyQ6rgJoPBPw/9/+vdMX0fcbHjl6yk3jAbh
    mk/VKFjOHLvr7hAUanOBWrroy2d0eCz7kO6AbWiSU0WBPfpPFSXMGx3FFhY0ZaJn
    bAaP1vgoRC9+cdiqVfDCdZLWBoZ7E85UQwYwCXN5UrXhc2Hapc1dmCz0jKwdeC7t
    0AMepPLbswJ2jpMBsTMm6i83fd+qxGtWjaXmt4n+/1uq4CO5Dv4L1EGgaOQ3JOhO
    zzRPXRBxo+NcUcN2u7e82wEuP5eRPxSnb2kaTGWYh+FxJ8IRfUoEqw==
    -----END CERTIFICATE-----
    -----BEGIN CERTIFICATE-----
    MIIFBzCCA++gAwIBAgIRAIjIlPomNnQ0gajkW/aGHc4wDQYJKoZIhvcNAQELBQAw
    ezELMAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
    A1UEBwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQxITAfBgNV
    BAMMGEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczAeFw0yMjAxMTAwMDAwMDBaFw0y
    ODEyMzEyMzU5NTlaMFkxCzAJBgNVBAYTAkNOMSUwIwYDVQQKExxUcnVzdEFzaWEg
    VGVjaG5vbG9naWVzLCBJbmMuMSMwIQYDVQQDExpUcnVzdEFzaWEgUlNBIE9WIFRM
    UyBDQSBHMjCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBAMMsv9Ae9mba
    03+pEjRkDcT5/psaxSnRb1m11UkOo55ptSHNvD6ksa6h1ABuw/0n90bmj3aMJspG
    1IQXkRBoVnB2BUmDGMUfscHFmOsnI0qJxKpwe6YAxyFJbzIjq8D7DShACNUKzypR
    poBCoJKC3nSAqk+bkZ4qnmmd/FWl/K1EEcZHmJSFRkNm2V5Wiolithqeoulz9YCF
    Um1/D4pwgheY5yp+SeiNF9lwM6eILUQ2Rdot/nx2vQ0WypVfrz0TgR/VBPtS1n6Y
    LVO2awsQWYW2QjKzUVmk1wCHiTGQ8s6MlV35UcmycMJhS+lFxe6qPduxWrtbMGwJ
    PyzPBEPt2mItBkQGQmJ6suT2w092ask0cpotSR6zPFLpiawsE5k9KXl2yOCGAHH1
    WtiDAqu1hyW/isrGD1VIYvXNrsDBngog97kl4gHQASDM1HuiG3j9d2Bao2BP3q4u
    DI3GCJd468paeBDdkrQux+4tSO7eCoVbGnPFjUspEtMuMuNy5XD8JwIDAQABo4IB
    JjCCASIwHwYDVR0jBBgwFoAUoBEKIz6W8Qfs4q8p74Klf9AwpLQwHQYDVR0OBBYE
    FMoxITcM3jm30istVZpcqalcUPomMA4GA1UdDwEB/wQEAwIBhjASBgNVHRMBAf8E
    CDAGAQH/AgEAMB0GA1UdJQQWMBQGCCsGAQUFBwMBBggrBgEFBQcDAjAiBgNVHSAE
    GzAZMA0GCysGAQQBsjEBAgIxMAgGBmeBDAECAjBDBgNVHR8EPDA6MDigNqA0hjJo
    dHRwOi8vY3JsLmNvbW9kb2NhLmNvbS9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2VzLmNy
    bDA0BggrBgEFBQcBAQQoMCYwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmNvbW9k
    b2NhLmNvbTANBgkqhkiG9w0BAQsFAAOCAQEAdI/xWnHciaMYplkXi+20Ec5OLR1h
    UwczrHpDCvWAob2Hl+NK1IpwO3y3ALjCXvFTPAEkNI/RFbNoxz2UiFQh946m4ggB
    n77Dj35xu6TWgCeYnhc2R87EDLYS3UHxfg0fZY8Pvo4wm+Bqabx23aFESYDlk6fO
    /VgvUzZ/GewYo78DGPNd/dcqjMSR0Ga0Q7BD+SeFbmzmPD1oRfIPKog4kDum95Ro
    nt7m3K8cEjhEWZ6h3ZQ1Wrdi6oGdxMixhnE4b8X9tIflmVSoIdzSbsrIcaOvlkzv
    nc9IKm8XQvqOewdx5x3Gfd8pzGr5JjGQEBzDXtArfKt4pbBk2j5b9FAjCA==
    -----END CERTIFICATE-----