トレジャーデータのコホートインポート
この記事では、トレジャーデータからBrazeにユーザーコホートをインポートする方法について説明します。これにより、ウェアハウスにしか存在しないデータに基づいてターゲットキャンペーンを送信できるようになります。
この機能は現在ベータ版です。詳細については、トレジャーデータおよびBrazeの担当者にお問い合わせください。
前提条件
| 必要条件 | 説明 |
|---|---|
| トレジャーデータのアカウント | このパートナーシップを利用するには、トレジャーデータのアカウントが必要です。 |
| Brazeデータインポートキー | これは、Brazeダッシュボードのパートナー連携 > テクノロジーパートナーからトレジャーデータを選択して取得できます。 |
| Braze RESTエンドポイント | RESTエンドポイントURL。エンドポイントは、お使いのインスタンスのBraze URLに依存します。 |
| トレジャーデータの静的IPアドレス | トレジャーデータの静的IPアドレスは、この統合のリンクのアクセスポイントおよびソースです。静的IPアドレスを確認するには、トレジャーデータのカスタマーサクセス担当者またはトレジャーデータの技術サポートにご連絡ください。 |
データインポート統合
ステップ1:Brazeデータインポートキーを取得する
Brazeで、パートナー連携 > テクノロジーパートナーに移動し、トレジャーデータを選択します。ここで、RESTエンドポイントを確認し、Brazeデータインポートキーを生成できます。キーが生成されたら、新しいキーを作成するか、既存のキーを無効にできます。
ステップ2:データ接続を作成する
トレジャーデータ内でデータ接続を作成する前に、認証が必要になります。まず、Integrations Hubを選択し、次にCatalogを選択します。
CatalogでBraze統合を検索し、アイコンにカーソルを合わせてCreate Authenticationを選択します。認証情報を入力し、認証に名前を付けて、Doneを選択します。
ステップ3:コホートオーディエンスを定義する
Audience Studioでのアクティベーション、またはData Workbenchでのクエリ実行を通じて、コホートをBrazeに同期します。
Braze内にすでに存在するユーザーのみが、コホートに追加または削除されます。コホートインポートではBrazeに新しいユーザーは作成されません。
ステップ3.1:クエリを定義する
クエリ列は正確な列名とデータ型で指定する必要があります。クエリの列には、user_ids、device_ids、またはUIの設定と一致するBrazeエイリアス列のうち、少なくとも1つが含まれている必要があります。Braze内に存在するユーザープロファイルのみがコホートに追加されます。コホートインポートでは、新しいユーザープロファイルは作成されません。
- Data Workbench > Queriesに移動します。
- New Queryを選択します。
- クエリを実行して結果セットを検証します。
ユースケース:識別子によるコホートの同期
次にトレジャーデータのテーブルの例を示します。
| external_id | device_ids | |
|---|---|---|
TDCohort1 |
[email protected] |
1a2b3c |
TDCohort2 |
[email protected] |
4d5f6g |
TDCohort3 |
[email protected] |
7h8j9k |
TDCohort4 |
[email protected] |
1ab2cd |
列名はuser_idsである必要があります。そうでないと同期が失敗します。
external IDを使用してコホートを同期するには、次のクエリを実行します:
1
2
3
4
SELECT
external_id as user_ids
FROM
example_cohort_table
クエリを実行すると、これらのユーザーエイリアスがBrazeのコホートに追加されます:
TDCohort1TDCohort2TDCohort3TDCohort4
次にトレジャーデータのテーブルの例を示します。
| external_id | device_ids | |
|---|---|---|
TDCohort1 |
[email protected] |
1a2b3c |
TDCohort2 |
[email protected] |
4d5f6g |
TDCohort3 |
[email protected] |
7h8j9k |
TDCohort4 |
[email protected] |
1ab2cd |
ユーザーエイリアスを使用してコホートを同期するには、次のクエリを実行します:
SELECT
email
FROM
example_cohort_table
クエリを実行すると、これらのユーザーエイリアスがBrazeのコホートに追加されます:
"alias_label":"email", "alias_name":"[email protected]""alias_label":"email", "alias_name":"[email protected]""alias_label":"email", "alias_name":"[email protected]""alias_label":"email", "alias_name":"[email protected]"
次にトレジャーデータのテーブルの例を示します。
| external_id | device_ids | |
|---|---|---|
TDCohort1 |
[email protected] |
1a2b3c |
TDCohort2 |
[email protected] |
4d5f6g |
TDCohort3 |
[email protected] |
7h8j9k |
TDCohort4 |
[email protected] |
1ab2cd |
列名はdevice_idsである必要があります。そうでないと同期が失敗します。
デバイスIDを使用してコホートを同期するには、次のクエリを実行します:
SELECT
device_ids
FROM
example_cohort_table
クエリを実行すると、これらのデバイスIDがBrazeのコホートに追加されます:
1a2b3c4d5f6g7h8j9k1ab2cd
ステップ3.2:結果のエクスポートターゲットを指定する
クエリが構築されたら、Export Resultsを選択します。既存の認証（前のステップで作成した認証など）を選択するか、出力に使用する新しい認証を作成できます。
| エクスポート結果マッピング | 説明 |
|---|---|
| コホートID | Brazeに送信されるバックエンドのコホート識別子です。 |
| コホート名（任意） | Brazeのセグメンテーションツール内のコホートフィルターに表示される名前です。設定されていない場合、Cohort IDがCohort Nameとして使用されます。 |
| Operation | クエリがBrazeのコホートからプロファイルを追加するか削除するかを判断するために使用されます。 |
| 別名（オプション） | 定義されている場合、クエリ内の対応する列の名前がalias_labelとして送信され、列内の各行の値がalias_nameとして送信されます。 |
| スレッド数 | 同時API呼び出しの数です。 |
トレジャーデータの手順に従ってエクスポートを設定し、ユースケースに対応させます。
ステップ3.3:クエリを実行する
クエリに名前を付けて保存して実行するか、そのままクエリを実行します。クエリが正常に完了すると、クエリ結果は自動的にBrazeにエクスポートされます。
ステップ3.1:アクティベーションを作成する
新しいセグメントを作成するか、既存のセグメントを選択して、コホートとしてBrazeに同期します。セグメント内で、Create Activationを選択します。
ステップ3.2:アクティベーションの詳細を入力する
| アクティベーション詳細設定 | 説明 |
|---|---|
| アクティベーション名 | アクティベーションの名前です。 |
| アクティベーションの説明 | アクティベーションの簡単な説明です。 |
| 認証 | ステップ2で作成したBrazeコホート認証を選択します。 |
| コホートID | Brazeに送信されるバックエンドのコホート識別子です。 |
| コホート名（任意） | Brazeのセグメンテーションツール内のコホートフィルターに表示される名前です。設定されていない場合、Cohort IDがCohort Nameとして使用されます。 |
| Operation | クエリがBrazeのコホートからプロファイルを追加するか削除するかを判断するために使用されます。 |
| 別名（オプション） | 定義されている場合、クエリ内の対応する列の名前がalias_labelとして送信され、列内の各行の値がalias_nameとして送信されます。 |
| スレッド数 | 同時API呼び出しの数です。 |
ステップ3.3:出力マッピングを設定する
| アクティベーション出力マッピング | 説明 |
|---|---|
| 属性カラム | セグメントデータベースの列を指定し、プロファイルをBrazeコホートに同期する際の識別子としてマッピングします。 |
| String Builder | Braze統合には文字列ビルダーは必要ありません。 |
device_idを識別子として使用する場合、出力列名はdevice_idsにする必要があります。- エイリアスを識別子として使用する場合、出力列名はクエリ内の対応する列の名前にする必要があり、
alias_labelとして送信されます。列内の各行の値はalias_nameとして送信されます。 external_idを識別子として使用する場合、出力列名はuser_idsにする必要があります。
無関係または誤った名前の列名はすべて無視されます。同期で複数の識別子を使用することもできます。
ステップ3.4:アクティベーションスケジュールを定義する
希望する同期スケジュールを定義し、アクティベーションを保存します。
ステップ4:トレジャーデータのエクスポートからBraze セグメントを作成する
Brazeで、セグメントに移動し、新しいセグメントを作成して、フィルターとしてTreasure Data Cohortsを選択します。ここから、含めるトレジャーデータコホートを選択できます。トレジャーデータのコホートセグメントを作成したら、キャンペーンまたはキャンバスを作成する際にオーディエンスフィルターとして選択できます。
ユーザーマッチング
識別されたユーザーは、external_idまたはaliasのどちらかで照合できます。匿名ユーザーは、device_idで照合できます。元々匿名ユーザーとして作成された識別済みユーザーは、device_idでは識別できず、external_idまたはaliasで識別する必要があります。