全部产品
云市场

景区NPS(舆情分析)

更新时间:2019-11-25 14:49:37

1、服务介绍

1.1 概述

景区NPS:Net Promoter Score,净推荐值,又称净促进者得分,亦可称口碑,是一种计量某个客户将会向其他人推荐某个企业或服务可能性的指数。它是最流行的顾客忠诚度分析指标,专注于顾客口碑如何影响企业成长。

大型景区管理者或者运营方,希望能够对于景区长期口碑以及二次旅游等有一定的诉求,能够持续提升景区和营收。景区NPS基于景区售票平台满意度、景区现场实时互动屏、社交媒体评论指数、景区人工售票窗口、离景区后主动调研满意度、人群特征等数据,针对景区整体满意度进行评估。

1.2 接口及售卖维度

模块 售卖细分维度 数据输出 包含指标与定义说明
数据质量监测 实时小时/日/周/月级别(默认T-1天数据)
- 累计记录数
- 异常值(空值)累计数
- 物理存储值
所有数据源采集情况说明,便于检查数据来源异常
实时舆情分析 实时小时/日/周/月级别(默认T-1天数据) 反馈总数
实时小时/日/周/月级别(默认T-1天数据) NPS值
实时小时/日/周/月级别(默认T-1天数据) 正负比例
实时小时/日/周/月级别(默认T-1天数据) 政府TOP关键字(10/50/100三个规格)
实时舆情游客画像 不同性别游客的NPS值
不同年龄游客的NPS值
舆情处理策略 餐饮满意度提升策略
交通满意度提升策略
环境满意度提升策略
安防拥挤满意度提升策略

2、接入指南

2.1 API说明

统计数据查询接口,所有文旅相关的统计查询都是用这一个接口,根据model查询不同的统计数据。

Path 版本 是否登录
/tourism/statistics/query 1.0.0

入参

参数名 数据类型 是否必填 参数描述
projectId String Y 项目Id
model String Y 模型名称,具体模型名称参考对照表
paramJson String N json格式

paramJson根据模型需要传相应的参数(具体参数见模型示例),可用参数如下:

参数名 数据类型 是否必填 参数描述
startTime String N 开始时间(>=,包含该时间)
endTime String N 结束时间(<,不包含该时间)
size Integer N 数据topN条数

出参

参数名 数据类型 参数描述
code Int 错误码,code=200表示正确,其他表示错误
message String 结果信息,正确为success,错误的时候是错误提示
data JSONObject 结果数据
-series JSONArray 结果数据系列集合,可以理解为多个数据列,每个系列代表一列数据
—name String 数据系列名称
—values JSONArray 数据系列值的集合

2.2 API调用方式

SDK依赖

本例提供java sdk pom依赖示例,更多语言SDK详情请参考API调用对接指引

  1. <dependency>
  2. <groupId>com.aliyun.api.gateway</groupId>
  3. <artifactId>sdk-core-java</artifactId>
  4. <version>1.6.0.3</version>
  5. </dependency>

示例代码

  1. HttpClientBuilderParams builderParams = new HttpClientBuilderParams();
  2. builderParams.setAppKey("${appKey}"); // 请填写正确的AppKey
  3. builderParams.setAppSecret("${appSecret}"); // 请填写正确的AppSecret
  4. ApacheHttpClient apacheHttpClient = new ApacheHttpClient(builderParams);
  5. IoTApiRequest request = new IoTApiRequest();
  6. //设置api的版本
  7. request.setApiVer("1.0.0");
  8. //如果需要登陆,设置当前的会话的token
  9. //设置参数
  10. request.putParam("model", "xxxxxx");
  11. request.putParam("projectId", "yyyyy");
  12. Map<String, Object> param = new HashMap<>(8);
  13. param.put("startTime", "2019-01-01");
  14. param.put("endTime", "2019-01-31");
  15. param.put("limit", 10);
  16. request.putParam("paramJson", JSONObject.toJSONString(param));
  17. //请求参数域名、path、request
  18. String host = "api.link.aliyun.com";
  19. String path = "/tourism/statistics/query";
  20. System.out.println(JSON.toJSONString(request));
  21. ApiRequest apiRequest = new ApiRequest(HttpScheme.HTTP, host,
  22. HttpMethod.POST_BODY, path, JSON.toJSONBytes(request));
  23. apiRequest.setHttpConnectionMode(HttpConnectionModel.MULTIPLE_CONNECTION);
  24. ApiResponse response = apacheHttpClient.sendSyncRequest(apiRequest);
  25. System.out.println(request.getId());
  26. System.out.println(
  27. "response code = " + response.getCode() + " response message = " + response.getMessage()
  28. + " response content = " + new String(response.getBody(),
  29. "utf-8"));

2.3 模型示例

数据质量监测

model:TRIP_DATA_QUALITY
对游客购票数据、游客闸机数据等使用到的数据质量的监测,包含数据总条数、空值条数、占用存储空间大小。数据质量

入参

  1. {
  2. "model": "TRIP_DATA_QUALITY",
  3. "projectId": "a124DRzr6OWgL4QT",
  4. "paramJson":"{\"startTime\":\"2019-09-09\",\"endTime\":\"2019-10-09\"}
  5. }

出参

  1. {
  2. "code": 200,
  3. "data": {
  4. "series": [{
  5. "values": ["20"],
  6. "name": "总条数"
  7. }, {
  8. "values": ["5"],
  9. "name": "存储空间"
  10. }, {
  11. "values": ["4"],
  12. "name": "空值条数"
  13. }]
  14. },
  15. "message": "success"
  16. }

NPS舆情智能预警

model:NPS_INTEL_PREDICTION_INFO

类型 预警描述
负面 客户满意度低,请关注重点负面舆情,及时处理。
正面 客户满意度高,请关注重点正面反馈,进一步宣传。

入参

  1. {
  2. "model": "NPS_INTEL_PREDICTION_INFO",
  3. "projectId": "a124KKWfyglJF5rD"
  4. }

出参

  1. {
  2. "id": "ec008f50-1b50-4318-b95f-28bb4d8a794c",
  3. "code": 200,
  4. "message": null,
  5. "localizedMsg": null,
  6. "data": {
  7. "series": [
  8. {
  9. "values": [
  10. "客户满意度高,请关注重点正面反馈,进一步宣传。"
  11. ],
  12. "name": "餐饮信息"
  13. }
  14. ]
  15. }
  16. }

实时景区NPS

nps

入参

  1. {
  2. "model": "TRIP_NPS_BY_DAY",
  3. "projectId": "a124KKWfyglJF5rD",
  4. "paramJson":"{\"startTime\":\"2019-10-02\",\"endTime\":\"2019-10-09\"}"
  5. }

出参

  1. {
  2. "code": 200,
  3. "data": {
  4. "series": [{
  5. "values": ["2019-10-02", "2019-10-03", "2019-10-04", "2019-10-05", "2019-10-06", "2019-10-07", "2019-10-08"],
  6. "name": "时间"
  7. }, {
  8. "values": ["5", "6", "6", "7", "6", "7", "5"],
  9. "name": "人数"
  10. }]
  11. },
  12. "message": "success"
  13. }

正负评论

model:TRIP_NPS_BY_DAY
正负比例

入参

  1. {
  2. "model": "TRIP_NPS_RATE",
  3. "projectId": "a124KKWfyglJF5rD",
  4. "paramJson":"{\"startTime\":\"2019-10-02\",\"endTime\":\"2019-10-09\"}"
  5. }

出参

  1. {
  2. "code": 200,
  3. "data": {
  4. "series": [{
  5. "values": ["2019-10-02", "2019-10-03", "2019-10-04", "2019-10-05", "2019-10-06", "2019-10-07", "2019-10-08"],
  6. "name": "时间"
  7. }, {
  8. "values": ["5", "6", "6", "7", "6", "7", "5"],
  9. "name": "人数"
  10. }]
  11. },
  12. "message": "success"
  13. }

正面评价关键词

model:TRIP_NPS_KEYS

入参

  1. {
  2. "model": "TRIP_NPS_KEYS",
  3. "projectId": "a124KKWfyglJF5rD",
  4. "paramJson":"{\"startTime\":\"2019-10-08\",\"endTime\":\"2019-10-09\",\"size\":10,\"rateType\":\"1\"}"
  5. }

出参

  1. {
  2. "code": 200,
  3. "data": {
  4. "series": [{
  5. "values": ["10", "9", "8", "7", "6"],
  6. "name": "评价个数"
  7. }, {
  8. "values": ["人挺不多", "停车方便", "排队时间不长", "挺干净", "下次还来"],
  9. "name": "关键词"
  10. }]
  11. },
  12. "message": "success"
  13. }

负面评价关键词

model:TRIP_NPS_KEYS

入参

  1. {
  2. "model": "TRIP_NPS_KEYS",
  3. "projectId": "a124KKWfyglJF5rD",
  4. "paramJson":"{\"startTime\":\"2019-10-08\",\"endTime\":\"2019-10-09\",\"size\":10,\"rateType\":\"2\"}"
  5. }

出参

  1. {
  2. "code": 200,
  3. "data": {
  4. "series": [{
  5. "values": ["10", "9", "8", "7", "6"],
  6. "name": "评价个数"
  7. }, {
  8. "values": ["人挺多", "停车不方便", "排队时间太长", "环境一般", "吃饭贵"],
  9. "name": "关键词"
  10. }]
  11. },
  12. "message": "success"
  13. }