Demote media recommendations

When you use media recommendations, you can demote recommendations based on viewer data or content age. Recommendations that meet the demotion criteria that you specify are demoted to the bottom of the results list. This feature is available only for media recommendations, not generic recommendations or search.

Demotion is set on the serving config level. You can have multiple serving configs per media recommendations app, each with a different demotion setting. For more information about serving configs, see Create and manage serving configs.

Demote based on viewer data

You can demote recommendations based on how an end user has recently interacted with the recommended content.

If your recommended content has a detail page, then you can demote it if the user has recently viewed it. If your content is playable media, then you can demote it depending on the amount of time the user played it or the percentage of the content that the user played.

To demote recommendations based on viewer data:

  1. In the Google Cloud console, go to the Agent Builder page.

    Agent Builder

  2. Click the name of the app that you want to configure recommendations for.

  3. Go to the Configurations > Serving tab.

  4. If you have more than one serving config, select the serving config that you plan to set demotion for.

  5. In the Recommendation demotion section, turn on the Demote recommendations based on viewer data toggle to see the available demotion options.

  6. Select your demotion option and, if prompted, enter a threshold value for when to trigger demotion.

  7. Click Save and publish.

Demote based on content age

You can demote playable content based on its age. You set the age threshold in days, and any content that reaches that age is demoted to the bottom of the results list.

To demote recommendations based on content age:

  1. In the Google Cloud console, go to the Agent Builder page.

    Agent Builder

  2. Click the name of the app that you want to configure recommendations for.

  3. Go to the Configurations > Serving tab.

  4. If you have more than one serving config, select the serving config that you plan to set demotion for.

  5. In the Recommendation demotion section, turn on the Demote recommendations based on content age toggle.

  6. Enter a content age threshold value for when to trigger demotion.

  7. Click Save and publish.