Analysen ansehen

Auf dieser Seite wird beschrieben, wie Sie Analysen für Ihre Empfehlungen und Such-Apps aufrufen.

Analysen geben Aufschluss über die Nutzungstrends, die Qualität der Suche und Empfehlungen sowie die Interaktionen der Endnutzer mit Ihrer App. Die Vertex AI Agent Builder Console bietet ein interaktives Dashboard, das von Looker unterstützt wird.

• Für Apps mit Medienempfehlungen: Öffentliche Vorschau. Sie können Messwerte pro Empfehlung auf Grundlage von Nutzerereignissen sehen. Sie können Messwerte nach Zeitraum und Gerätetyp filtern.
• Für allgemeine Such- und Mediensuch-Apps: Sie können Messwerte pro Suchanfrage und pro Suchsitzung auf Grundlage von Suchprotokollen und Nutzerereignissen abrufen. Sie können Messwerte nach Zeitraum, Suchanfrage und Gerätetyp filtern.
• Für Apps zur Suche nach Gesundheitsdaten: Öffentliche Vorschau. Sie können Messwerte pro Suchanfrage auf Grundlage von Suchprotokollen abrufen.

Die Messwerte werden etwa alle sechs Stunden aktualisiert. Es kann also einige Stunden dauern, bis Sie die Seite Analytics verwenden können, nachdem Sie Ihre App erstellt haben.

Datenquellen für Analysen

In diesem Abschnitt werden die Datenquellen für Analysen je nach App-Typ beschrieben.

Sie müssen die Integration von Nutzerereignissen abschließen, um Analysen zu Nutzerereignissen sehen zu können.

Welche Analysen generiert werden, hängt davon ab, welche Nutzerereignisse Sie hochladen.

Für einige Messwerte in Apps für Medienempfehlungen sind die folgenden Nutzerereignisse erforderlich:

• Ereignisse vom Typ „Artikel ansehen“ Erforderlich für die Klickrate.
• Ereignisse, bei denen die Medienwiedergabe abgeschlossen ist Erforderlich für die Abschlussrate pro Wiedergabe und die Abschlussrate pro Empfehlung.
• Ereignisse für die Medienwiedergabe Erforderlich für die Anzahl der Wiedergaben, die Wiedergaberate, die Abschlussrate pro Wiedergabe und die durchschnittliche Wiedergabezeit pro Wiedergabe von Empfehlungsmedien.

Für Such-Apps sind die folgenden Nutzerereignisse erforderlich, um einige Messwerte zu sehen:

• Nach Ereignissen suchen Erforderlich für die Klickrate.
• Ereignisse vom Typ „Artikel ansehen“ Erforderlich für die Klickrate.

Die folgenden Informationen werden auch für einige Analysen verwendet:

• Impressionen Sie können Impressionen (Artikelaufrufe oder -klicks) bereitstellen, die Vertex AI Search zugeordnet werden können. Dazu müssen Sie das zugehörige Element beim Aufnehmen von Nutzerereignissen in UserEvent.Documents angeben. Diese Informationen sind für die Attribution und die Berechnung von Messwerten pro Suchanfrage erforderlich.
• Attributionstokens Attributionstokens sind eindeutige IDs, die von Vertex AI Search generiert und mit jeder Suchanfrage zurückgegeben werden. Geben Sie dieses Attributionstoken als UserEvent.attributionToken in allen Nutzerereignissen an, die aus einer Suche resultieren. So wird ermittelt, ob eine Suche von der API ausgeführt wird. Für die Berechnung von Messwerten werden nur Nutzerereignisse mit einem von Google generierten Attributionstoken verwendet.
• User-Agent: Fügen Sie UserInfo.userAgent in Nutzerereignisse ein, damit Sie nach Messwerten für Nutzerereignisse nach Gerätetyp filtern können.

Suchprotokolle

Suchanwendungen verwenden Suchprotokolle als Datenquellen für einige Messwerte.

Suchprotokolle basieren auf Suchanfragen. Damit Vertex AI Agent Builder Nutzersitzungen identifizieren und Analysen pro Sitzung sowie Suchergebnisse mit höherer Qualität liefern kann, empfehlen wir Ihnen dringend, das optionale Feld SearchRequest.UserPseudoId festzulegen.

Wenn noch keine Suchprotokolle oder Nutzerereignisse vorhanden sind, werden für alle Messwerte Standardwerte angezeigt.

Analysen zu Medienempfehlungen aufrufen

Hinweis: Analysen zu Medienempfehlungen befinden sich in der öffentlichen Vorschau.

So rufen Sie Analysen für Medienempfehlungen auf:

1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

   Zum Agent Builder

2. Klicken Sie auf den Namen der App, für die Sie Analysen aufrufen möchten.

3. Klicken Sie auf Analytics.

4. Wenn Sie Ihre Messwerte filtern möchten, geben Sie einen der folgenden Filter an und klicken Sie dann auf die Schaltfläche Aktualisieren, um ihn anzuwenden:

   • Zeitraum Wählen Sie einen voreingestellten Zeitraum aus oder geben Sie einen benutzerdefinierten Zeitraum ein.
   • Gerätetyp Wählen Sie einen Gerätetyp aus, auf dem Suchanfragen stattgefunden haben.

Suchanalysen ansehen

Hinweise:

• Für Datenspeicher in den Mehrfachregionen USA und EU befindet sich die Anzeige von Suchanalysen in der öffentlichen Vorabversion.
• Da Vertex AI Agent Builder für die Suche im Gesundheitswesen nur Suchdienste in der Multiregion „USA“ (`us`) bereitstellt, befinden sich Analysen für die Suche im Gesundheitswesen in der öffentlichen Vorabversion.
• Suchanalysen sind für globale Datenspeicher allgemein verfügbar.
• Standardmäßig werden Messwerte aus dem Widget nicht auf der Seite Analytics angezeigt. Wenn Sie Widget-Messwerte sehen möchten, wenden Sie sich an Ihr Google Konten-Team und bitten Sie darum, zur Zulassungsliste hinzugefügt zu werden.

So rufen Sie Analysen für Such-Apps auf:

1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

   Zum Agent Builder

2. Klicken Sie auf den Namen der App, für die Sie Analysen aufrufen möchten.

3. Klicken Sie auf Analytics.

4. Klicken Sie auf einen Tab, um die entsprechende Messwertgruppe aufzurufen:

   • Pro Suchanfrage Die Messwerte werden nach Suchanfragen gruppiert. Bei der Suche nach Gesundheitsdaten ist dies die einzige verfügbare Messwertgruppe.
   • Pro Sitzung Die Messwerte werden nach Suchsitzungen gruppiert.
   • Vergleichen Die Baseline-Messwerte werden neben den Messwerten aus einem Vergleichszeitraum angezeigt. Wählen Sie Zeiträume für die Referenzmesswerte (einen früheren Zeitraum) und die Vergleichsmesswerte (einen späteren Zeitraum) aus. Diese Zeiträume dürfen sich nicht überschneiden.

5. Wenn Sie Ihre Messwerte filtern möchten, geben Sie die Filter an und klicken Sie dann auf die Schaltfläche Aktualisieren, um sie anzuwenden.

   Für Medien-Apps und allgemeine Such-Apps sind die folgenden Filter verfügbar:

   • Zeitraum Wählen Sie einen voreingestellten Zeitraum aus oder geben Sie einen benutzerdefinierten Zeitraum ein.
   • Suchanfrage Wählen Sie eine Bedingung und einen Wert für die Suchanfrage aus. Sie können mehrere Suchanfragefilter hinzufügen. Verfügbar für die Messwerte Pro Suchanfrage und Vergleichen.
   • Gerätetyp Wählen Sie einen Gerätetyp aus, auf dem Suchanfragen stattgefunden haben.

   Für Such-Apps aus dem Gesundheitsbereich sind die folgenden Filter verfügbar:

   • Zeitraum Wählen Sie einen voreingestellten Zeitraum aus oder geben Sie einen benutzerdefinierten Zeitraum ein. Wenn Sie ein bestimmtes Datum für den benutzerdefinierten Zeitraum auswählen, ist dies das Datum, an dem die Suche in der Zeitzone UTC−08:00 stattgefunden hat.
   • Suchanfrage Wählen Sie eine Bedingung und einen Wert für die Suchanfrage aus. Sie können mehrere Suchanfragefilter hinzufügen.
   • Nutzerstandort Wählen Sie den Standort des Krankenhauses, der Klinik oder des Gesundheitsdienstleisters aus, der in der Suchanfrage festgelegt wurde. Dieser Filter ist nur verfügbar, wenn er in der Suchanfrage festgelegt wurde.
   • Nutzerrolle Wählen Sie die Jobkategorie des Nutzers aus, der die Suchanfrage gesendet hat. Dieser Filter ist nur verfügbar, wenn er in der Suchanfrage festgelegt wurde.
   • Nutzereinstellung Wählen Sie die in der Suchanfrage festgelegte Gesundheitseinrichtung aus, z. B. stationäre, ambulante oder hybride Behandlung. Dieser Filter ist nur verfügbar, wenn er in der Suchanfrage festgelegt wurde.

Messwertdefinitionen

In den folgenden Tabellen wird beschrieben, wie Messwerte definiert werden.

Messwerte für Medienempfehlungen

Messwertname	Definition des Messwerts	Hinweise
Anzahl der Empfehlungen	Gesamtzahl der Empfehlungen
Anzahl der Wiedergaben der Empfehlung	Häufigkeit der Wiedergabe empfohlener Medienelemente
Anzahl der Klicks auf Empfehlungen	Anzahl der Klicks auf empfohlene Medienelemente
Klickrate (Click-through-Rate, CTR)	Anzahl der Klicks auf Empfehlungen / Anzahl der Empfehlungen	Klicks auf Empfehlungen sind Ereignisse vom Typ „Artikel ansehen“, die einer Empfehlung zugeordnet werden können.
Anzahl der abgeschlossenen Empfehlungsmedien	Häufigkeit, mit der empfohlene Medienelemente bis zum Ende wiedergegeben wurden
Wiedergaberate pro Empfehlung	Anzahl der Wiedergaben empfohlener Medienelemente / Anzahl der Empfehlungen
Abschlussrate pro Wiedergabe	Häufigkeit, mit der empfohlene Medienelemente bis zum Ende wiedergegeben wurden ÷ Häufigkeit, mit der Medienelemente wiedergegeben wurden
Durchschnittliche Wiedergabezeit pro Wiedergabe	Wiedergabezeit in Sekunden der empfohlenen Medienelemente ÷ Anzahl der Wiedergaben der empfohlenen Medienelemente
Abschlussrate pro Empfehlung	Häufigkeit, mit der Medienelemente bis zum Ende wiedergegeben wurden / Anzahl der Empfehlungen
Durchschnittliche Wiedergabezeit pro Empfehlung	Dauer in Sekunden, während der empfohlene Medienelemente angesehen wurden / Anzahl der Empfehlungen

Messwerte für Medien und allgemeine Suchanfragen

Messwertname	Definition von Messwerten	Hinweise
Anzahl der Suchanfragen	Anzahl der Suchereignisse	Basierend auf Suchprotokollen.
Anteil der Anfragen ohne Ergebnis	Anzahl der Suchanfragen ohne Ergebnisse ÷ Anzahl der Suchanfragen	Basierend auf Suchprotokollen.
Klickrate (CTR) pro Suchanfrage	Anzahl der Suchklicks / Anzahl der Suchanfragen	Suchklicks sind Ereignisse vom Typ „Artikel ansehen“, die einem vorherigen Suchereignis zugeordnet werden können. Basierend auf Nutzerereignissen
Anzahl der Suchsitzungen	Anzahl der Suchsitzungen	Eine Suchsitzung ist eine Nutzersitzung, die mindestens ein Suchereignis enthält. Eine Nutzersitzung, auch Besuch genannt, ist eine kontinuierliche Folge von Nutzerereignissen. Nach 30 Minuten Inaktivität endet die Sitzung. Basierend auf Suchprotokollen.
Seitenaufrufe pro Suchanfrage	Anzahl der „view_item“-Ereignisse in Suchsitzungen ÷ Anzahl der Suchsitzungen	Dieser Messwert umfasst alle Seitenaufrufe bei Suchanfragen, unabhängig davon, ob sie der Vertex AI Search zugeordnet werden können. Basierend auf Nutzerereignissen
Absprungrate	Anzahl der Ausstiege bei Suchsitzungen ÷ Anzahl der Suchsitzungen	Ein Suchsitzungs-Ausstieg wird als Sitzung mit einer einzelnen Suchanfrage definiert, bei der der Nutzer die Website nach nur einer Suchanfrage verlassen hat. Basierend auf Nutzerereignissen

Messwerte für die Suche in Gesundheitsdaten

Die folgenden Suchmesswerte sind für Such-Apps aus dem Gesundheitswesen verfügbar.

Messwertname	Definition von Messwerten	Hinweise
Anzahl der Suchanfragen	Anzahl der Suchereignisse
Keine Ergebnisanzahl	Anzahl der Suchereignisse ohne Ergebnisse
Anteil der Suchanfragen ohne Ergebnis	Anzahl der Suchereignisse ohne Ergebnisse pro Suche
Anzahl der Patienten	Anzahl der Patienten-IDs, für die Suchanfragen stattgefunden haben	Die Daten werden nach Suchnutzern, aber nicht nach Patienten dedupliziert. Wenn Nutzer 1 beispielsweise nach den Patienten A und B sucht und Nutzer 2 nur nach Patient B, wird die Anzahl mit 3 angegeben.
Anzahl der Suchsitzungen von Kunden	Anzahl der vom Nutzer definierten Suchsitzungen	Sie können eine Sitzungs-ID in Ihrer Suche senden. Weitere Informationen finden Sie unter session.
Anzahl der Suchzugriffe	Anzahl der Nutzer, die eine Suchanfrage gesendet haben	Nutzer werden anhand des Felds userInfo gezählt.
Anzahl der synthetischen Suchsitzungen	Anzahl der von Google definierten Suchsitzungen	Eine Suchsitzung ist eine Nutzersitzung, die mindestens ein Suchereignis enthält. Eine Nutzersitzung, auch Besuch genannt, ist eine kontinuierliche Folge von Nutzerereignissen. Nach 30 Minuten Inaktivität endet die Sitzung.

Analyse deaktivieren

Sie können Analysen für eine vorhandene App nicht deaktivieren. Beim Erstellen einer App können Sie jedoch festlegen, dass Analysen deaktiviert werden sollen.

So erstellen Sie eine Suchanwendung, bei der keine Analysedaten erhoben werden:

1. Folgen Sie der REST-Anleitung unter Such-App erstellen und fügen Sie dem Curl-Befehl Folgendes hinzu:

      "disableAnalytics": true
   

   Beispielbefehl

   curl -X POST \
   -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/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app" \
   -d '{
     "displayName": "App without analytics",
     "dataStoreIds": ["my-data-store"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "searchEngineConfig": {
        "searchTier": "SEARCH_TIER_ENTERPRISE",
        "searchAddOns": ["SEARCH_ADD_ON_LLM"]
      },
     "disableAnalytics": true
   }'
   
       

   Mit diesem Befehl wird eine App erstellt, bei der keine Daten für Suchanalysen erhoben werden.