トレジャーデータのコホートインポート
この記事では、トレジャーデータからBrazeにユーザーコホートをインポートする方法について説明します。これにより、倉庫にしか存在しないデータに基づいてターゲットキャンペーンを送信できるようになります。
この機能は現在ベータ版です。詳細については、トレジャーデータおよび Braze の担当者にお問い合わせください。
前提条件
必要条件 | 説明 |
---|---|
トレジャーデータのアカウント | このパートナーシップを利用するには、トレジャーデータのアカウントが必要です。 |
Braze データインポートキー | これは、Braze ダッシュボードの [パートナー連携] > [テクノロジーパートナー] からキャプチャされます。その後 [Heap] を選択します。 |
Braze REST エンドポイント | あなたのRESTエンドポイントURL。お客様のエンドポイントは、お客様のインスタンスのBraze URLに依存します。 |
トレジャーデータの静的IPアドレス | トレジャーデータの静的 IP アドレスは、この統合のリンクのアクセスポイントおよびソースです。静的 IP アドレスを確認するには、トレジャーデータのカスタマーサクセス担当者またはトレジャーデータの技術サポートにご連絡ください。 |
データインポート統合
ステップ1:Brazeデータインポートキーを取得する
Brazeで、Partner Integrations > Technology Partners に移動し、トレジャーデータ を選択します。ここで、RESTエンドポイントを見つけて、Brazeデータインポートキーを生成します。キーが生成されたら、新しいキーを作成するか、既存のキーを無効にできます。
ステップ2:データ接続を作成する
トレジャーデータ内でデータ接続を作成する前に、認証が必要になります。まず、インテグレーションハブを選択し、次にカタログを選択します。
カタログでBraze統合を検索し、アイコンにカーソルを合わせて認証の作成を選択します。資格情報を入力し、認証に名前を付けて、完了を選択します。
ステップ3:コホートオーディエンスを定義する
Audience Studio でのアクティベーション、または Data Workbench でクエリを実行して、コホートを Braze に同期します。
Braze内に既に存在するユーザーのみがコホートに追加または削除されます。コホートインポートはBrazeに新しいユーザーを作成しません。
ステップ 3.1:クエリを定義する
クエリ列は正確な列名とデータ型で指定する必要があります。クエリの列には、user_ids
、device_ids
、または UI の設定と一致する Braze エイリアス列のうち、1つ以上の列が含まれている必要があります。Braze内に存在するユーザーのプロファイルのみがコホートに追加されます。コホートインポートでは、新しいユーザープロファイルは作成されません。
- データワークベンチ > クエリ に移動します。
- 新しいクエリを選択します。
- クエリを実行して結果セットを検証します。
ユースケース:識別子によるコホートの同期
次にトレジャーデータのテーブルの例を示します。
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のコホートに追加されます:
TDCohort1
TDCohort2
TDCohort3
TDCohort4
次にトレジャーデータのテーブルの例を示します。
external_id | device_ids | |
---|---|---|
TDCohort1 |
[email protected] |
1a2b3c |
TDCohort2 |
[email protected] |
4d5f6g |
TDCohort3 |
[email protected] |
7h8j9k |
TDCohort4 |
[email protected] |
1ab2cd |
ユーザーエイリアスを使用してコホートを同期するには、次のクエリを実行します:
1
2
3
4
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を使用してコホートを同期するには、次のクエリを実行します:
1
2
3
4
SELECT
device_ids
FROM
example_cohort_table
クエリを実行すると、これらのデバイスIDがBrazeのコホートに追加されます:
1a2b3c
4d5f6g
7h8j9k
1ab2cd
ステップ 3.2:結果のエクスポートターゲットを指定します
クエリが構築されたら、結果をエクスポートを選択します。既存の認証 (前回の手順で作成した認証など) を選択するか、または出力に使用する新しい認証を作成できます。
エクスポート結果マッピング | 説明 |
---|---|
コホートID | これは、Brazeに送信されるバックエンドのコホート識別子です。 |
コホート名(任意) | これは、Brazeのセグメンテーションツール内のコホートフィルターに表示される名前です。これが設定されていない場合、Cohort ID はCohort Name として使用されます。 |
Operation | クエリがBrazeのコホートからプロファイルを追加または削除するかどうかを判断するために使用されます。 |
別名(オプション) | 定義されている場合、クエリ内の対応する列の名前はalias_label として送信され、列内の各行の値はalias_name として送信されます。 |
スレッド数 | 同時API呼び出しの数。 |
トレジャーデータの手順に従ってエクスポートを設定し、ユースケースに対応させます。
ステップ 3.3:クエリを実行する
クエリに名前を付けて保存して実行するか、またはクエリを実行します。クエリが正常に完了すると、クエリ結果は自動的にBrazeにエクスポートされます。
ステップ 3.1:アクティベーションを作成する
新しいSegmentを作成するか、既存のSegmentを選択して、コホートとしてBrazeに同期します。セグメント内で、アクティベーションを作成を選択します。
ステップ 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:Treasure Data Export から Braze セグメントを作成する
Brazeで、Segmentに移動し、新しいセグメントを作成して、フィルターとしてトレジャーデータコホートを選択します。ここから、どのトレジャーデータコホートを含めるかを選択できます。トレジャーデータのコホートセグメントを作成したら、キャンペーンまたはキャンバスを作成するときにこのセグメントをオーディエンスフィルターとして選択できます。
ユーザーマッチング
識別されたユーザは、external_id
またはalias
のいずれかで照合できます。匿名ユーザは、device_id
と照合できます。最初に匿名ユーザーとして作成された識別済みユーザーは、device_id
で識別できず、external_id
またはalias
で識別する必要があります。