文章

多厂商-个推

多厂商-个推

多厂商-个推

多厂商-个推

集成指南

1.1 添加 Maven 库地址

在以项目名为命名的顶层 build.gradle 文件的 allprojects.repositories 中,添加个推 maven 库地址 https://mvn.gt.getui.com/nexus/content/repositories/releases/ 如下所示:

1
2
3
4
5
6
7
8
9
10
allprojects {
    repositories {
        jcenter()
        //添加 Maven URL 地址
        maven {
            url "http://mvn.gt.getui.com/nexus/content/repositories/releases/"
        }
    }
}

###
1.2 配置相关依赖 在 app/build.gradle 文件中的 dependencies 块中引用厂商 SDK 依赖库 ,此处的{version}为对应的版本号,详见厂商更新日志。ups为个推与手机厂商合作通道,目前支持坚果,索尼,海信手机。如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])

    // 根据所需厂商选择集成
    //小米
    compile 'com.getui:xmp-for-google-play:1.0.7'
    //华为
    compile 'com.getui:hwp-for-google-play:1.0.6'
    //魅族
    compile 'com.getui:mzp-for-google-play:1.0.9'
    //OPPO
    compile 'com.assist:oppo:1.0.7'
    //VIVO
    compile 'com.assist:vivo:1.0.7'
}
//注意:此处不要照搬官网

个推maven库地址:https://mvn.gt.getui.com/nexus/content/repositories/releases/com/

注意:RN版本个推用的是谷歌版本包(不要照搬官网)

###
1.3 配置应用参数 请先确保已 创建厂商应用 ,并获取厂商应用参数信息
在 app/build.gradle 文件中的 android.defaultConfig 下添加 manifestPlaceholders,配置厂商相关的应用参数,如下 manifestPlaceholders 中的内容所示,ups无需配置对应的厂商ID,个推已经默认作出处理:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
android {
    defaultConfig {
        manifestPlaceholders = [
            GETUI_APP_ID : "",
            GETUI_APP_KEY : "",
            GETUI_APP_SECRET : "",
  
            // 华为 相关应用参数
            HUAWEI_APP_ID  : "",

            // 小米相关应用参数
            XIAOMI_APP_ID  : "",
            XIAOMI_APP_KEY : "",

            // OPPO 相关应用参数   
            OPPO_APP_KEY   : "",
            OPPO_APP_SECRET: "",

            // VIVO 相关应用参数   
            VIVO_APP_ID    : "",
            VIVO_APP_KEY   : "",

            // 魅族相关应用参数  
            MEIZU_APP_ID   : "",
            MEIZU_APP_KEY  : ""
        ]
    }
}

安卓厂商离线机型版本支持情况

  • 华为机型要求:需华为rom且华为rom版本大于等于emui4.1, 华为移动服务(可在应用列表或华为应用市场中查看)版本大于等于2.5.2
  • 小米机型要求:需小米rom且小米服务框架(包名:com.xiaomi.xmsf)版本号⼤于等于105
  • 魅族机型要求:需魅族rom版本大于等于5.x
  • oppo机型要求:需oppo colorOS rom且版本号大于等于3.1
  • vivo机型要求:请参考vivo官网说明

rom - 系统包

消息报表介绍

  • 华为渠道:华为暂时未对外提供报表数据接口,提供了回执,报表数据可以根据回执统计到到达数据
  • 魅族渠道:魅族有对外提供报表数据接口,可以统计到全量的数据
  • 小米渠道:小米有对外提供报表数据接口,展示数据未提供
  • oppo渠道:oppo暂时未对外提供报表数据接口,提供了回执,报表数据可以根据回执统计到到达数据
  • vivo渠道:vivo渠道有对外提供群推报表数据,任务维度报表可以统计到全量的数据;单推没有提供报表数据,由于也未提供app维度的报表数据接口,所以app维度报表通过单推回执+群推报表的形式统计

华为

1. 创建华为应用

登录AppGallery Connect网站,选择“我的项目”。添加项目》添加应用

1620977763574-e1e340e6-aa2b-4407-80b6-f843694f922c.png

2. 应用配置

在开发者中心中填写相关厂商信息1620977823642-70efaa91-17e2-4e72-badb-58f51964aeb3.png

3. 在华为推送平台开通回执功能

此步骤不影响华为离线通知,用于数据统计(开通后需提供个推appid 参数,联系个推技术开通第三方回执权限【oppo、vivo也需】)

3.1 开通华为回执功能1620977982951-8c17d546-db93-47f7-a3e7-cbd7aa85ce17.jpeg

3.2 在“回调地址”和“HTTPS证书”里输入以下内容

  • 回调地址
https://thirdrcp-hz.getui.com/hw
or
https://thirdrcp-bz.getui.com/hw   //归属个推北京机房应用
  • HTTPS证书
-----BEGIN CERTIFICATE-----
MIIGxTCCBa2gAwIBAgIQBV+1ZzjAmrzPkloBgHIwpjANBgkqhkiG9w0BAQsFADBN
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMScwJQYDVQQDEx5E
aWdpQ2VydCBTSEEyIFNlY3VyZSBTZXJ2ZXIgQ0EwHhcNMTkwNDEyMDAwMDAwWhcN
MjEwNjI1MTIwMDAwWjCBizELMAkGA1UEBhMCQ04xETAPBgNVBAgTCFpoZWppYW5n
MREwDwYDVQQHEwhIYW5nemhvdTFAMD4GA1UEChM3WmhlamlhbmcgTWVyaXQgSW50
ZXJhY3RpdmUgTmV0d29yayBUZWNobm9sb2d5IENvLiwgTHRkLjEUMBIGA1UEAwwL
Ki5nZXR1aS5jb20wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDJ37Cx
fD0XaVj7anlrs71N6NKgy6EaA8BXXyV5k7GLtGnlF9EGGjMeQDnMYGxlX1kqlPl8
/Rx24ulhj9qcJyKgwQOVtD0gx7P/KdDIJv2oAaWkEM5egSchmeQz5demLKNs3B2b
bMBgPqRyGfpE/6VQu/GBwQb2B7wKus8tp+mG5G1SrDi0RTOGc/9odse28WvAVfJL
U+esQLMBXG6YE77Say/l1A7S0RG23hfTE4xOKVk0hq6N+2bUlwKPUHcYR5xsblRQ
2Da7flQItDQyC4aDWa/FrdKvOHV77UQJnUqYJgwO2YYnEgF2Lhok/Sh8FPsCROFy
vz9Yqn7eUmXAEvNVAgMBAAGjggNgMIIDXDAfBgNVHSMEGDAWgBQPgGEcgjFh1S8o
541GOLQs4cbZ4jAdBgNVHQ4EFgQUFKCdBCNrr9CrJGFTPTX1pyRIYD0wIQYDVR0R
BBowGIILKi5nZXR1aS5jb22CCWdldHVpLmNvbTAOBgNVHQ8BAf8EBAMCBaAwHQYD
VR0lBBYwFAYIKwYBBQUHAwEGCCsGAQUFBwMCMGsGA1UdHwRkMGIwL6AtoCuGKWh0
dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9zc2NhLXNoYTItZzYuY3JsMC+gLaArhilo
dHRwOi8vY3JsNC5kaWdpY2VydC5jb20vc3NjYS1zaGEyLWc2LmNybDBMBgNVHSAE
RTBDMDcGCWCGSAGG/WwBATAqMCgGCCsGAQUFBwIBFhxodHRwczovL3d3dy5kaWdp
Y2VydC5jb20vQ1BTMAgGBmeBDAECAjB8BggrBgEFBQcBAQRwMG4wJAYIKwYBBQUH
MAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBGBggrBgEFBQcwAoY6aHR0cDov
L2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0U0hBMlNlY3VyZVNlcnZlckNB
LmNydDAMBgNVHRMBAf8EAjAAMIIBfwYKKwYBBAHWeQIEAgSCAW8EggFrAWkAdwCk
uQmQtBhYFIe7E6LMZ3AKPDWYBPkb37jjd80OyA3cEAAAAWoPYIkyAAAEAwBIMEYC
IQCL5yt2aBIbvKsZpkrcv2/fDjZuPb/iW7MeYWuHc+Jn7AIhAKalmeqXPcZL8uUN
xb/HgPXcDgTYYZ5yhXwjFR9vsmjTAHYARJRlLrDuzq/EQAfYqP4owNrmgr7YyzG1
P9MzlrW2gagAAAFqD2CI4AAABAMARzBFAiEA7R0pW3sbPO96dxRUeF9V5tLGUhNr
iYEE6n0YVyO8aZUCIFgQGd//IqZC/3idOXowTSW+dlHI5STh+QAGria+zCBrAHYA
VhQGmi/XwuzT9eG9RLI+x0Z2ubyZEVzA75SYVdaJ0N0AAAFqD2CKCwAABAMARzBF
AiEA2xQ1ri/sVj1xhK5s8SU9FLTX0M/G0ew9C4R7D/73WQ4CIA8p9XQh6LZCg99M
tjY8DP6J6lsV7oDCmTIqg53rxPH3MA0GCSqGSIb3DQEBCwUAA4IBAQAX2ucpHFVl
JwtC1JTlHyOQp6abWJ3yOUgR+GV852tAIzzR6R4obYiXBDzdbCMqdXDFW4czjxuz
Ygo9s5K3refmkKIo0oTpMl27MRCa3wWeorV/aZmXc0BD6VbxI/TvqWboBuMxZ0z9
pq999dj6Gk44WR/6fsf9YLvUvg4KU3dYKQnZjRoYK3coJFa1V4Ln57bbFT86SKBp
t1sXoPl9hOMs8Wy2XCYbhh0ctwpUHnFpOtSOUxfSgETdJNMgx7mSnipMhtWr0YN9
26iS+0atgpLZhIpPxsLQTyH4+PWWYhR9BsMIbpAB8G3+CS9GvUcEJJRRETbjkTtq
/mtP2EI5R52q
-----END CERTIFICATE-----

3.3 点击“测试回执”,提示“测试回执地址成功”则表示配置成功

1620977983033-3b4736c2-758a-4a7c-858e-f82aac3daa12.jpeg

3.4 开通后统计次日后数据

1622169778252-1a73a9e1-73d6-49be-92cc-56607542f652.png

4. 填写[SHA256证书指纹]

华为平台上【我的项目】-【项目配置】-【常规】中要填写[SHA256证书指纹],切记一定要点击右侧对勾保存。

1620978485838-238cf49a-61f0-4c07-a821-c8a37fc5a37b.png

4.1 如何生成签名证书指纹

  • Windows
    1. 在JDK的bin目录,执行CMD命令打开命令行工具
    2. 执行命令**keytool -list -v -keystore **__,按命令行提示进行操作。为应用签名证书的完整路径。例如:
keytool -list -v -keystore E:\codes\RnDemo\android\app\test.keystore
  1. 根据结果获取对应的SHA256指纹。

1620978871268-0d7a126d-8ffb-4fa3-af99-ac2a71f0278f.png

如何生成签名证书指纹


小米

1. 创建小米应用

  • 登录小米开放平台申请开发者帐号:1620980063209-b126351d-4dd6-41f9-986c-f0ba7d84063d.png
  • 进入管理控制台->消息推送:1620980063228-ee713856-9498-48bd-a4e9-10eee1f82f66.png
  • 选择创建手机/平板应用:1620980063256-987efc9e-3ea0-41ad-9295-94f9d6c26c83.png
  • 填写应用名称和应用包名创建应用1620980063220-8da7cd93-8731-4f71-bef8-86b18b77cce9.png
  • 勾选我同意接受小米推送的接入合作协议复选框,点击启用按钮:1620980063239-35c4d7fe-0022-4057-8f00-a4b67aa7cc3f.png
  • 查看应用信息,获取小米 AppID、小米 AppKey、小米 AppSecret:1620980063784-6c8c7e4e-4c7a-44cb-8f94-ec1c3a583245.png

2. 应用配置

  • 在开发者中心中填写相关厂商信息:1620980063888-0ac27b26-e5ff-4b2b-a2be-36cb8c8a16ea.png

魅族

1. 创建魅族应用

  • 登录魅族开放平台申请开发者帐号:1621237045251-b970b883-574f-422d-816f-d20220ad101f.png
  • 登录魅族推送平台,选择新建应用:1621237045247-2e8b400f-7411-4ff1-90a6-2f5dd1beefa3.png
  • 填写应用名称和应用包名,上传应用图标后创建应用:1621237045318-9f9824ab-e304-4008-80e0-ba77523371f3.png
  • 打开新创建的应用:1621237045243-8f66a664-b553-4396-b28e-d72d84afce08.png
  • 在配置管理中查看相应的魅族 AppID、魅族 AppKey、魅族 AppSecret:1621237045268-265c6d6e-e27b-45b6-859f-7c909ddbd709.png

2. 应用配置

  • 在开发者中心中填写相关厂商信息:

1621237045875-2e8275d5-6d0f-4ae6-b099-1bdb7b8685f4.png

OPPO

1. 注册成为开发者

访问OPPO开放平台,注册成为OPPO企业开发者,详情请参考《OPPO企业开发者帐号注册流程》

2. 创建应用

登录OPPO企业开发者帐号,并创建应用,详情请参考《应用接入流程》

3. 开通PUSH服务

3.1 进入推送服务有二种方式:

3.1.1 登录OPPO开放平台,依次选择“应用服务”–“开发服务”–“推送服务”

1621237754630-fd84a637-9949-4145-a393-1ff5f7710f68.png

3.1.2 进入应用详情页,点击“推送服务”

1621237754838-d0c9a7ae-0675-4bc7-b331-af20f209a2e2.png

3.2 进入推送服务界面

在推送服务界面可以看到已开启服务应用和未开启服务应用

1)已开启服务:已申请push权限并通过的应用2)未开启服务:可申请push权限的应用

1621237754998-c3bc8b62-e35d-4f84-a429-aefa9791c3ed.png

3.3 点击“申请开通按钮”

在未开启服务中点击需要申请push权限的应用,进入PUSH服务并点击申请开通。

1621237754928-8890ef53-6d3d-45cb-a703-a9b4af1f092e.png

1)通知栏推送:应用需在OPPO软件商店上架,且主营业务不为借贷类的应用。2)通知栏推送测试权限:金融类的应用不支持接入推送测试,请上架OPPO软件商店后申请“通知栏推送”权限。3)通知栏推送测试权限:每天仅可推送1000条消息,限测试使用。应用上架后需重新申请“通知栏推送”权限,以获得正常消息推送数量。

3.4 提交申请。

1621237754904-bf293396-72cf-47e1-bfcf-bfa9551657be.png

3.5 等待审核结果

平台将会在1个工作日内返回审核结果,开发者可以在申请页面查看审核结果,其他问题可咨询开放平台客服。

  • 查看应用信息,获取 OPPO App ID、OPPO App Key、OPPO App Secret、OPPO Master Secret

1621237793783-cf0664fe-1b02-4768-b27a-c6d32198f9f3.png

VIVO

1. 注册vivo开发者账号

请访问vivo开放平台,使用vivo账号登录进入开发者站,如果没有vivo账号需要先注册vivo账号。

详细开发者账号注册流程请参考:https://dev.vivo.com.cn/documentCenter/doc/2

推送服务将同步开放平台上架应用结果,请关注开放平台应用的上架状态,开发者可在申请页面查看审核结果。

2. 登录vivo推送平台启用推送

若要使用vivo推送平台进行推送,开发者的应用必须要在开放平台通过审核上架后,才会通过消息推送服务审核。

2.1 创建应用

创建正式推送:创建正式推送前需先在开放平台创建您的应用。详情请见《应用提交流程》https://dev.vivo.com.cn/documentCenter/doc/52

2.2 申请push服务:

当开发者已经创建应用后,无论应用审核通过与否均可申请push服务。在登录vivo开发者账号后,申请push服务有以下三种方式

① 开放平台首页-开放能力-消息推送进入。

1621237454934-b8b89aa3-b2cb-46e9-b513-c8bb9422e5a2.jpeg

② 开放平台首页-管理中心-消息推送进入。

1621237454586-c1b9a52b-ffb5-41cc-9715-aecc9da21f34.jpeg

1621237454551-ff1f3400-e8e0-4970-a3e4-1fa73a473e6b.jpeg

点击进入消息推送后,将会进入vivo开放平台-推送运营平台,在“消息推送-全部应用”中点击“创建应用”,若此操作在开发者创建应用后,所创建应用将会列入在应用名称里,点击“应用名称”选择要申请的应用后点击“提交申请”

1621237454333-c4f8c55e-7a29-46f3-a583-4b8dd08a4e26.png

1621237454503-d06e7601-bcca-470a-bd8a-d591850c7139.png

若先进入此步骤,略过了创建应用环节,可点击“开放平台-创建应用”跳转到相应界面,详细流程请见:《应用提交流程》;若已有应用点击提交申请后,推送服务将同步开放平台上架应用结果,请关注开放平台应用的上架状态,开发者可在申请页面查看审核结果。

3. 接入消息推送服务

审核通过后即可使用平台返回的App key及App secret进行SDK的集成,使用推送服务。

查看应用信息,获取 VIVO APP ID、VIVO APP keyy、VIVO APP secret

1621237894683-dc4c92ee-6b7a-4bbc-92b5-5205cdebd8b1.jpeg

本文由作者按照 CC BY 4.0 进行授权