Scene Recommendation Rules

App version and other prerequisites

Version requirements

• If your app is developed based on the OEM App or OEM App SDK services, the app template version must be v3.16.0 (released about in the year earlier than 2020) or later before scene recommendations can be enabled.
• To apply scene recommendations to customized apps, the scene recommendation configuration service and recommendation algorithm must be customized.

Multilingual requirements

Set the language for scene recommendation in line with the current multilingual settings of the app. For example, if the language of a mobile phone that runs your app is French, the user can receive the recommendations only when the multilingual options for scene recommendations have French configured.

Product configuration

Scene linkage settings must involve all product DPs required by a recommended scene. For more information, see Configure Scene Linkage.

Example:
The DP of a scene action for a recommended scene is mode=smart. However, you do not select Mode as the scene action in the scene task setting when you configure scene linkage during product development. As a result, your app users cannot receive the specified scene recommendations.

App authorization

• If recommended scenes are triggered by weather conditions, such as outdoor temperature, outdoor humidity, outdoor wind speed, weather like sunny and cloudy, outdoor PM2.5, outdoor air quality, sunrise, and sunset, users must enable the location feature and grant location permissions to the app. Otherwise, the users cannot receive the scene recommendations.
• Recommended scenes can also be triggered by geographical conditions, for example, when users arrive at or leave a specific location or when users return home. To enable these scene recommendations, the users must enable the location feature and grant location permissions to the app. Otherwise, the users cannot receive the scene recommendations.

Upper limit of scene recommendations

Currently, scene recommendations support both automation and tap-to-run scenes. The total number of recommendations for both smart scene types cannot exceed 10.

Scene matching rules for reception devices

Pair smart devices required by recommended scenes

Smart scenes can be recommended and added even if respective smart devices go offline.

• If the configured scene recommendations are targeted at a certain product category, the recommendations apply to the users as long as the smart devices paired by the users belong to the specified category.

• If the configured scene recommendations are targeted at a certain product ID (PID), the recommendations apply to the users only when the smart devices associated with the specified PID are paired by the users.

  For more information about how to configure smart scenes, see Scene Recommendation Management.

Configure all DPs required by recommended scenes

To enable scene recommendations for paired devices, you must configure and select all DPs required by recommended scenes on the Tuya Developer Platform.

For example, the DP for the scene action in your recommended scene of an air purifier is mode=energy_saving. However, the smart device configured on the Tuya Developer Platform and purchased by users does not have the DP mode configured. As a result, the users cannot receive the specified scene recommendation. For more information, see Create product functions.

Similar scenes added or used

Scene recommendations are intended to guide users to apply recommended scenes. If users have already added a scene with similar conditions and actions, the users cannot receive similar types of scene recommendations, even after the users have deleted the smart scene.

Similar scenes marked as not interested

The values or parameters set in a scene are not considered in the recommendation.

For example, a user marks the following smart scene as not interested: If the outdoor temperature is more than 30°C, the air conditioner runs the DPs switch=1 and mode=cold. So the user cannot receive the following scene recommendation: If the outdoor temperature is more than 20°C, the air conditioner runs the DPs switch=1 and mode=auto. This is because the conditions and actions of these two smart scenes are the same, except for the preset values.

However, the user can still receive the following scene recommendation: if the outdoor temperature is less 20°C, the air conditioner runs switch=1 and mode=auto. If the outdoor temperature is more than 30°C, the air conditioner runs the DP switch=0. This is because the conditions are different in the former smart scene and the actions are different in the latter smart scene.

Users feel fatigue about a smart scene

Smart scenes are filtered based on certain policies before they are recommended. A single scene is processed with the following three levels of policies:

• Level-1 policy: If the number of times that the scene is received is 500 or less, the scene is recommended. Otherwise, check the scene against the level-2 policy.
• Level-2 policy: If the number of times that the scene is received is more than 500 and less than or equal to 1,500, and the feedback rate is 0.01 or higher, the scene is recommended. Feedback rate = (Number of times that the scene is added + Number of times that the scene is deleted) ÷ Total number of times that the scene is recommended. Otherwise, if the level-2 policy does not apply, check the scene against the level-3 policy.
• Level-3 policy: If the number of times that the scene is received is more than 1,500 and the interested and added rate is 0.005 or higher, the scene is recommended. Interested and added rate = Number of times that the scene is added ÷ Total number of times that the scene is recommended. Otherwise, if the level-3 policy does not apply, the scene is not recommended.

A smart scene that does not meet these three levels of policies will be unnecessary for users and thus be skipped for a recommendation.

If you have any questions about the recommendation rules, please contact Tuya by:

• Service email: service@tuya.com
• Phone call:
  • For customers in mainland China: 4008818611
  • For customers outside mainland China: 1-8446725646