场景推荐规则

更新时间:2024-06-20 04:22:09下载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 场景推荐

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

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

若您配置的净化器推荐场景的执行动作功能点为 mode=开启节电模式,而用户购买的设备,您在涂鸦开发者平台产品功能点设置中未设置 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