Skip to content
/
Braze Cohort Export Integ...
Last updated

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の基本的な知識
  • Braze Cohortサービスを使用するには、Brazeの担当者に連絡して、Brazeアカウントでこのサービスを有効にしてください。
  • Data Import Key（クライアントシークレット）とREST Endpointを取得できる必要があります。詳細については、BrazeからRequired Parameter Valuesを取得するを参照してください。

要件と制限事項

  • 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/

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

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

Authenticationを作成する

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

  1. Integrations Hubを選択します。
  2. Catalogを選択します。
  3. Catalog内でIntegrationを検索し、アイコンにマウスを合わせてCreate Authenticationを選択します。
  4. Credentialsタブが選択されていることを確認し、Integrationの認証情報を入力します。

New Authentication Fields

ParameterDescription
Rest EndpointTreasure Data Partner Cohort REST Endpoint。詳細については、BrazeからRequired Parameter Valuesを取得するを参照してください。
Cluster Region2つのリージョンをサポート: USとEU
Data Import KeyTreasure Data Partner Cohort Data Import Key。詳細については、BrazeからRequired Parameter Valuesを取得するを参照してください。
  1. Continueを選択します。
  2. Authenticationの名前を入力し、Doneを選択します。

Queryを定義する

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

Result Export Targetを指定する

  1. Export Resultsを選択します。

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

Use Existing Integration

Create a New Integration

Parameter configuration

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

Example Query

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

  4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:

    ドロップダウン値説明
    Custom cron...Custom cron... の詳細を参照してください。
    @daily (midnight)指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。
    @hourly (:00)毎時 00 分に実行します。
    Noneスケジュールなし。

Custom cron... の詳細

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を選択します。
  3. 下にスクロールしてData Import Using Cohort Importを見つけます。
  4. Data Import KeyとREST Endpointの値をコピーして、このConnectorのAuthentication設定に入力します。
Previous page
Next page