场景推荐规则

更新时间:2022-09-14 04:11:02下载pdf

App 版本和其他前置条件

版本要求

  • 如果使用 OEM App 或 OEM App SDK 服务,则需要达到 v3.16.0(约为 2020 年之前的版本)及以上的版本,才能使用场景推荐。
  • 如果是定制版本 App,则需要定制的内容须包含场景推荐的配置服务平台和推荐算法部分,才能使用场景推荐服务。

多语言要求

推荐的场景需要配置 App 的当前语种。若用户 App 当前的系统语言为法语,则场景推荐的多语言也需要配置法语,用户才能收到推荐的场景。

智能产品的配置要求

平台默认您创建产品的全部功能点均可作为场景执行动作。若您没更改过此项,则可跳过阅读此项。

场景联动设置中,将推荐场景所需要的产品功能点设置为场景联动。关于如何设置场景联动,请参考 配置场景联动

举例
若场景推荐配置的执行动作功能点为 功能点mode=smart,但是您在产品开发过程中,在 场景联动设置 中的 场景执行任务设置 没有勾选 Mode 作为场景执行动作,则用户无法收到这个推荐。

用户 App 授权要求

  • 如果推荐场景采用天气相关条件作为触发条件,例如室外温度、室外湿度、室外风速、天气(如晴天、阴天等)、室外 PM2.5、室外空气质量、日出日落等,需要用户开启定位并且授权 App 定位权限,否则推荐无法到达用户。
  • 如果推荐场景采用地理位置相关条件作为触发条件,例如到达或离开、家人回家等,需要用户开启定位并且授权定位权限,否则推荐无法到达用户。

推荐数量限制

目前,场景推荐可以在自动化和一键执行中同时出现,两种类型的推荐总数不超过 10 个。

场景匹配规则:用户接收设备相关的场景规则

用户是否已配网添加场景推荐内品类的设备

设备离线不会影响场景推荐和添加。

  • 如果您配置的场景推荐是基于产品类目,则用户配网的设备类目只需要属于您配置的产品类目即可。

  • 如果您配置的场景推荐是基于产品编号,涂鸦工作人员与您沟通时可能会称为 PID,那用户必须要配网这个产品的设备,才能接收到您配置的场景推荐。

    关于配置方式,请参考 OEM App 场景推荐

已配网的产品,是否已经设置全部产品功能点

对于用户已配网的产品,您是否在涂鸦 IoT 开发平台设置并选择了场景推荐所配置的全部产品功能点。涂鸦工作人员与您沟通的时候可能会习惯称为 data point(DP)。

若您配置的净化器推荐场景的执行动作功能点为 mode=开启节电模式,而用户购买的设备,您在涂鸦 IoT 开发平台产品功能点设置中未设置 mode 这一功能点,则用户无法收到推荐。更多详情,请参考 创建产品功能

用户是否添加或使用过类似场景

场景推荐是用于引导用户应用推荐的场景。若用户已经添加过相同条件和动作的场景,则无法收到推荐,即使场景已经被删除。

用户是否对类似场景标记不感兴趣

  • 请注意,用户把类似场景标记为不感兴趣后,与场景条件和动作完全相同的场景则不再推荐。

  • 场景内设置的数值或参数不影响推荐的判断。
    例如:用户如果有操作如下场景不感兴趣:若室外温度 > 30℃,则空调执行 switch=1 and mode=cold。 用户无法收到以下场景推荐:若室外温度 > 20℃,则空调执行 switch=1 and mode=auto。因为这两个场景的条件和动作完全相同,仅预设值不同。但用户仍然收到以下场景推荐:若室外温度 < 20℃,则空调执行 switch=1 and mode=auto。若室外温度 > 30℃,则空调执行 switch=0

    因为前一个场景的条件判断不同,后一个场景的执行动作不同。

用户对于某个场景是否已经达到推荐疲劳

场景在推荐分发时会经过策略过滤。依据我们目前的策略,单个场景推荐时会判断该场景:

  • 一级策略(receive 次数 ≤ 500),如果符合则直接推荐,如果不符合则进入二级判断。
  • 二级策略(500 < receive 次数 ≤ 1500 并且反馈率 ≥ 0.01),其中反馈率 = (用户添加次数 + 删除次数)÷ 总推荐曝光次数。如果符合则可以推荐,如果不符合则进入三级策略判断。
  • 三级策略(receive 次数 > 1500 并且喜欢添加率 ≥ 0.005),其中喜欢添加率 = 添加次数 ÷ 总推荐曝光次数。如果符合则可以推荐,如果不符合则结束推荐。

如果这 3 级策略都不符合,我们认为该场景对该用户不具备价值,因此会直接过滤。

如果您对推荐规则有任何疑问,可通过下述方式联系我们:

  • 服务邮箱:service@tuya.com
  • 服务电话:
    • 中国大陆的客户可致电:4008818611
    • 中国大陆以外的客户可致电:1-8446725646