Google Cloud Storage

Google Cloud Storage ist ein massiv skalierbarer Objektspeicher für unstrukturierte Daten, der von Google als Teil der Cloud-Computing-Produkt-Suite angeboten wird.

Wichtig

Wenn Sie zwischen Cloud-Speicheranbietern wechseln, wenden Sie sich an Ihre:n Customer-Success-Manager:in bei Braze, um weitere Unterstützung bei der Einrichtung und Validierung Ihrer neuen Integration zu erhalten.

Mit der Integration von Braze und Google Cloud Storage können Sie Currents-Daten zu Google Cloud Storage streamen. Anschließend können Sie einen ETL-Prozess (Extract, Transform, Load) verwenden, um Ihre Daten an andere Standorte zu übertragen, z. B. Google BigQuery.

Hinweis

Currents ist nicht direkt mit BigQuery verbunden und daher nicht Teil der Google Cloud Ready – BigQuery-Validierung von Braze. Currents schreibt Event-Daten in Ihren Google Cloud Storage-Bucket. Anschließend können Sie diese Daten mit BigQuery-Tools aus Cloud Storage laden oder abfragen.

Voraussetzungen

Integration

Für die Integration mit Google Cloud Storage müssen Sie die entsprechenden Zugangsdaten einrichten, die es Braze erlauben, Informationen über die Speicher-Buckets zu erhalten, in die geschrieben wird (storage.buckets.get), und Objekte innerhalb dieses Buckets zu erstellen (storage.objects.create).

Hinweis

Workload Identity Federation (WIF) wird als Authentifizierungsmethode für Currents nicht unterstützt. Sie müssen ein Dienstkonto mit einem JSON Private Key verwenden.

Verwenden Sie dazu die folgenden Anweisungen, die Sie durch die Erstellung einer Rolle und eines Dienstkontos führen, die einen Private Key für Ihre Currents-Integration erzeugen.

1. Schritt: Rolle erstellen

Erstellen Sie eine neue Rolle in Ihrer Google Cloud Platform-Konsole, indem Sie zu IAM & admin > Roles > + Create Role navigieren.

Geben Sie der Rolle einen Namen, wählen Sie dann +Add Permissions und wählen Sie Folgendes aus:

• storage.objects.create
• storage.objects.delete
• storage.objects.list
• storage.objects.get
• storage.buckets.get

Hinweis

Die Berechtigung storage.objects.delete ist optional. Sie erlaubt es Braze, unvollständige Dateien zu bereinigen.

In seltenen Fällen kann es vorkommen, dass Google Cloud die Verbindung vorzeitig beendet, was dazu führt, dass Braze unvollständige Dateien in Google Cloud Storage schreibt. In den meisten Fällen wird Braze einen neuen Versuch unternehmen und eine neue Datei mit den richtigen Daten erstellen, wobei die alte Datei in Google Cloud Storage verbleibt.

Wichtig

Wenn Ihr Bucket einen hierarchischen Namespace verwendet, müssen Sie außerdem die Berechtigung storage.folders.create hinzufügen. Bei diesen Buckets sind Ordner verwaltete Ressourcen, sodass Braze diese Berechtigung benötigt, um die Ordnerstruktur für Ihre exportierten Dateien zu erstellen. Ohne diese Berechtigung kann Braze nicht in den Bucket schreiben und die Integration kann keine Daten exportieren.

Wenn Sie fertig sind, wählen Sie Create.

2. Schritt: Ein neues Dienstkonto erstellen

Schritt 2.1: Dienstkonto erstellen

Erstellen Sie ein neues Dienstkonto in Ihrer Google Cloud Platform-Konsole, indem Sie zu IAM & admin > Service Accounts navigieren und Create Service Account auswählen.

Als Nächstes geben Sie dem Dienstkonto einen Namen und gewähren ihm Zugriff auf Ihre neu erstellte angepasste Rolle.

Schritt 2.2: Schlüssel erstellen

Verwenden Sie unten auf der Seite den Button Create Key, um einen JSON Private Key zur Verwendung in Braze zu erstellen. Nachdem der Schlüssel erstellt wurde, wird er auf Ihren Computer heruntergeladen.

3. Schritt: Currents in Braze einrichten

Navigieren Sie in Braze zu Currents > + Create Current > Google Cloud Storage Data Export und geben Sie den Namen Ihrer Integration und Ihre Kontakt-E-Mail an.

Geben Sie eine Kontakt-E-Mail-Adresse für Benachrichtigungen bei Integrationsfehlern an. Braze sendet Benachrichtigungen an diese Adresse, wenn bei der Integration Fehler auftreten, z. B. Probleme mit Anmeldedaten oder der Konnektivität. Um sicherzustellen, dass die richtigen Personen Benachrichtigungen erhalten, verwenden Sie einen Verteiler oder eine Gruppen-E-Mail-Adresse.

Als Nächstes laden Sie Ihren JSON Private Key unter GCS JSON Credentials hoch und geben den GCS-Bucket-Namen und das GCS-Präfix (optional) an. Beachten Sie, dass Sie diese Zugangsdaten über Google Cloud Platform generieren müssen, wie in den vorherigen Schritten beschrieben.

Wichtig

Es ist wichtig, dass Sie Ihre Zugangsdaten immer auf dem neuesten Stand halten. Wenn die Zugangsdaten für Ihren Konnektor ablaufen, sendet der Konnektor keine Ereignisse mehr. Wenn dieser Zustand länger als 5 Tage anhält, werden die Ereignisse des Konnektors gelöscht und die Daten gehen dauerhaft verloren.

Scrollen Sie schließlich zum Ende der Seite und wählen Sie aus, welche Nachrichten-Engagement-Ereignisse oder Kundenverhalten-Ereignisse Sie exportieren möchten. Wenn Sie fertig sind, starten Sie Ihren Current.

4. Schritt: Google Cloud Storage-Exporte einrichten

Um Google Cloud Storage (GCS)-Exporte einzurichten, gehen Sie zu Technologie-Partner > Google Cloud Storage, geben Sie Ihre GCS-Zugangsdaten ein und wählen Sie Make this the default data export destination.

Denken Sie daran, dass die Organisation und der Inhalt der exportierten Dateien bei der Integration von AWS S3, Microsoft Azure und Google Cloud Storage identisch sind.

Wichtig

Achten Sie darauf, dass Sie den vollständigen JSON-Wert eingeben, der von Google Cloud generiert wird.

5. Schritt: Zugangsdaten des Dienstkontos testen (optional)

Ihr Google Cloud IAM-Dienstkonto muss über die folgenden Berechtigungen verfügen:

• storage.objects.create
• storage.objects.delete
• storage.objects.list
• storage.objects.get
• storage.buckets.get

Um diese Berechtigungen im Braze-Dashboard zu überprüfen, gehen Sie auf die Seite Google Cloud Storage und wählen Sie Test Credentials.

Exportverhalten

Nutzer:innen, die eine Cloud-Datenspeicherlösung integriert haben und APIs, Dashboard-Berichte oder CSV-Berichte exportieren möchten, erleben Folgendes:

• Alle API-Exporte geben im Antwortkörper keine Download-URL zurück und müssen über den Datenspeicher abgerufen werden.
• Alle Dashboard-Berichte und CSV-Berichte werden zum Herunterladen an die E-Mail-Adresse der Nutzer:innen gesendet (keine Speicherberechtigungen erforderlich) und im Datenspeicher gesichert.

Wichtig

Anforderung an das JSON-Format: Für JSON-Exporte verwendet Braze das JSONL-Format (durch Zeilenumbrüche getrenntes JSON), bei dem jede Zeile ein separates JSON-Objekt enthält. Dieses Format unterscheidet sich von Standard-JSON, das aus einem einzelnen JSON-Array oder -Objekt besteht. Jede Zeile in der exportierten Datei ist ein gültiges JSON-Objekt, die Datei als Ganzes ist jedoch kein einzelnes gültiges JSON-Dokument. Parsen Sie bei der Verarbeitung dieser Dateien jede Zeile einzeln als separates JSON-Objekt, anstatt zu versuchen, die gesamte Datei als einzelnes JSON-Dokument zu parsen.

Currents-Exporte verwenden das Apache-Avro-Format (.avro-Dateien), nicht JSON. Diese Anforderung an das JSON-Format gilt für Datenexporte aus dem Dashboard und API-Exporte, die das JSON-Format verwenden.

Fehlerbehebung

Google Cloud Storage-Zugangsdaten sind ungültig

Wenn Sie beim Eingeben Ihrer Zugangsdaten die folgende Fehlermeldung erhalten:

1

Google Cloud Storage Credentials are invalid. Please ensure that your credentials string, bucket name, and prefix are valid. You do not have read permission.

Stellen Sie sicher, dass Ihr Google Cloud IAM-Dienstkonto über die folgenden Berechtigungen verfügt:

• storage.objects.create
• storage.objects.delete
• storage.objects.list
• storage.objects.get
• storage.buckets.get

Nachdem Sie dies überprüft haben, können Sie Ihre Zugangsdaten im Braze-Dashboard testen.