Skip to content

BrazeラーニングコースLooker

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

BrazeとLookerの統合により、会社ユーザーはREST APIを介してファーストパーティの Looker Blocks と Looker Actions のユーザーフラグ機能を活用できます。フラグを設定したユーザーをSegmentsに追加して、将来のBraze CampaignsやCanvasesをターゲットにすることができます。LookerをBrazeと併用するには、Braze Currentsを使用してデータウェアハウスにBrazeデータを送信し、Braze Looker Blocksを使用してLookerでBrazeデータを素早くモデル化および視覚化することをお勧めします。

前提条件

注意事項

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

統合

Looker Blocks

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

Looker Blocksを実装するには、GitHubコードの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アクションを設定します。

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 をクリックします。



    エクスポートが正しく送信された場合、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でこれらのフラグ付きユーザーのSegmentを作成するには、エンゲージメントの下のSegmentsに移動し、Segmentに名前を付け、フィルターとして Looker_Export を選択します。次に、「includes value」オプションを使用し、Lookerで割り当てたカスタム属性フラグを指定します。

BrazeのSegmentビルダーで、フィルター「looker_export」が「includes_value」と「Looker」に設定されています。

保存すると、CanvasやCampaign作成時のターゲットユーザーステップでこのSegmentを参照できます。

トラブルシューティング

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!