Supprimer des utilisateurs avec Cloud Data Ingestion

Cette page traite du processus de suppression des utilisateurs avec Cloud Data Ingestion.

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

Configuration de 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 qui peut accéder à la table de suppression. Sur la page Créer une synchronisation d’importation, définissez le Type de données sur Supprimer les utilisateurs afin que les actions appropriées soient exécutées pendant l’intégration pour supprimer les utilisateurs.

Configuration des données sources

Les tables sources pour les suppressions d’utilisateurs doivent inclure un ou plusieurs types d’identifiants d’utilisateurs et un horodatage UPDATED_AT. Les colonnes 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 l’heure à laquelle 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’identification de l’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 différentes étiquettes, mais un seul alias_name par alias_label.
• BRAZE_ID : l’identifiant utilisateur Braze. Il est généré par le SDK Braze et les nouveaux utilisateurs ne peuvent pas être créés à l’aide d’un ID Braze via Cloud Data Ingestion. Pour créer de nouveaux utilisateurs, spécifiez un ID utilisateur externe ou un alias d’utilisateur.

• 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 Cloud Data Ingestion de Braze, vous configurez une intégration entre votre instance d’entrepôt de données et votre espace de travail Braze pour synchroniser les données de manière récurrente. Cette synchronisation s’exécute selon la planification que vous définissez, et chaque intégration peut avoir sa propre planification. Les synchronisations peuvent avoir lieu toutes les 15 minutes ou aussi rarement qu’une fois par mois. Si vous avez besoin de synchronisations plus fréquentes que toutes les 15 minutes, contactez votre Customer Success Manager ou envisagez d’utiliser les appels API REST pour l’ingestion de données en temps réel.

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 utilisateur correspondants dans votre tableau de bord de Braze.