Supprimer des utilisateurs avec l’Ingestion de données cloud

Cette page traite du processus de suppression des utilisateurs avec l’Ingestion de données cloud.

Les synchronisations de suppression d’utilisateurs sont prises en charge pour toutes les sources de données d’Ingestion de données cloud disponibles.

Configurer l’intégration

Suivez le processus standard pour créer une nouvelle intégration dans le tableau de bord de Braze pour l’entrepôt de données auquel vous souhaitez vous connecter. Assurez-vous d’inclure un rôle pouvant accéder à la table de suppression. Sur la page Create import sync, définissez le Data Type sur Delete Users afin que les actions appropriées soient effectuées lors de l’exécution de l’intégration pour supprimer les utilisateurs.

Configurer les données sources

Les tables sources pour la suppression d’utilisateurs doivent inclure un ou plusieurs types d’identifiants utilisateur et un horodatage UPDATED_AT. Les colonnes de payload ne sont pas prises en charge pour les données de suppression d’utilisateurs.

UPDATED_AT

Ajoutez un horodatage UPDATED_AT à votre table source. Cet horodatage indique le moment où cette ligne a été mise à jour ou ajoutée à la table. Braze synchronise les lignes dont la valeur UPDATED_AT est postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.

Colonnes d’identifiants utilisateur

Votre table peut contenir une ou plusieurs colonnes d’identifiants utilisateur. Chaque ligne ne doit contenir qu’un seul identifiant : soit external_id, soit la combinaison de alias_name et alias_label, soit braze_id. Une table source peut contenir des colonnes pour un, deux ou les trois types d’identifiants.

• EXTERNAL_ID — Identifie l’utilisateur que vous souhaitez mettre à jour. Cette valeur doit correspondre à la valeur external_id utilisée dans Braze.
• ALIAS_NAME et ALIAS_LABEL — Ces deux colonnes créent un objet d’alias d’utilisateur. alias_name doit être un identifiant unique, et alias_label spécifie le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seul alias_name par alias_label.
• BRAZE_ID — L’identifiant utilisateur Braze. Il est généré par le SDK Braze et de nouveaux utilisateurs ne peuvent pas être créés à l’aide d’un Braze ID via l’ingestion de données Cloud. Pour créer de nouveaux utilisateurs, spécifiez un identifiant utilisateur externe ou un alias d’utilisateur.

Important

N’incluez pas de colonne payload dans votre table pour la suppression d’utilisateurs. Afin d’éviter la suppression accidentelle et permanente d’utilisateurs, une synchronisation échouera si une colonne de payload est présente dans la table source. Toute autre colonne est autorisée, mais sera ignorée par Braze.

• 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

Fonctionnement

Avec l’ingestion de données Cloud de Braze, vous configurez une intégration entre votre instance d’entrepôt de données et votre espace de travail Braze. Les synchronisations s’exécutent selon une planification que vous définissez ou à la demande via l’API. Pour les options de fréquence, consultez Fonctionnement.

Lorsqu’une synchronisation s’exécute, Braze se connecte directement à votre instance d’entrepôt de données, récupère toutes les nouvelles données de la table spécifiée et supprime les profils utilisateurs correspondants de votre tableau de bord de Braze.

Avertissement

La suppression de profils utilisateurs est irréversible. Cette action supprime définitivement les utilisateurs, ce qui peut entraîner des incohérences dans vos données. Pour plus de détails, consultez Effets de la suppression de profils utilisateurs.