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 sehen, Empfehlungsmesswerten basierend auf Nutzerereignissen. Sie können Messwerte nach Zeitraum und Gerätetyp filtern.
- Für allgemeine Such- und Mediensuchanwendungen: Sie können Messwerte pro Suche aufrufen. und Sitzungen pro Suche basierend auf Suchprotokollen und Nutzerereignissen. Sie können Sie können Messwerte nach Zeitraum, Abfrage 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 Einbindung der Nutzerereignisse abschließen, um Nutzerereignisanalysen sehen.
Welche Analysen generiert werden, hängt davon ab, welche Nutzerereignisse Sie hochladen.
Für Apps mit Medienempfehlungen sind zum Ansehen einiger Apps die folgenden Nutzerereignisse erforderlich Messwerte:
- View-item-Ereignisse. Für die Klickrate erforderlich.
- Ereignisse, bei denen die Medienwiedergabe abgeschlossen ist Erforderlich für die Abschlussrate pro Spiel und Abschlussrate pro Empfehlung.
- Ereignisse für die Medienwiedergabe Erforderlich für die Anzahl der empfohlenen Medienwiedergaben, Wiedergaberate, Abschlussrate pro Spiel und durchschnittliche Wiedergabezeit pro Spiel.
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, indem das verknüpfte Element hinzugefügt wird
in
UserEvent.Documents
bei der Aufnahme von Nutzerereignissen. 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 und wird bei jeder Suchanfrage zurückgegeben. Achten Sie darauf,
dieses Attributionstoken als
UserEvent.attributionToken
mit beliebigen Nutzerereignisse, die aus einer Suche resultieren. So wird ermittelt, ob eine Suche von der API bedient wird. Nur Nutzerereignisse mit einer von Google generierten Attribution Token werden zur Berechnung von Messwerten 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 Folgendes tun kann:
Nutzersitzungen identifizieren, um Analysen pro Sitzung und
hochwertige Suchergebnisse erhalten, empfiehlt Google dringend, die optionale Einstellung
Feld SearchRequest.UserPseudoId
.
Wenn noch keine Suchprotokolle oder Nutzerereignisse vorhanden sind, werden Standardwerte angezeigt. für alle Messwerte.
Analysedaten zu Medienempfehlungen ansehen
Folgen Sie der Anleitung unten, um Analysen für Medienempfehlungen aufzurufen.
Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.
Klicken Sie auf den Namen der App, für die Sie Analysen aufrufen möchten.
Klicken Sie auf Analytics.
Wenn Sie Ihre Messwerte filtern möchten, wählen Sie einen der folgenden Filter aus und klicken Sie dann auf auf die Schaltfläche Aktualisieren, um sie 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 Abfragen ausgeführt wurden.
Suchanalysen ansehen
Folgen Sie der Anleitung unten, um Analysen für Apps für allgemeine Suchanfragen oder Mediensuchen aufzurufen.
Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.
Klicken Sie auf den Namen der App, für die Sie Analysen aufrufen möchten.
Klicken Sie auf Analytics.
Klicken Sie auf einen Tab, um die entsprechende Messwertgruppe aufzurufen:
- Pro Suche. 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.
Wenn Sie Ihre Messwerte filtern möchten, wählen Sie einen der folgenden Filter aus und klicken Sie dann auf auf die Schaltfläche Aktualisieren, um sie anzuwenden:
- Zeitraum Wählen Sie einen vordefinierten Zeitraum aus oder, falls verfügbar, benutzerdefinierten Zeitraum eingeben.
- Suchanfrage: Wählen Sie eine Bedingung und einen Wert für die Suchanfrage aus. Ich mehrere Suchanfragenfilter hinzufügen. Verfügbar für die Messwerte Pro Suchanfrage und Vergleichen.
- Gerätetyp: Wählen Sie einen Gerätetyp aus, auf dem Suchanfragen ausgeführt wurden.
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 Empfehlungen für Wiedergaben | 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 | Empfehlungsklicks sind Ereignisse mit Aufrufen von Elementen, die einer Empfehlung zugeordnet werden können |
Anzahl der vollständigen Empfehlungen für Medien | Häufigkeit, mit der empfohlene Media-Elemente 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 | Wiedergabedauer der empfohlenen Medieninhalte in Sekunden ÷ Anzahl der Wiedergaben empfohlener Medien | |
Abschlussrate pro Empfehlung | Häufigkeit, mit der Medienelemente bis zum Ende wiedergegeben wurden / Anzahl der Empfehlungen | |
Durchschnittliche Wiedergabezeit pro Empfehlung | Wiedergabedauer empfohlener Medien in Sekunden ÷ Anzahl der Empfehlungen |
Messwerte suchen
Messwertname | Messwertdefinition | Hinweise |
---|---|---|
Anzahl der Suchanfragen | Anzahl der Suchereignisse | Basierend auf Suchprotokollen |
Anteil der Anfragen ohne Ergebnis | Anzahl der Suchereignisse 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 |
Suchsitzung Anzahl | Anzahl der Suchsitzungen | Eine Suchsitzung ist eine Nutzersitzung, die mindestens ein Suchereignis enthält. A Nutzersitzung, auch Besuch ist, ist eine fortlaufende Gruppe von Nutzern Ereignisse. Wenn es 30 Minuten Inaktivität ist der Sitzung endet. Basierend auf Suchprotokolle |
Seitenaufruf pro Suche | Anzahl der Ansichtselemente Ereignisse in der Suche Sitzungen / Suche Anzahl der Sitzungen | Dieser Messwert umfasst alle Seitenaufrufe in Besuche über Suche und zwar unabhängig davon, ob können sie dem Begriff bis Vertex AI Search. Basierend auf Nutzerereignissen |
Absprungrate | Anzahl der Absprunge 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 Nutzerereignisse |