Daten zwischen Workspaces und Instanzen migrieren

Workspaces halten Ihre Braze-Daten getrennt. Diese Seite erklärt, wie sich diese Isolation auf die Migration auswirkt, was Sie mit Produktfeatures und APIs verschieben können und was Sie außerhalb von Braze neu aufbauen oder handhaben müssen. Eine Migration ist in der Regel eine bereichsübergreifende Aufgabe – nicht nur eine Aufgabe für Unternehmensadministrator:innen. Administrator:innen sind oft für die Workspace-Einrichtung und Kanalkonfiguration zuständig; Entwickler:innen kümmern sich um SDK- und API-Änderungen; Marketer bauen Segmente neu auf und übernehmen Messaging-Inhalte. Jeder Schritt erfordert die entsprechenden Berechtigungen im Quell- und Ziel-Workspace.

Alles, was Sie in Braze speichern – Nutzerprofile, Segmente, Messaging-Inhalte und Engagement-Verlauf – befindet sich innerhalb eines Workspace. Ein Segment, eine Campaign oder ein Canvas kann keine Daten aus einem anderen Workspace lesen oder darauf abzielen. Dashboard-Nutzer:innen verwenden häufig mehrere Workspaces auf demselben Unternehmens-Dashboard für Staging und Produktion, für verschiedene Marken oder für regionale Aufteilungen. Dieses Setup bietet Ihnen Isolation, bedeutet aber auch, dass es keine einzelne Aktion im Dashboard gibt, die alle Workspace-Daten in einen anderen Workspace oder eine andere Braze-Instanz verschiebt.

Für den Planungskontext siehe Erste Schritte: Workspaces und Workspaces erstellen und verwalten.

Was Braze nicht automatisch zwischen Workspaces migriert

Folgendes wird nicht automatisch migriert, wenn Sie SDKs oder APIs auf einen neuen Workspace (oder eine neue Braze-Dashboard-Umgebung mit eigenen Workspaces) ausrichten:

Wichtig

Wenn Sie separate Workspaces für Staging und Produktion verwenden, denken Sie daran, dass Currents-Konnektoren nicht zwischen Workspaces geteilt werden. Planen Sie, welcher Workspace die Produktionsexporte besitzt. Weitere Details finden Sie unter Erste Schritte: Workspaces.

Was Sie verschieben oder neu erstellen können

Campaign-, Canvas- und Landing-Page-Inhalte

Sie können viele Campaign-, Canvas- und Landing-Page-Definitionen als Entwürfe in einen anderen Workspace kopieren. Unterstützte Kanäle, ausgelassene Felder und Liquid-Einschränkungen sind in Campaigns, Canvases und Landing-Pages zwischen Workspaces kopieren dokumentiert. Aktualisieren Sie nach dem Kopieren Segmente, Trigger und alle Workspace-spezifischen Referenzen, bevor Sie starten oder veröffentlichen.

Nutzerprofildaten

Typische Ansätze:

• REST API: Verwenden Sie /users/track, um Nutzer:innen im Ziel-Workspace mit den benötigten Bezeichnern und Attributen zu erstellen oder zu aktualisieren. Dies ist dasselbe Muster, das für die Migration von Legacy-Nutzerdaten beim Einbringen historischer Daten in Braze beschrieben wird.
• CSV-Import: Für Marketer-gesteuerte Importe siehe Nutzer:innen importieren und CSV-Import.
• Cloud-Datenaufnahme: Um Attribute aus einem Warehouse in den Ziel-Workspace zu synchronisieren, siehe Cloud-Datenaufnahme.
• Exporte aus dem Quell-Workspace: Verwenden Sie /users/export/ids oder /users/export/segment, um Daten zu extrahieren, die Sie verschieben dürfen, und ordnen Sie sie dann users/track oder CSV für das Ziel zu. Beachten Sie Ihre Datenaufbewahrungs-, Datenschutz- und vertraglichen Verpflichtungen beim Exportieren und erneuten Laden von Daten.

Hinweis

Das Zusammenführen doppelter Profile mit dem Endpunkt Nutzer:innen zusammenführen oder doppelte Nutzer:innen im Dashboard gilt innerhalb eines einzelnen Workspace, nicht über zwei Workspaces hinweg.

Nutzerexportfelder, die nicht auf Standard-Profil-APIs abgebildet werden können

Wenn Sie Nutzer:innen in einem Ziel-Workspace aus einem Nutzerexport neu aufbauen, können einige Exportfelder nicht über die REST API oder CSV in die Standard-Profilfelder von Braze zurückgeschrieben werden (so wie das SDK und der Server sie befüllen). Sie können die Werte oft stattdessen als angepasste Attribute speichern. Beachten Sie die folgenden Einschränkungen.

Geräteinformationen (devices)

Gerätedatensätze im Export werden vom SDK befüllt. Sie können diese Daten nicht über die REST API in die Standard-Gerätefelder von Braze migrieren.

Wenn Sie diese Informationen benötigen, bevor Nutzer:innen eine Sitzung in einer App starten, die auf den Ziel-Workspace ausgerichtet ist, senden Sie sie als angepasste Attribute, wenn Sie die Nutzer:innen importieren. Standard-Segmentierungsfilter und Liquid-Referenzen, die auf integrierten Gerätedaten basieren, verwenden die exportierten Gerätedaten erst, wenn Nutzer:innen eine Sitzung in einer App-Instanz öffnen, die mit dem neuen Workspace verbunden ist (wenn das SDK die Standard-Gerätefelder aktualisiert).

Hinweis

Dies ist getrennt von der Push-Token-Migration, die das Feld push_tokens auf /users/track verwendet.

Gesamtsitzungen und App-bezogene Sitzungsdaten (apps und verschachtelte sessions)

Sitzungssummen und verschachtelte Sitzungsdaten aus dem apps-Objekt in einem Export können nicht in dieselben integrierten Felder reimportiert werden. Um Legacy-Zähler zu erhalten (z. B. Gesamtsitzungen aus dem Quell-Workspace), speichern Sie sie in angepassten Attributen und segmentieren Sie im Ziel-Workspace nach diesen Feldern.

Sie können date_of_first_session und date_of_last_session über /users/track oder CSV-Import setzen. Für akzeptierte Formate siehe das Nutzerattribut-Objekt und CSV-Import.

Zufällige Bucket-Nummer (random_bucket)

Jede:r Nutzer:in erhält in ihrem Workspace eine zufällige Bucket-Nummer. Dieser Wert kann nicht reimportiert werden; Nutzer:innen erhalten eine neue zufällige Bucket-Nummer im Ziel-Workspace.

Wenn Sie sich auf die alte Nummer für Holdouts oder Stichproben verlassen (z. B. Ausschluss von Nutzer:innen, deren random_bucket unter einem Schwellenwert liegt), speichern Sie den exportierten Wert als angepasstes Attribut und erstellen Sie Segmente oder Filter auf diesem Attribut anstelle des integrierten Felds für die zufällige Bucket-Nummer.

Partner-Attributionsfelder (attributed_*)

Attributionsfelder aus Partnerintegrationen (die attributed_*-Felder in einem Export) können nicht über die REST API auf die Standard-Attributionsfelder von Braze gesetzt werden. Ordnen Sie sie angepassten Attributen im Ziel-Workspace zu, wenn Sie sie für Segmentierung oder Messaging benötigen.

Push-Token

Wenn Nutzer:innen bereits Push-Token von einem früheren Anbieter oder einer früheren App-Version haben, können Sie Token für mobile Apps über die API importieren oder sich nach der Integration auf das SDK verlassen. Web-Push-Token haben API-Einschränkungen. Vollständige Details und Beispiele finden Sie unter Push-Token migrieren.

WhatsApp

Telefonnummern und Abo-Gruppen können mit einem speziellen Übertragungsablauf zwischen Workspaces verschoben werden. Siehe WhatsApp-Telefonnummern und Abo-Gruppen zwischen Workspaces übertragen.

Engagement- und Analytics-Daten außerhalb von Braze

Wenn Sie bei der Konsolidierung von Umgebungen einen historischen Datensatz von Sendungen, Öffnungen oder Klicks benötigen, sind Currents und andere Exporte der unterstützte Weg, diese Daten in Ihr Warehouse oder Ihre Tools zu übertragen. Diese Daten werden nicht als native nutzerbezogene Nachrichtenhistorie in einem anderen Workspace wieder in Braze aufgenommen.

Bevor Sie SDK- oder API-Schlüssel ändern

Wenn Sie Ihre App oder Website auf einen neuen Workspace ausgerichtet haben:

• Nutzer:innen, die die App oder Website öffnen, können neue Profile im neuen Workspace erstellen. Sie übernehmen nicht automatisch den vorherigen Workspace-spezifischen Verlauf.
• Wenn dieselbe Person in beiden Workspaces existieren könnte, können duplikatähnliche Szenarien auftreten (z. B. überlappende Push-Reichweite). Bevorzugen Sie einen bewussten Daten- und Targeting-Plan gegenüber dem unbeabsichtigten Teilen von Produktions- und Staging-Schlüsseln.

Tipp

Für Workspace- oder App-Instanz-Löschungslimits, spezielle Kontoumzüge oder die Planung umfangreicher Migrationen kontaktieren Sie den Braze-Support mit Ihren Dashboard-Links und einer Zusammenfassung der Quell- und Ziel-Workspaces.