RudderStack

RudderStack ist eine quelloffene Infrastruktur für Kundendaten zum Sammeln und Weiterleiten von Kundenereignisdaten an Ihr bevorzugtes Data Warehouse und Dutzende anderer Analytics-Anbieter, wie z. B. Braze. Es ist unternehmenstauglich und bietet ein robustes Transformations-Framework, mit dem Sie Ihre Ereignisdaten im Handumdrehen verarbeiten können.

Die Integration von Braze und RudderStack bietet eine native SDK-Integration für Ihre Android-, iOS- und Internet-Anwendungen sowie eine Server-zu-Server-Integration von Ihren Backend-Diensten.

Voraussetzungen

Integration

1. Schritt: Eine Quelle hinzufügen

Um mit dem Senden von Daten an Braze zu beginnen, müssen Sie zunächst sicherstellen, dass eine Quelle in Ihrer RudderStack-App eingerichtet ist. Besuchen Sie RudderStack, um zu erfahren, wie Sie Ihre Datenquelle einrichten.

2. Schritt: Ziel konfigurieren

Da Ihre Datenquelle nun eingerichtet ist, wählen Sie im RudderStack-Dashboard unter Destinations die Option ADD DESTINATION aus. Wählen Sie aus der Liste der verfügbaren Ziele Braze aus und klicken Sie auf Next.

Geben Sie im Braze-Ziel den App-Schlüssel, den Braze REST-API-Schlüssel, den Daten-Cluster und die native SDK-Option (nur im Gerätemodus) an. Die Option „Natives SDK“ verwendet das native Braze SDK zum Senden von Ereignissen, wenn sie aktiviert ist.

3. Schritt: Wählen Sie die Art der Integration

Sie können die web- und nativen clientseitigen Bibliotheken von RudderStack auf eine der folgenden Arten in Braze integrieren:

• Side-by-side / Gerätemodus: RudderStack sendet die Ereignisdaten direkt von Ihrem Client (Browser oder mobile Anwendung) an Braze.
• Server-zu-Server / Cloud-Modus: Das Braze SDK sendet die Ereignisdaten direkt an RudderStack, die dann transformiert und an Braze weitergeleitet werden.
• Hybrid-Modus: Verwenden Sie den Hybrid-Modus, um automatisch und von Nutzer:innen generierte iOS- und Android-Ereignisse über eine einzige Verbindung an Braze zu senden.

Hinweis

Erfahren Sie mehr über die Verbindungsmodi von RudderStack und die Vorteile der einzelnen Modi.

Side-by-side-Integration (Gerätemodus)

In diesem Modus können Sie Ihre Ereignisse mit dem Braze SDK, das Sie auf Ihrer Website oder in Ihrer mobilen App eingerichtet haben, an Braze senden.

Richten Sie die Abbildungen zum RudderStack SDK für Ihre Plattform im Braze GitHub Repository ein, wie unter Unterstützte Methoden beschrieben:

• Android
• iOS
• Swift
• Web
• React Native
• Flutter

Um die Integration im Gerätemodus abzuschließen, lesen Sie die ausführliche RudderStack-Anleitung zum Hinzufügen von Braze zu Ihrem Projekt.

Server-zu-Server-Integration (Cloud-Modus)

In diesem Modus sendet das SDK die Ereignisdaten direkt an den RudderStack-Server. RudderStack transformiert dann diese Daten und leitet sie an das gewünschte Ziel weiter. Diese Transformation wird im RudderStack-Backend mithilfe des Transformer-Moduls von RudderStack durchgeführt.

Um die Integration zu aktivieren, müssen Sie die RudderStack-Methoden auf Braze abbilden, wie unter Unterstützte Methoden beschrieben.

Hinweis

Die serverseitigen SDKs von RudderStack (Java, Python, Node.js, Go, Ruby) unterstützen nur den Cloud-Modus. Das liegt daran, dass ihre serverseitigen SDKs im RudderStack-Backend arbeiten und kein Braze-spezifisches SDK laden können.

Wichtig

Die Server-zu-Server-Integration unterstützt keine Braze-UI-Features wie Push-Benachrichtigungen oder In-App-Messaging. Diese Features werden jedoch von der Integration im Gerätemodus unterstützt.

Hybrid-Modus

Verwenden Sie den Hybrid-Modus, um alle Ereignisse von Ihren iOS- und Android-Quellen an Braze zu senden.

Wenn Sie den Hybrid-Modus wählen, um Ereignisse an Braze zu senden, wird RudderStack:

1. Das Braze SDK initialisieren.
2. Alle von Nutzer:innen erzeugten Ereignisse (identify, track, page, screen und group) nur über den Cloud-Modus an Braze senden und verhindern, dass sie über den Gerätemodus gesendet werden.
3. Die automatisch generierten Ereignisse (In-App-Nachrichten, Push-Benachrichtigungen, die das Braze SDK erfordern) über den Gerätemodus senden.

Um Ereignisse über den Hybrid-Modus zu senden, verwenden Sie die Option Hybrid-Modus, während Sie Ihre Quelle mit dem Braze-Ziel verbinden. Fügen Sie dann die Braze-Integration zu Ihrem Projekt hinzu.

4. Schritt: Zusätzliche Einstellungen konfigurieren

Konfigurieren Sie nach Abschluss der Ersteinrichtung die folgenden Einstellungen, um Ihre Daten korrekt in Braze zu empfangen:

• Enable subscription groups in group call: Aktivieren Sie diese Einstellung, um den Abo-Gruppenstatus in Ihren Gruppenereignissen zu senden. Weitere Informationen finden Sie unter Group.
• Use angepasste Attribute Operation: Aktivieren Sie diese Einstellung, wenn Sie die Funktionalität der verschachtelten angepassten Attribute in Braze nutzen möchten, um Segmente zu erstellen und Ihre Nachrichten mithilfe eines angepassten Attribut-Objekts zu personalisieren. Weitere Informationen finden Sie unter Send user traits as nested angepasste Attribute.
• Track events for anonymous users: Aktivieren Sie diese Einstellung, um die Aktivitäten anonymer Nutzer:innen zu verfolgen und diese Informationen an Braze zu senden.

Einstellungen für den Gerätemodus

Die folgenden Einstellungen gelten nur, wenn Sie Ereignisse über den Gerätemodus an Braze senden:

• Client-side Events Filtering: Mit dieser Einstellung können Sie festlegen, welche Ereignisse blockiert oder an Braze durchgelassen werden sollen. Weitere Informationen zu dieser Einstellung finden Sie unter Client-side Events Filtering.
• Deduplicate Traits: Aktivieren Sie diese Einstellung, um die Nutzer-Traits im identify-Aufruf zu deduplizieren.
• Show Braze logs: Diese Einstellung ist nur bei Verwendung des JavaScript SDK als Quelle anwendbar. Aktivieren Sie sie, um Ihren Nutzer:innen die Braze-Logs anzuzeigen.
• OneTrust Cookie Categories: Mit dieser Einstellung können Sie die OneTrust-Cookie-Zustimmungsgruppen mit Braze verknüpfen.

Unterstützte Methoden

Braze unterstützt die RudderStack-Methoden identify, track, screen, page, group und alias.

• identify
• track
• screen
• page
• group
• alias

Nutzer-Traits als verschachtelte angepasste Attribute senden

Sie können die Nutzer-Traits als verschachtelte angepasste Attribute an Braze senden und Hinzufüge-, Aktualisierungs- und Entfernungsoperationen darauf ausführen. Aktivieren Sie dazu die Einstellung „Use angepasste Attribute Operation dashboard“ in RudderStack, während Sie das Braze-Ziel konfigurieren. Dieses Feature ist nur im Cloud-Modus verfügbar.

Sie können die Nutzer-Traits als verschachtelte angepasste Attribute in Ihren identify-Ereignissen im folgenden Format senden:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
rudderanalytics.identify("1hKOmRA4GRlm", {
  "cars": {
    "add": [{
      "age": 27,
      "id": 1,
      "name": "Alex Keener"
    }],
    "update": [{
        "age": 30,
        "id": 2,
        "identifier": "id",
        "name": "Rowan"
      },
      {
        "age": 27,
        "id": 1,
        "identifier": "id",
        "name": "Alex"
      }
    ]
  },
  "country": "USA",
  "email": "[email protected]",
  "firstName": "Alex",
  "gender": "M",
  "pets": [{
      "breed": "beagle",
      "id": 1,
      "name": "Scooby",
      "type": "dog"
    },
    {
      "breed": "calico",
      "id": 2,
      "name": "Garfield",
      "type": "cat"
    }
  ]
})

Um die Nutzer-Traits als angepasste Nutzerattribute über die Aufrufe track, page oder screen zu senden, übergeben Sie traits als kontextuelles Feld im Ereignis:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
rudderanalytics.track("Product Viewed", {
    revenue: 8.99,
    currency: "USD",
 },{
  "traits": {
    "cars": {
      "add": [{
        "age": 27,
        "id": 1,
        "name": "Alex Keener"
      }],
      "update": [{
          "age": 30,
          "id": 2,
          "identifier": "id",
          "name": "Alex"
        },
        {
          "age": 27,
          "id": 1,
          "identifier": "id",
          "name": "Rowan"
        }
      ]
    },
    "city": "Disney",
    "country": "USA",
    "email": "[email protected]",
    "firstName": "Alexa",
    "gender": "woman",
    "pets": [{
        "breed": "beagle",
        "id": 1,
        "name": "Scooby",
        "type": "dog"
      },
      {
        "breed": "calico",
        "id": 2,
        "name": "Garfield",
        "type": "cat"
      }
    ]
  }
});

Hinweis

Für die Aktualisierungs- und Entfernungsoperationen ist identifier ein erforderlicher Schlüssel. Wenn Hinzufüge-, Aktualisierungs- oder Entfernungsoperationen im verschachtelten Array nicht vorhanden sind, verwendet RudderStack standardmäßig die Erstellungsoperation, um die Eigenschaften zu erstellen. Weitere Informationen zum Senden verschachtelter angepasster Attribute finden Sie unter Array von Objekten.

Fehlerbehebung

In den RudderStack-Logs wird „[Braze Deduplication]: Duplicate user detected, the user is dropped“ angezeigt

Diese Meldung stammt von RudderStack, wenn Deduplicate Traits aktiviert ist und RudderStack unveränderte Nutzer:innen-Traits verwirft, bevor sie an Braze weitergeleitet werden. Es handelt sich nicht um einen Braze-Fehler.

RudderStack vergleicht eingehende identify- und track-Traits mit dem Kundenprofil und überspringt Attribute ohne Änderung, um die Braze-Datenpunkt-Nutzung zu reduzieren. Weitere Informationen finden Sie in der RudderStack-Dokumentation User Trait Deduplication in Braze.

Wenn Sie möchten, dass bei jedem Aufruf alle Traits gesendet werden, deaktivieren Sie Deduplicate Traits in den Einstellungen Ihres RudderStack-Braze-Ziels. Beachten Sie, dass dies den Verbrauch von Braze-Datenpunkten erhöhen kann.