Statistiken ansehen

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

Mithilfe von Analysen erhalten Sie Einblicke in die Nutzungstrends, die Such- und Empfehlungsqualität und die Nutzerinteraktion für Ihre App. Die Agent Search Console bietet ein interaktives Dashboard, das auf Looker basiert.

• Für Apps für Medienempfehlungen: Öffentliche Vorschau. Sie können Messwerte pro Empfehlung basierend auf Nutzerereignissen aufrufen. Sie können Messwerte nach Zeitraum und Gerätetyp filtern.
• Für benutzerdefinierte Such- und Mediensuch-Apps: Sie können Messwerte pro Suche und Messwerte pro Suchsitzung basierend auf Suchlogs und Nutzerereignissen aufrufen. Sie können Messwerte nach Zeitraum, Abfrage und Gerätetyp filtern.
• Für Such-Apps für das Gesundheitswesen: Öffentliche Vorschau. Sie können Messwerte pro Suche basierend auf Suchlogs aufrufen.

Messwerte werden etwa alle sechs Stunden aktualisiert. Daher kann es mehrere Stunden dauern, bis Sie die Seite Analysen nach dem Erstellen Ihrer App verwenden können.

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 aufrufen zu können.

Welche Nutzerereignisse Sie hochladen, wirkt sich darauf aus, welche Analysen generiert werden.

Für Apps für Medienempfehlungen sind die folgenden Nutzerereignisse erforderlich, um einige Messwerte aufzurufen:

• Ereignisse vom Typ „Artikel ansehen“ Erforderlich für die Klickrate.
• Ereignisse vom Typ „Medien vollständig wiedergegeben“ Erforderlich für die Abschlussrate pro Wiedergabe und die Abschlussrate pro Empfehlung.
• Ereignisse vom Typ „Medien wiedergegeben“ Erforderlich für die Anzahl der Wiedergaben von empfohlenen Medien, die Wiedergaberate, die Abschlussrate pro Wiedergabe und die durchschnittliche Wiedergabezeit pro Wiedergabe.

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

• Suchereignisse 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) angeben, die auf Agent Search zurückzuführen sind, indem Sie das zugehörige Element beim Erfassen von Nutzerereignissen in UserEvent.Documents einfügen. Diese Informationen sind für die Attribution und die Berechnung von Messwerten pro Suche erforderlich.
• Attributionstokens Attributionstokens sind eindeutige IDs, die von Agent Search generiert und mit jeder Suchanfrage zurückgegeben werden. Fügen Sie dieses Attributionstoken als UserEvent.attributionToken in alle Nutzerereignisse ein, die aus einer Suche resultieren. Dies ist erforderlich, um zu ermitteln, ob eine Suche von der API bereitgestellt wird. Nur Nutzerereignisse mit einem von Google generierten Attributionstoken werden zur Berechnung von Messwerten verwendet.
• Nutzeragent Fügen Sie UserInfo.userAgent in Nutzerereignisse ein, damit Sie Nutzerereignismesswerte nach Gerätetyp filtern können.

Suchprotokolle

Such-Apps verwenden Suchprotokolle als Datenquellen für einige Messwerte.

Suchprotokolle basieren auf Suchanfragen. Damit Agent Search Nutzersitzungen identifizieren kann, um Analysen pro Sitzung und hochwertigere Suchergebnisse zu liefern, empfiehlt Google dringend, das optionale Feld userPseudoId festzulegen.

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

Analysen für Medienempfehlungen aufrufen

**Hinweis**: Analysen für Medienempfehlungen sind in der öffentlichen Vorschau verfügbar.

Folgen Sie der Anleitung unten, um Analysen für Medienempfehlungen aufzurufen.

1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

   KI-Anwendungen

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

3. Klicken Sie auf Analysen.

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 sie anzuwenden:

   • Zeitraum Wählen Sie einen voreingestellten Zeitraum aus oder geben Sie, falls verfügbar, einen benutzerdefinierten Zeitraum ein.
   • Gerätetyp Wählen Sie einen Gerätetyp aus, auf dem Abfragen ausgeführt wurden.

Suchanalysen aufrufen

Hinweise:

• Für Datenspeicher in multiregionalen Standorten in den USA und der EU ist die Anzeige von Suchanalysen in der öffentlichen Vorschau verfügbar.
• Da Agent Search für die Suche im Gesundheitswesen Suchdienste nur in der multiregionalen Region „USA“ (us) bereitstellt, sind Analysen für die Suche im Gesundheitswesen in der öffentlichen Vorschau verfügbar.
• Suchanalysen sind für globale Datenspeicher allgemein verfügbar.

Folgen Sie der Anleitung unten, um Analysen für Such-Apps aufzurufen.

1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

   KI-Anwendungen

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

3. Klicken Sie auf Analysen.

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

   • Pro Suche Messwerte werden nach Suchanfragen gruppiert. Für die Suche im Gesundheitswesen ist dies die einzige verfügbare Messwertgruppe.
   • Pro Sitzung Messwerte werden nach Suchsitzungen gruppiert.
   • Vergleichen Neben den Messwerten aus einem Vergleichszeitraum werden Baseline-Messwerte angezeigt. Wählen Sie Zeiträume für die Baseline-Messwerte (ein früherer Zeitraum) und die Vergleichsmesswerte (ein späterer 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 benutzerdefinierte Such-Apps sind die folgenden Filter verfügbar:

   • Zeitraum Wählen Sie einen voreingestellten Zeitraum aus oder geben Sie, falls verfügbar, einen benutzerdefinierten Zeitraum ein.
   • Suchanfrage Wählen Sie eine Bedingung und einen Wert für die Suchanfrage aus. Sie können mehrere Filter für Suchanfragen hinzufügen. Verfügbar für die Messwerte Pro Suche und Vergleichen.
   • Gerätetyp Wählen Sie einen Gerätetyp aus, auf dem Abfragen ausgeführt wurden.

   Für Such-Apps für das Gesundheitswesen sind die folgenden Filter verfügbar:

   • Zeitraum Wählen Sie einen voreingestellten Zeitraum aus oder geben Sie, falls verfügbar, einen benutzerdefinierten Zeitraum ein. Wenn Sie ein bestimmtes Datum für den benutzerdefinierten Zeitraum auswählen, ist dieses Datum das Datum, an dem die Suche in der Zeitzone UTC-8:00 stattgefunden hat.
   • Suchanfrage Wählen Sie eine Bedingung und einen Wert für die Suchanfrage aus. Sie können mehrere Filter für Suchanfragen 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 Berufsbezeichnung 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 Einstellung für das Gesundheitswesen 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 von Empfehlungen	Anzahl der Wiedergaben von empfohlenen Medienelementen
Anzahl der Klicks auf Empfehlungen	Anzahl der Klicks auf empfohlene Medienelemente
Klickrate	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 vollständigen Wiedergaben von empfohlenen Medien	Anzahl der Wiedergaben von empfohlenen Medienelementen bis zum Ende
Wiedergaberate pro Empfehlung	Anzahl der Wiedergaben von empfohlenen Medienelementen / Anzahl der Empfehlungen
Abschlussrate pro Wiedergabe	Anzahl der Wiedergaben von empfohlenen Medienelementen bis zum Ende / Anzahl der Wiedergaben von Medienelementen
Durchschnittliche Wiedergabezeit pro Wiedergabe	Zeit in Sekunden, in der empfohlene Medienelemente wiedergegeben wurden / Anzahl der Wiedergaben von empfohlenen Medienelementen
Abschlussrate pro Empfehlung	Anzahl der Wiedergaben von Medienelementen bis zum Ende / Anzahl der Empfehlungen
Durchschnittliche Wiedergabezeit pro Empfehlung	Zeit in Sekunden, in der empfohlene Medienelemente angesehen wurden / Anzahl der Empfehlungen

Messwerte für Medien- und benutzerdefinierte Suchanfragen

Messwertname	Definition des Messwerts	Hinweise
Anzahl der Suchanfragen	Anzahl der Suchereignisse	Basierend auf Suchprotokollen.
Rate ohne Ergebnisse	Anzahl der Suchereignisse ohne Ergebnisse / Anzahl der Suchanfragen	Basierend auf Suchprotokollen.
Klickrate (CTR) pro Suche	Anzahl der Klicks auf Suchergebnisse / Anzahl der Suchanfragen	Klicks auf Suchergebnisse sind Ereignisse vom Typ „Artikel ansehen“, die einem vorherigen Suchereignis zugeordnet werden können. Basierend auf Nutzerereignissen.
Anzahl der „Gefällt mir“- und „Gefällt mir nicht“-Bewertungen	Anzahl der „Gefällt mir“- und „Gefällt mir nicht“-Bewertungen	Ein Datensatz der „Gute Antwort“/„Schlechte Antwort“-Feedbackantworten, die von den Nutzern der App gesendet wurden.
Aufschlüsselung der Gründe für „Gefällt mir nicht“	Prozentsatz der Gründe für „Gefällt mir nicht“	Wenn ein Nutzer eine generierte Antwort mit „Gefällt mir nicht“ bewertet, kann er mehrere Gründe für seine Bewertung auswählen. Der Prozentsatz gibt an, wie oft jeder Grund ausgewählt wurde.
Anzahl der Suchsitzungen	Anzahl der Suchsitzungen	Eine Suchsitzung ist eine Nutzersitzung, die mindestens ein Suchereignis enthält. Eine Nutzersitzung, auch Besuch genannt, ist eine fortlaufende Reihe von Nutzerereignissen. Nach 30 Minuten Inaktivität endet die Sitzung. Basierend auf Suchprotokollen.
Seitenaufrufe pro Suchsitzung	Anzahl der Ereignisse vom Typ „Artikel ansehen“ in Suchsitzungen / Anzahl der Suchsitzungen	Dieser Messwert umfasst alle Seitenaufrufe in Suchsitzungen, unabhängig davon, ob sie Agent Search zugeordnet werden können. Basierend auf Nutzerereignissen.
Absprungrate	Anzahl der Absprünge in Suchsitzungen / Anzahl der Suchsitzungen	Ein Absprung in einer Suchsitzung wird als Sitzung mit einer einzelnen Suche definiert, bei der der Nutzer die Sitzung beendet hat, nachdem er nur eine Suche durchgeführt hat. Basierend auf Nutzerereignissen.

Messwerte für die Suche im Gesundheitswesen

Veraltet: Agent Search für das Gesundheitswesen ist veraltet und nach dem 15. Mai 2027 nicht mehr verfügbar.

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

Messwertname	Definition des Messwerts	Hinweise
Anzahl der Suchanfragen	Anzahl der Suchereignisse
Anzahl der Suchanfragen ohne Ergebnisse	Anzahl der Suchereignisse ohne Ergebnisse
Rate ohne Ergebnisse pro Suche	Anzahl der Suchereignisse ohne Ergebnisse pro Suche
Anzahl der Patienten	Anzahl der Patienten-IDs, für die Suchanfragen durchgeführt wurden	Dies wird pro Suchnutzer dedupliziert, aber nicht pro Patient. Wenn Nutzer 1 beispielsweise nach Patient A und B sucht und Nutzer 2 nur nach Patient B sucht, ist die Anzahl 3.
Anzahl der vom Kunden definierten Suchsitzungen	Anzahl der vom Suchnutzer definierten Sitzungen	Sie können in Ihrer Suche eine Sitzungs-ID senden. Weitere Informationen finden Sie unter siehe session.
Anzahl der Suchbesucher	Anzahl der Nutzer, die eine Suchanfrage gesendet haben	Nutzer werden anhand des userInfo Felds gezählt.
Anzahl der von Google definierten 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 fortlaufende Reihe von Nutzerereignissen. Nach 30 Minuten Inaktivität endet die Sitzung.

Analysen deaktivieren

Sie können Analysen für eine vorhandene App nicht deaktivieren. Wenn Sie jedoch eine App erstellen, können Sie festlegen, dass Analysen deaktiviert sind.

So erstellen Sie eine Such-App, 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 Suchanalysedaten erhoben werden.