Personalisierungsdaten mit BigQuery prüfen

Remote Config Personalisierung protokolliert ein personalization_assignment Analytics-Ereignis, wenn einem Nutzer eine Personalisierung zugewiesen wird. So können Sie Personalisierungsereignisse und zugehörige Ereignisse in BigQuery untersuchen und analysieren.

In den folgenden Abschnitten wird beschrieben, wie Sie den BigQuery Export für Analytics Ereignisse aktivieren und wie Personalisierungsereignisse gespeichert werden. Außerdem finden Sie einige grundlegende Abfragen für den Einstieg.

BigQuery-Export für Google Analytics für Firebase aktivieren

Wenn Sie den Spark-Tarif nutzen, können Sie die BigQuery Sandbox verwenden, um kostenlos auf BigQuery zuzugreifen. Dabei gelten die Sandbox-Limits. Weitere Informationen finden Sie unter Preise und BigQuery-Sandbox.

Prüfen Sie zuerst, ob Sie Ihre Analytics Daten nach BigQuery exportieren:

  1. Öffnen Sie in der Firebase console den Integrations Tab, den Sie über > Projekteinstellungen aufrufen können.
  2. Wenn Sie BigQuery bereits mit anderen Firebase-Diensten verwenden, klicken Sie auf Verwalten. Klicken Sie andernfalls auf Verknüpfen.
  3. Lesen Sie die Informationen unter Firebase mit BigQuery verknüpfen und klicken Sie dann auf Weiter.
  4. Aktivieren Sie im Abschnitt Integration konfigurieren die Option Google Analytics.
  5. Wählen Sie eine Region aus und legen Sie die Exporteinstellungen fest.

  6. Klicken Sie auf Mit BigQuery verknüpfen.

Je nachdem, wie Sie die Daten exportiert haben, kann es bis zu einem Tag dauern, bis die Tabellen verfügbar sind. Weitere Informationen zum Exportieren von Projektdaten nach BigQuery finden Sie unter Projektdaten nach BigQuery exportieren.

Als Nächstes greifen wir auf unsere Personalisierungsereignisse in BigQuery zu und untersuchen sie.

Mit BigQuery auf Personalisierungsdaten zugreifenRemote Config

So fragen Sie Analytics-Daten für einen Test ab:

  1. Öffnen Sie BigQuery in der Google Cloud Konsole. Sie können BigQuery auch direkt über AnalyticsEreignisse öffnen. Klicken Sie dazu unten auf der Seite auf den Link Rohereignisse in BigQueryansehen.
  2. Wählen Sie Ihr Firebase Projekt aus und maximieren Sie es. Maximieren Sie dann den analytics_ANALYTICS_PROPERTY_ID Eintrag und klicken Sie auf events_.

    Auf Personalisierungsereignisse in der Cloud Console zugreifen

  3. Wählen Sie im Drop-down-Menü Abfrage die Option In neuem Tab aus.

    Eine automatisch generierte Beispielabfrage wird angezeigt.

  4. Wenn Sie Personalisierungsereignisse und zugehörige Daten aufrufen möchten, aktualisieren Sie die Abfrage, um personalization_assignment-Ereignisse auszuwählen. Die folgende Beispielabfrage gibt ein vollständiges Ereignis zur Personalisierungszuweisung für einen bestimmten Datumsshard zurück und beschränkt die Ergebnisse auf 10:

    # Select all personalization_assignment events
    SELECT *
    FROM `PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10
    

    Tipp: Wenn Sie alle Ereignistabellen anstelle der Shard-Tabelle durchsuchen möchten, können Sie das Datum der Ereignistabelle durch ein Sternchen ersetzen (z. B. PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_*). Dies wird in Nicht-Testszenarien oder bei großen Datensätzen nicht empfohlen.

  5. Wählen Sie im Abfrageeditor Abfrage ausführen aus. Die Ergebnisse werden im unteren Bereich angezeigt.

Im nächsten Abschnitt gehen wir genauer darauf ein, was in einem Ereignis zur Personalisierungszuweisung enthalten ist.

Welche Personalisierungsdaten werden nach BigQuery exportiert?

Personalisierungsdaten sind in Google Analytics Tabellen in BigQuery enthalten und werden in personalization_assignment Ereignissen gespeichert.

Die grundlegenden Felder in einem Personalisierungsereignis sind dieselben wie bei jedem Analytics Ereignis, wie unter [GA4] BigQuery Exportschema beschrieben. Sie beziehen sich hauptsächlich auf user_pseudo_id(mit der sich verschiedene Nutzer unterscheiden lassen), Ereigniszeitstempel und andere Nutzereigenschaften.

Personalisierungsspezifische Details werden im Feld event_params gespeichert und sind in der folgenden Tabelle beschrieben:

Parameter Datentyp Beschreibung
personalization_id STRING Enthält die Universally Unique Identifier (UUID) der zugewiesenen Personalisierung.
group STRING Gibt an, ob der Nutzer der Personalisierungsgruppe (P13N) oder der Baseline-Gruppe (BASELINE) zugewiesen wurde.
arm_index INTEGER Stellt den alternativen Wert dar, der dem Nutzer zugewiesen wurde. Es ist eine Ganzzahl zwischen 0 und 4.
arm_key STRING Enthält den Parameternamen, der von der Personalisierung verwendet wird.
arm_value STRING Enthält den alternativen Wertstring, der von der Personalisierung zugewiesen wurde.
engaged_session_event INTEGER Enthält die Anzahl der Sitzungen, in denen der Nutzer aktiv ist. Weitere Informationen finden Sie unter Sitzungen.
firebase_event_origin STRING Gibt die Quelle des Ereignisses an. Für personalization_assignment Ereignisse ist dies immer fp.
firebase_screen_class STRING Enthält den Klassennamen des Bildschirms, auf dem der Nutzer aktiv war, als die Personalisierungszuweisung erfolgte. Weitere Informationen finden Sie unter Automatisch erfasste Ereignisse.
firebase_screen_id INTEGER Enthält die ID des Bildschirms, auf dem sich der Nutzer befand, als die Personalisierungs zuweisung erfolgte. Weitere Informationen finden Sie unter Automatisch erfasste Ereignisse.
first_open_time STRING Enthält den Zeitstempel in UTC-Millisekunden, als der Nutzer die App zum ersten Mal geöffnet hat. Weitere Informationen finden Sie unter Automatisch erfasste Ereignisse.
ga_session_id INTEGER Enthält die Google Analytics Sitzungs-ID. Weitere Informationen finden Sie unter Sitzungen. Mit dieser ID können Sie das personalization_assignment Ereignis mit anderen Analytics Ereignissen verknüpfen.
ga_session_number INTEGER Enthält die Google Analytics Sitzungsnummer. Weitere Informationen finden Sie unter Sitzungen.

Beispielabfragen

Mit einer SQL-Anweisung wie der folgenden können Sie die personalisierungsspezifischen Parameter aus personalization_assignment-Ereignissen extrahieren:

    # Expand nested personalization parameters
    SELECT
     timestamp_micros(event_timestamp) AS event_time,
     user_pseudo_id,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'group'
     ) AS personalization_group,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'personalization_id'
     ) AS personalization_id,
     (
       SELECT event_params.value.string_value,
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'arm_key'
     ) AS arm_key,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'arm_value'
     ) AS arm_value,
     (
       SELECT event_params.value.int_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'ga_session_id'
     ) AS ga_session_id,
    FROM `PROJECT_NAME.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10