ハイタッチ・パーソナライゼーションAPI

HightouchのパーソナライゼーションAPIは、クラウドデータウェアハウス内の任意のデータセットに基づく低遅延データAPIをホストできるマネージドサービスである。

BrazeとHightouchの統合により、Braze Connected ContentでAPIを使用し、送信時にキャンペーンやCanvasに最新の顧客データやオブジェクトデータを取り込むことができる。

HightouchのPersonalization APIは、Braze設定内で使用するRESTエンドポイントを提供する。具体的には、BrazeのConnected Contentオファリングを使用して、Personalization APIにGETリクエストを行い、特定の識別子に関連するすべての情報を取得することができる。このAPIによって公開されるデータは、顧客、製品、またはその他のオブジェクトデータを表すことができる。

前提条件

• 使用例
• データセット

統合

ステップ1:データソースをハイタッチに接続する

ハイタッチ・ソースは、組織のビジネス・データが存在する場所である。この場合、ユーザーデータが保存されている場所であればどこでもいい。

1. ハイタッチで、「ソースの概要」＞「ソースの追加」と進む。ソースとしてデータウェアハウスを選択する。
   
   
2. 関連する認証情報を入力する。これらはソースによって異なる。

詳細については、関連するソース・ドキュメントを参照のこと。

ステップ2:モデルデータ

ハイタッチ・モデルは、ソースからどのようなデータを引き出すかを定義する。新しいモデルをセットアップするには、以下の手順に従う：

1. ハイタッチでは モデルの概要> モデルを追加]を選択し、先ほど接続したソースを選択する。
   
   
2. 次に、モデリング方法を選択する。すべての情報を1つのテーブルにまとめる必要があるので、ビジュアル・テーブル・セレクタを使って定義することができる。あるいは、必要なカラムだけを含むSQLを書いたり、既存のdbtモデル、ルッカー・ルック、シグマ・ワークブックに頼ることもできる。
   
   
3. 続行する前に、モデルをプレビューして、興味のあるデータを照会していることを確認する。デフォルトでは、Brazeはプレビューを最初の100レコードに制限している。データを確認したら、Continueをクリックする。
   
   
4. 例えば、”User recommendations “のように、モデルに名前をつける。
   
   
5. 最後に、主キーを選択し、Finishをクリックする。主キーは一意な識別子を持つカラムでなければならない。これは、パーソナライゼーションAPIを呼び出して特定のユーザーのおすすめを取得するために使用するフィールドでもある。

ステップ3:パーソナライゼーションAPIを設定する

リクエストを受け取るためにAPIを準備するには、2つのステップがある：

• お客様のインフラに最も近い地域でパーソナライゼーションAPIを有効にする
• Hightouchが管理するキャッシュで実体化されるべきモデルを定義するためにシンクを作成する。

以下の指示に従って、両方を完了させる：

1. ハイタッチでは 目的地を選択し、あなたのために作成されたHightouchパーソナライゼーションAPIを選択する。この宛先が有効になっていない場合は、ハイタッチ・サポートに連絡すること。
   
   
2. 次に、適切な地域を選択する。インフラに最も近い地域を選択することで、応答時間を短縮することができる。お住まいのインフラに近い地域が表示されない場合は、ハイタッチ・サポートまでご連絡を。
   
   
3. シンクの概要ページに移動し、シンクを追加ボタンをクリックする。次に、該当するモデルと、以前に設定した保存先を選択する。
   
   
4. 英数字のコレクション名を入力する。コレクションは概念的にはデータベースのテーブルに似ている。それぞれ、顧客や請求書など、特定のデータ型を表す必要がある。コレクション名は英数字でなければならず、Personalization APIエンドポイントの一部となる。
   
   
5. 次に、モデルのどのカラムをレコード検索のプライマリー・インデックスとして使用するかを指定する。このフィールドは、コレクション内の各レコードを一意に識別する必要があり、多くの場合、モデルの主キーと同じである。パーソナライゼーションAPIは、複数のインデックスの検索をサポートする。例えば、user_id 、anonymous_id 、email_address を使って顧客プロファイルを検索したい。複数のインデックスを有効にするには、ハイタッチ・サポートに連絡すること。
   
   
6. フィールドマッパーを使用して、APIレスポンスペイロードに含まれるべきモデルのカラムを指定する。これらのフィールドの名前を変更し、リキッドテンプレート言語を使用して変換を適用するために高度なマッパーを使用することができる。
   
   
7. ユースケースに適した削除動作を選択する。
   
   
8. 最後に、「続ける」をクリックし、同期スケジュールを選択する。

Hightouchは、ウェアハウスのデータを管理データベースに同期し、パーソナライゼーションAPIを介して公開する。

ステップ4:Braze Connected Contentを通じてパーソナライゼーションAPIを呼び出す

パーソナライゼーションAPIインスタンスを設定したら、それをBraze Connected Contentのエンドポイントとして使用できる。

APIはhttps://personalization.{region}.hightouch.com 、例えばhttps://personalization.us-west-2.hightouch.com からアクセスできる。

情報はこのエンドポイント/v1/collections/:collection_name/records/:index_key/:index_value を使って入手できる。

例えば、キャンペーンやキャンバスにこのスニペットを入れることができる：

1
2
3
4
5
6
7
8
9
{% connected_content
     https://personalization.us-west-2.hightouch.com/v1/collections/customer/records/id/12345
     :method get
     :headers {
       "Authorization": "Bearer {{YOUR-API-KEY}}"
  }
     :content_type application/json
     :save customer
%}

リキッドテンプレートを使って、JSONペイロードで返されたプロパティを参照し、メッセージングで使うことができる。

以下のペイロードの例の場合：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
{
    "user_id": 12345,
    "full_name": "Jane Doe",
    "lifetime_value": 1492.18,
    "churn_risk": 0.04,
    "90_day_summary": {
        "num_songs_listened": 813,
        "top_genres": [
            "house",
            "techno",
            "ambient"
        ],
        "top_artists": [
            "deadmau5",
            "Marsh",
            "Enamour"
        ],
    },
    "recommendations": {
        "concerts": [
            {
                "artist": "Aphex Twin",
                "location": "San Francisco, CA",
                "event_date": "2023-01-31"
            },
            {
                "artist": "Sultan + Shepard",
                "location": "San Francisco, CA",
                "event_date": "2023-02-25"
            }
        ],
        "upcoming_album_release": {
            "title": "Universal Language",
            "artist": "Simon Doty",
            "label": "Anjunadeep",
            "release_date": "2023-04-28"
        }
    },
}

次のリキッド参照は、この例のデータを返すだろう：

トラブルシューティング

質問がある場合は、ハイタッチ・サポートに問い合わせること。