天气变量填充功能使用说明
气象变量填充是U-Push高级功能，使用前请务必联系友盟在线客服或商务开通此功能，否则集成后也无法下发；
此功能只能通过API进行下发；
功能介绍
气象数据是消息推送中非常重要的参数，为了便于客户更方便地使用气象数据进行推送，友盟+消息推送U-Push推出了气象变量填充的功能。即运营人员在创建通知消息的内容时，只需在内容中增加气象变量参数，等通知消息下发到设备时，友盟服务端会根据此设备的IP地址查询所在地最新的气象数据，这样C端用户接收消息时看到的就是自己周围真实的气象数据。
使用方法
第一步，友盟技术同学开通权限
第二步，需要在调用API时，将 context_variable_fill 设置为 true（详见下方示例）
第三步，创建文案+ $${forecast} 或 $${scene}文案
第四步，监测数据
气象变量内容
气象变量名称 | 气象变量包含参数 | 通知内容填写示例 | C端用户接收消息示例 |
$${scene} | 根据所在地当天的温度范围、是否有特殊气象会填充不同的文案，文案填充影响参数和以下相关： 1.当天最高温度范围：例如最高温度在20°~30°之间 2.当天相比昨天是否有降温/升温情况：例如降温5度、降温10度、升温5度、升温10度 3.是否有极端天气及极端天气具体等级：例如大风、降水、暴雨、暴雪、高温、雾霾 4.是否有特殊生活情况：例如易发感冒、风寒、过敏 友盟侧会综合参考以上情况，填充具体的天气信息，具体填充文案详情请见附录 | $${scene}，点击签到>> | 1.比昨日降温10度，请穿厚衣物注意防寒保暖！点击签到>> 2.橙色预警，大风来袭！请注意防护！点击签到>> 3.暴雪黄色预警，注意保暖防滑！点击签到>> 4.剧烈降温易得风寒，注意添衣保暖！点击签到>> |
$${forecast} | 此气象变量由以下三个参数构成： 1.气象现象：阴/晴/多云/有雨/有雪 2.温度范围：最低温度~最高温度 3.空气质量：优/良/严重污染/重度污染/中度污染/轻度污染 | 今日气象$${forecast}，点击进行每日签到>> | 今日气象晴，28°C~35°C，空气质量优，点击进行每日签到>> |
1.多个气象变量之间可以自由排列组合，例如通知内容传递“今日气象$${forecast}，$${scene}，点击签到>>”，那么友盟会填充2种变量，C端用户收到的文案可能是“今日气象晴，28°C~35°C，空气质量优，比昨日降温10度，请穿厚衣物注意防寒保暖！点击签到>>”；
2.目前气象变量的具体参数由友盟固定填充，如果您希望可以修改填充的参数，请联系友盟。
使用方式
API调用
您需要在调用API时，将context_variable_fill设置为true,并且在通知内容内传入气象变量如$${forecast}或者$${scene}
安卓API示例：
{
"appkey":"xx",
"timestamp":"xx",
"payload":{
"display_type":"xx",
"body":{
"title":"xx",
"text":"xx", // 通知内容，如果包含了天气变量如$${forecast}或者$${scene}，友盟会自动填充具体天气数据
},
"policy":{
"context_variable_fill":true ,// 表示是否需要变量填充，传入true并且通知内容里包含天气变量时，友盟服务端才会填充具体天气数据
"start_time":"xx",
"expire_time":"xx",
}
}
iOSAPI示例：
{
"appkey":"xx",
"timestamp":"xx",
"payload":{
"aps":{
"alert":""或者{
"title":"title",
"subtitle":"subtitle",
"body":"body"// 通知内容，如果包含了天气变量如$${forecast}或者$${scene}，友盟会自动填充具体天气数据
}
},
},
...
"policy":{
"context_variable_fill":true ,// 表示是否需要变量填充，传入true并且通知内容里包含天气变量时，友盟服务端才会填充具体天气数据
"start_time":"xx",
"expire_time":"xx"
}
}边界说明
1.只支持API发送，Push产品后台暂时不支持传递气象变量消息
2.支持广播、组播、单播等全部发送类型
3.支持立即推送、定时推送方式，因气象数据对时效性要求较高，为保证数据准确性，气象数据的消息有效期建议设置成1天
4.如果您通过API发送时通知内容处传入了气象变量，在Portal后台推送记录页面，查看此条消息的推送详情页面：通知内容模块显示的是气象变量名称而不是真实气象文案。
例如通知内容是： 早上好，今日气象$${forecast}，点击进行签到>>
5.特殊情况：如果发生了IP解析地域失败，或者气象变量填充失败，v2.0期服务端会不填充变量内容，直接下发剩余文案
6.如果您传入了气象变量，那么消息就不支持撤回，如果您有此需求请向我们反馈
7.如果采用友盟的默认样式，在部分机型上通知内容只会展示一行，气象有关文案会展示不全，因此建议您采取自定义通知样式，把text放在长文本字段里，这样会展示全部通知内容
附录
以下是气象变量$${scene}具体文案填充逻辑：
当日最高温度范围 | 温度变化范围 | 特殊天气及等级 | 填充具体文案 |
-50°<=温度<0° | 5°<=比昨日下降温度<10° | -- | 比昨日降温x度，请穿厚衣物注意防寒保暖！ |
10°<=比昨日下降温度<20° | -- | 极寒来袭，降温超过10度，注意保暖！ | |
5°<=比昨日上升温度<10° | -- | 气温稍微回暖，注意适当保暖！ | |
10°<=比昨日上升温度<20° | -- | 升温超过10度以上，注意适时调整穿衣！ | |
0°<= 温度<10° | 5°<=比昨日下降温度<10° | -- | 比昨日降温x度，请穿厚衣物注意防寒保暖！ |
10°<=比昨日下降温度<20° | -- | 降温超过10度，请穿厚衣物注意防寒保暖！ | |
5°<=比昨日上升温度<10° | -- | 气温稍微回暖，注意适当保暖！ | |
10°<=比昨日上升温度<20° | -- | 气温大幅回暖，升温超过10度以上，注意适时调整穿衣！ | |
10°<= 温度<20° | 5°<=比昨日下降温度<10° | -- | 降温x度，适当添衣物哦 |
10°<=比昨日下降温度<20° | -- | 温度骤降10度以上，注意适当保暖！ | |
5°<=比昨日上升温度<10° | -- | 天气升温，注意适时调整穿衣！ | |
10°<=比昨日上升温度<20° | -- | 气温大幅回暖，注意适时调整穿衣！ | |
20°<= 温度<30° | 5°<=比昨日下降温度<10° | -- | 降温X度，注意调整穿衣！ |
10°<=比昨日下降温度<20° | -- | 气温骤降超过10°C，享受宜人天气！ | |
5°<=比昨日上升温度<10° | -- | 天气升温，注意适时调整穿衣！ | |
10°<=比昨日上升温度<20° | -- | 天热升级，升温超10°C。请做好防晒！ | |
温度>=30° | 5°<=比昨日下降温度<10° | -- | 降温X度，享受舒适气候！ |
10°<=比昨日下降温度<20° | -- | 降温超过10度，享受舒适气候！ | |
5°<=比昨日下降温度<10° | -- | 酷热来袭，温度升5°C。请做好防暑措施！ | |
10°<=比昨日上升温度<20° | -- | 酷热来袭，温度飙升超10°C。请做好防暑措施！ | |
-50°<=温度<10° | -- | 大风-蓝色预警 | 风大寒冷，请穿厚衣物注意保暖 |
所有温度 | 大风-黄色预警 | 风大寒冷，请穿厚衣物注意保暖 | |
橙色预警，大风来袭！请注意防护！ | |||
红色预警！大风来袭！请减少户外活动 | |||
小雨绵绵，请备好雨具！ | |||
出门记得带伞哦 | |||
大雨来袭！出门记得带伞！ | |||
暴雨来袭，注意外出安全 | |||
大暴雨来袭，注意外出安全 | |||
特大暴雨来袭，注意外出安全 | |||
暴雨蓝色预警！注意外出安全 | |||
暴雨黄色预警！注意外出安全 | |||
暴雨橙色预警！注意外出安全 | |||
暴雨红色预警！注意外出安全 | |||
暴雪蓝色预警，注意保暖防滑！ | |||
暴雪黄色预警，注意保暖防滑！ | |||
暴雪橙色预警，注意保暖防滑！ | |||
暴雪红色预警，注意保暖防滑！ | |||
寒潮蓝色预警，注意保暖防寒！ | |||
寒潮黄色预警，注意保暖防寒！ | |||
寒潮橙色预警，注意保暖防寒！ | |||
寒潮红色预警，严防冻伤！ | |||
高温蓝色预警，注意防晒防暑！ | |||
高温黄色预警，注意防晒防暑！ | |||
高温橙色预警，注意防晒防暑！ | |||
高温红色预警，注意防晒防暑！ | |||
中度雾霾，请佩戴口罩！ | |||
重度雾霾，请减少外出！ | |||
雾霾严重，请减少外出！ | |||
近期过敏高发，请注意防护！ | |||
2°<=比昨日下降温度<5° | 风寒-极易发 | 降温易得风寒，注意添衣保暖！ | |
5°<=比昨日下降温度<10° | 风寒-极易发 | 大幅降温易得风寒，注意添衣保暖！ | |
10°<=比昨日下降温度<20° | 风寒-极易发 | 剧烈降温易得风寒，注意添衣保暖！ | |
2°<=比昨日下降温度<5° | 感冒-极易发 | 降温易感冒，注意添衣保暖！ | |
5°<=比昨日下降温度<10° | 感冒-极易发 | 大幅降温易得感冒，注意添衣保暖！ | |
10°<=比昨日下降温度<20° | 感冒-极易发 | 剧烈降温易得感冒，注意添衣保暖！ |