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.

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

Beim Exportieren von Messwertdaten nach BigQuery gelten die folgenden 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, oder Messwerte, die vor mehr als 180 Tagen generiert wurden. Messwerte, die vor Ablauf des 180-tägigen Zeitraums generiert wurden, können nicht abgerufen werden.

Hinweise

Bevor Sie Ihre Messwerte in BigQuery exportieren können, müssen Sie die Schritte unter Vorbereitung ausführen. Dazu gehören der Import Ihrer Nutzerereignisse und optional Ihrer Kataloginformationen.

Weitere Informationen zum Importieren finden Sie unter:

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 der Multiregion USA (mehrere Regionen in den USA). Benennen Sie ihn beispielsweise 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 wird nicht unterstützt. Wenn Sie diese Option aktivieren, schlägt der Export fehl.

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

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

Analysemesswerte in eine BigQuery-Tabelle exportieren

Verwenden Sie die Methode exportAnalyticsMetrics, um Ihren Retail-Katalog in eine BigQuery-Tabelle zu exportieren.

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: Ein 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 Zählmesswerten kann es zu leichten Abweichungen kommen, da einige Ereignisse durch die Bot-Filterung möglicherweise von der Berechnung der Messwerte ausgeschlossen werden. Durch den Bot-Filter können Sie genauere Leistungsmessungen vornehmen. A/B-Tests, die von der Dimension external_experiment_ids abhängen, sind davon nicht betroffen. Die Bot-Filterung wird dagegen auf den gesamten Traffic angewendet.

Messwertdimensionen

Die Anzahlsmesswerte sind die Rohzahlen, die direkt aus relevanten Nutzerereignissen mit denselben Dimensionen aggregiert werden. Um Messwerte zu interpretieren, müssen Sie wissen, auf welchen Dimensionen sie basieren. Für Analysemesswerte werden Such- und Suchansichtsereignisse als Impressionsereignisse und detail_page_view-, add_to_cart- und purchase-Ereignisse als Conversion-Ereignisse bezeichnet. In der folgenden Tabelle werden Messwertdimensionen definiert.

Messwertdimension Beschreibung
Datum

Das Datum des Ereignisses bzw. der Ereignisse, durch die die Messwerte generiert wurden.

Bei Impressionsmesswerten ist dies das Datum der Impressionsereignisse.

Bei Messwerten für Sitzungen und Besucher ist dies das Datum des ersten Eindrucksereignisses der Sitzung bzw. des Besuchers.
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. Wenn es beispielsweise zwei Suchen innerhalb einer Sitzung oder eines Besuchers gibt, das erste Suchereignis „external_experiment_ids“ mit „test_arm_1,test_arm_2“ und das zweite Suchereignis „external_experiment_ids“ mit „test_arm_1,test_arm_3“ hat, lautet „external_experiment_ids“ der Sitzung oder des Besuchers „test_arm_1,test_arm_2,test_arm_3“.
device_type

Der Gerätetyp der relevanten Ereignisse, die die Messwerte generiert haben, 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 Produktkatalog bedienen. 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.

Impressionsmesswerte

Impressionsmesswerte werden gemäß den Voraussetzungen berechnet. Conversion-Ereignisse (detail_page_view-, add_to_cart- und purchase-Ereignisse) können einem Impressionsereignis nur dann zugeordnet werden, wenn sie den folgenden Kriterien entsprechen.

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

  • Die Produkt-ID des Conversion-Ereignisses muss in den Ergebnissen des Impressionsereignisses enthalten sein.

  • Das Conversion-Ereignis liegt innerhalb des erforderlichen Zeitfensters nach dem Impressionsereignis. Für verschiedene Conversion-Ereignisse gelten unterschiedliche Conversion-Tracking-Zeiträume.

    Conversion-Pfad Conversion-Tracking-Zeitraum
    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 Detailseitenaufruf-Ereignisse 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 Suchanfragen, 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. Das Ende einer Sitzung wird markiert, wenn in den nächsten 30 Minuten kein weiteres Ereignis auftritt. Die Sitzung wird jeweils um 30 Minuten verlängert, wenn in einer gestarteten Sitzung ein Nutzerereignis auftritt. Nach dem Ende einer Sitzung beginnt eine neue Sitzung, wenn der Nutzer wieder mit dem System interagiert.

Die Dimensionen, die die Sitzungsmesswerte charakterisieren, werden gemeinsam von allen Nutzerereignissen innerhalb der Sitzung definiert. Weitere Informationen dazu, wie Dimensionswerte für die Sitzung festgelegt werden, finden Sie unter Messwertdimensionen.

Name des Messwerts Beschreibung
Sitzung Sitzungsanzahl

Messwerte für Suchsitzungen

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

Name des Messwerts Beschreibung
search_session Anzahl der Sitzungen mit Suchanfrage
search_event_in_search_session Anzahl der Suchereignisse innerhalb von Suchsitzungen
browse_event_in_search_session Anzahl der Durchsuchen-Ereignisse in Suchsitzungen
detail_page_view_in_search_session Anzahl der Aufrufe von Detailseiten innerhalb von Suchsitzungen
add_to_cart_in_search_session Anzahl der „In den Einkaufswagen“-Ereignisse innerhalb von Suchsitzungen
add_to_cart_unit_in_search_session Anzahl der „In den Einkaufswagen“-Einheiten innerhalb von Suchsitzungen
purchase_order_in_search_session Anzahl der Bestellungen innerhalb von Suchsitzungen
purchase_unit_in_search_session Anzahl der gekauften Artikel in Suchsitzungen
revenue_in_search_session Umsatz aus Suchsitzungen
bounce_count_in_search_session Sitzungsanzahl 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 Suchsitzungen
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 „In den Einkaufswagen“-Ereignisse in Sitzungen mit Suchanfragen
add_to_cart_unit_in_browse_session Anzahl der „In den Einkaufswagen“-Einheiten in Suchsitzungen
purchase_order_in_browse_session Anzahl der Aufträge in Suchsitzungen
purchase_unit_in_browse_session Anzahl der gekauften Artikel in Sitzungen mit Suchanfragen
revenue_in_browse_session Umsatz aus Suchsitzung
bounce_count_in_browse_session Sitzungsanzahl des Besuchers, der die Website verlässt, nachdem er sich innerhalb einer Sitzung nur eine Seite angesehen hat

Besuchermesswerte

Ein Besucher wird durch die Besucher-ID eindeutig identifiziert. Besuchermesswerte fassen alle Informationen zu Nutzerereignissen für den Besucher zusammen.

Die Dimensionen, die die Besuchermesswerte charakterisieren, werden gemeinsam durch alle Nutzerereignisse für den Besucher definiert. Weitere Informationen dazu, wie Dimensionswerte für den Besucher festgelegt werden, finden Sie unter Messwertdimensionen.

Name des Messwerts Beschreibung
Besucher Besucherzahl

Messwerte für Besucher der Suche

Ein Suchbesucher ist ein Besucher, der mindestens ein Suchereignis ausführt. Ein Suchbesucher kann auch ein Besucher sein, der sich die Website nur angesehen hat, wie in den Messwerten für Besucher, die sich die Website nur angesehen haben 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 über die 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 Suche
add_to_cart_from_search_visitor Anzahl der „In den Einkaufswagen“-Ereignisse von Besuchern über die 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 über die Suche
purchase_unit_from_search_visitor Kaufanzahl von Besuchern der Suche
revenue_from_search_visitor Umsatz über Suchmaschinenbesucher

Besuchermesswerte ansehen

Ein Sucher ist ein Besucher, der mindestens ein Suchereignis ausführt. Ein Besucher, der sich die Website angesehen hat, kann auch ein Suchbesucher sein, wie in den Messwerten für Suchbesucher definiert.

Name des Messwerts Beschreibung
browse_visitor Anzahl der Besucher, die mindestens eine Suchanfrage ausführen
search_event_from_browse_visitor Anzahl der Suchereignisse von Besuchern, die sich nur umgesehen haben
browse_event_from_browse_visitor Anzahl der Durchsuchen-Ereignisse von Besuchern der Website mit Suchfunktion
detail_page_view_from_browse_visitor Anzahl der Detailseitenaufrufe von Besuchern der Suchergebnisseite
add_to_cart_from_browse_visitor Anzahl der „In den Einkaufswagen“-Ereignisse von Besuchern, die sich Produkte angesehen haben
add_to_cart_unit_from_browse_visitor Anzahl der „In den Einkaufswagen“-Einheiten von Besuchern, die sich Produkte angesehen haben
purchase_order_from_browse_visitor Anzahl der Aufträge von Besuchern, die sich Produkte angesehen haben
purchase_unit_from_browse_visitor Anzahl der Kaufeinheiten von Besuchern, die sich Produkte angesehen haben
revenue_from_browse_visitor Umsatz aus Suchanfragen

Nutzungsbeispiel

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

Klickrate (CTR) berechnen

CTR für Suchanfragen pro Datum, pro Gerätetyp und pro Besucherziel berechnen

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 Seitenaufrufe auf Detailseiten aufgrund von Suchanfragen abrufen

Rufen Sie Detailseitenaufruf-Ereignisse ab, die aus Suchanfragen für Google-Traffic mit external_experiment_ids stammen, die test_arm enthält, und zeigen Sie alle Dimensionsinformationen an. 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