Looker

ビジネスインテリジェンスとビッグデータ分析のプラットフォームである Looker は、リアルタイムのビジネス分析の探索、分析、共有をシームレスに行えるようにしています。

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

前提条件

制限事項

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

統合

Looker Blocks

Looker Blocks により、Braze のお客様は Currents で当社から提供される詳細なデータのビューに素早くアクセスできるようになります。Braze のブロックは、Currents データ用に事前に作成されている視覚化とモデリング機能を提供します。これにより、Braze のお客様は、リテンションなどの分析パターンを容易に実装し、メッセージの配信可能性を評価し、ユーザーの行動をより細かく確認することなどができるようになります。

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

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

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

利用可能なブロック

Looker Actions

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

ステップ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 アクションを送信する

1. braze_id ディメンションが選択されている Look 内で、右上の設定の歯車 () をクリックし、[Send…] を選択します。
2. カスタム Braze アクションを選択します。
3. [Unique Keｙ] で Braze アカウントのプライマリユーザーマッピングキー (external_id またはbraze_id) を入力します。
4. エクスポートに名前をつける。指定されない場合は LOOKER_EXPORT が使用されます。
5. 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で割り当てたカスタム属性フラグを指定する。

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

トラブルシューティング

Looker アクションに問題がある場合、テストユーザーを内部グループに追加し、以下を確認します。

• 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は本番環境でも機能する。