Skip to content

Limbik

Limbikは、AIレゾナンスレイヤーです。実際のオーディエンスがメッセージ、コンセプト、AI出力をどのように解釈し反応するかを、市場に届く前に予測します。60以上の国と25以上の言語にわたる継続的な一次調査を基盤とし、Limbikは人間が検証した合成オーディエンス（マシンスピードかつリサーチグレードの精度（95%信頼度、1.5%〜3%の誤差範囲）で実際のオーディエンスの反応をシミュレートするデジタル集団）を提供します。Limbikを使用すると、メッセージングがターゲットオーディエンスの信念や感情に即座に共鳴するかどうかを確認できます。

このインテグレーションはLimbikによって管理されています。

前提条件

LimbikをBrazeで使用するには、以下が必要です。

要件 説明
Limbik account_id Limbikのアカウントチームに問い合わせるか、Limbikの/rest/api/organizationsエンドポイントにGETリクエストを送信してください。
Limbikアクセストークン（access_token） LimbikのloginエンドポイントにPOSTリクエストを送信し、返されたaccess_tokenの値をAuthorizationヘッダーのBearerトークンとして使用してください。
Braze REST APIキー 「Messages」権限を持つBraze REST APIキー。Brazeダッシュボードの設定 > APIキーで作成してください。
Braze campaign_id メッセージング > Campaignsに移動し、Campaignを選択します。使用したいCampaignがまだ存在しない場合は、作成して保存してください。Campaignページの下部にCampaign API識別子があります。

予測エンドポイントを使用する前に、まずアクセス可能な組織（account_id）を特定する必要があります。ほとんどの顧客は1つの組織のみですが、一部のアカウントでは複数の組織が利用可能な場合があります。

利用可能な組織を取得する

組織エンドポイントにクエリを送信して、利用可能な組織を取得します。

1
2
3

curl -X 'GET' \
  'https://cortex.prod.limbik.com/rest/api/organizations' \
  -H 'accept: application/json'
レスポンス例
1
2
3
4
5
6
7
8

{
  "data": [
    {
      "uid": "aca61bd5-7132-499c-946e-42d092cc1156",
      "name": "Braze API"
    }
  ]
}

目的の組織のuidを選択し、以降のすべてのAPIリクエストでaccount_idヘッダーとして使用します。

認証

APIエンドポイントにアクセスするには、認証用のBearerトークンが必要です。認証情報を使用して認証し、トークンを取得してください。

ログインリクエスト
1
2
3
4
5
6
7
8

curl -X 'POST' \
  'https://cortex.prod.limbik.com/rest/api/auth/login' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "username": "your_username",
  "password": "your_password"
}'
レスポンス例

レスポンスには、以降のすべてのAPIリクエストでBearerトークンとして使用できるaccess_tokenが含まれています。

1
2
3
4

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer"
}

すべてのAPIリクエストのAuthorizationヘッダーにこのトークンを含めてください。

1

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

ユースケース - メッセージコピーの生成

BrazeとLimbikのREST APIエンドポイントの両方を使用することで、Limbikの生成予測を活用してメッセージコピーを作成し、Brazeのメッセージングチャネルを通じて送信したり、既存のコピーを調整してオーディエンスへのインパクトを向上させたりできます。両プラットフォームとも、プログラムで呼び出して高度なワークフローを構築できる機能を公開しています。

このドキュメントでは、2つの例を説明します。Limbikでメッセージコピーを生成し、そのコピーをBrazeを通じて送信する後続のメッセージで使用する例と、Limbikを使用して選択したオーディエンスに対するメッセージの品質をスコアリングする例です。

Limbik生成予測リクエスト

このエンドポイントを使用してメッセージを生成し、予測テンプレートで返します。リクエスト例：

1
2
3
4
5

curl -X 'GET' \
  'https://cortex.prod.limbik.com/rest/api/forecasts/generate/template?prompt=YOUR_PROMPT' \
  -H 'account_id: YOUR_ACCOUNT_ID' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'accept: application/json'

YOUR_PROMPT、YOUR_ACCOUNT_ID、YOUR_ACCESS_TOKENを、プロンプトテキスト、組織ID（組織エンドポイントから取得）、ログインエンドポイントからのBearerトークンに置き換えてください。

レスポンス例

Limbik予測テンプレートのレスポンス例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

[
  {
    "type": "Message",
    "displayText": "Formula one next race",
    "additionalDetail": "The latest dev in Formula...",
    "messages": [
      {
        "body": "The latest dev in Formula ..."
      }
    ],
    "population": {
      "id": 56,
      "name": "us2",
      "org_enabled": true,
      "org_visible": true,
      "categories": [],
      "display_name": "US Adults",
      "composite_key": "us2",
      "enabled": true
    }
  }
]

このユースケースの重要な要素はadditionalDetailフィールドで、Limbikが生成したメッセージコピーが含まれています。

この値を使用して、Brazeに送信するメッセージを構成します。たとえば、POST /campaigns/trigger/sendエンドポイントでは、additionalDetailを使用してペイロードフィールドを構成します。POST /messages/sendエンドポイントでは、選択したメッセージオブジェクトを構成するために使用します。

レスポンスフィールド

レスポンスには以下の主要フィールドが含まれます。

  • type: メッセージタイプ（例：AI生成コンテンツの場合は"Generate"、検証済みメッセージの場合は"Message"）
  • displayText: メッセージの短いタイトルまたは要約
  • additionalDetail: 完全なAI生成メッセージコピー - メッセージングプラットフォームを通じて送信できる完全なメッセージテキストを含む主要フィールドです
  • population: このメッセージのターゲット層とSegments

Brazeでの使用

LimbikのレスポンスのadditionalDetailフィールドには、Brazeに送信するメッセージコピーが含まれています。一般的なインテグレーションパターンの1つは、Brazeのトリガー送信エンドポイントを呼び出す際に、その値をtrigger_properties.payloadに渡すことです。以下の例では、をLimbikの`additionalDetail`フィールドの実際の文字列に、をCampaign IDに置き換えてください。

Brazeトリガーメッセージリクエスト例

1
2
3
4
5
6
7

{
  "campaign_id": "",
  "trigger_properties": {
    "payload": ""
  },
  "broadcast": true
}

ユースケース - 合成オーディエンスの詳細

最初のユースケースを発展させるために、Limbikのエンドポイント/rest/api/populations/{account_id}/{population_id}を使用します。

このエンドポイントは、性別、ロケーションなど、Limbikの合成オーディエンスの構成を説明する主要なデータポイントを返します。これらの値を使用して、Brazeのメッセージングエンドポイントを呼び出す際にConnected Audienceオブジェクトを構成できます。

特定のSegmentsの予測スコアを取得するには、利用可能な国とそれに対応するSegmentsを特定します。

ステップ1:利用可能な国を一覧表示する

アカウントで利用可能な国の一覧を取得します。

1
2
3

curl -X 'GET' \
  'https://cortex.prod.limbik.com/rest/api/populations/list/aca61bd5-7132-499c-946e-42d092cc1156' \
  -H 'accept: application/json'

レスポンスから、使用したい国を特定します。たとえば、米国のidは56です。

ステップ2:利用可能なSegmentsを取得する

国IDを取得した後、その国の全Segments一覧を取得します。

呼び出し例
1
2
3

curl -X 'GET' \
  'https://cortex.prod.limbik.com/rest/api/populations/aca61bd5-7132-499c-946e-42d092cc1156/56' \
  -H 'accept: application/json'
レスポンス例

たとえば、米国の成人集団の女性をターゲットにする場合：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

[
  {
    "id": 56,
    "name": "us2",
    "composite_key": "us2",
    "categories": [
      {
        "id": 9331,
        "name": "gender",
        "composite_key": "us2::gender",
        "segments": [
          {
            "id": 63793,
            "name": "female",
            "composite_key": "us2::gender::female"
          }
        ]
      }
    ]
  }
]

選択した予測メッセージのコンポジットキー値を使用して、これらの合成オーディエンス記述子をBrazeの実際のユーザープロファイルの値にマッピングできます。

たとえば、コンポジットキー（fr1::education_level::master_s_degree）をBrazeのConnected Audienceオブジェクトで以下のように使用できます。

1
2
3
4
5
6
7
8
9
10
11

{
  "AND": [
    {
      "custom_attribute": {
        "custom_attribute_name": "education_level",
        "comparison": "equals",
        "value": "masters"
      }
    }
  ]
}

ユースケース - 予測スコアの評価

Limbikを使用して、合成オーディエンスに対するメッセージの推定スコアを作成できます。Limbikのforecasts/synchronousエンドポイントを使用してプログラムで実行します。

オプション1 - 同期予測

テンプレート生成からのレスポンスペイロードを、同期予測エンドポイントで直接使用できます。

汎用リクエスト例
1
2
3
4
5
6
7
8
9
10
11
12
13
14

curl -X 'POST' \
  'https://cortex.prod.limbik.com/rest/api/forecasts/synchronous' \
  -H 'accept: application/json' \
  -H 'account_id: aca61bd5-7132-499c-946e-42d092cc1156' \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "Generate",
  "displayText": "Formula one season testing 2026",
  "additionalDetail": "Day 1 of the 2026 Formula 1 Bahrain testing session has concluded. Lando Norris recorded the fastest time in the McLaren, with Ferrari in second place. Cadillac drivers Sergio Perez and Valtteri Bottas completed 107 laps, nearly two race distances, and Audi introduced significant upgrades. Which team do you expect to perform best in Australia? #F12026 #BahrainTesting #LandoNorris",
  "population": {
    "population": "us2",
    "segments": []
  }
}'
レスポンス例（省略版）
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

{
  "uid": "6c5e28ef-8796-4659-a743-d842a06c9bf7",
  "datetime": "2026-02-11T20:04:06.545+00:00",
  "userId": "9cdd921c-f62f-46a6-902f-a6b0d1702f99",
  "accountId": "aca61bd5-7132-499c-946e-42d092cc1156",
  "name": "Formula one season t...",
  "user_message_context": "",
  "population": [
    {
      "name": "us2",
      "display_name": "US Adults",
      "categories": []
    }
  ],
  "privacy_compliant": false,
  "model_outputs": {
    "belmetrics": {
      "metrics": {
        "moe": 0.02144,
        "pfi": "0.3611",
        "min_val": 0.2941,
        "mean_val": 0.41831
      }
    },
    "virmetrics": {
      "metrics": {
        "moe": 0.02381,
        "pfi": "0.3611",
        "min_val": 0.2,
        "mean_val": 0.30395
      }
    },
    "model_variant": "v4_0_0"
  }
}

オプション2:Segmentsを使用した予測ペイロードの準備

選択したSegmentsを使用して予測ペイロードを作成します。Segmentsは簡略化されたコンポジットキー形式を使用します。

Segment固有のリクエスト例
1
2
3
4
5
6
7
8
9
10
11

{
  "type": "Generate",
  "displayText": "Formula one season testing 2026",
  "additionalDetail": "🚀 Day 1 of 2026 F1 Bahrain testing just dropped BOMBS! Lando Norris edged out Max Verstappen for P1 in McLaren's beast, with Ferrari hot on their heels 🔥. But the real shocker? Cadillac's debutants Sergio Perez & Valtteri Bottas smashed 107 laps – nearly TWO race distances! New kids on the block are HERE to stay. Audi's radical upgrades already turning heads too. Who's your early fave for Australia? 👀 #F12026 #BahrainTesting #LandoNorris",
  "population": {
    "population": "us2",
    "segments": [
      "gender::female"
    ]
  }
}
New Stuff!