Eliminar usuarios con la Ingesta de datos de Cloud

En esta página se explica el proceso de eliminación de usuarios con la Ingesta de datos de Cloud.

Las sincronizaciones de eliminación de usuarios son compatibles con todos los orígenes de datos disponibles de la Ingesta de datos de Cloud.

Configurar la integración

Sigue el proceso estándar para crear una nueva integración en el panel de Braze para el almacén de datos al que quieras conectarte. Asegúrate de incluir un rol que pueda acceder a la tabla de eliminación. En la página Crear sincronización de importación, establece el Tipo de datos en Eliminar usuarios para que se ejecuten las acciones adecuadas durante la ejecución de la integración para eliminar usuarios.

Configura los datos de origen

Las tablas de origen para las eliminaciones de usuarios deben incluir uno o más tipos de identificador de usuario y una marca de tiempo UPDATED_AT. Las columnas de carga útil no son compatibles con los datos de eliminación de usuarios.

UPDATED_AT

Añade una marca de tiempo UPDATED_AT a tu tabla de origen. Esta marca de tiempo indica el momento en que se actualizó o se añadió esta fila a la tabla. Braze sincroniza las filas en las que UPDATED_AT es posterior al último valor sincronizado. Las filas con la marca de tiempo exacta del límite pueden volver a sincronizarse si nuevas filas comparten esa misma marca de tiempo.

Columnas de identificador de usuario

Tu tabla puede contener una o más columnas de identificador de usuario. Cada fila solo debe contener un identificador: ya sea external_id, la combinación de alias_name y alias_label, o braze_id. Una tabla de origen puede contener columnas para uno, dos o los tres tipos de identificador.

• EXTERNAL_ID: identifica al usuario que deseas actualizar. Debe coincidir con el valor de external_id utilizado en Braze.
• ALIAS_NAME y ALIAS_LABEL: estas dos columnas crean un objeto de alias de usuario. alias_name debe ser un identificador único y alias_label especifica el tipo de alias. Los usuarios pueden tener múltiples alias con diferentes etiquetas, pero solo un alias_name por alias_label.
• BRAZE_ID: el identificador de usuario de Braze. Este es generado por el SDK de Braze y no se pueden crear nuevos usuarios utilizando un Braze ID a través de la ingesta de datos en la nube. Para crear nuevos usuarios, especifica un ID de usuario externo o un alias de usuario.

Importante

No incluyas una columna PAYLOAD en tu tabla para la eliminación de usuarios. Para evitar la eliminación accidental y permanente de usuarios, una sincronización fallará si se proporciona una columna de carga útil en la tabla de origen. Se permiten otras columnas, pero Braze las ignorará.

• 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

Cómo funciona

Con la ingesta de datos en la nube de Braze, configuras una integración entre tu instancia de almacén de datos y tu espacio de trabajo de Braze. Las sincronizaciones se ejecutan según un programa que tú estableces o bajo demanda a través de la API. Para conocer las opciones de frecuencia, consulta Cómo funciona.

Cuando se ejecuta una sincronización, Braze se conecta directamente a tu instancia de almacén de datos, recupera todos los datos nuevos de la tabla especificada y elimina los perfiles de usuario correspondientes en tu panel de Braze.

Advertencia

La eliminación de perfiles de usuario no se puede deshacer. La acción de eliminación borra permanentemente a los usuarios, lo que puede causar discrepancias en tus datos. Para más detalles, consulta Efectos de eliminar perfiles de usuario.