Medienempfehlungen hervorheben und unterdrücken

Auf dieser Seite wird erläutert, wie Sie die Ranking-Position von Media-Empfehlungen ändern, die vom Modell zurückgegeben werden, indem Sie Boost-Bereitstellungssteuerungen (auch als „Steuerungen“ bezeichnet) verwenden.

Mit einer Boost-Steuerung wird die Reihenfolge der Empfehlungen geändert, nachdem sie vom Modell zurückgegeben wurden. Sie wenden einen Filterausdruck auf die Ergebnisse an, um festzulegen, welche Empfehlungen Sie optimieren oder abschwächen möchten, und wenden dann einen Optimierungswert zwischen -1 und +1 an. Ein Steigerungswert von +1 führt zur größten Steigerung einer Empfehlung, die dann ganz oben in den zurückgegebenen Empfehlungen platziert wird. Mit dem Wert -1 wird die Empfehlung vergraben, d. h., sie wird unten in der Liste der zurückgegebenen Empfehlungen angezeigt.

„Steigerung“ ist eine Steuerung zur Bereitstellungszeit. Zuerst gibt das Empfehlungsmodell eine Liste mit Empfehlungen zurück. Mithilfe einer Bereitstellungskonfiguration wird die Boost-Steuerung dann auf diese Liste angewendet, um das Ranking der Empfehlungen anzupassen. Mit der Boost-Funktion werden keine Empfehlungen hinzugefügt oder gelöscht. Sie steuert jedoch die Reihenfolge, in der die Empfehlungen dem Nutzer präsentiert werden.

Empfehlungen hochstufen oder filtern

„Boost“ ist ein weicher Filter. Der reguläre Filter für Empfehlungen, der unter Empfehlungen filtern beschrieben wird, ist ein fester Filter.

Wenn Sie einen harten Filter auf Empfehlungen anwenden, werden die herausgefilterten Dokumente nie angezeigt. Mit einem weichen Filter werden jedoch keine Dokumente aus der Empfehlungsliste entfernt. Stattdessen wird der Filter verwendet, um zu bestimmen, welche Dokumente in der Liste der zurückgegebenen Empfehlungen weiter oben oder weiter unten stehen sollen.

Überlastung des Empfehlungsmodells vermeiden

Wenn Sie einen Filter zum Hervorheben oder Ausblenden anwenden, werden kleine Werte nahe null empfohlen. Werte, die nahe bei +1 oder -1 liegen, überfordern das Empfehlungsmodell wahrscheinlich. Die vom Modell angewendete Empfehlungsrangfolge wird dann nicht in der Reihenfolge wiedergegeben, in der der Nutzer die Empfehlungen sieht.

Wenn Sie beispielsweise animierte Filme mit +1 boosten, sehen Nutzer nur animierte Filme oben in der Empfehlungsliste. Nicht animierte Filme, die vom Modell sehr empfohlen wurden, werden an das Ende der Liste verschoben, wo Nutzer sie möglicherweise nicht sehen.

Herabstufung und Ausblenden

Durch Herabstufen und Ausblenden werden Empfehlungen für Züge an eine niedrigere Position in der Liste der zurückgegebenen Empfehlungen verschoben, als sie sonst angezeigt würden.

Die Herabstufung basiert jedoch auf dem Alter der Inhalte oder darauf, ob sich der Nutzer bereits einige der Inhalte angesehen hat. Weitere Informationen zum Herabstufen finden Sie unter Medienempfehlungen herabstufen.

Ausblenden bezieht sich auf Inhalte, die von einem Filter identifiziert wurden. Der Filter kann ein beliebiges Datenfeld sein, das im Schema als filterbar gekennzeichnet ist. Allgemeine Informationen zu Empfehlungsfiltern, einschließlich der Vorgehensweise zum Markieren eines Felds als filterbar, finden Sie unter Empfehlungen filtern.

Steuerelemente für Kampagnen mit Steigerung und Bereitstellungskonfigurationen

Jede Auslieferungssteuerung für Steigerungen besteht aus einem Filter und einem Steigerungswert. Mit einer Boost-Steuerung werden beispielsweise Filme mit „Weihnachten“ im Titel mit dem Wert 0.1 beworben, während Horrorfilme mit dem Wert -0.2 unterdrückt werden.

Nachdem Sie ein oder mehrere Steuerelemente für die Steigerung erstellt haben, hängen Sie sie an eine Bereitstellungskonfiguration an. Wenn eine Vertex AI Search-Anwendung erstellt wird, wird automatisch auch eine Standardkonfiguration für die Bereitstellung erstellt. Zum Zeitpunkt der Bereitstellung wird auf die Bereitstellungskonfiguration verwiesen, um zu bestimmen, welche Ergebnisse die App generiert. Neben den Steuerelementen für die Steigerung kann die Bereitstellungskonfiguration auch andere Arten von Steuerelementen enthalten, z. B. diversify- und demote-Steuerelemente.

Die Serving-Konfiguration kann angewendet werden, wenn Sie die Methode „recommend“ aufrufen. Alle Einstellungen in der Bereitstellungskonfiguration werden dann auf Empfehlungen angewendet, die vom Methodenaufruf zurückgegeben werden.

Außerdem können Sie Ihrer App mehrere Bereitstellungskonfigurationen zuordnen. So können Sie unter verschiedenen Umständen unterschiedliche Steuerelemente anwenden. Wenn die Empfehlungsanfrage beispielsweise von einem Kinderkonto stammt, sollten Filme in Kategorien, die für Kinder geeignet sind, hervorgehoben und ungeeignete Filme ausgeblendet werden. Wenn die Anfrage von einem Konto stammt, das als „nicht jugendfrei“ gekennzeichnet ist, werden Titel oder Kategorien, die bei Erwachsenen beliebt sind, ebenfalls hervorgehoben. Alternativ können Sie auch verschiedene Bereitstellungskonfigurationen für verschiedene geografische Standorte verwenden und Inhalte entsprechend der regionalen Beliebtheit hervorheben. Weitere Informationen zu Bereitstellungskonfigurationen finden Sie unter Bereitstellungskonfigurationen für Media erstellen und verwalten.

Verstärkerwerte sind additiv

Wenn Sie einer Bereitstellungskonfiguration mehrere Bereitstellungssteuerungen angehängt haben, werden die Boosts und Buries additiv.

Wenn Sie beispielsweise animierte Kinderfilme um 0,3 und animierte Abenteuerfilme um 0,4 steigern, wird ein Film, der als animiertes Kinderabenteuer kategorisiert ist, um 0,7 gesteigert.

Wenn ein Horrorfilm durch eine Kontrollgruppe um 0,2 gesteigert und durch eine andere Kontrollgruppe in derselben Serving-Konfiguration um -0,3 verringert wird, ist das Nettoergebnis eine Verringerung um -0,1.

Die Summe der Steigerungen kann +1 überschreiten. Wenn die Einstellungen beispielsweise animierte Kinderfilme um 0,6 und animierte Abenteuerfilme um 0,5 steigern, wird ein animierter Kinder-Abenteuerfilm um +1,1 gesteigert.

Beispiele für Filter

Im Folgenden finden Sie einige Beispiele für Filter für Media-Empfehlungen.

Filter für häufig verwendete Schlüsselattribute

Beispiele für Filter für gängige Schlüsselstring-Properties (category, image_name, image_uri, language, title und uri).

• Animationen für Kinder:
  "filter": "categories: ANY(\"animation\") AND categories: ANY(\"children\")"

• Gruselige Medien:
  "filter": "categories: ANY(\"horror\", \"thriller\", \"crime\")

• Media mit dem Titel „Weihnachten“:
  "filter": "title: ANY(\"Christmas\")"

• Medien, bei denen das erste Element im Array images den name „beachball“ hat:
  "filter": "images[0].name: ANY(\"beach ball\")"

Filter für Media-Schlüsselattribute

Beispiele für Filter für Media-Schlüsselattribute. Media-Schlüsselattribute beginnen mit media_. In der Filtersyntax wird dem Feldnamen media_key_properties. vorangestellt. Eine Liste der Media-Schlüssel-Eigenschaften finden Sie unter Von Google vordefiniertes Schema im Vergleich zu benutzerdefiniertem Schema.

• Media mit dem Typ audio:
  "filter": "media_key_properties.media_type: ANY(\"audio\")"

• Media, bei denen das hash_tags-Array den String #winter enthält:
  "filter": "media_key_properties.hash_tags: ANY(\"#winter\")"

• Media, bei denen das erste Element des hash_tags-Arrays der String #winter ist:
  "filter": "media_key_properties.hash_tags[0]: ANY(\"#winter\")"

Benutzerdefinierte Felder

Beispiele für Filter für benutzerdefinierte Felder Bei benutzerdefinierten Attributen stellen Sie dem Feldnamen attributes. voran.

• Sie haben in Ihrem Schema ein benutzerdefiniertes Stringfeld (festival), um das Filmfestival anzugeben, auf dem ein Film uraufgeführt wurde. So filtern Sie nach Filmen, die in Cannes uraufgeführt wurden:
  "filter": "attributes.festival: ANY(\"Cannes\")

• Sie haben ein benutzerdefiniertes boolesches Feld, audio_desc, das „true“ ist, wenn die Media eine Audiobeschreibung für sehbehinderte Zuschauer enthält. So filtern Sie nach Medien mit Audiodeskription:
  "filter": "attributes.audio_desc: ANY(true)"

Einschränkungen bei filterbaren Feldern

Für die Bereitstellungssteuerungen für Steigerungen gelten die folgenden Einschränkungen:

• Für die Steigerung können nur Attributfelder vom Typ „String“ und „Boolean“ in Filterausdrücken verwendet werden.

• Sie können nicht nach Feldern filtern, die mehr als eine Ebene verschachtelt sind. Sie können beispielsweise nach persons.name filtern, aber nicht nach dem Feld persons.name.stage, auch wenn es vorhanden wäre.

• Filter müssen genaue Übereinstimmungen sein. Das bedeutet, dass in Beispielen ein Film mit dem Titel „Christmas Story“ oder „CHRISTMAS“ nicht beworben würde.

Hinweise

• Sie müssen eine App für Medienempfehlungen und einen Datenspeicher erstellt haben. Weitere Informationen finden Sie unter App und Datenspeicher für Medienempfehlungen erstellen.

• Optional: Wenn Sie die Standardkonfiguration für die Bereitstellung nicht verwenden möchten, erstellen Sie eine neue Konfiguration für die Bereitstellung. Folgen Sie dazu den Schritten 1 bis 5 und 7 unter Konfiguration für die Bereitstellung erstellen. Wenn Ihre App in der Produktion ist, empfiehlt Google, eine separate Bereitstellungskonfiguration zum Testen von Boost-Steuerelementen zu erstellen, bevor Sie die Steuerelemente auf Ihre Produktionsbereitstellungskonfiguration anwenden.

• Achten Sie darauf, dass alle Felder, die Sie in der Steuerung für die Steigerung verwenden möchten, im Schema als Filterable (Filterbar) gekennzeichnet sind. Weitere Informationen finden Sie unter Feldeinstellungen konfigurieren. Siehe auch Filtereinschränkungen.

Empfehlungen hoch- oder herabstufen

In dieser Anleitung wird beschrieben, wie Sie Boost-Steuerelemente erstellen und an eine Bereitstellungskonfiguration anhängen.

Nachdem die Steuerelemente an die Bereitstellungskonfiguration angehängt wurden, können Sie die Bereitstellungskonfiguration beim Aufrufen der Methode servingConfigs.recommend angeben. Das Steuerelement für die Steigerung wird dann verwendet, um die Reihenfolge der zurückgegebenen Empfehlungen zu beeinflussen.

Boost-Steuerelement aktualisieren

In dieser Anleitung wird beschrieben, wie Sie eine vorhandene Boost-Steuerung aktualisieren, um den Wert des Boosts oder des Filters zu ändern.

Nachdem Sie die Boost-Steuerung getestet haben, stellen Sie möglicherweise fest, dass Sie den Boost verstärken oder abschwächen möchten. Alternativ können Sie den Filterstring ändern.

Wenn Sie einen Boost-Wert oder einen Filter aktualisieren, rufen Sie die Methode engines.controls.patch auf.

Mit der Patch-Methode werden die Werte von boost und filter durch die neuen Werte ersetzt, die Sie angeben. In dieser Anleitung wird gezeigt, wie Sie den Wert boost (Schritt 3) und den Wert filter (Schritt 4) separat bearbeiten. Wenn Sie beide bearbeiten möchten, können Sie das mit einem einzigen curl-Befehl tun.

Steuerelement für Kampagnen mit Steigerung löschen

In dieser Anleitung wird beschrieben, wie Sie ein Boost-Steuerelement löschen. Wenn Sie keine Boost-Kontrollgruppe verwenden, sollten Sie sie löschen, damit Sie das Kontingent für die zulässige Anzahl von Kontrollgruppen nicht erreichen oder überschreiten.

Wenn Sie eine Boost-Steuerung löschen, rufen Sie die Methode engines.controls.delete auf.

Boost-Steuerelemente, die an eine Bereitstellungskonfiguration angehängt sind, können nicht gelöscht werden. Wenn Sie versuchen, eine Boost-Steuerung zu löschen, wird in einer Fehlermeldung der Name der Bereitstellungskonfiguration angezeigt. Anschließend müssen Sie die Bereitstellungskonfiguration löschen oder die Verknüpfung der Steuerungsregel mit der Bereitstellungskonfiguration aufheben.

Bereitstellungskonfiguration aktualisieren, um ein Steuerelement für die Steigerung zu entfernen

Bevor Sie ein Steuerelement für die Steigerung löschen können, müssen Sie es von allen Steuerelementen für die Bereitstellung trennen. Dazu müssen Sie die Bereitstellungssteuerungen patchen, um die ID der Boost-Steuerung zu entfernen.

So trennen Sie Boost-Einstellungen von einer Serving-Konfiguration:

1. Mit einer engines.servingConfigs.get-Anfrage können Sie herausfinden, welche Boost-Steuerelemente an die Bereitstellungskonfiguration angehängt sind. Sehen Sie sich dazu das Feld boostControlIds in der Antwort an.

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID"
   

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die ID Ihres Google Cloud Projekts.

   • APP_ID: Die ID der Vertex AI Search-Anwendung.

   • CONFIG_ID: Die ID der Serving-Konfiguration, zu der Sie mehr erfahren möchten.

   Beispielbefehl und -ergebnis

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id"
   

   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
     "displayName": "jane-day-test-serving-config-for-boost-bury",
     "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
     "modelId": "my-app",
     "diversityLevel": "no-diversity",
     "diversityType": "RULE_BASED_DIVERSITY",
     "mediaConfig": {},
     "createTime": "2024-11-22T23:54:45.613178Z",
     "updateTime": "2024-11-26T20:28:11.967439Z",
     "boostControlIds": [
       "boost-kids",
       "bury-horror"
     ]
   }
   

   Mit diesem Befehl werden Informationen zur Bereitstellungskonfiguration my_app-1234567_id aufgeführt. Insbesondere wird angezeigt, dass der Bereitstellungskonfiguration zwei Boost-Steuerelemente zugewiesen sind: boost-kids und bury-horror.

2. Wenn Sie die Serving-Konfiguration aktualisieren möchten, um eine Steuerung für die Steigerung zu entfernen, verwenden Sie die Methode engines.servingConfigs.patch.

   curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID?update_mask=boost_control_ids" \
   -d '{
     "boostControlIds": ["CONTROL_ID"]
   }'
   

   Ersetzen Sie Folgendes:

   • CONFIG_ID: Die ID der Serving-Konfiguration, an die Sie die Boost-Steuerelemente anhängen möchten, z. B. my_app-1234567_id. Siehe vorheriger Schritt.

   • CONTROL_ID: Enthält die IDs einer oder mehrerer Boost-Steuerelemente, die in der Serving-Konfiguration enthalten sein sollen. Lassen Sie alle Boost-Steuerelemente weg, die Sie löschen möchten. Dies ist ein Array von Strings. Wenn Sie mehrere IDs haben, müssen Sie Trennzeichen in Form von Anführungszeichen und Kommas verwenden, z. B. boost-1", "boost-2.

   Beispielbefehl und ‑ergebnis: Eine Steuerungsgruppe wird beibehalten.

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id?update_mask=boost_control_ids" \
   -d '{
     "boostControlIds": ["bury-horror"]
   }'
   

   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
     "displayName": "jane-day-test-serving-config-for-boost-bury",
     "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
     "modelId": "my-app",
     "diversityLevel": "no-diversity",
     "diversityType": "RULE_BASED_DIVERSITY",
     "mediaConfig": {},
     "boostControlIds": [
       "bury-horror"
     ]
   }
   

   Mit diesem Befehl bleibt das Boost-Steuerelement bury-horror an die Bereitstellungskonfiguration angehängt und das Steuerelement boost-kids wird entfernt. Wenn boost-kids nicht an eine andere Bereitstellungskonfiguration angehängt ist, kann sie jetzt gelöscht werden. Weitere Informationen zum Löschen von Boost-Steuerelementen

   Beispielbefehl und Ergebnis: Alle Steuerelemente werden entfernt

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id?update_mask=boost_control_ids" \
   -d '{
   "boostControlIds": []
   }'
   

   {
   "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
   "displayName": "jane-day-test-serving-config-for-boost-bury",
   "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
   "modelId": "my-app",
   "diversityLevel": "no-diversity",
   "diversityType": "RULE_BASED_DIVERSITY",
   "mediaConfig": {}
   }
   

   Mit diesem Befehl werden alle Steuerelemente für die Steigerung aus der Bereitstellungskonfiguration entfernt. my_app-1234567_id