Git Product home page Git Product logo

laravel-getui's Introduction

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

开发前的准备

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

安装拓展

1、运行如下代码安装拓展包：

composer require "earnp/getui:dev-master"

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

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

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

服务注入以后，如果要使用自定义的配置，还可以发布配置文件到config目录：

php artisan vendor:publish

其他接口

获取单日用户数据

Getui::getUserDataByDate($date);

请求参数date,查询的日期（格式：yyyyMMdd）,比如：20170525
返回参数：

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

获取单日推送数据

Getui::getPushDataByDate($date);

请求参数date,查询的日期（格式：yyyyMMdd）,比如：20170525

返回参数：

[
  "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

查询用户状态

Getui::getUserStatus($CID);

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

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

获取推送状态

Getui::getPushMessageResult($taskId);

请求参数taskId,发送任务的taskId，在Push返回中获取
返回参数：

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

通过标签获取用户总数

Getui::getUserCountByTags($tagList);

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

返回参数：

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

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

Getui::getPersonaTags();

返回参数：

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

消息模板

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

IGtNotificationTemplate
$config配置信息如下

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

点击通知打开网页模板

IGtLinkTemplate

$config配置信息如下：

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

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

IGtNotyPopLoadTemplate
$config配置信息如下：

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

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

IGtTransmissionTemplate
$config配置信息如下

参数 类型 说明
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

返回参数:

[
  "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

返回参数:

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

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

对指定应用群推消息

// 模版选择
$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为发送给用户组的条件筛选

返回参数:

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

应用场景：
1、对全部APP的用户推送消息
2、对某个城市的人推送消息
3、对某个年龄的人推送消息

推送接口模式

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

laravel-getui's People

Contributors

lusongcn avatar

Stargazers

avatar avatar avatar avatar avatar avatar avatar avatar

Watchers

avatar

Forkers

zhanzhaopeng1 juckknife songcijohn nineyang hadeswang2016

laravel-getui's Issues

Class 'Earnp\Getui\GetuiServiceprovider' not found

{
"name": "earnp/getui",
"description": "getui for laravel",
"authors": [
{
"name": "lusong",
"email": "[email protected]",
"url": "https://phpartisan.cn"
}
],
"license": "MIT",
"minimum-stability": "dev",
"require": {},
"autoload": {
"psr-4": {
"Earnp\Contact\":"src/"
}
}
}

也许是这里有问题:)

Class 'Earnp\Getui\AppConditions' not found

//群发
public function msgTemplateToApp(){
$rules = [
'template' => 'required',
'data' => 'required',
'config' => 'required',
'choice' => 'required'
];
if ($error = $this->validateInput($rules)) {
return $error;
}
/* $template = "IGtNotificationTemplate";
$data = "a";
$config = array("type" => "HIGH", "title" => "你有一条新消息", "body" => "你有一个3000元的订单需要申请", "logo" => "", "logourl" => "");
$CID = "3eb2606cfa2f3c8172e6699bde3db7aa"; */
$template = $this->validated['template'];
$data = $this->validated['data'];
$config = $this->validated['config'];
$choice = $this->validated['choice'];
$test = Getui::pushMessageToApp($template, $config, $data, $choice);
#$array['data'] = $test;
return $this->successData($test);
}

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.