Segment

Segment ist eine Customer Data Platform, mit der Sie Ihre Kundendaten sammeln, bereinigen und aktivieren können.

Die Integration von Braze und Segment ermöglicht es Ihnen, Ihre Nutzer:innen zu tracken und Daten an verschiedene Anbieter von Analytics weiterzuleiten. Segment ermöglicht Ihnen:

• Segment Engage mit Braze zu synchronisieren, um es in Braze-Campaigns und Canvas-Segmentierung zu verwenden.
• Daten zwischen den beiden Plattformen zu importieren. Wir bieten eine Side-by-side-SDK-Integration für Ihre Android-, iOS- und Web-Anwendungen sowie eine Server-zu-Server-Integration zur Synchronisierung Ihrer Daten mit den Braze REST APIs.
• Daten über Currents mit Segment zu verbinden.

Voraussetzungen

Integration

Um Braze und Segment zu integrieren, müssen Sie Braze als Ziel entsprechend dem von Ihnen gewählten Integrationstyp (Verbindungsmodus) festlegen. Wenn Sie ein neuer Braze-Kunde sind, können Sie historische Daten mithilfe von Segment Replays an Braze weitergeben. Als Nächstes müssen Sie Abbildungen einrichten und Ihre Integration testen, um einen reibungslosen Datenfluss zwischen Braze und Segment zu gewährleisten.

Schritt 1: Ein Braze-Ziel erstellen

Nachdem Sie Ihre Quellen erfolgreich eingerichtet haben, müssen Sie Braze als Ziel für jede Quelle (iOS, Android, Web usw.) konfigurieren. Sie haben viele Möglichkeiten, den Datenfluss zwischen Braze und Segment über die Verbindungseinstellungen anzupassen.

Schritt 2: Ziel-Framework und Verbindungstyp wählen

Navigieren Sie in Segment zu Destinations > Braze > Configure Braze > Select your Source > Setup.

Sie können die Web-Quelle von Segment (Analytics.js) und die nativen clientseitigen Bibliotheken mit Braze integrieren, indem Sie entweder eine Side-by-side-Integration (Gerätemodus) oder eine Server-zu-Server-Integration (Cloud-Modus) verwenden.

Die Wahl des Verbindungsmodus hängt von der Art der Quelle ab, für die das Ziel konfiguriert ist.

Hinweis

Besuchen Sie Segment, um mehr über die beiden Integrationsmöglichkeiten (Verbindungsmodi) zu erfahren, einschließlich der jeweiligen Vorteile.

Side-by-side-SDK-Integration

Diese Integration, die auch als Gerätemodus bezeichnet wird, bildet das SDK und die Methoden von Segment auf das Braze SDK ab und ermöglicht so den Zugriff auf alle Features, die unser SDK bietet, wie Push, In-App-Nachrichten und andere native Braze-Methoden.

Hinweis

Wenn Sie den Gerätemodus von Segment verwenden, lassen Sie Segment Braze initialisieren. Initialisieren Sie das Braze SDK nicht zusätzlich in Ihrer App. Das Ziel-Plugin konfiguriert Braze und öffnet Sitzungen; eine zweite native Initialisierung kann doppelte Sitzungen protokollieren. Verwenden Sie Segment identify, um die Nutzer-ID festzulegen. Das Plugin bildet diesen Aufruf auf changeUser() ab.

Wichtig

Für Gerätemodus-Integrationen auf Mobilgeräten müssen Sie das Braze-Ziel-Plugin zusätzlich zur Konfiguration des Ziels im Segment-Dashboard zu Ihrer App hinzufügen. Das Segment SDK enthält das Braze-Plugin nicht standardmäßig – ohne dieses kann das Segment SDK keine Daten oder abgebildeten Methodenaufrufe an Braze weiterleiten, und Features wie Push, In-App-Nachrichten und Content Cards funktionieren nicht. Installationsanweisungen finden Sie in den plattformspezifischen Tabs in diesem Abschnitt.

Bei der Verwendung einer Gerätemodus-Verbindung weist das Braze SDK, ähnlich wie bei der nativen Integration des Braze SDK, jedem/jeder Nutzer:in eine device_id und einen Backend-Bezeichner, braze_id, zu. Dies ermöglicht es Braze, anonyme Aktivitäten des Geräts zu erfassen, indem diese Bezeichner anstelle von userId abgeglichen werden.

Hinweis

Wenn Sie Zielfilter mit Gerätemodus-Zielen (Kotlin oder Swift) verwenden, müssen Sie das Ziel-Plugin mit aktivierter Filterunterstützung konfigurieren. Weitere Informationen zu unterstützten Plugin-Versionen finden Sie in der Dokumentation zu Zielfiltern von Segment.

• android
• ios
• web oder javascript
• react native

Wichtig

Der Quellcode für die Android-Gerätemodus-Integration wird von Braze gepflegt und regelmäßig aktualisiert, um neue Braze SDK-Versionen zu berücksichtigen.

Welches Braze SDK Sie verwenden, hängt davon ab, welches Segment SDK Sie verwenden:

	Segment SDK	Braze SDK
Bevorzugt	Analytics-Kotlin	Braze Segment Kotlin
Legacy	Analytics-Android	Braze Segment Android

Um Braze als Gerätemodus-Ziel für Ihre Android-Quelle einzurichten, wählen Sie Actions als Destination framework und dann Save.

Um die Side-by-side-Integration abzuschließen, müssen Sie das Braze Kotlin-Ziel-Plugin zu Ihrer Android-App hinzufügen. Dieses Plugin verbindet das Segment SDK mit dem Braze SDK und ermöglicht den Datenfluss im Gerätemodus zu Braze. Folgen Sie den Installationsanweisungen von Segment, um die Plugin-Abhängigkeit hinzuzufügen und es mit Ihrer Segment-Analytics-Instanz zu initialisieren.

Der Quellcode für die Android-Gerätemodus-Integration wird von Braze gepflegt und regelmäßig aktualisiert, um neue Braze SDK-Versionen zu berücksichtigen.

Wichtig

Der Quellcode für die iOS-Gerätemodus-Integration wird von Braze gepflegt und regelmäßig aktualisiert, um neue Braze SDK-Versionen zu berücksichtigen.

Welches Braze SDK Sie verwenden, hängt davon ab, welches Segment SDK Sie verwenden:

	Segment SDK	Braze SDK
Bevorzugt	Analytics-Swift	Braze Segment Swift
Legacy	Analytics-iOS	Braze Segment iOS

Um Braze als Gerätemodus-Ziel für Ihre iOS-Quelle einzurichten, wählen Sie Actions als Destination framework und dann Save.

Um die Side-by-side-Integration abzuschließen, müssen Sie das Braze Swift-Ziel-Plugin zu Ihrer iOS-App hinzufügen. Dieses Plugin verbindet das Segment SDK mit dem Braze SDK und ermöglicht den Datenfluss im Gerätemodus zu Braze. Folgen Sie den Installationsanweisungen von Segment, um die Plugin-Abhängigkeit (über den Swift-Paketmanager oder CocoaPods) hinzuzufügen und es mit Ihrer Segment-Analytics-Instanz zu initialisieren.

Der Quellcode für die iOS-Gerätemodus-Integration wird von Braze gepflegt und regelmäßig aktualisiert, um neue Braze SDK-Versionen zu berücksichtigen.

Das Braze Web Mode (Actions) Framework von Segment wird empfohlen, um Braze als Gerätemodus-Ziel für Ihre Web-Quelle einzurichten.

Wählen Sie in Segment Actions als Ziel-Framework und Device Mode als Verbindungsmodus.

Der Quellcode für das React Native Braze Plugin wird von Segment gepflegt und regelmäßig aktualisiert, um neue Braze SDK-Versionen zu berücksichtigen.

Wenn Sie eine React Native Segment-Quelle mit Braze verbinden, müssen Sie eine Quelle und ein Ziel pro Betriebssystem einrichten. Zum Beispiel die Einrichtung eines iOS-Ziels und eines Android-Ziels.

Innerhalb Ihrer App-Codebasis initialisieren Sie das Segment SDK bedingt nach Gerätetyp, indem Sie den jeweiligen, mit jeder App verbundenen Quell-Schreibschlüssel verwenden.

Wenn ein Push-Token von einem Gerät registriert und an Braze gesendet wird, wird es mit dem App-Bezeichner verknüpft, der bei der Initialisierung des SDK verwendet wurde. Die gerätetypabhängige Initialisierung stellt sicher, dass alle an Braze gesendeten Push-Token mit der entsprechenden App verknüpft sind.

Wichtig

Wenn die React Native App Braze mit demselben Braze-App-Bezeichner für alle Geräte initialisiert, werden alle React Native Nutzer:innen in Braze als Android- oder iOS-Nutzer:innen betrachtet, und alle Push-Token werden mit diesem Betriebssystem assoziiert.

Um Braze als Gerätemodus-Ziel für jede Quelle einzurichten, wählen Sie Actions als Destination framework und dann Save.

Server-zu-Server-Integration

Diese auch als Cloud-Modus bezeichnete Integration leitet Daten von Segment an die Braze REST APIs weiter. Verwenden Sie das Braze Cloud Mode (Actions) Framework von Segment, um ein Cloud-Modus-Ziel für jede Ihrer Quellen einzurichten.

Im Gegensatz zur Side-by-side-Integration unterstützt die Server-zu-Server-Integration keine Braze-UI-Features wie In-App-Nachrichten, Content Cards oder die automatische Registrierung von Push-Token. Es gibt auch automatisch erfasste Daten (wie anonyme Nutzer:innen und Felder auf Geräteebene), die nicht über den Cloud-Modus verfügbar sind.

Wenn Sie diese Daten und Features nutzen möchten, sollten Sie die Side-by-side-SDK-Integration (Gerätemodus) verwenden.

Der Quellcode für das Braze Cloud Mode (Actions)-Ziel wird von Segment verwaltet.

Schritt 3: Einstellungen

Definieren Sie die Einstellungen für Ihr Ziel. Nicht alle Einstellungen gelten für alle Zieltypen.

• mobile device-mode
• web device-mode
• cloud-mode

Schritt 4: Methoden abbilden

Braze unterstützt die Segment-Methoden Page, Identify und Track. Welche Arten von Bezeichnern bei diesen Methoden verwendet werden, hängt davon ab, ob die Daten über eine Server-zu-Server-Integration (Cloud-Modus) oder eine Side-by-side-Integration (Gerätemodus) gesendet werden. In den Zielen Braze Web Mode Actions und Cloud Mode Actions können Sie auch eine Abbildung für einen Segment-Alias-Aufruf einrichten.

Hinweis

Obwohl Nutzer-Aliase als Bezeichner im Ziel Braze Cloud Mode (Actions) unterstützt werden, ist zu beachten, dass der Alias-Aufruf von Segment nicht direkt mit Braze-Nutzer-Aliasen zusammenhängt.

Das Cloud-Modus (Actions)-Ziel bietet eine Aktion „Alias erstellen“, mit der Sie einen reinen Alias-Nutzer:in erstellen oder einen Alias zu einem bestehenden external_id-Profil hinzufügen können. Die Aktion „Nutzer:in identifizieren“ kann zusammen mit der Aktion „Alias erstellen“ verwendet werden, um einen reinen Alias-Nutzer:in mit einer external_id zusammenzuführen, nachdem eine solche für den/die Nutzer:in verfügbar geworden ist.

Es ist auch möglich, einen Workaround zu entwickeln und braze_id zu verwenden, um anonyme Nutzerdaten im Cloud-Modus zu senden. Dies erfordert die manuelle Aufnahme der braze_id des Nutzers/der Nutzerin in alle Ihre Segment API-Aufrufe. In der Dokumentation von Segment erfahren Sie mehr darüber, wie Sie diesen Workaround einrichten können.

An Braze gesendete Zieldaten können im Rahmen von Cloud-Modus-Aktionen gebündelt werden. Die Batch-Größe ist auf 75 Events begrenzt, und diese Batches sammeln sich über einen Zeitraum von 30 Sekunden an, bevor sie gesendet werden. Das Batching von Anfragen erfolgt pro Aktion. Zum Beispiel werden Identify-Aufrufe (Attribute) in einer Anfrage und Track-Aufrufe (angepasste Events) in einer zweiten Anfrage zusammengefasst. Braze empfiehlt, dieses Feature zu aktivieren, da es die Anzahl der Anfragen reduziert, die von Segment an Braze gesendet werden. Dadurch verringert sich das Risiko, dass das Ziel auf die Rate-Limits von Braze stößt und Anfragen wiederholt werden müssen.

Sie können das Batching für eine Aktion aktivieren, indem Sie zu Ihrem Braze-Ziel > Mappings navigieren. Klicken Sie dort auf das 3-Punkte-Symbol neben der Abbildung und wählen Sie Edit Mapping. Scrollen Sie zum Ende des Abschnitts Select mappings und vergewissern Sie sich, dass Batch Data to Braze auf Yes gesetzt ist.

• identify
• track
• page

Identify

Der Identify-Aufruf ermöglicht es Ihnen, Nutzer:innen mit ihren Aktionen zu verknüpfen und Attribute über sie aufzuzeichnen.

Bestimmte spezielle Segment-Traits werden Standard-Attribut-Profilfeldern in Braze zugeordnet:

Spezielle Segment-Traits	Braze-Standardattribute
userId	external_id
firstName	first_name
lastName	last_name
email	email
birthday	dob
address.country	country
address.city	home_city
gender	gender

Andere reservierte Braze-Profilfelder wie email_subscribe und push_subscribe können gesendet werden, indem Sie die Braze-Namenskonvention für diese Felder verwenden und sie als Traits innerhalb eines Identify-Aufrufs übergeben.

Nutzer:in zu einer Abo-Gruppe hinzufügen

Sie können Nutzer:innen auch über die folgenden Felder im Traits-Parameter für eine bestimmte Abo-Gruppe abonnieren oder abmelden.

Verwenden Sie das reservierte Braze-Profilfeld namens braze_subscription_groups, das mit einem Array von Objekten verknüpft werden kann. Jedes Objekt im Array sollte zwei reservierte Schlüssel haben:

1. subscription_group_state: Gibt an, ob der/die Nutzer:in für eine bestimmte Abo-Gruppe "subscribed" oder "unsubscribed" ist.
2. subscription_group_id: Stellt die eindeutige ID der Abo-Gruppe dar. Sie finden diese ID im Braze-Dashboard unter Abo-Gruppen-Verwaltung.

• swift
• kotlin
• typescript

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
analytics.identify(
  userId: "{your-user}",
  traits: [
    "braze_subscription_groups": [
      [
        "subscription_group_id": "{your-group-id}",
        "subscription_group_state": "subscribed"
      ],
      [
        "subscription_group_id", "{your-group-id}",
        "subscription_group_state": "unsubscribed"
      ]
    ]
  ]
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
analytics.identify(
  "{your-user}",
  buildJsonObject {
    put("braze_subscription_groups", buildJsonArray {
        add(
          buildJsonObject {
            put("subscription_group_id", "{your-group-id}")
            put("subscription_group_state", "subscribed")
          }
        )
        add(
          buildJsonObject {
            put("subscription_group_id", "{your-group-id}")
            put("subscription_group_state", "unsubscribed")
          }
        )
      }
    )
  }
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
analytics.identify(
  "{your-user}",
  {
    braze_subscription_groups: [
      {
        subscription_group_id: "{your-group-id}",
        subscription_group_state: "subscribed"
      },
      {
        subscription_group_id: "{your-group-id}",
        subscription_group_state: "unsubscribed"
      }
    ]
  }
)

Angepasste Attribute

Alle anderen Traits werden als angepasste Attribute aufgezeichnet.

Segment-Methode	Braze-Methode	Beispiel
Identify mit Nutzer-ID	Externe ID setzen	Segment: analytics.identify("dawei"); Braze: Braze.changeUser("dawei")
Identify mit reservierten Traits	Nutzer:innen-Attribute setzen	Segment: analytics.identify({email: "[email protected]"}); Braze: Braze.getUser().setEmail("[email protected]");
Identify mit angepassten Traits	Angepasste Attribute setzen	Segment: analytics.identify({fav_cartoon: "Naruto"}); Braze: Braze.getUser().setCustomAttribute("fav_cartoon": "Naruto");
Identify mit Nutzer-ID und Traits	Segment: Externe ID und Attribut setzen	Kombinieren Sie die vorangegangenen Methoden.

In den Zielen Web Mode Actions und Cloud Mode Actions können diese Abbildungen mit der Aktion „Kundenprofil aktualisieren“ eingestellt werden.

Wichtig

Stellen Sie bei der Übergabe von Nutzer:innen-Attributdaten sicher, dass Sie nur Werte für Attribute übergeben, die sich seit dem letzten Update geändert haben. So stellen Sie sicher, dass Sie nicht unnötigerweise Datenpunkte protokollieren. Für clientseitige Quellen verwenden Sie das Open-Source-Middleware-Tool von Segment, um Ihre Integration zu optimieren und die Datenpunkt-Nutzung zu begrenzen, indem Sie doppelte identify()-Aufrufe von Segment entprellen.

Track

Wenn Sie ein Event tracken, erfassen wir dieses Event als angepasstes Event unter dem angegebenen Namen.

Metadaten, die innerhalb des Eigenschaften-Objekts des Track-Aufrufs gesendet werden, werden in Braze als angepasste Event-Eigenschaften für das zugehörige Event protokolliert. Es werden alle Datentypen für angepasste Event-Eigenschaften unterstützt.

In den Zielen Web Mode Actions und Cloud Mode Actions können diese Abbildungen mit der Aktion „Track Event“ eingestellt werden.

Segment-Methode	Braze-Methode	Beispiel
Track	Als angepasstes Event protokolliert.	Segment: analytics.track("played_game"); Braze: Braze.logCustomEvent("played_game");
Track mit Eigenschaften	Als Event-Eigenschaft protokolliert.	Segment: analytics.track("played_game", {name: "BotW", weapon: "boomerang"}); Braze: Braze.logCustomEvent("played_game", { "name": "BotW", "weapon": "boomerang"});
Track mit Produkt	Als Kauf-Event protokolliert.	Segment: analytics.track("Order Completed", {products: [product_id: "ab12", price: 19]}); Braze: Braze.logPurchase("ab12", 19);

Bestellung abgeschlossen

Wenn Sie ein Event mit dem Namen Order Completed unter Verwendung des in der E-Commerce API von Segment beschriebenen Formats tracken, erfassen wir die Produkte, die Sie als Käufe aufgeführt haben.

In den Zielen Web Mode Actions und Cloud Mode Actions kann die Standardabbildung über die Aktion „Track Purchase“ angepasst werden.

Page

Der Page-Aufruf ermöglicht es Ihnen, aufzuzeichnen, wann immer Nutzer:innen eine Seite Ihrer Website sehen, zusammen mit allen optionalen Eigenschaften der Seite.

Dieser Event-Typ kann als Trigger in den Zielen Web Mode Actions und Cloud Actions verwendet werden, um ein angepasstes Event in Braze zu protokollieren.

Schritt 5: Integration testen

Wenn Sie die Side-by-side-Integration (Gerätemodus) verwenden, können Ihre Übersichtsmetriken (Lifetime-Sitzungen, MAU, täglich aktive:r Nutzer:in; täglich aktiv, Kundenbindung, tägliche Sitzungen und tägliche Sitzungen pro MAU) verwendet werden, um sicherzustellen, dass Braze Daten von Segment erhält.

Sie können Ihre Daten auf den Seiten für angepasste Events oder Umsatz einsehen oder ein Segment erstellen. Auf der Dashboard-Seite Angepasste Events können Sie die Anzahl der angepassten Events im Zeitverlauf anzeigen. Beachten Sie, dass Sie keine Formeln verwenden können, die MAU- und täglich aktive:r Nutzer:in; täglich aktiv-Statistiken enthalten, wenn Sie eine Server-zu-Server-Integration (Cloud-Modus) verwenden.

Wenn Sie Kaufdaten an Braze senden (siehe „Bestellung abgeschlossen“ im Tab Track in Schritt 4), können Sie auf der Umsatz-Seite Daten zu Umsatz oder Käufen in bestimmten Zeiträumen oder den Gesamtumsatz Ihrer App einsehen.

Ein Segment erstellen ermöglicht es Ihnen, Ihre Nutzer:innen auf der Grundlage der angepassten Event- und Attributdaten zu filtern.

Wichtig

Wenn Sie eine Server-zu-Server-Integration (Cloud-Modus) verwenden, funktionieren Filter, die sich auf automatisch gesammelte Sitzungsdaten beziehen (z. B. „App zuerst verwendet“ und „App zuletzt verwendet“), nicht. Verwenden Sie eine Side-by-side-Integration (Gerätemodus), wenn Sie diese in Ihrer Segment- und Braze-Integration verwenden möchten.

Löschung und Unterdrückung von Nutzer:innen

Wenn Sie Nutzer:innen löschen oder unterdrücken müssen, beachten Sie, dass die Nutzerlöschfunktion von Segment dem Braze-Endpunkt /users/delete zugeordnet ist. Beachten Sie, dass die Überprüfung dieser Löschungen bis zu 30 Tage dauern kann.

Sie müssen sicherstellen, dass Sie einen gemeinsamen Nutzer-Bezeichner zwischen Braze und Segment auswählen (z. B. external_id). Nachdem Sie eine Löschanfrage über Segment initiiert haben, können Sie den Status im Tab für Löschanfragen in Ihrem Segment-Dashboard einsehen.

Segment Replays

Segment bietet seinen Kund:innen einen Dienst an, um alle historischen Daten an einen neuen Technologie-Partner zu „replaysn“ – also erneut zu übertragen. Neue Braze-Kund:innen, die alle relevanten historischen Daten importieren möchten, können dies über Segment tun. Sprechen Sie mit Ihrem Segment-Ansprechpartner, wenn Sie daran interessiert sind.

Segment stellt eine Verbindung zu unserem /users/track-Endpunkt her, um Nutzerdaten in Ihrem Namen in Braze zu importieren.

Wichtig

Alle Bezeichner, die im Cloud-Mode-Actions-Ziel unterstützt werden, werden auch im Rahmen von Segment Replays unterstützt.

Best Practices

Besonderheiten bei der Datenzuordnung.

Szenarien, in denen Daten nicht wie erwartet übermittelt werden:

1. Verschachtelte angepasste Attribute
   • Obwohl verschachtelte angepasste Attribute technisch über Segment an Braze gesendet werden können, wird jedes Mal die gesamte Payload übermittelt. Dies verursacht Datenpunkte pro übergebenem Schlüssel im verschachtelten Objekt bei jedem Senden der Payload.
     
     Um beim Senden der Payload nur einen Teil der Datenpunkte zu verbrauchen, können Sie das von Segment bereitgestellte Feature Destination Functions verwenden. Dieses Feature in der Segment-Plattform ermöglicht es Ihnen, die Art und Weise anzupassen, wie Daten an nachgelagerte Ziele gesendet werden.

Hinweis

Custom Destination Functions werden innerhalb von Segment gesteuert, und Braze hat nur eingeschränkte Einblicke in extern konfigurierte Funktionen.

2. Anonyme Daten per Server-zu-Server übermitteln.
   • Kund:innen können die Server-zu-Server-Bibliotheken von Segment verwenden, um anonyme Daten an andere Systeme weiterzuleiten. Im Abschnitt zu den Map-Methoden erfahren Sie mehr darüber, wie Sie Nutzer:innen ohne external_id über eine Server-zu-Server-(Cloud-Mode)-Integration an Braze senden.