クラウドデータ取り込みによるユーザーの削除
このページでは、クラウドデータ取り込みを使用してユーザーを削除するプロセスについて説明します。
ユーザー削除の同期は、利用可能なすべてのクラウドデータ取り込みデータソースでサポートされています。
統合の設定
標準のプロセスに従って、接続するデータウェアハウスのBrazeダッシュボードで新しい統合を作成します。削除テーブルにアクセスできるロールが含まれていることを確認してください。Create import sync ページで、データタイプをDelete Usersに設定し、統合実行中にユーザーを削除するための適切なアクションが実行されるようにします。

ソースデータの設定
ユーザー削除のソーステーブルには、1つ以上のユーザー識別子タイプとUPDATED_ATタイムスタンプを含める必要があります。ペイロード列は、ユーザー削除データではサポートされていません。
UPDATED_AT
ソーステーブルにUPDATED_ATタイムスタンプを追加します。このタイムスタンプは、この行が更新されたか、テーブルに追加された時点を示します。Brazeは、UPDATED_ATが最後に同期された値より後の行を同期します。同じタイムスタンプを持つ新しい行がある場合、境界のタイムスタンプにある行は再同期される可能性があります。
ユーザー識別子列
テーブルには、ユーザー識別子列を1列以上含めることができます。各行には、識別子(external_id単独か、alias_nameとalias_labelの組み合わせ、またはbraze_id)を1つのみ含める必要があります。ソーステーブルには、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によって生成されます。クラウドデータ取り込み経由でBraze IDを使用して新規ユーザーを作成することはできません。新規ユーザーを作成するには、外部ユーザーIDまたはユーザーエイリアスを指定してください。

ユーザーを削除する目的で、テーブルにPAYLOAD列を含めないでください。ユーザーの偶発的かつ永久的な削除を防ぐため、ソーステーブルにペイロード列がある場合、同期は失敗します。その他の列は許可されますが、Brazeでは無視されます。
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
);
次のフィールドを持つテーブルを作成します。
| フィールド名 | タイプ | モード |
|---|---|---|
UPDATED_AT |
TIMESTAMP | REQUIRED |
EXTERNAL_ID |
STRING | NULLABLE |
ALIAS_NAME |
STRING | NULLABLE |
ALIAS_LABEL |
STRING | NULLABLE |
BRAZE_ID |
STRING | NULLABLE |
次のフィールドを持つテーブルを作成します。
| フィールド名 | タイプ | モード |
|---|---|---|
UPDATED_AT |
TIMESTAMP | REQUIRED |
EXTERNAL_ID |
STRING | NULLABLE |
ALIAS_NAME |
STRING | NULLABLE |
ALIAS_LABEL |
STRING | NULLABLE |
BRAZE_ID |
STRING | NULLABLE |
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のクラウドデータ取り込みでは、データウェアハウスインスタンスとBrazeワークスペースの間の統合を設定して、定期的にデータを同期します。この同期は設定したスケジュールで実行され、統合ごとに異なるスケジュールを設定できます。同期は最短で15分ごと、最長で月に1回の頻度で実行できます。15分より短い間隔で同期を実行する必要がある場合は、カスタマーサクセスマネージャーにご相談いただくか、リアルタイムのデータ取り込みにREST API呼び出しの使用をご検討ください。
同期が実行されると、Brazeはデータウェアハウスインスタンスに直接接続し、指定されたテーブルからすべての新しいデータを取得して、Brazeダッシュボード上の対応するユーザープロファイルを削除します。

ユーザープロファイルの削除は元に戻せません。ユーザーが完全に削除されるため、データの不整合が発生する可能性があります。詳細については、ユーザープロファイルの削除を参照してください。