Skip to main content
Data-Warehouse-Integrationen sind als Premium-Add-on für das Modul Web Experimentation und Feature Experimentation von Kameleoon verfügbar. Wenden Sie sich für weitere Informationen an Ihren Customer Success Manager.
Mit der BigQuery-Integration kann Kameleoon Daten aus Ihrem BigQuery-Projekt für Audience-Targeting und Reporting lesen und Experiment-Expositionsereignisse an Ihr BigQuery-Projekt zurücksenden. Kameleoon unterstützt die Data-Warehouse-Integration mit folgenden Anbietern:
  • BigQuery
  • Snowflake
  • Redshift
  • Databricks

BigQuery-Projekt mit Kameleoon verbinden

Voraussetzungen

Um diese Integration zu konfigurieren, benötigen Sie Folgendes:
  • Google Cloud-Konto: Sie benötigen ein gültiges Google Cloud-Konto, um auf Google BigQuery zuzugreifen und die erforderlichen Anmeldedaten zu erstellen.
  • Google Service Account: Sie benötigen einen Google Service Account mit den passenden Berechtigungen für den Zugriff auf BigQuery und die Erstellung von Anmeldedaten.
  • BigQuery-Projekt: Sie benötigen ein eingerichtetes Google BigQuery-Projekt, in dem Sie Daten speichern und abfragen.
  • Anmeldedaten-Datei: Sie erstellen aus Ihrem Google Service Account eine Anmeldedaten-Datei, mit der Kameleoon sicher auf BigQuery zugreift.

Ein Service Account erstellen

Erstellen Sie in Ihrem Projekt einen Service Account für Kameleoon und weisen Sie ihm die Rolle BigQuery Data Viewer zu.
  1. Geben Sie service accounts in die globale Suchleiste ein und klicken Sie auf das vorgeschlagene Ergebnis.
Die Suchleiste der Google Cloud-Konsole mit dem eingegebenen Suchbegriff service accounts. Darunter ist das Ergebnis Service Accounts unter Products and pages aufgeführt.
  1. Klicken Sie auf Create service account.
  2. Füllen Sie die Pflichtfelder aus und klicken Sie auf Create and continue.
  3. Geben Sie „BigQuery data viewer“ in das Feld Select a role ein und klicken Sie auf BigQuery Data Viewer, sobald es in der Dropdown-Suche erscheint.
Der Schritt Grant this service account access to the project, in dem BigQuery Data Viewer als Rollenoption aufgeführt ist
  1. Klicken Sie auf Continue und dann auf Done.

Ein neues Dataset erstellen

Erstellen Sie in Ihrem Projekt ein neues Dataset namens „kameleoon“.
Der BigQuery-Arbeitsbereich mit geöffnetem Explorer-Menü und der Option Create dataset
Wählen Sie die Region oder Multi-Region, die für Sie passt.
Das Panel Create dataset, in dem die Dataset ID auf kameleoon und der Standort auf die Multi-Region EU gesetzt ist

Dem Service Account Berechtigungen erteilen

Dem Service Account den Status BigQuery Data Owner für dieses Dataset „kameleoon“ erteilen

Erteilen Sie dem Kameleoon-Service-Account die Rolle BigQuery Data Owner für das Dataset „kameleoon“.
  1. Klicken Sie im BigQuery-Dashboard auf das Dataset kameleoon in der Leiste Explorer links.
  2. Klicken Sie auf Sharing > Permissions.
Die Seite des Datasets kameleoon mit geöffnetem Menü Sharing und ausgewählter Option Permissions
  1. Klicken Sie auf Add principal.
  2. Geben Sie den Namen des Kameleoon-Service-Accounts in das Feld New principals ein.
Das Panel Grant access für das Dataset kameleoon, in dem der Kameleoon-Service-Account im Feld New principals eingetragen ist
  1. Geben Sie im Feld Assign roles „BigQuery Data Owner“ ein.
  2. Schließen Sie die Einrichtung ab, indem Sie auf Save klicken.

Eine benutzerdefinierte Rolle erstellen

Eine benutzerdefinierte Rolle mit der Berechtigung bigquery.jobs.create erstellen

Erstellen Sie eine benutzerdefinierte Rolle, die die Berechtigung bigquery.jobs.create gewährt. Mit dieser Berechtigung kann der Service Account BigQuery-Jobs erstellen.
  1. Navigieren Sie zu Roles.
    • Sie finden Roles, indem Sie „Roles“ in das globale Suchfeld der Konsole eingeben.
Die Suchleiste der Google Cloud-Konsole mit eingegebenem Roles. Darunter ist das Ergebnis Roles unter IAM and admin aufgeführt.
  1. Klicken Sie auf Create role.
  2. Geben Sie einen Titel und eine ID für die Rolle ein, zum Beispiel Job Creator Role und CustomRole.
Das Formular Create role mit dem Titel Job Creator Role, der ID CustomRole und der Schaltfläche Add permissions
  1. Klicken Sie auf Add permissions und fügen Sie bigquery.jobs.create aus der Dropdown-Liste hinzu, die im Pop-in-Fenster erscheint.
  2. Klicken Sie auf Add.
Das Formular Create role, in dem bigquery.jobs.create als zugewiesene Berechtigung aufgeführt ist
  1. Klicken Sie auf Create, um die benutzerdefinierte Rolle fertigzustellen.

Diese benutzerdefinierte Rolle dem Service Account zuweisen, den Sie erstellt haben

Weisen Sie dem Kameleoon-Service-Account die benutzerdefinierte Rolle zu.
  1. Navigieren Sie in der Seitenleiste der Google Cloud-Konsole zu IAM.
  2. Sie sehen eine Liste mit Principals. Ein Service Account ist ein Principal. Suchen Sie in der Liste den Kameleoon-Service-Account und klicken Sie auf das Stift-Symbol, um den Principal zu bearbeiten.
Die IAM-Seite, gefiltert auf den Kameleoon-Service-Account, mit dem Stift-Symbol zum Bearbeiten des Principals am Ende der Zeile
  1. Auf der rechten Seite erscheint eine Konfigurationsseitenleiste. Klicken Sie auf Add another role und suchen Sie im Dropdown-Menü die benutzerdefinierte Rolle für die Berechtigung bigquery.jobs.create (in diesem Beispiel Job Creator Role).
Das Panel Edit access für den Service Account, in dem BigQuery Data Viewer zugewiesen ist und eine zweite Rolle über ein Dropdown-Menü ausgewählt wird
  1. Klicken Sie auf Save.

Einen JSON-Schlüssel für den Service Account erstellen

Erstellen Sie einen JSON-Schlüssel für den Kameleoon-Service-Account. Kameleoon verwendet die Schlüsseldatei, um sich mit BigQuery zu verbinden.
  1. Öffnen Sie die Seite Service accounts in der Google Cloud-Konsole.
  2. Wählen Sie Ihr Projekt aus.
  3. Klicken Sie auf die E-Mail-Adresse des Kameleoon-Service-Accounts.
  4. Öffnen Sie den Tab Keys.
  5. Öffnen Sie das Dropdown-Menü Add key und wählen Sie Create new key.
  6. Legen Sie Key type auf JSON fest und klicken Sie auf Create.
Google Cloud speichert die Schlüsseldatei auf Ihrem Computer, sobald Sie auf Create klicken. Sie können den Schlüssel nicht erneut herunterladen. Bewahren Sie die Datei deshalb an einem sicheren Ort auf.

Die Integration für Ihr Projekt aktivieren

Aktivieren Sie die BigQuery-Integration in Kameleoon mit der Anmeldedaten-Datei des Service Accounts.
  1. Melden Sie sich bei Ihrem Kameleoon-Konto an und klicken Sie auf Admin > Integrations.
Die BigQuery-Karte im Dashboard Integrations mit dem Add-on-Badge und dem Label Data Warehouse
  1. Wählen Sie BigQuery aus.
  2. Wählen Sie das Projekt aus, für das Sie BigQuery aktivieren möchten.
  3. Klicken Sie auf Upload file und wählen Sie Ihre JSON-Datei aus.
  4. Klicken Sie auf Validate, um Ihre Änderungen zu speichern.
Die BigQuery-Einstellungen eines Projekts mit hochgeladener credential.json, aktivierten Optionen für Destination und Source sowie dem Abschnitt Data Ingestion Task darunter

Mehrere Projekte verwalten

Wenn Sie mehrere Projekte haben, können Sie die BigQuery-Integration für jedes davon im selben Kameleoon-Konto konfigurieren. Um zwischen den Projektkonfigurationen zu wechseln, verwenden Sie das Projekt-Dropdown-Menü in den Integrationseinstellungen. Mit diesem Dropdown-Menü wählen Sie die Integrationseinstellungen für jedes dieser Projekte aus und verwalten sie. Beachten Sie, dass jedes Projekt eigene Konfigurationseinstellungen hat. Sie müssen für jedes Projekt eine eigene JSON-Anmeldedatei hochladen. Wenn die Berechtigungen einer einzelnen Anmeldedatei jedoch für mehrere Projekte gelten, können Sie dieselbe Anmeldedatei für diese Projekte wiederverwenden.
Das Projekt-Dropdown in den BigQuery-Einstellungen, geöffnet und mit zwei Projekt-URLs
Sie können die aktivierte Integration auf folgende Weise nutzen:

Datenregion

Kameleoon speichert die Daten dieser Integration in der Kameleoon-Datenregion Ihres Kontos, entweder den USA oder der EU.