Skip to content

Braze LearningコースLooker

ビジネスインテリジェンスおよびビッグデータ分析プラットフォームであるLookerを使用すると、リアルタイムのビジネス分析をシームレスに探索、分析、共有できます。

BrazeとLookerの統合により、企業ユーザーはREST APIを介してファーストパーティのLooker BlocksとLooker Actionsのユーザーフラグ機能を活用できます。フラグを設定したユーザーをセグメントに追加して、将来のBrazeキャンペーンやキャンバスのターゲティングに使用できます。LookerをBrazeと併用するには、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統合が、必要なデータを取り込んで送信するように適切に設定されていることを前提としています。

利用可能なブロック

ブロック 説明
メッセージエンゲージメント分析ブロック このブロックには、プッシュ、メール、アプリ内メッセージ、Webhook、コンバージョン、キャンバスエントリ、およびキャンペーンコントロールグループ登録イベントに関するデータが含まれます。

このLookerブロックの詳細については、GitHubのコードをご確認ください。
ユーザー動作分析ブロック このブロックには、カスタムイベント、購入、セッション、ロケーションイベント、アンインストールに関するデータが含まれます。

このLookerブロックの詳細については、GitHubのコードをご確認ください。

Looker Actions

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

ステップ1:Braze Lookerアクションを設定する

Braze REST APIキーとRESTエンドポイントを使用して、Braze Lookerアクションを設定します。

Looker Brazeの設定ページ。Braze APIキーとBraze REST APIエンドポイントのフィールドがあります。

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

Looker Develop内で、適切なビューを選択します。ディメンションタグにbraze_idを追加し、変更をコミットします。 このbraze_idタグは、どのフィールドがユニークキーであるかを決定するために使用されます。

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 Keyで、Brazeアカウントのプライマリユーザーマッピングキー（external_idまたはbraze_id）を入力します。
  4. エクスポートに名前を付けます。指定されない場合はLOOKER_EXPORTが使用されます。
  5. Advanced Optionsで、Results in TableまたはAll Resultsを選択し、Sendをクリックします。

    Brazeアクションと詳細オプションが選択されたLookerの送信ダイアログ。

    エクスポートが正しく送信された場合、LOOKER_EXPORTは、アクションに入力した値を含むカスタム属性としてユーザーのプロファイルに表示されます。

    LOOKER_EXPORTカスタム属性値が表示されたBrazeユーザープロファイル。
送信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」に設定されています。

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

トラブルシューティング

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

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