クラウドデータ取り込みによるユーザーの削除

このページでは、クラウドデータ取り込みを使用してユーザーを削除するプロセスについて説明します。

ユーザー削除の同期は、利用可能なすべてのクラウドデータ取り込みデータソースでサポートされています。

インテグレーションの設定

接続したいデータウェアハウスに対して、Brazeダッシュボードで新しいインテグレーションを作成する標準プロセスに従ってください。削除テーブルにアクセスできるロールを含めるようにしてください。インポート同期の作成ページで、データタイプをユーザーの削除に設定し、インテグレーション実行中にユーザーを削除する適切なアクションが実行されるようにします。

ソースデータの設定

ユーザー削除のソーステーブルには、1つ以上のユーザー識別子タイプと UPDATED_AT タイムスタンプが含まれている必要があります。ペイロード列はユーザー削除データではサポートされていません。

UPDATED_AT

ソーステーブルに UPDATED_AT タイムスタンプを追加します。このタイムスタンプは、この行がテーブルに更新または追加された時刻を示します。Brazeは、UPDATED_AT が最後に同期された値よりも後の行を同期します。新しい行が同じタイムスタンプを共有している場合、正確な境界タイムスタンプの行は再同期される可能性があります。

ユーザー識別子列

テーブルには1つ以上のユーザー識別子列を含めることができます。各行には1つの識別子のみを含める必要があります。external_id、alias_name と alias_label の組み合わせ、または braze_id のいずれかです。ソーステーブルには、1つ、2つ、または3つすべての識別子タイプの列を含めることができます。

• EXTERNAL_ID - 更新するユーザーを識別します。Brazeで使用される external_id 値と一致する必要があります。
• ALIAS_NAME と ALIAS_LABEL - これらの2つの列はユーザーエイリアスオブジェクトを作成します。alias_name は一意の識別子であり、alias_label はエイリアスのタイプを指定します。ユーザーは異なるラベルを持つ複数のエイリアスを持つことができますが、alias_label ごとに alias_name は1つのみです。
• BRAZE_ID - Brazeユーザー識別子です。これはBraze SDKによって生成され、Cloud Data Ingestionを通じてBraze IDを使用して新しいユーザーを作成することはできません。新しいユーザーを作成するには、外部ユーザーIDまたはユーザーエイリアスを指定してください。

重要

ユーザー削除のテーブルに PAYLOAD 列を含めないでください。ユーザーの意図しない永続的な削除を防ぐため、ソーステーブルにペイロード列が提供された場合、同期は失敗します。その他の列は許可されますが、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

仕組み

Braze Cloud Data Ingestionを使用すると、データウェアハウスインスタンスとBrazeワークスペース間のインテグレーションを設定できます。同期は設定したスケジュールで実行されるか、APIを通じてオンデマンドで実行されます。頻度オプションについては、仕組みを参照してください。

同期が実行されると、Brazeはデータウェアハウスインスタンスに直接接続し、指定されたテーブルからすべての新しいデータを取得して、Brazeダッシュボード上の対応するユーザープロファイルを削除します。

警告

ユーザープロファイルの削除は元に戻すことができません。削除アクションはユーザーを永久に削除するため、データに不整合が生じる可能性があります。詳細については、ユーザープロファイル削除の影響を参照してください。