Excluir usuários com Ingestão de dados na nuvem

Esta página aborda o processo de exclusão de usuários com Ingestão de dados na nuvem.

As sincronizações de exclusão de usuários são compatíveis com todas as fontes de dados disponíveis da Ingestão de dados na nuvem.

Configurar a integração

Siga o processo padrão para criar uma nova integração no dashboard da Braze para o data warehouse ao qual você deseja se conectar. Certifique-se de incluir uma função que possa acessar a tabela de exclusão. Na página Create import sync, defina o Data Type como Delete Users para que as ações adequadas sejam executadas durante a execução da integração para excluir usuários.

Configurar dados de origem

As tabelas de origem para exclusão de usuários devem incluir um ou mais tipos de identificadores de usuário e um registro de data/hora UPDATED_AT. Colunas de carga útil não são compatíveis com dados de exclusão de usuários.

UPDATED_AT

Adicione um registro de data/hora UPDATED_AT à sua tabela de origem. Esse registro indica o momento em que a linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em que UPDATED_AT é posterior ao último valor sincronizado. Linhas no registro de data/hora exato do limite podem ser ressincronizadas se novas linhas compartilharem esse mesmo registro.

Colunas de identificadores de usuário

Sua tabela pode conter uma ou mais colunas de identificadores de usuário. Cada linha deve conter apenas um identificador: external_id, a combinação de alias_name e alias_label, ou braze_id. Uma tabela de origem pode conter colunas para um, dois ou todos os três tipos de identificadores.

• EXTERNAL_ID - Identifica o usuário que você deseja atualizar. Deve corresponder ao valor de external_id usado na Braze.
• ALIAS_NAME e ALIAS_LABEL - Essas duas colunas criam um objeto de alias de usuário. alias_name deve ser um identificador exclusivo e alias_label especifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas um alias_name por alias_label.
• BRAZE_ID - O identificador de usuário da Braze. É gerado pelo SDK da Braze, e novos usuários não podem ser criados usando um Braze ID por meio da ingestão de dados na nuvem. Para criar novos usuários, especifique um ID de usuário externo ou um alias de usuário.

Importante

Não inclua uma coluna PAYLOAD na sua tabela para remoção de usuários. Para evitar a remoção acidental e permanente de usuários, uma sincronização falhará se uma coluna de carga útil for fornecida na tabela de origem. Quaisquer outras colunas são permitidas, mas serão ignoradas pela 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

Como funciona

Com a ingestão de dados na nuvem da Braze, você configura uma integração entre sua instância de data warehouse e o espaço de trabalho da Braze. As sincronizações são executadas em um cronograma definido por você ou sob demanda por meio da API. Para opções de frequência, consulte Como funciona.

Quando uma sincronização é executada, a Braze se conecta diretamente à sua instância de data warehouse, recupera todos os novos dados da tabela especificada e exclui os perfis de usuário correspondentes no seu dashboard da Braze.

Aviso

A exclusão de perfis de usuário não pode ser desfeita. A ação de exclusão remove permanentemente os usuários, o que pode causar discrepâncias nos seus dados. Para mais detalhes, consulte Efeitos da exclusão de perfis de usuário.