Scuba Analytics
Scuba Analytics は、高速時系列データ向けに設計された、機械学習を採用したフルスタックのデータコラボレーションプラットフォームです。Scuba では、ユーザー (アクターとも呼ばれます) を選択的にエクスポートし、Braze プラットフォームにそれらのユーザーを読み込むことができます。Scuba では、カスタムアクタープロパティを使用して動作トレンドを分析し、さまざまなプラットフォーム間でデータを有効化し、マシンラーニングを使用して予測モデリングを実行します。
前提条件
Braze で Scuba Analytics を使用するには、以下が必要です。
必要条件 | 説明 |
---|---|
スキューバ API トークン | https://{scuba_hostname}/api/create_token エンドポイントから取得できる Scuba API トークン。 |
Braze REST API キー | users.track 権限を持つ Braze REST API キー。これは、Brazeダッシュボードの「設定」>「APIキー」から作成できる。 |
Braze RESTエンドポイント | REST エンドポイントのURL。エンドポイントはインスタンスの Braze URL に応じて異なります。 |
Braze への Scuba データのアップロード
以下の要求はcurl を使用します。API リクエストの管理を改善するには、Postman などの API クライアントを使用することをお勧めします。
Braze に Scuba データをアップロードするには、https://scuba.pliant.io/a/scuba-connectors/prod/braze-activation
に対して application/json
content-type を使用して POST リクエストを行います。
1
2
3
4
5
6
7
8
9
10
11
12
13
curl -X POST "https://scuba.pliant.io/a/scuba-connectors/prod/braze-activation" \
-H "content-type: application/json" \
-d '{"braze_host":"BRAZE_API_ENDPOINT", \
"braze_api_key":"BRAZE_API_KEY", \
"scuba_host":"HOSTNAME", \
"scuba_token":"SCUBA_API_TOKEN", \
"scuba_table_name":"TABLE_NAME", \
"scuba_actor_property_name":"ACTOR_PROPERTY_NAME", \
"scuba_actor_property_value_filter":"ACTOR_PROPERTY_FILTER" \
"scuba_actor_id":"ACTOR_ID", \
"scuba_period_start":"PERIOD_START", \
"scuba_period_end":"PERIOD_END", \
"scuba_record_limit":"RECORD_LIMIT"}'
次のように置き換えます。
placeholder | 説明 |
---|---|
BRAZE_API_ENDPOINT |
現在の Braze インスタンスの Braze REST エンドポイント URL。詳細については、「REST API キー」を参照してください。 |
BRAZE_API_KEY |
users.track 権限を持つBraze REST API キー。 |
HOSTNAME |
現在のScuba インスタンスのホスト名。 |
SCUBA_API_TOKEN |
Scuba API トークン。 |
TABLE_NAME |
データセットが属するテーブル。詳細については、用語集:データセットテーブル。 |
ACTOR_PROPERTY_NAME |
データセットが属するアクタプロパティ。この名前に一致するデータのみが返されます。詳細については、用語集:アクタープロパティ 。 |
ACTOR_PROPERTY_FILTER |
アクタープロパティのオーディエンス検索フィルター。 |
ACTOR_ID |
データセットが属するアクタプロパティのID。この ID は、Braze のexternal_id に一致します。詳細については、用語集:Actor.を参照してください。 |
PERIOD_START |
BQL 互換の日付としての期間開始日。詳細については、BQL構文および使用法を参照してください。 |
PERIOD_END |
BQL 互換の日付としての期間終了日。詳細については、BQL構文および使用法を参照してください。 |
RECORD_LIMIT |
オプション:返されるレコードの最大数。scuba_record_limit が省略された場合、Scuba は最大100件のレコードを返します。これを変更するには、負でない数値を scuba_record_limit に割り当てます。 |
デフォルト動作
デフォルトでは、update_existing_only
はfalse
に設定されています。これにより、Braze内の既存のレコードが更新され、存在しないレコードの新規レコードが作成されます。Scuba が新しいレコードを作成しないようにするには、update_existing_only
を true
に設定します。
レート制限
Scuba は、1分あたり50,000件のリクエストのレート制限をこのエンドポイントに適用します。
Scuba の行動データを使用したセグメントの作成
データをアップロードしたら、Scuba の行動データを使用して Braze でユーザーセグメントを作成できます。
ステップ1:新しいSegmentの作成
Braze で、Audience > Segments に移動し、Segmentの作成 を選択して、Segmentの名前を入力します。
ステップ2:Scuba 属性を探して選択する
Segment Details > Filtersで、Custom Attributesを選択します。
検索カスタム属性sを選択し、前回のPOSTリクエストで使用したアクタープロパティの名前を選択します。
ステップ 3:属性の設定
アクタープロパティ名の横で、演算子と値を選択します (該当する場合)。これらの値は、Scuba で定義したアクタープロパティによって決定されます。完了したら、[保存] を選択します。