Looker

ビジネスインテリジェンスとビッグデータ分析プラットフォームであるLookerは、リアルタイムのビジネス分析をシームレスに探索、分析、共有することを可能にする。

BrazeとLookerの統合により、BrazeユーザーはREST APIを介してファーストパーティのLooker Blocksと Looker Actionsのユーザーフラグを活用することができる。これらのフラグを立てたユーザーをセグメントに追加し、将来のBrazeキャンペーンやCanvasのターゲットにすることができる。BrazeでLookerを使用するには、Brazeカレントを使用してBrazeデータをデータウェアハウスに送信し、BrazeのLooker Blocksを使用してLookerでBrazeデータを素早くモデル化、視覚化することを推奨する。

前提条件

制限事項

• このプロセスは、ピボットされていないデータに対してのみ機能する。
• APIは一度に最大100,000行を処理する。
• 重複や非ユーザーのため、最終的なユーザーフラグのカウントは低くなる可能性がある。

統合

ルッカーブロック

当社のLooker Blocksは、Brazeの顧客がCurrentsを通じて提供する詳細なデータのビューに素早くアクセスするのに役立つ。Brazeのブロックは、Currentsデータ用にあらかじめ作成されたビジュアライゼーションとモデリングを提供するため、Brazeの顧客は、リテンションなどの分析パターンの実装、メッセージ配信性の評価、ユーザー行動のより詳細な調査などを簡単に行うことができる。

Looker Blocksを実装するには、GitHubコードのREADMEファイルの指示に従う。

• メッセージ・エンゲージメント分析ブロック README
• ユーザー行動分析ブロック README

どちらの統合も、最初のBrazeとの統合、およびBrazeとLooker互換のデータウェアハウスとの統合が、必要なデータを取り込み、送信するように適切に設定されていることを前提としている。

利用可能なブロック

ルッカーのアクション

Looker Actionsを使用すると、Looker LookからREST APIエンドポイント経由でBraze内のユーザーにフラグを立てることができる。アクションでは、ディメンジョンにbraze_id というタグが付けられる必要がある。アクションは、フラグを立てた値をユーザーのカスタム属性（looker_export ）に追加する。

ステップ1:ブレイズ・ルッカーのアクションをセットする

Braze REST APIキーとRESTエンドポイントを使用して、Braze Looker Actionを設定する。

ステップ2:Looker Developをセットアップする

Looker Develop 内で、適切なビューを選択する。dimensionsタグに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 Actionはプロダクションの設定でのみ機能する。

ステップ3:タグにユーザー属性を設定する

オプションで、braze[] タグを使って、属性名を括弧で囲んで設定することもできる。例えば、カスタム属性user_segment を送信したい場合、タグはbraze[user_segment] となる。

以下の制限に注意：

• 属性は、ルック内のフィールドとして含まれている場合にのみ送信される。
• サポートされるタイプはStrings 、Boolean 、Numbers 、Dates である。
• 属性名は大文字と小文字を区別する。
• 標準ユーザープロファイル名と完全に一致する限り、標準属性も設定できる。
• 完全なタグは引用符で囲む。例えば、tags: ["braze[first_name]"] 。他のタグを割り当てることもできるが、無視される。
• 追加情報はGitHubで見ることができる。

ステップ 4:ルッカーのアクションを送信する

1. braze_id ディメンジョンを選択したルック内で、右上の設定ギア ( ) をクリックし、Send... を選択する。
2. カスタムブレイズアクションを選択する。
3. Unique Keyの下に、Brazeアカウントのプライマリユーザーマッピングキー（external_id またはbraze_id ）を入力する。
4. エクスポートに名前をつける。指定がない場合は、LOOKER_EXPORT 。
5. Advanced Options（詳細オプション）」で、「Results in Table（テーブル内の結果）」または「All Results（すべての結果）」を選択し、「Send（送信）」を選択する。
   
   
   
   エクスポートが正しく送信されていれば、LOOKER_EXPORT 、アクションで入力した値がカスタム属性としてユーザーのプロファイルに表示されるはずだ。
   
   

送信APIの例

以下は発信APIコールの例で、/users/track/ エンドポイントに送られる。

ヘッダー

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で、これらのフラグを付けたユーザーのセグメントを作成するには、Engagementの Segmentsに移動し、セグメントに名前を付け、フィルターとしてLooker_Exportを選択する。次に、”includes value “オプションを使い、Lookerで割り当てたカスタム属性フラグを指定する。

一度保存すれば、キャンバスやキャンペーン作成時に、ユーザーをターゲティングするステップでこのセグメントを参照することができる。

トラブルシューティング

Lookerアクションに問題がある場合、テストユーザーを[internal groups]16 ] に追加し、以下を確認する：

• APIキーにはusers.track の権限がある。
• 正しいRESTエンドポイントは、https://rest.iad-01.braze.com のように入力する。
• braze_id タグがディメンジョン・ビューに設定される。
• クエリには、Id ディメンジョンまたは属性が列として含まれている。
• ルッカーの結果はピボットされない。
• ユニークキーは正しく選択されている。通常、external_id 。
• braze_id 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は本番環境でも機能する。