Excluir usuários com o Ingestão de Dados

As sincronizações de exclusão de usuários 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 dashboard do Braze para o data warehouse ao qual você deseja se conectar. Inclua 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. Isso garantirá 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. Não há suporte para colunas de carga útil para dados de exclusão de usuários.

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. Esse valor 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 apenas 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 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.

• snowflake
• redshift
• bigquery
• databricks

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
);

Como funciona?

Com o Braze Cloud Data Ingestion, você configura uma integração entre sua instância de data warehouse e o espaço de trabalho do Braze para sincronizar 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 frequência a cada 15 minutos ou com pouca frequência, como uma vez por mês. Para os clientes que precisam que as sincronizações ocorram com mais frequência do que 15 minutos, fale com seu gerente de sucesso do cliente ou considere o uso de chamadas de 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ários correspondentes em seu dashboard do Braze.