# Braze Cohort Export Integration

Brazeは、消費者とブランドを結びつけるCustomer Engagement Platformです。SDKを介して、消費者向けのモバイルアプリケーションやウェブサイトにターゲット広告をプッシュすることができます。さらに、このプラットフォームは、オプトアウトユーザーやセグメントのスケジュールされたクリーンアップを含む、スケーラブルなユーザープロファイル管理システムを提供します。Treasure DataはBrazeと提携し、セグメント構築に使用できるTreasure Data cohortをサポートしています。

このBraze Cohort Export Integrationを使用すると、特定のcohortにプロファイルを追加または削除できます。

# 前提条件

- Treasure Dataの基本的な知識
- BrazeおよびBraze Cohortの基本的な知識
  - 参照: [Treasure Data Cohort Import](https://www.braze.com/docs/partners/data_and_infrastructure_agility/cohort_import/treasuredata)
- Braze Cohortサービスを使用するには、Brazeの担当者に連絡して、Brazeアカウントでこのサービスを有効にしてください。
- Data Import Key（クライアントシークレット）とREST Endpointを取得できる必要があります。詳細については、[BrazeからRequired Parameter Valuesを取得する](/ja/int/braze-cohort-export-integration#h2__1796476053)を参照してください。


# 要件と制限事項

- Queryのカラムは、正確なカラム名とデータ型で指定する必要があります。
- Queryのカラムには、少なくとも次のいずれかのカラムが存在する必要があります: user_ids、device_ids、またはUI上の設定と一致するbraze aliasカラム。


## Treasure Data Integration の静的 IP アドレス

セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。

リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります:
[https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/](https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/)

# TD Consoleを使用してConnectionを作成する

Queryを実行する前に、Treasure Dataでデータ接続を作成および設定する必要があります。データ接続の一部として、Integrationにアクセスするための認証情報を提供します。

## Authenticationを作成する

最初のステップは、一連の認証情報を使用して新しいAuthenticationを作成することです。

1. **Integrations Hub**を選択します。
2. **Catalog**を選択します。
![](/assets/braze-cohort-export-integration-2024-05-29.520810dbdd3bfc5694a09fbeb88a8e30c9c4531c7b4cb3d73789167eff2cf346.b520e344.png)
3. Catalog内でIntegrationを検索し、アイコンにマウスを合わせて**Create Authentication**を選択します。
![](/assets/braze-cohort-export-integration-2024-05-29-1.48b66198d22d5b6ac99bad6bfe024a58ea42a11b234f01152cbe105560bda2e3.b520e344.png)
4. **Credentials**タブが選択されていることを確認し、Integrationの認証情報を入力します。
![](/assets/screen-shot-2024-04-22-at-09.54.43.7408b563efe13e85fcba7cf22412e972ac0c29162195f7a0ec800a2339f9da90.b520e344.png)


**New Authentication Fields**

| Parameter | Description |
|  --- | --- |
| Rest Endpoint | Treasure Data Partner Cohort REST Endpoint。詳細については、[BrazeからRequired Parameter Valuesを取得する](/ja/int/braze-cohort-export-integration#h2__1796476053)を参照してください。 |
| Cluster Region | 2つのリージョンをサポート: USとEU |
| Data Import Key | Treasure Data Partner Cohort Data Import Key。詳細については、[BrazeからRequired Parameter Valuesを取得する](/ja/int/braze-cohort-export-integration#h2__1796476053)を参照してください。 |


1. **Continue**を選択します。
2. Authenticationの名前を入力し、**Done**を選択します。


## Queryを定義する

1. **Data Workbench > Queries**に移動します。
2. **New Query**を選択します。
3. Queryを実行して結果セットを検証します。


![](/assets/screen-shot-2024-04-22-at-10.08.47.f1acadd40b31ce9aa910579fcea4d1a2686409d251313df4e93ab62374089d39.b520e344.png)

# Result Export Targetを指定する

1. **Export Results**を選択します。


![](/assets/screen-shot-2024-04-22-at-10.13.42.82362924063ff40c225f95dabed5c6b09c64a13469442c28a4275089d35dde74.b520e344.png)

出力に使用する外部サービスの既存のAuthenticationを選択するか、新しいAuthenticationを作成できます。次のいずれかを選択します:

**Use Existing Integration**

![](/assets/export-integration-template_26617476-2024-02-05-2.654362d5d36805519ec64f0c0dcb467e4921dcd3e2760a0f6f6d4b2ddb672a3a.9f8ceb9f.png)

**Create a New Integration**

![](/assets/screen-shot-2024-04-22-at-10.15.46.fd608d79c32b3c414b8b7e310caf902dc9c1d623d94b58385b03ccdbbabb6fed.b520e344.png)

![](/assets/screen-shot-2024-04-22-at-10.19.55.9b4ef245157e085aa97a1ada2df9aaaf7f57ebc26f895f53ddff0820e11a9a07.b520e344.png)

**Parameter configuration**

| Field | Description |
|  --- | --- |
| Cohort ID | Braze Cohort ID |
| Cohort Name | Braze Cohort Name |
| Operation | 2つのモードをサポート:  - APPEND: ターゲットcohortにプロファイルを追加  - REMOVE: ターゲットcohortからプロファイルを削除 |
| Aliases | ターゲットBraze Treasure Data Cohortに送信する際にaliasとして扱われるカラム名のカンマ区切りリスト。カラム名はAlias Labelにマッピングされ、カラムの値はAlias Nameにマッピングされます。 |
| Thread Count | Braze Cohort APIへの同時リクエスト数。最小値は1、最大値は10です。 |
| Skip on Invalid Record | 有効にすると、無効なレコードがあってもJobは実行を続けます。無効にすると停止します。 |


## Example Query

- Queryのカラムは、正確なカラム名とデータ型で指定する必要があります。
- Queryのカラムには、少なくとも次のいずれかのカラムが存在する必要があります: **user_ids**、**device_ids**、またはUI上の設定と一致するbraze aliasカラム。



```sql
SELECT
   user_ids,
   device_ids,
   alias_label_1
FROM
   cohort
```

### (オプション) Query Export ジョブをスケジュールする

Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。

Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。

2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。

例えば、cron スケジュールが `'0 0 1 * 1'` の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。

#### TD Console を使用してジョブをスケジュールする

1. **Data Workbench > Queries** に移動します
2. 新しいクエリを作成するか、既存のクエリを選択します。
3. **Schedule** の横にある None を選択します。
![](/assets/image2021-1-15_17-28-51.f1b242f6ecc7666a0097fdf37edd1682786ec11ef80eff68c66f091bc405c371.0f87d8d4.png)
4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:
![](/assets/image2021-1-15_17-29-47.45289a1c99256f125f4d887e501e204ed61f02223fde0927af5f425a89ace0c0.0f87d8d4.png)
| ドロップダウン値 | 説明 |
|  --- | --- |
| Custom cron... | [Custom cron... の詳細](#custom-cron-details)を参照してください。 |
| @daily (midnight) | 指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。 |
| @hourly (:00) | 毎時 00 分に実行します。 |
| None | スケジュールなし。 |


#### Custom cron... の詳細

![](/assets/image2021-1-15_17-30-23.0f94a8aa5f75ea03e3fec0c25b0640cd59ee48d1804a83701e5f2372deae466c.0f87d8d4.png)

| **Cron 値** | **説明** |
|  --- | --- |
| `0 * * * *` | 1 時間に 1 回実行します。 |
| `0 0 * * *` | 1 日 1 回午前 0 時に実行します。 |
| `0 0 1 * *` | 毎月 1 日の午前 0 時に 1 回実行します。 |
| "" | スケジュールされた実行時刻のないジョブを作成します。 |



```
 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- day of week (0 - 6) (Sunday=0)
 |    |    |    +---------- month (1 - 12)
 |    |    +--------------- day of month (1 - 31)
 |    +-------------------- hour (0 - 23)
 +------------------------- min (0 - 59)
```

次の名前付きエントリを使用できます:

- Day of Week: sun, mon, tue, wed, thu, fri, sat.
- Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec.


各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます:

| フィールド値  | 例  | 例の説明  |
|  --- | --- | --- |
| 各フィールドに対して上記で表示された制限内の単一の値。 |  |  |
| フィールドに基づく制限がないことを示すワイルドカード
`'*'`。 | `'0 0 1 * *'` | 毎月 1 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| 範囲 `'2-5'`
フィールドの許可される値の範囲を示します。 | `'0 0 1-10 * *'` | 毎月 1 日から 10 日までの午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| カンマ区切りの値のリスト `'2,3,4,5'`
フィールドの許可される値のリストを示します。 | `0 0 1,11,21 * *'` | 毎月 1 日、11 日、21 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| 周期性インジケータ `'*/5'`
フィールドの有効な値の範囲に基づいて、
スケジュールが実行を許可される頻度を表現します。 | `'30 */2 1 * *'` | 毎月 1 日、00:30 から 2 時間ごとに実行するようにスケジュールを設定します。
`'0 0 */5 * *'` は、毎月 5 日から 5 日ごとに午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| `'*'`
ワイルドカードを除く上記の
いずれかのカンマ区切りリストもサポートされています
`'2,*/5,8-10'` | `'0 0 5,*/10,25 * *'` | 毎月 5 日、10 日、20 日、25 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |


1. (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。


### クエリを実行する

クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。

設定エラーにより継続的に失敗するスケジュールジョブは、複数回通知された後、システム側で無効化される場合があります。

(オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

## BrazeからRequired Parameter Valuesを取得する

設定に入力するために、Braze環境からいくつかの値を取得する必要があります。

1. Braze環境にログインします
2. **Partner Integrations > Technology Partners**に移動します。**Treasure Data**を選択します。
![](/assets/braze-cohort-export-integration-2024-05-09-2.b1654659b9800b1138ef96ce47941aa1ba3154f7a799b6923344ea056083c592.b520e344.png)
3. 下にスクロールして**Data Import Using Cohort Import**を見つけます。
4. Data Import KeyとREST Endpointの値をコピーして、このConnectorのAuthentication設定に入力します。
![](/assets/braze-cohort-export.7c1272382489c539c96aae38dfbb932d4024c45d2f46224765b5049fe1b5b09d.b520e344.png)