Nutzer:innen mit Cloud-Datenaufnahme löschen

Auf dieser Seite wird das Verfahren zum Löschen von Nutzer:innen mit Cloud-Datenaufnahme beschrieben.

Löschsynchronisierungen von Nutzer:innen werden für alle verfügbaren Datenquellen der Cloud-Datenaufnahme unterstützt.

Integration konfigurieren

Folgen Sie dem Standardprozess, um eine neue Integration im Braze-Dashboard zu erstellen für das Data Warehouse, mit dem Sie eine Verbindung herstellen möchten. Stellen Sie sicher, dass Sie eine Rolle einbeziehen, die auf die Löschtabelle zugreifen kann. Setzen Sie auf der Seite Import-Synchronisierung erstellen den Datentyp auf Delete Users, damit während des Integrationslaufs die richtigen Aktionen zum Löschen von Nutzer:innen ausgeführt werden.

Quelldaten konfigurieren

Quelltabellen zum Löschen von Nutzer:innen sollten einen oder mehrere Nutzerbezeichner-Typen und einen UPDATED_AT-Zeitstempel enthalten. Payload-Spalten werden für Daten zur Nutzerlöschung nicht unterstützt.

UPDATED_AT

Fügen Sie Ihrer Quelltabelle einen UPDATED_AT-Zeitstempel hinzu. Dieser Zeitstempel gibt an, wann die jeweilige Zeile aktualisiert oder der Tabelle hinzugefügt wurde. Braze synchronisiert Zeilen, bei denen UPDATED_AT nach dem zuletzt synchronisierten Wert liegt. Zeilen mit exakt dem gleichen Grenz-Zeitstempel können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel aufweisen.

Nutzerbezeichner-Spalten

Ihre Tabelle kann eine oder mehrere Nutzerbezeichner-Spalten enthalten. Jede Zeile sollte nur einen Bezeichner enthalten: entweder external_id, die Kombination aus alias_name und alias_label oder braze_id. Eine Quelltabelle kann Spalten für einen, zwei oder alle drei Bezeichner-Typen enthalten.

• EXTERNAL_ID – Identifiziert die Nutzer:innen, die Sie aktualisieren möchten. Dieser Wert sollte mit dem in Braze verwendeten external_id-Wert übereinstimmen.
• ALIAS_NAME und ALIAS_LABEL – Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein, und alias_label gibt den Alias-Typ an. Nutzer:innen können mehrere Aliase mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label.
• BRAZE_ID – Der Braze-Nutzerbezeichner. Dieser wird vom Braze SDK generiert, und neue Nutzer:innen können nicht über eine Braze-ID durch Cloud-Datenaufnahme erstellt werden. Um neue Nutzer:innen zu erstellen, geben Sie eine externe Nutzer-ID oder einen Nutzer-Alias an.

Wichtig

Fügen Sie Ihrer Tabelle für die Nutzerlöschung keine PAYLOAD-Spalte hinzu. Um eine versehentliche, dauerhafte Löschung von Nutzer:innen zu verhindern, schlägt eine Synchronisierung fehl, wenn eine Payload-Spalte in der Quelltabelle vorhanden ist. Andere Spalten sind zulässig, werden aber von Braze ignoriert.

• snowflake
• redshift
• bigquery
• databricks
• microsoft fabric

1
2
3
4
5
6
7
8
9
10

CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_DELETES (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id, alias_name and alias_label, or braze_id is required
     EXTERNAL_ID VARCHAR(16777216),
     --if using user alias, both alias_name and alias_label are required
     ALIAS_LABEL VARCHAR(16777216),
     ALIAS_NAME VARCHAR(16777216),
     --braze_id can only be used to update existing users created through the Braze SDK
     BRAZE_ID VARCHAR(16777216)
);

1
2
3
4
5
6
7
8
9
10

CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_DELETES (
   updated_at timestamptz default sysdate,
   --at least one of external_id, alias_name and alias_label, or braze_id is required
   external_id varchar,
   --if using user alias, both alias_name and alias_label are required
   alias_label varchar,
   alias_name varchar,
   --braze_id can only be used to update existing users created through the Braze SDK
   braze_id varchar
);

1
2
3
4
5
6
7
8
9
10
11
12
13

CREATE OR ALTER TABLE [warehouse].[schema].[users_deletes]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PAYLOAD VARCHAR NOT NULL,
  --at least one of external_id, alias_name and alias_label, or braze_id is required
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR,
  --braze_id can only be used to update existing users created through the Braze SDK
  BRAZE_ID VARCHAR,
)
GO

So funktioniert es

Mit der Braze Cloud-Datenaufnahme richten Sie eine Integration zwischen Ihrer Data-Warehouse-Instanz und Ihrem Braze-Workspace ein. Synchronisierungen werden nach einem von Ihnen festgelegten Zeitplan oder bei Bedarf über die API ausgeführt. Informationen zu Frequenzoptionen finden Sie unter So funktioniert es.

Wenn eine Synchronisierung ausgeführt wird, stellt Braze eine direkte Verbindung zu Ihrer Data-Warehouse-Instanz her, ruft alle neuen Daten aus der angegebenen Tabelle ab und löscht die entsprechenden Nutzerprofile in Ihrem Braze-Dashboard.

Warnung

Das Löschen von Nutzerprofilen kann nicht rückgängig gemacht werden. Die Löschaktion entfernt Nutzer:innen dauerhaft, was zu Abweichungen in Ihren Daten führen kann. Weitere Informationen finden Sie unter Auswirkungen des Löschens von Nutzerprofilen.