Limbik

Limbik ist Ihre KI-Resonanzschicht – sie sagt vorher, wie reale Zielgruppen Nachrichten, Konzepte und KI-Ausgaben interpretieren und darauf reagieren, bevor diese den Markt erreichen. Gestützt auf kontinuierliche Primärforschung in über 60 Ländern und mehr als 25 Sprachen liefert Limbik menschlich validierte synthetische Zielgruppen – digitale Populationen, die reale Zielgruppenreaktionen mit Maschinengeschwindigkeit und forschungsgerechter Genauigkeit simulieren (95 % Konfidenz, 1,5 % bis 3 % Fehlermarge). Limbik gibt Ihnen die Möglichkeit, sofort sicherzustellen, dass Ihre Nachrichten mit den Überzeugungen und Gefühlen Ihrer Zielgruppe resonieren.

Diese Integration wird von Limbik gepflegt.

Voraussetzungen

Folgendes ist erforderlich, um Limbik mit Braze zu verwenden:

Bevor Sie einen der Prognose-Endpunkte verwenden, müssen Sie zunächst ermitteln, auf welche Organisation (account_id) Sie Zugriff haben. Während die meisten Kund:innen nur eine Organisation haben, stehen einigen Konten möglicherweise mehrere Organisationen zur Verfügung.

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"
    }
  ]
}

Authentifizierung

Um auf die API-Endpunkte zuzugreifen, benötigen Sie ein Bearer-Token zur Authentifizierung. Erhalten Sie Ihr Token, indem Sie sich mit Ihren Zugangsdaten authentifizieren.

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"
}'

Beispielantwort

Die Antwort enthält ein access_token, das Sie als Bearer-Token in allen nachfolgenden API-Anfragen verwenden können:

1
2
3
4
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer"
}

Fügen Sie dieses Token im Authorization-Header für alle API-Anfragen ein:

1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Hinweis

Sie können API-Plattformen wie Postman verwenden, um automatisierte Workflows einzurichten, die mehrere REST-API-Endpunkte verschiedener Organisationen aufrufen, wie den folgenden Workflow.

Anwendungsfall – Nachrichtentext generieren

Durch die Nutzung der REST-API-Endpunkte von Braze und Limbik können Sie Limbiks generative Prognosen verwenden, um Nachrichtentext zu erstellen und über Braze-Messaging-Kanäle zu versenden, oder bestehenden Text anzupassen, um die Wirkung bei Ihrer Zielgruppe zu verbessern. Beide Plattformen stellen Funktionalitäten bereit, die Sie programmatisch aufrufen können, um anspruchsvolle Workflows zu erstellen.

Diese Dokumentation beschreibt zwei Beispiele: die Generierung von Nachrichtentext in Limbik und die Verwendung dieses Textes in einer anschließend über Braze versendeten Nachricht sowie die Nutzung von Limbik zur Bewertung der Qualität einer bestimmten Nachricht für Ihre gewählte Zielgruppe.

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'

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
    }
  }
]

Antwortfelder

Die Antwort enthält die folgenden Schlüsselfelder:

• type: Der Nachrichtentyp (zum Beispiel "Generate" für KI-generierte Inhalte, "Message" für validierte Nachrichten)
• displayText: Ein kurzer Titel oder eine Zusammenfassung der Nachricht
• additionalDetail: Der vollständige KI-generierte Nachrichtentext – Dies ist das primäre Feld mit dem vollständigen Nachrichtentext, den Sie über Ihre Messaging-Plattform versenden können
• population: Die Zielpopulation und Segmente für diese Nachricht

Verwendung mit Braze

Das Feld additionalDetail aus Limbiks Antwort enthält den Nachrichtentext, den Sie an Braze senden. Ein gängiges Integrationsmuster besteht darin, diesen Wert in trigger_properties.payload zu übergeben, wenn Sie den Braze-Trigger-Send-Endpunkt aufrufen. Ersetzen Sie im folgenden Beispiel durch den tatsächlichen String aus Limbiks `additionalDetail`-Feld und durch Ihre Campaign-ID.

Beispiel einer Braze-Trigger-Nachrichtenanfrage

1
2
3
4
5
6
7
{
  "campaign_id": "",
  "trigger_properties": {
    "payload": ""
  },
  "broadcast": true
}

Anwendungsfall – Details zu synthetischen Zielgruppen

Aufbauend auf dem ersten Anwendungsfall verwenden Sie Limbiks Endpunkt /rest/api/populations/{account_id}/{population_id}.

Dieser Endpunkt gibt wichtige Datenpunkte zurück, die die Zusammensetzung von Limbiks synthetischen Zielgruppen beschreiben, wie Geschlecht, Standort und so weiter. Sie können diese Werte verwenden, um Connected-Audience-Objekte zu befüllen, wenn Sie Braze-Messaging-Endpunkte aufrufen.

Hinweis

Connected-Audience-Objekte können Nutzer:innen nicht anhand von Braze-Standardattributen ansprechen, daher müssen Sie alle Attribute, die Sie ansprechen möchten, als angepasste Attribute in Braze speichern.

Um Prognosewerte für bestimmte Segmente zu erhalten, identifizieren Sie die verfügbaren Länder und ihre entsprechenden Segmente.

1. Schritt: Verfügbare Länder auflisten

Rufen Sie die Liste der für Ihr Konto verfügbaren Länder ab:

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

Identifizieren Sie aus der Antwort das gewünschte Land. Beispielsweise haben die Vereinigten Staaten eine id von 56.

2. Schritt: Verfügbare Segmente abrufen

Nachdem Sie die Länder-ID abgerufen haben, rufen Sie die vollständige Liste der Segmente für dieses Land ab.

Beispielaufruf

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

Hinweis

Die Antwort kann umfangreich sein. Cachen Sie diese Daten (zum Beispiel in Redis) nach Name oder Schlüssel für bessere Performance.

Beispielantwort

Um beispielsweise Frauen in der US-Erwachsenenpopulation anzusprechen:

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"
          }
        ]
      }
    ]
  }
]

Hinweis

• Segmente werden mit einem vereinfachten Composite-Key-Format angegeben (zum Beispiel gender::female).
• Der vollständige Composite Key aus der API-Antwort (us2::gender::female) wird auf den Kategorie- und Segmentnamen verkürzt.
• Eine vollständige Referenz der verfügbaren Populationen und Segmente finden Sie unter Limbik-Zielgruppen.

Mithilfe des Composite-Key-Werts für Ihre gewählte Prognosenachricht können Sie diese synthetischen Zielgruppenbeschreibungen auf Werte realer Nutzerprofile in Braze abbilden.

Beispielsweise können Sie den Composite Key (fr1::education_level::master_s_degree) in einem Braze-Connected-Audience-Objekt wie folgt verwenden:

1
2
3
4
5
6
7
8
9
10
11
{
  "AND": [
    {
      "custom_attribute": {
        "custom_attribute_name": "education_level",
        "comparison": "equals",
        "value": "masters"
      }
    }
  ]
}

Anwendungsfall – Prognosewert auswerten

Sie können Limbik verwenden, um einen geschätzten Score für eine Nachricht gegenüber einer synthetischen Zielgruppe zu erstellen. Tun Sie dies programmatisch mit Limbiks forecasts/synchronous-Endpunkt.

Option 1 – Synchrone Prognose

Sie können die Antwort-Payload aus der Template-Generierung direkt mit dem synchronen Prognose-Endpunkt verwenden:

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"
  }
}

Option 2: Prognose-Payload mit Segmenten vorbereiten

Erstellen Sie Ihre Prognose-Payload mit den ausgewählten Segmenten. Segmente verwenden ein vereinfachtes Composite-Key-Format.

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"
    ]
  }
}