Analysemesswerte nach BigQuery exportieren

Auf dieser Seite wird beschrieben, wie Sie Vertex AI Search-Messwerte für Analysen im Einzelhandel nach BigQuery exportieren. Wenn Sie Analysemesswerte exportieren, können Sie sie behalten und SQL-Abfragen für Ihre eigene Analyse schreiben.

Analysemesswerte von Vertex AI Search für den Einzelhandel werden automatisch für Sie generiert. Weitere Informationen zum Ermitteln der Geschäftsauswirkungen der Vertex AI Search für den Einzelhandel mithilfe von Analysemesswerten finden Sie unter Analysen ansehen.

Für den Export von Messwertdaten nach BigQuery gelten folgende Einschränkungen:

  • Die Daten, die in Ihrem Vertex AI-Suchprojekt für den Einzelhandel in BigQuery-Tabellen exportiert werden, sind autorisierte Ansichten, keine materialisierten Ansichten.

  • Sie können die Daten in diesen Tabellen nicht ändern oder aktualisieren. Wenn Sie Ihre Daten ändern oder aktualisieren möchten, exportieren oder kopieren Sie die Datenansicht in ein anderes Ziel.

  • Sie können keine Messwerte für Nutzerereignisse exportieren, die älter als 180 Tage sind, die vor mehr als 180 Tagen generiert wurden. Messwerte, die vor Ablauf des 180-tägigen Zeitraums generiert wurden, können nicht abgerufen werden.

Hinweis

Bevor Sie Messwerte nach BigQuery exportieren können, müssen Sie Sie haben die Schritte unter Vorbereitung ausgeführt. Dieses umfasst das Importieren Ihrer Nutzerereignisse und optional Ihres Katalogs Informationen.

Weitere Informationen zum Importieren finden Sie hier:

Dataset in BigQuery erstellen

Sie müssen ein Dataset in BigQuery erstellen, um Ihre Analysemesswerte zu speichern.

Sie müssen die Datasets in demselben Projekt erstellen, in dem Sie Vertex AI Search for Retail implementiert haben.

  1. Wenn Sie BigQuery in Ihrem Projekt noch nicht verwendet haben, aktivieren Sie die BigQuery API und prüfen Sie, ob Sie die IAM-Rolle haben, mit der Sie Datasets und Tabellen erstellen können.

    Weitere Informationen finden Sie unter Vorab und Zugriffssteuerung mit IAM.

    in der BigQuery-Dokumentation.

  2. Erstellen Sie ein Dataset in BigQuery in den USA (mehrere Regionen in USA) multiregional. Nennen Sie sie z. B. retail_data. Wenn Sie das Dataset in einer anderen Region erstellen, schlägt der Export Ihrer Daten nach BigQuery fehl. CMEK für das Dataset ist nicht supported; führt dazu, dass der Export fehlschlägt.

    Informationen zum Erstellen eines Datasets finden Sie unter Datasets erstellen in der BigQuery-Dokumentation.

    In diesem Datensatz werden die von Ihnen exportierten Datentabellen gespeichert. Im Folgenden wird beschrieben, wie Sie Daten exportieren.

Analysemesswerte in eine BigQuery-Tabelle exportieren

Exportieren Sie Ihren Einzelhandelskatalog mit der Methode exportAnalyticsMetrics in ein BigQuery-Tabelle.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Die ID des Vertex AI Search for Retail API-Projekts, in dem Sie das BigQuery-Dataset erstellt haben.
  • DATASET_ID: Der Name des Datasets, das Sie unter Dataset in BigQuery erstellen erstellt haben. Verwenden Sie z. B. retail_data oder retail_metrics_data.
  • TABLE_ID_PREFIX: Präfix für die Tabellen-ID. Dieses Präfix darf kein leerer String sein. Um den Tabellennamen zu vervollständigen, wird das Suffix retail_analytics_metrics hinzugefügt. Wenn das Präfix beispielsweise test ist, heißt die Tabelle test_retail_analytics_metrics.

JSON-Text der Anfrage:

{
  "catalog": "projects/PROJECT_ID/locations/global/catalogs/default_catalog",
  "outputConfig":
  {
    "bigqueryDestination":
    {
      "datasetId": "DATASET_ID",
        "tableIdPrefix": "TABLE_ID_PREFIX",
        "tableType": "view"
    }
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/12310973052792775280",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.retail.v2.ExportAnalyticsMetricsResponse",
    "outputResult": {
      "bigqueryResult": [
        {
          "datasetId": "DATASET_ID",
          "tableId": "TABLE_ID_PREFIX_retail_analytics_metrics"
        }
      ]
    }
  }
}

Messwertdefinitionen

Die exportierten Messwerte sind die Anzahlmesswerte. Bei einigen Personen kann es zu leichten Anzahl von Messwerten, da durch die Bot-Filterung möglicherweise einige Ereignisse aus Messwerten ausgeschlossen werden Berechnung. Durch den Bot-Filter können Sie genauere Leistungsmessungen vornehmen. Dies hat keine Auswirkungen auf A/B-Tests, die je nach Dimension external_experiment_ids, während die Botfilterung auf den gesamten Traffic angewendet wird.

Messwertdimensionen

Die Rohzahlen für die Zählmesswerte werden direkt aus relevanten Nutzerereignissen mit denselben Dimensionen aggregiert. Um Messwerte zu interpretieren, müssen Sie wissen, Dimensionen, auf denen die Messwerte basieren. Für Analysemetriken Such- und Stöberereignisse werden als Impressionsereignisse bezeichnet. Die Ereignisse detail_page_view, add_to_cart und purchase werden als Conversion-Ereignisse. In der folgenden Tabelle werden Messwertdimensionen definiert.

Messwertdimension Beschreibung
Datum

Das Datum der relevanten Ereignisse, durch die die Messwerte generiert wurden.

Bei Impressionsmesswerten ist dies das Datum der Impressionsereignisse.

Bei Sitzungs- und Besuchermesswerten ist dies das Datum der ersten Impression durch die Sitzung oder den Besucher.
external_experiment_ids

Die Test-IDs der relevanten Ereignisse, die die Messwerte generiert haben.

Bei Impressionsmesswerten ist dies die Test-ID des Impressionsereignisses.

Bei Sitzungs- und Besuchermesswerten ist dies die Konkatenierung der eindeutigen externen Test-IDs aller Impressionsereignisse, die innerhalb der Sitzung bzw. des Besuchers auftreten. Beispiel: Wenn es zwei Suchereignisse innerhalb einer Sitzung bzw. eines Besuchers gibt, hat das erste Suchereignis die externen_experiment_ids „test_arm_1,test_arm_2“ und das zweite Suchereignis die externen_experiment_ids „test_arm_1,test_arm_3“. Die „external_experiment_ids“ der Sitzung/des Besuchers lautet dann „test_arm_1,test_arm_3“,test_arm_2.
device_type

Der Gerätetyp der relevanten Ereignisse, auf denen die Messwerte generiert wurden, z. B. ob das Ereignis von einem Mobilgerät oder Computer generiert wurde.

Bei Impressionsmesswerten ist dies der Gerätetyp des Impressionsereignisses.

Bei Sitzungs- und Besuchermesswerten ist dieses Feld leer, wenn die Sitzung bzw. der Besucher mehr als einen Gerätetyp hat. Andernfalls wird der Gerätetyp angezeigt, der für die gesamte Sitzung bzw. den gesamten Besucher gilt.
serving_config

Die Bereitstellungskonfiguration der relevanten Ereignisse, die die Messwerte generiert haben.

Bei Impressionsmesswerten ist dies die Bereitstellungskonfiguration des Impressionsereignisses.

Bei Sitzungs- und Besuchermesswerten ist dieses Feld leer, wenn die Sitzung bzw. der Besucher mehr als eine Bereitstellungskonfiguration hat. Andernfalls wird die Konfiguration angezeigt, die für die gesamte Sitzung bzw. den gesamten Besucher gilt.
traffic_destination

Die Quelle der relevanten Ereignisse, die die Messwerte generiert haben.

Bei Impressionsmesswerten ist dies entweder „Google“, wenn die Impression von Google ausgeliefert wird, oder „Sonstige“, wenn die Impression über Ihre eigene Lösung ausgeliefert wird.

Bei Sitzungs- und Besuchermesswerten wird „Gemischt“ angezeigt, wenn für die Sitzung bzw. den Besucher sowohl von Google als auch von Ihrer eigenen Lösung Impressionsereignisse gesendet wurden. Wählen Sie „Google“ aus, wenn die Impressionsereignisse ausschließlich von Google ausgeliefert werden, oder „Nicht von Google“, wenn die Impressionsereignisse für die gesamte Sitzung bzw. den gesamten Besucher ausschließlich von Ihrer Lösung ausgeliefert werden.
Entität

Diese Option wird von Einzelhändlern verwendet, die mehrere Markenwebsites oder ‐regionen mit einem einzigen Produktkatalog anbieten. Das Rechtssubjekt steht in der Regel für die Marken oder Standorte.

Bei Impressionsmesswerten ist dies die Entität des Impressionsereignisses.

Bei Messwerten für Sitzungen und Besucher sind dies die fünf meistgezählten Entitäten der Impressionsereignisse für die Sitzung bzw. den Besucher.

Messwerte zu Impressionen

Impressionsmesswerte werden gemäß den Voraussetzungen berechnet. Conversion-Ereignisse (detail_page_view-, add_to_cart- und purchase-Ereignisse), kann zugeordnet werden zurück zu einem Impressions-Ereignis, wenn sie die folgenden Kriterien erfüllen.

  • Dem Impressionsereignis und dem Conversion-Ereignis ist derselbe Besucher zugeordnet.

  • Die Produkt-ID des Conversion-Ereignisses muss in der Spalte Ergebnisse.

  • Das Conversion-Ereignis liegt im erforderlichen Zeitraum nach dem Auftreten das Impressionsereignis. Für verschiedene Arten von Conversion-Ereignissen gelten unterschiedliche Conversion-Tracking-Zeiträume.

    Conversion-Pfad Conversion-Zeitfenster
    Impression -> Detailseitenaufruf 60 Sekunden
    Impression -> In den Einkaufswagen 24 Stunden
    Impression -> Kauf 48 Stunden

Messwerte für Suchimpressionen

Name des Messwerts Beschreibung
search_event Anzahl der Suchereignisse
detail_page_view_from_search Anzahl der Detailseitenaufrufe aus der Suche
add_to_cart_unit_from_search Anzahl der „In den Einkaufswagen“-Einheiten aus der Suche
purchase_unit_from_search Anzahl der gekauften Artikel über die Suche
revenue_from_search Umsatz aus der Suche
search_event_without_result Anzahl der Suchereignisse, die zu keinen Ergebnissen führen
search_request_personalization_enabled Anzahl der Suchanfragen mit aktivierter Personalisierung
search_request_personalization_result_served Anzahl der Suchanfragen, für die personalisierte Ergebnisse zurückgegeben werden

Impressionsmesswerte ansehen

Name des Messwerts Beschreibung
browse_event Anzahl der Suchanfragen
detail_page_view_from_browse Ereignisanzahl für Detailseitenaufrufe über „Suchen“
add_to_cart_unit_from_browse Anzahl der „In den Einkaufswagen“-Einheiten aus Suchvorgängen
purchase_unit_from_browse Anzahl der gekauften Artikel aus der Suche
revenue_from_browse Umsatz aus der Suche
browse_event_without_result Anzahl der Durchsuchen-Ereignisse, die keine Ergebnisse liefert
browse_request_personalization_enabled Anzahl der Stöberanfragen bei aktivierter Personalisierung
browse_request_personalization_result_served Anzahl der Suchanfragen, für die personalisierte Ergebnisse ausgeliefert werden

Sitzungsmesswerte

Eine Sitzung ist definiert als ein kontinuierlicher Zeitraum der Interaktion zwischen einem Nutzer und dem System. Jedes Nutzerereignis markiert den Beginn einer Sitzung und das Ende einer Sitzung wird markiert, wenn in den nächsten 30 Minuten kein anderes Ereignis eintritt. Die Sitzung um weitere 30 Minuten verlängert, wenn ein Nutzerereignis Sitzung gestartet. Nach dem Ende einer Sitzung beginnt eine neue Sitzung, wieder mit dem System interagiert.

Die Dimensionen, die die Sitzungsmesswerte charakterisieren, werden gemeinsam von allen Nutzerereignisse innerhalb der Sitzung. Siehe Messwerte Dimensionen verwenden, um die Dimensionswerte Sitzung.

Name des Messwerts Beschreibung
Sitzung Anzahl der Sitzungen

Sitzungsmesswerte suchen

Eine Suchsitzung ist eine Sitzung, die mindestens ein Suchereignis enthält. Beachten Sie, dass ein Eine Suchsitzung kann auch eine Browsersitzung sein, wie durch die Durchlaufsitzung definiert. Messwerte.

Name des Messwerts Beschreibung
search_session Anzahl der Sitzungen mit Suchanfrage
search_event_in_search_session Anzahl der Suchereignisse in Suchsitzungen
browse_event_in_search_session Anzahl der Durchsuchen-Ereignisse in Suchsitzungen
detail_page_view_in_search_session Anzahl der Seitenaufrufe von Detailseiten in Suchsitzungen
add_to_cart_in_search_session Anzahl der Ereignisse vom Typ „In den Einkaufswagen“ in Suchsitzungen
add_to_cart_unit_in_search_session Anzahl der „In den Einkaufswagen“-Einheiten innerhalb von Suchsitzungen
purchase_order_in_search_session Anzahl der Aufträge in Suchsitzungen
purchase_unit_in_search_session Anzahl der gekauften Einheiten in Suchsitzungen
revenue_in_search_session Umsatz aus Suchsitzungen
bounce_count_in_search_session Sitzungszahl des Besuchers, der die Website verlässt, nachdem er sich nur eine Seite innerhalb von Suchsitzung angesehen hat

Sitzungsmesswerte ansehen

Eine Suchsitzung ist eine Sitzung, die mindestens ein Suchereignis enthält. Eine Suchsitzung kann auch eine Sitzung sein, in der Nutzer nur Inhalte angesehen haben, wie in den Messwerten für Suchsitzungen definiert.

Name des Messwerts Beschreibung
browse_session Sitzungsanzahl mit Suchanfragen
search_event_in_browse_session Anzahl der Suchereignisse in Stöbersitzungen
browse_event_in_browse_session Anzahl der Durchsuchen-Ereignisse in Suchsitzungen
detail_page_view_in_browse_session Anzahl der Detailseitenaufrufe in Suchsitzung
add_to_cart_in_browse_session Anzahl der Ereignisse vom Typ „In den Einkaufswagen“ in Suchsitzungen
add_to_cart_unit_in_browse_session Anzahl der Einheiten zum Hinzufügen von Artikeln zum Einkaufswagen bei Suchsitzungen
purchase_order_in_browse_session Anzahl der Bestellungen in Stöbersitzungen
purchase_unit_in_browse_session Anzahl der gekauften Artikel in Suchsitzungen
revenue_in_browse_session Umsatz in Stöbersitzungen
bounce_count_in_browse_session Sitzungsanzahl des Besuchers, der die Website verlässt, nachdem er sich innerhalb von Suchsitzung nur eine Seite angesehen hat

Besucherkennzahlen

Ein Besucher wird durch die Besucher-ID eindeutig identifiziert. Zusammenfassung der Besuchermesswerte alle Nutzerereignisinformationen für den Besucher enthalten.

Die Dimensionen, die die Besuchermesswerte charakterisieren, werden gemeinsam durch alle Nutzerereignisse für den Besucher definiert. Siehe Messwertdimensionen wie Dimensionswerte für den Besucher festgelegt werden.

Name des Messwerts Beschreibung
Besucher Besucherzahl

Besuchermesswerte suchen

Ein Besucher einer Suche ist ein Besucher, der mindestens ein Suchereignis durchführt. Ein Suchmaschinenbesucher kann auch ein Besucher sein, der sich die Website nur angesehen hat, wie in den Messwerten für Besucher definiert.

Name des Messwerts Beschreibung
search_visitor Anzahl der Besucher, die mindestens eine Suche ausführen
search_event_from_search_visitor Anzahl der Suchereignisse von Besuchern der Suche
browse_event_from_search_visitor Anzahl der Durchsuchen-Ereignisse von Besuchern über die Suche
detail_page_view_from_search_visitor Anzahl der Aufrufe der Detailseite durch Besucher der Google Suche
add_to_cart_from_search_visitor Anzahl der Ereignisse vom Typ „In den Einkaufswagen“ von Besuchern aus der Suche
add_to_cart_unit_from_search_visitor Anzahl der „In den Einkaufswagen“-Einheiten von Suchbesuchern
purchase_order_from_search_visitor Anzahl der Bestellungen von Besuchern der Google Suche
purchase_unit_from_search_visitor Einheit der Anzahl der Käufe durch Besucher der Suche
revenue_from_search_visitor Umsatz über Suchmaschinenbesucher

Besuchermesswerte ansehen

Ein Suchkampagnenbesucher ist ein Besucher, der mindestens ein Suchereignis ausführt. Beachten Sie, dass ein „Seitenbesucher“ kann auch ein Besucher der Suche sein, wie durch „Suchbesucher“ definiert. Messwerte.

Name des Messwerts Beschreibung
browse_visitor Anzahl der Besucher, die mindestens einen Suchvorgang ausgeführt haben
search_event_from_browse_visitor Anzahl der Suchereignisse von Stöberbesuchen
browse_event_from_browse_visitor Anzahl der Stöberereignisse von Stöberbesuchen
detail_page_view_from_browse_visitor Anzahl der Detailseitenaufrufe von Besuchern der Suchergebnisseite
add_to_cart_from_browse_visitor Anzahl der Ereignisse vom Typ „In den Einkaufswagen“ von Websitebesuchern
add_to_cart_unit_from_browse_visitor Anzahl der Artikeleinheiten vom Typ „In den Einkaufswagen“ von „Stöbern“
purchase_order_from_browse_visitor Anzahl der Bestellungen durch Stöberbesucher
purchase_unit_from_browse_visitor Anzahl der Kaufeinheiten von Besuchern, die sich Produkte angesehen haben
revenue_from_browse_visitor Umsatz durch Stöberbesucher

Nutzungsbeispiel

Wenn Sie Ihre Messwertdaten an ein anderes Ziel kopieren oder exportieren, können Sie SQL verwenden. um allgemeine oder spezifische Informationen zu den exportierten Messwerten zu erhalten. In den folgenden Abschnitten finden Sie einige gängige Möglichkeiten, Ihre exportierten Messwerte mit SQL zu analysieren.

Klickrate (CTR) berechnen

Berechnen Sie die CTR für die Suche pro Datum, Gerätetyp und Traffic-Ziel.

SELECT
  `date`,
  device_type,
  traffic_destination,
  SUM(detail_page_view_from_search) / SUM(search_event) as search_CTR
FROM copied_table
GROUP BY `date`, device_type, traffic_destination

Anzahl der Aufrufe der Detailseite aufgrund von Suchanfragen abrufen

Detailseitenaufrufe abrufen, die aus „Ereignisse durchsuchen“ für Google-Zugriffe mit external_experiment_ids mit test_arm und alle Dimensionen werden angezeigt Informationen. external_experiment_ids wird string Mal wiederholt.

SELECT
  `date`,
  external_experiment_ids,
  device_type,
  serving_config,
  traffic_destination,
  entity,
  detail_page_view_from_browse
FROM copied_table
WHERE
  traffic_destination = 'Google' AND 'test_arm' in UNNEST(external_experiment_ids)

Am häufigsten verwendete Bereitstellungskonfigurationen abrufen

Die am häufigsten verwendeten Bereitstellungskonfigurationen für Google-Traffic vom 01.10.2023 bis zum 01.11.2023 abrufen Jedem Suchereignis sollte eine Auslieferungskonfiguration zugeordnet sein.

SELECT
  serving_config,
  SUM(search_event) as total_search_count
FROM copied_table
WHERE `date` between '2023-10-01' and '2023-11-01' AND traffic_destination = 'Google'
GROUP BY serving_config
ORDER BY total_search_count