Statistiken ansehen

Auf dieser Seite wird beschrieben, wie Sie Analysen für Ihre Apps für Medienempfehlungen 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 Apps für allgemeine Suchanfragen und Mediensuchen: 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.

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 der Vertex AI Search zugeordnet werden können. Dazu müssen Sie beim Aufnehmen von Nutzerereignissen das zugehörige Element 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 zu Nutzerereignissen hinzu, damit Sie nach Messwerten für Nutzerereignisse nach Gerätetyp filtern können.

Suchprotokolle

Such-Apps 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

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

Folgen Sie der Anleitung unten, um Analysen für Apps für allgemeine Suchanfragen oder Mediensuchen aufzurufen.

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.
   • 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 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.
   • 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.

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
Wiedergabeanzahl 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	Wiedergabezeit in Sekunden der empfohlenen Medienelemente ÷ Anzahl der Empfehlungen

Messwerte für die Suche

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

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.