2017 © Pedro Peláez
 

library getui

Laravel 5 Getui Package

image

zhanzhaopeng1/getui

Laravel 5 Getui Package

  • Thursday, November 23, 2017
  • by zhanzhaopeng1
  • Repository
  • 0 Watchers
  • 1 Stars
  • 5 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 5 Forks
  • 0 Open issues
  • 3 Versions
  • 0 % Grown

The README.md

个推是国内领先的推送技术服务商,提供安卓(Android)和iOS推送SDK,为APP开发者提供高效稳定推送技术服务; 每个APP都需要推送,在做后端的时候,我们肯定是需要个推来实现对APP推送消息,个推的使用功能特别多,如果自己单独去开发,一定浪费大量的时间,所以我集成了Laravel个推拓展,方便大家学习使用, (*1)

开发前的准备

  1. 安装Laravel
  2. 申请个推APPKEY,APPID,MASTERSECRET等
  3. 有一个自己的测试CID,问APP开发人员要吧

安装拓展

1、运行如下代码安装拓展包:, (*2)

composer require "zhanzhaopeng1/getui:dev-master"

3.等待下载安装完成,需要在config/app.php中注册服务提供者同时注册下相应门面:, (*3)

'providers' => [
    //........
    Earnp\Getui\GetuiServiceprovider::class,
],

'aliases' => [
     //..........
    'Getui'     => Earnp\Getui\Facades\Getui::class,
],

服务注入以后,如果要使用自定义的配置,还可以发布配置文件到config目录:, (*4)

php artisan vendor:publish

其他接口

获取单日用户数据

Getui::getUserDataByDate($date);

请求参数date,查询的日期(格式:yyyyMMdd),比如:20170525
返回参数:, (*5)

[
  "result" => "Success",
  "data" => [
  // 新注册用户数
  "newRegistCount" => 512,
  // 累计注册用户数
  "registTotalCount" => 14349,
  // 活跃用户数
  "activeCount" => 1544,
  // 在线用户数
  "onlineCount" => 55,
  "appId" => "",
  "date" => "20170726",
  ]
]

获取单日推送数据

Getui::getPushDataByDate($date);

请求参数date,查询的日期(格式:yyyyMMdd),比如:20170525, (*6)

返回参数:, (*7)

[
  "result" => "ok",
  "data" => [
    "appId" => "",
    "date" => "20170726",
    // 发送总数
    "sendCount" => 255,
    // 在线发送数
    "sendOnlineCount" => 140,
    // 接收数
    "receiveCount" => 138,
    // 展示数
    "showCount" => 25,
    // 点击数
    "clickCount" => 12,
  ],
  "GT" => "{"sent":140,"feedback":138,"displayed":25,"clicked":12}"
]

停止任务接口

Getui::stopPushTask($taskId);

请求参数taskId,发送任务的taskId,在Push返回中获取
返回参数:true,false, (*8)

查询用户状态

Getui::getUserStatus($CID);

请求参数CID,用户唯一标识符,默认查询的是config/getui.php文件中的CID, (*9)

[
  // 是否在线,Offline代表不在线,Online代表在线
  "result" => "Offline",
  // 最后登陆时间
  "lastLogin" => 1501142220930,
  "isblack" => false,
]

获取推送状态

Getui::getPushMessageResult($taskId);

请求参数taskId,发送任务的taskId,在Push返回中获取
返回参数:, (*10)

[
  "result" => "ok",
  "taskId" => "OSS-0728_071043065bcecc3a129937763b2309cd"
]

通过标签获取用户总数

Getui::getUserCountByTags($tagList);

请求参数tagList,标签列表Array,比如:array("laravel","php"), (*11)

返回参数:, (*12)

[
  "result" => "Success",
  "appId" => "",
  "tagCount" => [],
]

大数据综合分析用户得到的标签:即用户画像

Getui::getPersonaTags();

返回参数:, (*13)

[
  "result" => "Success",
  "tags" => []
]

消息模板

点击通知打开应用模板,可传递参数

IGtNotificationTemplate
$config配置信息如下, (*14)

参数 类型 说明
type str HIGH/SIMPLE SIMPLE代表简单模版,HIGH代表高级模版
title str HIGH模版使用,消息标题
body str 消息内容
logo str logo
logourl str logo地址

点击通知打开网页模板

IGtLinkTemplate, (*15)

$config配置信息如下:, (*16)

参数 类型 说明
title str 消息标题
body str 消息内容
logo str logo
logourl str logo地址
url str url代表当点击弹窗跳转到的网址

点击通知弹窗下载模板(iOS 不支持使用该模板)

IGtNotyPopLoadTemplate
$config配置信息如下:, (*17)

参数 类型 说明
type str notice/bomb/download notice代表通知栏,bomb代表弹框,download代表下载
title str 消息标题
body str 消息内容
logo str logo
loadurl str loadurl代表当使用download模版时的下载地址

透传消息模版,可传递参数

IGtTransmissionTemplate
$config配置信息如下, (*18)

参数 类型 说明
type str HIGH/SIMPLE SIMPLE代表简单模版,HIGH代表高级模版
title str HIGH模版使用,消息标题
body str 消息内容
logo str logo
logourl str logo地址

消息推送方式

对单个用户推送消息

$template = "IGtTransmissionTemplate";
$data = "a";
$config = array("type" => "HIGH", "title" => "你有一条新消息", "body" => "你有一个3000元的订单需要申请","logo"=>"","logourl"=>"");
$CID = "";
$test = Getui::pushMessageToSingle($template,$config,$data,$CID);

参数说明:
$template代表上一步的消息模板
$data代表您推送的内容,具体询问APP开发人员,一般为JSON格式,如果只是普通的发送消息随意填写
$config参考模版所需内容,这里使用透传为例
$CID为发送给某人具体CID,默认为config/getui.php中的测试CID, (*19)

返回参数:, (*20)

[
  "result" => "ok",
  "taskId" => "OSS-0728_071043065bcecc3a129937763b2309cd",
  "status" => "successed_offline",
]

对指定列表用户推送消息

$template = "IGtTransmissionTemplate";
$data = "a";
$config = array("type" => "HIGH", "title" => "你有一条新消息", "body" => "你有一个3000元的订单需要申请","logo"=>"","logourl"=>"");
$CID = "";
$test = Getui::pushMessageToList($template,$config,$data,$CID);

参数说明:
$template代表上一步的消息模板
$data代表您推送的内容,具体询问APP开发人员,一般为JSON格式,如果只是普通的发送消息随意填写
$config参考模版所需内容,这里使用透传为例
$CID为发送给用户组的CID(列表模式),默认为config/getui.php中的测试CID, (*21)

返回参数:, (*22)

[
  "result" => "ok"
  "contentId" => "OSL-0728_hLKYR4tmkC7S0lI7QnSTT"
]

应用场景:
场景1,对于抽奖活动的应用,需要对已知的某些用户推送中奖消息,就可以通过ClientID列表方式推送消息。
场景2,向新客用户发放抵用券,提升新客的转化率,就可以事先提取新客列表,将消息指定发送给这部分指定CID用户。, (*23)

对指定应用群推消息

// 模版选择
$template = "IGtTransmissionTemplate";
// 发送内容
$data = "IGtTransmissionTemplate";
// 条件选择
$choice = array(
        // 发送手机类型
        "phoneTypeList"=>["ANDROID","IPHONE","IPAD"],
        // 发送城市
        "provinceList"=>["北京","上海"],
        // 标签选择,为空即可
        "tagList"=>["标签"],
        // 年龄选择
        "age"=>["10","11"]
    );
$config = array("type" => "HIGH", "title" => "你有一条新消息", "body" => "APP更新了哦,快去看看吧","logo"=>"","logourl"=>"");
$test = Getui::pushMessageToApp($template,$config,$data,$choice);

参数说明:
$template代表上一步的消息模板
$data代表您推送的内容,具体询问APP开发人员,一般为JSON格式,如果只是普通的发送消息随意填写
$config参考模版所需内容,这里使用透传为例
$choice为发送给用户组的条件筛选, (*24)

返回参数:, (*25)

[
  "result" => "ok"
  "contentId" => "OSL-0728_hLKYR4tmkC7S0lI7QnSTT"
]

应用场景:
1、对全部APP的用户推送消息
2、对某个城市的人推送消息
3、对某个年龄的人推送消息, (*26)

推送接口模式

推送接口包括https模式和http模式 更改只需要修改config/getui.php中的HTTPS参数,true代表为Https推送接口,false代表为Http推送接口,默认为Http请求, (*27)

The Versions

23/11 2017

dev-master

9999999-dev

Laravel 5 Getui Package

  Sources   Download

MIT

23/11 2017

1.1

1.1.0.0

Laravel 5 Getui Package

  Sources   Download

MIT

28/07 2017

v1.0

1.0.0.0

getui for laravel

  Sources   Download

MIT