.NET快速对接极光消息推送

什么是消息推送?

很多手机APP会不定时的给用户推送消息,例如一些新闻APP会给用户推送用户可能感兴趣的新闻,或者APP有更新了,会给用户推送是否选择更新的消息等等,这就是所谓的"消息推送"。

更多APP消息推送的介绍可查阅该篇文章:十分钟带你了解APP消息推送(Push)👉

常见的一些APP消息推送示例

强营销类:

直接把营销力度,营销模式以一种叫卖式方式展现出来,目的通过优惠,时效性勾起用户贪小便宜的心理,好奇心理,如下所示:

强关联性:

在信息爆炸的时代,大脑会自动筛选对自己有价值的信息和没价值的信息,如果在一条信息中有@你,您之类的言语,大脑会自动识别,使用直接关联的技巧在于巧用"你"相关的字眼。

强话题性:

营销界有这么一句话,没有违和感就创造不了传播,不出位就制造不了话题,那么强话题性的文案自带传播属性,一般都会击中用户内心的某个感触,比如对社会的愤世嫉俗,对高房价的逆反心理,对旅游的文艺心等等。

极光推送介绍

极光推送(JPush)是日均消息量超百亿级规模的 App 消息推送专业服务平台,极光推送支持 Android、iOS、QuickApp、Web 等平台,SDK 接入方便快捷,推送通道高速稳定且支持海外专线,API 开放接口强大、灵活和易用、WEB 端支持创建通知、后效分析、标签别名管理和故障排查等运营功能。 极光推送(JPush)在为开发者提供基础推送服务的同时,还提供了用户精准标签、用户分群、地理围栏、应用内消息、智能发送策略、智能促活等服务能力,可有效提升消息的送达率、展示率和点击率,通过精细化运营触达助力 APP 提升日活和留存。

平台类型支持

消息类型支持

通知样式支持

为什么选择极光作为APP的消息推送平台?

  • 首先极光推送支持多平台推送。
  • 支持大规模的消息推送。
  • 极光推送对接方便,不同后端语言都提供了对应的SDK。
  • 对于免费账号支持也非常的友好(不过免费账号高峰期有资源瓶颈,假如需要及时性很强的话可以购买高级版收费服务)。

快速对接Jpush极光推送

  • 到极光推送官方网站注册开发者帐号;
  • 登录进入管理控制台,创建应用程序,得到 Appkey(SDK 与服务器端通过 Appkey 互相识别);
  • 在推送设置中给 Android 设置包名、给 iOS 上传证书、启用 WinPhone,根据你的需求进行选择;

.NET FX 4.5项目快速接入

该项目是基于C#/.NET(.NET Framework4.5.1的示例)极光推送对接实例,主要是对接极光集成为我们.Neter提供的SKD。在这里我主要封装了单个设备注册ID推送,设备注册ID批量推送和广播推送三种推送三种方式,其他的推送方式大家可以参考文档去进行封装。

1、在项目中引入Jiguang.JPush nuget包

2、极光推送调用

复制代码
`namespace Jpush.Controllers`
`{`
`    /// <summary>`
`    /// 极光推送管理`
`    /// </summary>`
`    public class JPushManageController : Controller`
`    {`

`        private readonly JPushClientUtil _jPushClientUtil;`

`        public JPushManageController(JPushClientUtil jPushClientUtil)`
`        { `
`          this._jPushClientUtil=jPushClientUtil;`
`        }`


`        /// <summary>`
`        /// 单个设备注册ID推送`
`        /// </summary>`
`        /// <returns></returns>`
`        public ActionResult SendPushByRegistrationId()`
`        {`
`            var isOk = _jPushClientUtil.SendPushByRegistrationId("追逐时光者欢迎你!", "2022新年快乐", "1507bfd3f715abecfa4", new Dictionary<string, object>(), true);`

`            return Json(new { result = isOk });`
`        }`


`        /// <summary>`
`        /// 设备注册ID批量推送(一次推送最多1000个)`
`        /// </summary>`
`        /// <returns></returns>`
`        public ActionResult SendPushByRegistrationIdList()`
`        {`
`            var registrationIds = new List<string>() { "1507bfd3f715abecfa455", "1507bfd3f715abecfa433", "1507bfd3f715abecfa422" };`
`            var isOk = _jPushClientUtil.SendPushByRegistrationIdList("追逐时光者欢迎你!", "2022新年快乐", registrationIds, new Dictionary<string, object>(), true);`

`            return Json(new { result = isOk });`
`        }`


`        /// <summary>`
`        /// 广播推送`
`        /// </summary>`
`        /// <returns></returns>`
`        public ActionResult BroadcastPush()`
`        {`
`            var isOk = _jPushClientUtil.BroadcastPush("追逐时光者欢迎你!", "2022新年快乐", new Dictionary<string, object>(), true);`

`            return Json(new { result = isOk });`
`        }`

`    }`
`}`

3、极光推送工具类(JPushClientUtil)

复制代码
`namespace Jpush.Common`
`{`
`    /// <summary>`
`    /// 极光推送工具类`
`    /// </summary>`
`    public class JPushClientUtil`
`    {`
`        private const string appKey = "youAppKey";`
`        private const string masterSecret = "youMasterSecret";`
`        private static JPushClient client = new JPushClient(appKey, masterSecret);`

`        /// <summary>`
`        /// 单个设备注册ID推送`
`        /// </summary>`
`        /// <param name="title">推送标题(Android才会存在)</param>`
`        /// <param name="noticeContent">通知内容</param>`
`        /// <param name="registrationid">设备注册ID(registration_id)</param>`
`        /// <param name="extrasParam">拓展参数(传入App接收的一些参数标识)</param>`
`        /// <param name="isApnsProduction">注意:iOS是否推送生产环境(true是,false否推开发环境)</param>`
`        /// <returns></returns>`
`        public bool SendPushByRegistrationId(string title, string noticeContent, string registrationid, Dictionary<string, object> extrasParam = null, bool isApnsProduction = true)`
`        {`
`            //设备标识参数拼接`
`            var pushRegistrationId = new RegistrationIdList();`
`            pushRegistrationId.registration_id.Add(registrationid);`

`            return JPushBaseSendMessage(title, noticeContent, isApnsProduction, pushRegistrationId, extrasParam);`
`        }`

`        /// <summary>`
`        /// 设备注册ID批量推送(一次推送最多1000个)`
`        /// </summary>`
`        /// <param name="title">推送标题(Android才会存在)</param>`
`        /// <param name="noticeContent">通知内容</param>`
`        /// <param name="registrationIds">注册ID(registration_id)列表,一次推送最多1000个</param>`
`        /// <param name="extrasParam">拓展参数(传入App接收的一些参数标识)</param>`
`        /// <param name="isApnsProduction">注意:iOS是否推送生产环境(true是,false否推开发环境)</param>`
`        /// <returns></returns>`
`        public bool SendPushByRegistrationIdList(string title, string noticeContent, List<string> registrationIds, Dictionary<string, object> extrasParam = null, bool isApnsProduction = true)`
`        {`
`            //设备标识参数拼接`
`            var pushRegistrationId = new RegistrationIdList();`
`            pushRegistrationId.registration_id.AddRange(registrationIds);`

`            return JPushBaseSendMessage(title, noticeContent, isApnsProduction, pushRegistrationId, extrasParam);`
`        }`

`        /// <summary>`
`        /// 广播推送`
`        /// </summary>`
`        /// <param name="title">推送标题(Android才会存在)</param>`
`        /// <param name="noticeContent">通知内容</param>`
`        /// <param name="extrasParam">拓展参数(传入App接收的一些参数标识)</param>`
`        /// <param name="isApnsProduction">注意:iOS是否推送生产环境(true是,false否推开发环境)</param>`
`        /// <returns></returns>`
`        public bool BroadcastPush(string title, string noticeContent, Dictionary<string, object> extrasParam = null, bool isApnsProduction = true)`
`        {`
`            return JPushBaseSendMessage(title, noticeContent, isApnsProduction, null, extrasParam, true);`
`        }`

`        /// <summary>`
`        /// 极光消息推送公共方法`
`        /// </summary>`
`        /// <param name="title">推送标题(Android才会存在)</param>`
`        /// <param name="noticeContent">通知内容</param>`
`        /// <param name="pushRegistrationId">设备注册ID(registration_id)</param>`
`        /// <param name="isApnsProduction">iOS是否推送生产环境(true是,false否推开发环境)</param>`
`        /// <param name="extrasParam">拓展参数</param>`
`        /// <param name="isRadioBroadcast">是否广播</param>`
`        /// <returns></returns>`
`        private bool JPushBaseSendMessage(string title, string noticeContent, bool isApnsProduction, RegistrationIdList pushRegistrationId, Dictionary<string, object> extrasParam, bool isRadioBroadcast = false)`
`        {`
`            try`
`            {`
`                object audience = pushRegistrationId;`

`                if (isRadioBroadcast)`
`                {`
`                    audience = "all";`
`                }`

`                var pushPayload = new PushPayload()`
`                {`
`                    Platform = new List<string> { "android", "ios" },//推送平台设置`
`                    Audience = audience,//推送目标`
`                    //notifacation:通知内容体。是被推送到客户端的内容。与 message 一起二者必须有其一,可以二者并存。`
`                    Notification = new Notification`
`                    {`
`                        Alert = noticeContent,//通知内容`
`                        Android = new Android`
`                        {`
`                            Alert = noticeContent,//通知内容`
`                            Title = title,//通知标题`
`                            URIActivity = "com.king.sysclearning.platform.app.JPushOpenClickActivity",//该字段用于指定开发者想要打开的 activity,值为 activity 节点的 "android:name"属性值;适配华为、小米、vivo厂商通道跳转`
`                            URIAction = "com.king.sysclearning.platform.app.JPushOpenClickActivity",//该字段用于指定开发者想要打开的 activity,值为 "activity"-"intent-filter"-"action" 节点的 "android:name" 属性值;适配 oppo、fcm跳转`
`                            Extras = extrasParam //这里自定义JSON格式的Key/Value信息,以供业务使用。`
`                        },`
`                        IOS = new IOS`
`                        {`
`                            Alert = noticeContent,`
`                            Badge = "+1",//此项是指定此推送的badge自动加1`
`                            Extras = extrasParam //这里自定义JSON格式的Key/Value信息,以供业务使用。`
`                        }`
`                    },`
`                    Options = new Options//可选参数`
`                    {`
`                        //iOS 环境不一致问题:API 推送消息给 iOS,需要设置 apns_production 指定推送的环境,false 为开发,true 为生产。`
`                        IsApnsProduction = isApnsProduction// 设置 iOS 推送生产环境。不设置默认为开发环境。`
`                    }`
`                };`

`                var response = client.SendPush(pushPayload);`
`                //200一定是正确。所有异常都不使用 200 返回码`
`                if (response.StatusCode == HttpStatusCode.OK)`
`                {`
`                    return true;`
`                }`
`                else`
`                {`
`                    return false;`
`                }`
`            }`
`            catch (Exception ex)`
`            {`
`                return false;`
`            }`
`        }`
`    }`

`    public class RegistrationIdList`
`    {`
`        /// <summary>`
`        /// 设备注册ID`
`        /// </summary>`
`        public List<string> registration_id { get; set; } = new List<string>();`
`    }`
`}`

参考文章

加入DotNetGuide技术交流群

1、提供.NET开发者分享自己优质文章的群组和获取更多全面的C#/.NET/.NET Core学习资料、视频、文章、书籍,社区组织,工具和常见面试题资源,帮助大家更好地了解和使用 .NET技术。

2、在这个群里,开发者们可以分享自己的项目经验、遇到的问题以及解决方案,倾听他人的意见和建议,共同成长与进步。

3、可以结识更多志同道合的开发者,甚至可能与其他开发者合作完成有趣的项目。通过这个群组,我们希望能够搭建一个积极向上、和谐友善的.NET技术交流平台,为广大.NET开发者带来更多的价值。

欢迎加入DotNetGuide技术交流群👉

相关推荐
追逐时光者1 天前
C#字符串拼接的几种方式及其性能分析对比
【.net】·【c#】·【.net core】·【拾遗补漏】
追逐时光者3 天前
一个.NET开源、易于使用的屏幕录制工具
【.net】·【开源项目】
追逐时光者4 天前
好消息,在 Visual Studio 中可以免费使用 GitHub Copilot 了!
【visual studio】·【.net】·【c#】·【实用工具】·【ai编程】
追逐时光者5 天前
基于.NET WinForm开发的一款硬件及协议通讯工具
【.net】·【开源项目】·【winform】
追逐时光者6 天前
一款基于 .NET MVC 框架开发、功能全面的MES系统
【.net】·【c#】·【开源项目】·【.net core】
追逐时光者7 天前
C#/.NET/.NET Core技术前沿周刊 | 第 17 期(2024年12.09-12.15)
【.net】·【c#】·【.net core】·【技术前沿周刊】
追逐时光者8 天前
C#正则表达式快速入门
【.net】·【c#】·【.net core】·【拾遗补漏】
追逐时光者12 天前
一套以用户体验出发的.NET8 Web开源框架
【.net】·【c#】·【开源项目】·【.net core】