Analysemesswerte nach BigQuery exportieren

Auf dieser Seite wird beschrieben, wie Sie Analysemesswerte von Vertex AI Search for Retail nach BigQuery exportieren. Durch den Export von Analysemesswerten können Sie die Messwerte 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äftsauswirkungen von Vertex AI Search für den Einzelhandel mit Analysemesswerten finden Sie unter Analysen ansehen.

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

  • Die Daten, die in BigQuery-Tabellen in Ihrem Vertex AI Search for Retail-Projekt 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 an 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 dem 180-Tage-Zeitraum generiert wurden, können nicht abgerufen werden.

Hinweise

Bevor Sie Ihre Messwerte nach BigQuery exportieren können, müssen Sie die Schritte unter Vorbereitung ausgeführt haben. Dazu gehört das Importieren Ihrer Nutzerereignisse und optional Ihrer Kataloginformationen.

Weitere Informationen zum Importieren finden Sie hier:

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 for Retail implementiert haben.

  1. Wenn Sie BigQuery noch nicht in Ihrem Projekt verwendet haben, aktivieren Sie die BigQuery API und prüfen Sie, ob Sie die IAM-Rolle zum Erstellen von Datasets und Tabellen haben.

    Siehe Vorbereitung und Zugriffssteuerung mit IAM

    in der BigQuery-Dokumentation.

  2. Erstellen Sie in BigQuery ein Dataset am multiregionalen Standort US (mehrere Regionen in den USA). Nennen Sie sie z. B. retail_data. Wenn Sie Ihr Dataset in einer anderen Region erstellen, schlägt der Export Ihrer Daten nach BigQuery fehl. Der CMEK für das Dataset wird nicht unterstützt. Wenn Sie ihn 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 Datentabellen verwendet, die Sie exportieren. Im Folgenden wird das Exportieren beschrieben.

Analysemesswerte in eine BigQuery-Tabelle exportieren

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

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: Präfix für die Tabellen-ID. Dieses 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, hat die Tabelle den Namen 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 Messwerten kann es zu leichten Abweichungen kommen, da durch die Botfilterung möglicherweise einige Ereignisse von der Messwertberechnung ausgeschlossen werden. Durch das Filtern von Bots lassen sich genauere Leistungsmessungen vornehmen. Dies hat keine Auswirkungen auf A/B-Tests, die von der Dimension external_experiment_ids abhängen. Die Botfilterung wird dagegen auf den gesamten Traffic angewendet.

Messwertdimensionen

Die Messwerte sind die Rohdaten, 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 Stöberereignisse als Impressionsereignisse und detail_page_view-, add_to_cart- und purchase-Ereignisse als Conversion-Ereignisse bezeichnet. In der folgenden Tabelle sind die Dimensionen für Messwerte definiert.

Messwertdimension Beschreibung
date

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 bzw. 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 handelt es sich hierbei um die Verkettung der eindeutigen externen Test-IDs aller Impressionsereignisse, die in der Sitzung bzw. dem Besucher auftreten. Wenn es z. B. 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 dieser Wert leer, wenn die Sitzung oder der Besucher mehrere unterschiedliche Gerätetypen hat oder wenn es nur einen Gerätetyp für die gesamte Sitzung bzw. den gesamten Besucher gibt.
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 dieser Wert leer, wenn die Sitzung/der Besucher mehr als eine unterschiedliche Bereitstellungskonfiguration hat, oder diejenige, wenn nur eine Bereitstellungskonfiguration für die gesamte Sitzung bzw. den gesamten Besucher vorhanden ist.
traffic_destination

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

Bei Messwerten zu Impressionen lautet der Wert entweder „Google“, wenn die Impression von Google erzielt wird, oder „Nicht von Google“, wenn die Impression von Ihrer eigenen Lösung stammt.

Bei Sitzungs- und Besuchermesswerten lautet dieser Wert „Gemischt“, wenn für die Sitzung bzw. den Besucher sowohl von Google als auch von Ihrer eigenen Lösung ausgelieferte Impressionsereignisse erfasst wurden. Dies ist „Google“, wenn die Impressionsereignisse ausschließlich von Google erfasst werden, oder „Nicht-Google“, wenn sie nur von Ihrer Lösung für die gesamte Sitzung bzw. den gesamten Besucher erfasst werden.
Entität

Sie wird von Einzelhändlern verwendet, die mehrere Markenwebsites oder ‐regionen mit einem einzigen Produktkatalog anbieten. Das Element repräsentiert in der Regel die Marken oder Standorte.

Bei Impressionsmesswerten ist dies die Entität des Impressionsereignisses.

Bei Sitzungs- und Besuchermesswerten sind dies die fünf am häufigsten gezä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) 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 dem Auftreten des Impressionsereignisses. Für unterschiedliche Arten von Conversion-Ereignissen gelten unterschiedliche Conversion-Zeiträume.

    Conversion-Pfad Conversion-Zeitfenster
    Impression -> Detailseitenansicht 60 Sekunden
    Impression -> In den Einkaufswagen 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 Anzahl der Detailseitenaufrufe aus der Suche
add_to_cart_unit_from_search Anzahl der Einheiten für „In den Einkaufswagen“ aus der Suche
purchase_unit_from_search Anzahl der gekauften Einheiten aus der Suche
revenue_from_search Umsatz aus der 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 die personalisierte Ergebnisse bereitgestellt wurden

Messwerte zu Impressionen ansehen

Name des Messwerts Beschreibung
browse_event Anzahl der Stöberereignisse
detail_page_view_from_browse Anzahl der aufgerufenen Detailseiten aus dem Stöberverhalten
add_to_cart_unit_from_browse Anzahl der Einheiten im Einkaufswagen „In den Einkaufswagen“ aus „Durchsuchen“
purchase_unit_from_browse Anzahl der gekauften Einheiten in der Kategorie „Stöbern“
revenue_from_browse Umsatz aus Stöbervorgängen
browse_event_without_result Anzahl der Stöberereignisse, die keine Ergebnisse liefern
browse_request_personalization_enabled Anzahl der Stöberanfragen mit aktivierter Personalisierung
browse_request_personalization_result_served Anzahl der Stöberanfragen, die mit personalisierten Ergebnissen beantwortet wurden

Sitzungsmesswerte

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

Die Dimensionen, die die Sitzungsmesswerte beschreiben, werden durch alle Nutzerereignisse während der Sitzung gemeinsam definiert. Informationen dazu, wie Dimensionswerte für die Sitzung festgelegt werden, finden Sie unter Messwertdimensionen.

Name des Messwerts Beschreibung
session Anzahl der Sitzungen

Sitzungsmesswerte suchen

Eine Suchsitzung ist eine Sitzung, die mindestens ein Suchereignis enthält. Eine Suchsitzung kann auch eine Suchsitzung sein, wie durch die Messwerte für Surfsitzungen definiert.

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 Stöberereignisse 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 Einheiten vom Typ „In den Einkaufswagen“ in 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 in Suchsitzungen
bounce_count_in_search_session Anzahl der Sitzungen des Besuchers, der die Website verlässt, nachdem er innerhalb der Suchsitzungen nur eine Seite aufgerufen hat

Sitzungsmesswerte ansehen

Eine Browsersitzung ist eine Sitzung, die mindestens ein Stöberereignis enthält. Eine Browsersitzung kann auch eine Suchsitzung sein, wie durch die Messwerte für die Suchsitzung definiert.

Name des Messwerts Beschreibung
browse_session Anzahl der Sitzungen mit Durchsuchen
search_event_in_browse_session Anzahl der Suchereignisse in Stöbersitzungen
browse_event_in_browse_session Anzahl der Stöberereignisse in Stöbersitzungen
detail_page_view_in_browse_session Anzahl der Detailseitenaufrufe in Stöbersitzungen
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 Einheiten in Stöbersitzungen
revenue_in_browse_session Umsatz in Stöbersitzungen
bounce_count_in_browse_session Anzahl der Sitzungen des Besuchers, der die Website verlässt, nachdem er während der Surfsitzungen nur eine Seite aufgerufen hat

Besucherkennzahlen

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

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

Name des Messwerts Beschreibung
Besucher Besucheranzahl

Besuchermesswerte suchen

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

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 Google 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 Anzeigenblöcke vom Typ „In den Einkaufswagen“ von Besuchern, die eine Suche durchgeführt haben
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 durch Besucher der Google Suche

Besuchermesswerte durchsuchen

Ein Besucher des Stöberns ist ein Besucher, der mindestens ein Durchsuchen-Ereignis durchführt. Ein Besucher kann auch ein Besucher der Suche sein, wie durch die Messwerte für Suchbesucher definiert.

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 Seitenaufrufe durch Stöberbesucher
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 Stöberbesuchern
revenue_from_browse_visitor Umsatz durch Stöberbesucher

Nutzungsbeispiel

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

Klickrate (Click-through-Rate, 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 durchstöbernden Detailseite abrufen

Sie können Ereignisse vom Typ „Aufruf der Detailseite“ abrufen, die aus Stöberereignissen für Google-Traffic stammen, wobei external_experiment_ids den Wert test_arm enthält. Außerdem werden alle Dimensionsinformationen angezeigt. 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 am häufigsten verwendeten Bereitstellungskonfigurationen für Google-Traffic zwischen dem 01.10.2023 und dem 01.11.2023 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