Analysemesswerte nach BigQuery exportieren

Auf dieser Seite wird beschrieben, wie Sie Analysemesswerte von Vertex AI Search für den Einzelhandel nach BigQuery exportieren. Wenn Sie Analysemesswerte exportieren, können Sie sie beibehalten und SQL für Ihre eigene Analyse schreiben.

Analysemesswerte von Vertex AI Search für den Einzelhandel werden automatisch für Sie generiert. Weitere Informationen zum Messen der geschäftlichen Auswirkungen von Vertex AI Search für den Einzelhandel mit Analysemesswerten finden Sie unter Analysen ansehen.

Beim Exportieren von Messwertdaten nach BigQuery gelten die folgenden Einschränkungen:

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

  • Sie können die Daten in diesen Tabellen weder ändern noch aktualisieren. Wenn Sie Ihre Daten ändern oder aktualisieren müssen, exportieren oder kopieren Sie die Ansicht 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 diesem Zeitraum generiert wurden, können nicht abgerufen werden.

Hinweise

Bevor Sie Ihre Messwerte in BigQuery exportieren können, müssen Sie die Schritte unter Vorbereitung abgeschlossen haben. Dazu gehört 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 Analysemesswertdaten zu speichern.

Sie müssen die Datasets in dem Projekt erstellen, in dem Sie Vertex AI Search für den Einzelhandel implementiert haben.

  1. Wenn Sie BigQuery noch nicht in Ihrem Projekt verwendet haben, aktivieren Sie die BigQuery API und benötigen Sie die IAM-Rolle zum Erstellen von Datasets und Tabellen.

    Siehe Vorbereitung und Zugriffssteuerung mit IAM

    in der BigQuery-Dokumentation.

  2. Erstellen Sie ein Dataset in BigQuery am multiregionalen Standort USA (mehrere Regionen in den USA). Nennen Sie sie beispielsweise retail_data. Wenn Sie das Dataset in einer anderen Region erstellen, schlägt der Export der Daten in BigQuery fehl. CMEK für das Dataset wird nicht unterstützt. Wenn Sie diese Option aktivieren, schlägt der Export fehl.

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

    Dieses Dataset wird für die Datentabelle(n) verwendet, die Sie exportieren. In den folgenden Verfahren wird beschrieben, wie Sie Daten exportieren.

Analysemesswerte in eine BigQuery-Tabelle exportieren

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

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

  • 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 beispielsweise retail_data oder retail_metrics_data.
  • TABLE_ID_PREFIX: Ein Präfix für die Tabellen-ID. Das Präfix darf kein leerer String sein. Das Suffix retail_analytics_metrics wird hinzugefügt, um den Tabellennamen zu vervollständigen. Wenn das Präfix beispielsweise test lautet, heißt die Tabelle test_retail_analytics_metrics.

JSON-Text anfordern: 

{
  "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 Messwerte für die Anzahl. Bei einigen Zählmesswerten kann es zu leichten Abweichungen kommen, da durch die Bot-Filterung möglicherweise bestimmte Ereignisse aus der Messwertberechnung ausgeschlossen werden. Durch das Filtern von Bots können Sie genauere Leistungsmessungen liefern. Dies hat keine Auswirkungen auf A/B-Tests, die von der Dimension external_experiment_ids abhängen. Die Filterung von Bots wird hingegen auf den gesamten Traffic angewendet.

Messwertdimensionen

Als „Anzahl“-Messwerte werden Rohdaten bezeichnet, die direkt aus relevanten Nutzerereignissen mit denselben Dimensionen aggregiert werden. Um Messwerte zu interpretieren, müssen Sie wissen, auf welchen Dimensionen die Messwerte basieren. Für Analysemesswerte werden Such- und Stöberereignisse 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 der relevanten Ereignisse, von denen die Messwerte generiert wurden.

Bei Impressionsmesswerten ist dies das Datum der Impressionsereignisse.

Bei Sitzungs- und Besuchermesswerten ist dies das Datum des ersten Impressionsereignisses für die Sitzung bzw. den Besucher.
external_experiment_ids

Die Test-IDs der relevanten Ereignisse, von denen die Messwerte generiert wurden.

Bei Impressionsmesswerten ist dies die Test-ID des Impressionsereignisses.

Bei Sitzungs- und Besuchermesswerten ist dies die Verkettung der eindeutigen externen Test-IDs aller Impressionsereignisse, die in der Sitzung bzw. am Besucher zu sehen sind. Bei zwei Suchereignissen innerhalb einer Sitzung bzw. eines Besuchers hat das erste Suchereignis „external_experiment_ids „test_arm_1,test_arm_2“ und das zweite „external_experiment_ids“ „test_arm_1,test_arm_3“.
device_type

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

Bei Impressionsmesswerten ist dies der Gerätetyp des Impressionsereignisses.

Bei Sitzungs- und Besuchermesswerten ist dieses Feld leer, wenn die Sitzung bzw. der Besucher mehrere Gerätetypen hat oder nur einen Gerätetyp für die gesamte Sitzung bzw. den gesamten Besucher.
serving_config

Die Bereitstellungskonfiguration der relevanten Ereignisse, von denen die Messwerte generiert wurden.

Bei Impressionsmesswerten ist dies die Bereitstellungskonfiguration des Impressionsereignisses.

Bei Sitzungs- und Besuchermesswerten ist dieses Feld leer, wenn die Sitzung bzw. der Besucher mehrere verschiedene Bereitstellungskonfigurationen hat oder nur eine Bereitstellungskonfiguration für die gesamte Sitzung bzw. den gesamten Besucher gibt.
traffic_destination

Die Quelle der relevanten Ereignisse, von denen die Messwerte generiert wurden.

Bei Impressionsmesswerten ist der Wert entweder „Google“, wenn die Impression von Google erzielt wurde, oder „Nicht von Google“, wenn die Impression mit Ihrer eigenen Lösung erzielt wurde.

Bei Sitzungs- und Besuchermesswerten lautet der Wert „Gemischt“, wenn für die Sitzung und für den Besucher sowohl Impressionsereignisse erfasst wurden, die sowohl von Google als auch von Ihrer eigenen Lösung ausgeliefert wurden. Dabei handelt es sich um „Google“, wenn die Impressionsereignisse ausschließlich von Google bereitgestellt werden, oder „Nicht-Google“, wenn sie ausschließlich von Ihrer Lösung für die gesamte Sitzung bzw. den gesamten Besucher ausgeliefert werden.
Entität

Es wird von Einzelhändlern verwendet, die mehrere Markenwebsites oder -regionen mit einem einzigen Produktkatalog betreiben. Die Entität repräsentiert normalerweise die Marken oder Standorte.

Bei Impressionsmesswerten handelt es sich dabei um das Impressionsereignis.

Bei Sitzungs- und Besuchermesswerten sind dies die fünf am häufigsten gezählten Elemente 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) können nur dann einem Impressionsereignis zugeordnet werden, wenn sie die folgenden Kriterien erfüllen.

  • Das Impressionsereignis und das Conversion-Ereignis haben denselben Besucher.

  • Die Produkt-ID des Conversion-Ereignisses muss in den Ergebnissen des Impressionsereignisses angezeigt werden.

  • Das Conversion-Ereignis liegt innerhalb des erforderlichen Zeitfensters nach Eintritt des Impressionsereignisses. Für unterschiedliche Arten von Conversion-Ereignissen gelten unterschiedliche Conversion-Zeiträume.

    Conversion-Pfad Conversion-Zeitraum
    Impression -> Detailseitenansicht 60 Sekunden
    Impression -> In den Warenkorb 24 Stunden
    Impression -> Kauf 48 Stunden

Messwerte für Impressionen im Suchnetzwerk

Name des Messwerts Beschreibung
search_event Anzahl der Suchereignisse
detail_page_view_from_search Ereignisanzahl für Detailseitenaufrufe aus der Suche
add_to_cart_unit_from_search Anzahl der in den Einkaufswagen gelegten Einheiten über die Suche
purchase_unit_from_search Anzahl der Kaufeinheiten aus der Suche
revenue_from_search Umsatz aus Suche
search_event_without_result Anzahl der Suchereignisse, die keine Ergebnisse liefern
search_request_personalization_enabled Anzahl der Suchanfragen mit aktivierter Personalisierung
search_request_personalization_result_served Anzahl der Suchanfragen für personalisierte Ergebnisse

Messwerte zu Impressionen ansehen

Name des Messwerts Beschreibung
browse_event Anzahl der Stöberereignisse
detail_page_view_from_browse Ereignisanzahl der Detailseite aus „Durchsuchen“
add_to_cart_unit_from_browse Anzahl der in den Einkaufswagen gelegten Einheiten aus der Suche
purchase_unit_from_browse Anzahl der Kaufeinheiten aus der Suche
revenue_from_browse Umsatz aus Stöbern
browse_event_without_result Anzahl der Durchsuchen-Ereignisse, die keine Ergebnisse liefern
browse_request_personalization_enabled Anzahl der Stöberanfragen mit aktivierter Personalisierung
browse_request_personalization_result_served Anzahl der Stöberanfragen mit personalisierten Ergebnissen

Sitzungsmesswerte

Eine Sitzung ist ein kontinuierlicher Zeitraum der Interaktion zwischen einem Nutzer und dem System. Jedes Nutzerereignis markiert den Beginn einer Sitzung und das Ende einer Sitzung, wenn innerhalb der nächsten 30 Minuten kein anderes Ereignis auftritt. Die Sitzung wird jedes Mal um weitere 30 Minuten verlängert, wenn innerhalb 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 der Sitzungsmesswerte werden gemeinsam durch alle Nutzerereignisse innerhalb der Sitzung definiert. Informationen zum Festlegen von Dimensionswerten für die Sitzung finden Sie unter Messwertdimensionen.

Name des Messwerts Beschreibung
session Sitzungsanzahl

Messwerte für Suchsitzungen

Eine Suchsitzung enthält mindestens ein Suchereignis. Eine Suchsitzung kann auch eine Browsersitzung sein, wie in den Messwerten für das Durchsuchen von Sitzungen definiert.

Name des Messwerts Beschreibung
search_session Anzahl der Sitzungen mit einer Suche
search_event_in_search_session Anzahl der Suchereignisse in Suchsitzungen
browse_event_in_search_session Anzahl der Ereignisse in Suchsitzungen durchsuchen
detail_page_view_in_search_session Anzahl der Detailseitenaufrufe in Suchsitzungen
add_to_cart_in_search_session Anzahl der Ereignisse vom Typ „In den Einkaufswagen“ innerhalb von Suchsitzungen
add_to_cart_unit_in_search_session Anzahl der in den Einkaufswagen gelegten Einheiten innerhalb von Suchsitzungen
purchase_order_in_search_session Anzahl der Bestellungen in Suchsitzungen
purchase_unit_in_search_session Anzahl der Kaufeinheiten in Suchsitzungen
revenue_in_search_session Umsatz in Suchsitzungen
bounce_count_in_search_session Sitzungsanzahl des Besuchers, der die Website verlässt, nachdem er innerhalb von Suchsitzungen nur eine Seite aufgerufen hat

Sitzungsmesswerte ansehen

Eine Stöbersitzung enthält mindestens ein Stöberereignis. Eine Browsersitzung kann auch eine Suchsitzung sein, wie in den Messwerten für Suchsitzungen definiert.

Name des Messwerts Beschreibung
browse_session Anzahl der Sitzungen mit Stöbern
search_event_in_browse_session Anzahl der Suchereignisse in Browsersitzungen
browse_event_in_browse_session Anzahl der Stöberereignisse in Browsersitzungen
detail_page_view_in_browse_session Anzahl der Aufrufe der Detailseite in den Browsersitzungen
add_to_cart_in_browse_session Anzahl der Ereignisse vom Typ „In den Einkaufswagen“ innerhalb von Browsersitzungen
add_to_cart_unit_in_browse_session Anzahl der in den Einkaufswagen gelegten Einheiten innerhalb von Browsersitzungen
purchase_order_in_browse_session Anzahl der Bestellungen innerhalb von Browsersitzungen
purchase_unit_in_browse_session Anzahl der Kaufeinheiten in Stöbersitzungen
revenue_in_browse_session Umsatz in Stöbersitzungen
bounce_count_in_browse_session Sitzungsanzahl des Besuchers, der die Website verlässt, nachdem er innerhalb von Browsersitzungen nur eine Seite aufgerufen hat

Besuchermesswerte

Ein Besucher wird eindeutig durch die Besucher-ID identifiziert. In Besuchermesswerten werden alle Nutzerereignisinformationen für den Besucher zusammengefasst.

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

Name des Messwerts Beschreibung
Besucher Besucheranzahl

Messwerte zu Besuchern im Suchnetzwerk

Ein Besucher einer Suche ist ein Besucher, der mindestens ein Suchereignis ausführt. Ein Besucher der Suche kann auch ein Besucher sein, der durch die Messwerte zum Durchsuchen von Besuchern definiert wird.

Name des Messwerts Beschreibung
search_visitor Anzahl der Besucher, die mindestens eine Suche durchgeführt haben
search_event_from_search_visitor Anzahl der Suchereignisse von Besuchern der Suche
browse_event_from_search_visitor Anzahl der Stöberereignisse von Besuchern der Suche
detail_page_view_from_search_visitor Anzahl der Aufrufe der Detailseite von Besuchern
add_to_cart_from_search_visitor Anzahl der Ereignisse vom Typ „In den Einkaufswagen“ von Websitebesuchern
add_to_cart_unit_from_search_visitor Anzahl der in den Einkaufswagen gelegten Anzeigenblöcke von Websitebesuchern
purchase_order_from_search_visitor Anzahl der Bestellungen von Besuchern der Suche
purchase_unit_from_search_visitor Anzahl der Käufe von Besuchern der Suche
revenue_from_search_visitor Umsatz durch Suchbesucher

Besuchermesswerte durchsuchen

Ein Stöberbesucher ist ein Besucher, der mindestens ein Stöberereignis ausführt. Ein Browser-Besucher kann auch ein Besucher sein, der durch die Messwerte zu Besuchern der Suche definiert ist.

Name des Messwerts Beschreibung
browse_visitor Anzahl der Besucher, die mindestens einmal gestöbert haben
search_event_from_browse_visitor Anzahl der Suchereignisse von Browserbesuchen
browse_event_from_browse_visitor Anzahl der Stöberereignisse von Browserbesuchen
detail_page_view_from_browse_visitor Anzahl der Aufrufe der Detailseite von Besuchern der Seite
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 in den Einkaufswagen gelegten Einheiten von Besuchern dieser Kategorie
purchase_order_from_browse_visitor Anzahl der Bestellungen von Besuchern der Website
purchase_unit_from_browse_visitor Anzahl der Kaufeinheiten von Stöbern
revenue_from_browse_visitor Umsatz durch Besucher, die die Funktion „Stöbern“ generiert haben

Nutzungsbeispiel

Wenn Sie Ihre Messwertdaten an 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, wie Sie Ihre exportierten Messwerte mit SQL untersuchen können.

Klickrate (CTR) berechnen

Berechnen Sie die CTR für die Suche nach 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 auf Stöbervorgänge abrufen

Rufen Sie Detailseitenereignisse aus Suchereignissen für Google-Traffic ab, wobei external_experiment_ids den Wert test_arm enthält, und zeigen Sie alle Dimensionsinformationen an. external_experiment_ids wird string 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

Rufen Sie die zwischen dem 01.10.2023 und dem 01.11.2023 am häufigsten verwendeten Bereitstellungskonfigurationen für Google-Traffic ab. Jedem Suchereignis sollte eine Bereitstellungskonfiguration 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