Looker
ビジネスインテリジェンスとビッグデータ分析のプラットフォームである Looker は、リアルタイムのビジネス分析の探索、分析、共有をシームレスに行えるようにしています。
Braze と Looker の統合により、Braze をご利用のお客様は REST API を介してファーストパーティの Looker Blocks と Looker Actions ユーザーフラグを利用できます。これらのフラグを立てたユーザーをセグメントに追加し、将来のBrazeキャンペーンやCanvasのターゲットにすることができる。Braze と Looker を使用するには、Braze Currents を使用してデータウェアハウスに Braze データを送信してから、Braze の Looker Blocks を使用して Looker で Braze データを迅速にモデル化して視覚化することを推奨します。
前提条件
必要条件 | 説明 |
---|---|
Looker アカウント | このパートナーシップを活用するには、Looker アカウントが必要です。 |
Braze REST API キー | users.track 権限を持つ Braze REST API キー。これは、Brazeダッシュボードの「設定」>「APIキー」から作成できる。 |
Braze RESTエンドポイント | RESTエンドポイントのURL。エンドポイントはインスタンスの Braze URL に応じて異なります。 |
制限事項
- このプロセスは、ピボットされていないデータに対してのみ機能する。
- APIは一度に最大100,000行を処理する。
- ユーザーの最終的なフラグの数は、重複や非ユーザーが原因で少なくなる可能性があります。
統合
Looker Blocks
Looker Blocks により、Braze のお客様は Currents で当社から提供される詳細なデータのビューに素早くアクセスできるようになります。Braze のブロックは、Currents データ用に事前に作成されている視覚化とモデリング機能を提供します。これにより、Braze のお客様は、リテンションなどの分析パターンを容易に実装し、メッセージの配信可能性を評価し、ユーザーの行動をより細かく確認することなどができるようになります。
Looker Blocksを実装するには、GitHubコードのREADMEファイルの指示に従う。
どちらの統合も、初回の Braze 統合と、Looker 互換のデータウェアハウスと Braze の統合が、必要なデータを取り込んで送信するように適切に設定されていることを前提としています。
BrazeはSnowflakeをデータウェアハウスとして使用してLooker Blocksを構築した。ブロックはできるだけ多くのデータウェアハウスで動作することを目指しているが、SQL関数の中には方言によって利用可能なもの、構文、動作が異なるものがある。
さまざまな命名規則に注意すること!カスタム名は、対応する名前をすべて変更しない限り、データの不整合を引き起こす可能性がある。ビュー名、テーブル名、モデル名をカスタマイズしている場合は、LookML 内のそれぞれの名前を、選択した名前に変更する。
利用可能なブロック
ブロック | 説明 |
---|---|
メッセージ・エンゲージメント分析ブロック | このブロックには、プッシュ、Eメール、アプリ内メッセージ、ウェブフック、ニュースフィード、コンバージョン、キャンバスエントリー、キャンペーンコントロールグループの登録イベントに関するデータが含まれる。 この Looker ブロックの詳細については、GitHub のコードをご確認ください。 |
ユーザー行動分析ブロック | このブロックには、カスタムイベント、購入、セッション、ロケーションイベント、アンインストールに関するデータが含まれる。 この Looker ブロックの詳細については、GitHub のコードをご確認ください。 |
Looker Actions
Looker Actions を使用すると、Looker Look から REST API エンドポイントを介して Braze 内のユーザーにフラグを設定することができます。アクションを使用するには、ディメンションに braze_id
というタグが付けられている必要があります。アクションは、フラグを立てた値をユーザーのカスタム属性(looker_export
)に追加する。
フラグが立つのは既存のユーザーだけだ。Brazeでデータにフラグを立てる場合、ピボット・ルックは使用できない。
ステップ1:Braze Looker アクションを設定する
Braze REST API キーと REST エンドポイントを使用して、Braze Looker アクションを設定します。
ステップ2:Looker Developをセットアップする
Looker Develop 内で、適切なビューを選択する。ディメンションタグに braze_id
を追加し、変更をコミットします。
このbraze_id
タグは、どのフィールドがユニークキーであるかを決定するために使用される。
1
2
3
4
5
6
dimension: external_id {
type: string
primary_key: yes
sql: ${TABLE}.external_id ;;
tags: ["braze_id"]
}
必ず変更をコミットすること。Looker アクションは本番環境の設定でのみ機能します。
ステップ3:タグにユーザー属性を設定する
オプションで、braze[]
タグを使用し、属性名を括弧で囲んで属性を設定することもできます。たとえば、カスタム属性 user_segment
を送信する場合、タグは braze[user_segment]
になります。
以下の制限に注意:
- 属性は、Look 内のフィールドとして含まれている場合にのみ送信されます。
- サポートされているタイプは
Strings
、Boolean
、Numbers
、Dates
です。 - 属性名は大文字と小文字を区別する。
- 標準ユーザープロファイル名と完全に一致する限り、標準属性も設定できる。
- 完全なタグは引用符で囲む。例:
tags: ["braze[first_name]"]
。他のタグを割り当てることもできるが、無視される。 - 追加情報は GitHub で確認できます。
ステップ 4:Looker アクションを送信する
braze_id
ディメンションが選択されている Look 内で、右上の設定の歯車 () をクリックし、[Send…] を選択します。- カスタム Braze アクションを選択します。
- [Unique Key] で Braze アカウントのプライマリユーザーマッピングキー (
external_id
またはbraze_id
) を入力します。 - エクスポートに名前をつける。指定されない場合は
LOOKER_EXPORT
が使用されます。 - Advanced Options(詳細オプション)」で、「Results in Table(テーブル内の結果)」または「All Results(すべての結果)」を選択し、「Send(送信)」を選択する。
エクスポートが正しく送信された場合、LOOKER_EXPORT
は、アクションに入力された値を含むカスタム属性としてユーザーのプロファイルに表示されます。
送信 API の例
以下に、/users/track/
エンドポイントに送信される送信 API 呼び出しの例を示します。
ヘッダー
1
Authorization: Bearer [API_KEY]
本文
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
"attributes" : [
{
"external_id" : "user_01",
"_update_existing_only" : true,
"looker_export" : { "add" : ["LOOKER"] }
},
{
"external_id" : "user_02",
"_update_existing_only" : true,
"looker_export" : { "add" : ["LOOKER"] }
},
{
"external_id" : "user_03",
"_update_existing_only" : true,
"looker_export" : { "add" : ["LOOKER"] }
},
.....
]
}
Braze でユーザーをセグメント化する
Braze で、これらのフラグが設定されたユーザーのセグメントを作成するには、[エンゲージメント] の下の [セグメント] に移動し、セグメントに名前を付け、フィルターとして [Looker_Export] を選択します。次に、”includes value “オプションを使い、Lookerで割り当てたカスタム属性フラグを指定する。
![Braze セグメントビルダーで、フィルター [looker_export] に [includes_value] と [Looker] が設定されている。]15
一度保存すれば、キャンバスやキャンペーン作成時に、ユーザーをターゲティングするステップでこのセグメントを参照することができる。
トラブルシューティング
Looker アクションに問題がある場合、テストユーザーを[内部グループ]16に追加し、以下を確認します。
- APIキーには
users.track
の権限がある。 - 正しい REST エンドポイントが入力されている (例:
https://rest.iad-01.braze.com
)。 - ディメンションビューで
braze_id
タグが設定されている。 - クエリには、Id ディメンションまたは属性が列として含まれている。
- ルッカーの結果はピボットされない。
- ユニークキーは正しく選択されている。通常は
external_id
です。 - ディメンションの
braze_id
は API のbraze_id
とは異なる。ディメンションのbraze_id
は、Braze API のid
フィールドであることを示すために使用されます。ほとんどの場合、送信時にはexternal_id
がプライマリキーとなります。 external_id
ユーザーはBrazeプラットフォームに存在する。looker_export
フィールドはBraze Platform > Settings > Manage Settings > Custom Attributes
の下にAutomatically Detect
として設定されている。- 変更はプロダクションにコミットされる。Looker Actionは本番環境でも機能する。