Excluir usuários com a ingestão de dados na nuvem

Esta página discute o processo de exclusão de usuários com o Cloud Data Ingestion.

As sincronizações de exclusão de usuário são compatíveis com todas as fontes de dados disponíveis do Cloud Data Ingestion.

Configuração da integração

Siga o processo padrão para criar uma nova integração no painel do 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 Criar sincronização de importação, defina o Tipo de dados como Excluir usuários para que as ações adequadas sejam tomadas durante a execução da integração para excluir usuários.

!

Configuração de dados de origem

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

UPDATED_AT

Adicione um registro de data e hora UPDATED_AT à sua tabela de origem. Esse registro de data e hora indica a hora em que essa linha foi atualizada ou adicionada à tabela. O Braze sincronizará apenas as linhas que foram adicionadas ou atualizadas desde a última sincronização.

Colunas de identificador de usuário

Sua tabela pode conter uma ou mais colunas de identificador 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 - Isso identifica o usuário que você deseja atualizar. Isso deve corresponder ao valor external_id usado no 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 somente um alias_name por alias_label.
• BRAZE_ID - O identificador de usuário do Braze. Isso é gerado pelo SDK do Braze e não é possível criar novos usuários usando uma ID do Braze 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.

• 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 o Braze Cloud Data Ingestion, você configura uma integração entre a instância do data warehouse e o Braze Workspace para sincronizar os dados de forma recorrente. Essa sincronização é executada em uma programação definida por você, e cada integração pode ter uma programação diferente. As sincronizações podem ser executadas com a frequência de 15 minutos ou com pouca frequência, como uma vez por mês. Para clientes que precisam que as sincronizações ocorram com mais frequência do que 15 minutos, fale com o gerente de sucesso do cliente ou considere o uso de chamadas à API REST para ingestão de dados em tempo real.

Quando uma sincronização for executada, o Braze se conectará diretamente à sua instância de data warehouse, recuperará todos os novos dados da tabela especificada e excluirá os perfis de usuário correspondentes no seu painel do Braze.