Personalisieren Sie Kundengespräche und aktivieren Sie die Kundenabsicht mithilfe des Echtzeit-Kundenprofils mit unstrukturierten Daten

AVAILABILITY
Diese Funktion befindet sich derzeit in der Betaversion. Die Funktionalität und Dokumentation können sich ändern. Um an dieser Beta-Version teilzunehmen, wenden Sie sich an die Adobe-Kundenunterstützung oder Ihren Kundenbetreuer.

In Adobe Experience Platform können Sie Ihre Kundendaten in einer zentralen Ansicht zusammenführen, indem Sie Daten aus mehreren Kanälen mit dem Echtzeit-Kundenprofil kombinieren. Das Echtzeit-Kundenprofil mit unstrukturierten Daten erweitert bestehende Kundenprofile um dialogbasierte und andere textbasierte Kundendaten. Auf diese Weise können kundenorientierte Agenten konfigurierten Profilkontext und Konversationsverlauf verwenden und Marketing-Experten Signale für die Zielgruppen-Qualifizierung und nachgelagerte Personalisierung definieren.

Grundlegendes zu Profilen mit unstrukturierten Daten understanding

Das Echtzeit-Kundenprofil kombiniert derzeit strukturierte Daten aus verschiedenen Kanälen, einschließlich Online-, Offline-, CRM- und Drittanbieterdaten, und konsolidiert diese Daten in einer einheitlichen Ansicht, die eine aussagekräftige, Darstellung jeder Kundeninteraktion mit Zeitstempel bietet. Dies umfasst jedoch nicht die Aufnahme unstrukturierter Daten, d. h. Daten aus Gesprächen, Transkripten oder anderen multimodalen Daten (wie PDFs oder Bilder) können nicht mit dem Profil verwendet werden.

Das Profil mit unstrukturierten Daten stellt dialogbasierte und andere textbasierte Kundendaten für den Kundenkontext und die Signalextraktion zur Verfügung, sodass Sie Interaktionen über unterstützte Agenten und Kanäle hinweg personalisieren können.

Profile mit unstrukturierten Daten bieten Experience Platform-Kunden die folgenden Funktionen:

  • Kundenabsicht verstehen: Nehmen Sie Konversationen, Messaging, Suchabfragen, Anruftranskripte, Umfragen und andere textbasierte Interaktionen auf, um das vorhandene Kundenprofil zu bereichern.
  • Konversationen personalisieren: Kombinieren Sie Profilattribute, Zielgruppenzugehörigkeit und Konversationsverlauf, damit Brand Concierge und andere kundenorientierte Agenten personalisierte Erlebnisse kontinuierlich über Agenten, Sitzungen, Geräte und Kanäle hinweg bereitstellen können.
  • Absicht in Echtzeit aktivieren: Extrahieren Sie von Marketingexperten definierte Signale aus Konversationen und aktivieren Sie sie über Zielgruppen, Journey und Personalisierung. Diese nachgelagerten Aktivierungen können in ganz Experience Platform verwendet werden, einschließlich Adobe Journey Optimizer und Target.

Anwendungsszenarien use-cases

Mit einem Profil mit unstrukturierten Daten können Sie Gesprächsdaten als Aktivierungssignal für weitere Interaktionen verwenden, wodurch Sie eingehende Personalisierungen und ausgehende Aktivierungen einfacher steuern können. Daher können Sie diese Profile in einer Vielzahl von Anwendungsfällen verwenden.

Konversationspersonalisierung

Einzelhandel
Ein Käufer bittet um Trainingskleidung. Der Conversational AI-Agent kann Profile mit unstrukturierten Daten nutzen, um seine Empfehlungen auf der Grundlage der Treuestufe des Käufers, aktiver Kleidungspräferenzen und bekannter Interessen anzupassen.
Reisen und Gastgewerbe
Ein Reisender fragt, welche Reise am besten zu ihnen passen würde. Der Conversational AI-Agent kann Profile mit unstrukturierten Daten nutzen, um seine Empfehlungen auf der Grundlage des bevorzugten Abflughafens des Benutzers, des Treuestatus und der Reisepräferenzen anzupassen.
Finanzdienstleistungen
Ein Kunde fragt nach Kreditkarten. Der Conversational AI-Agent kann Profile mit unstrukturierten Daten nutzen, um seine Empfehlungen auf der Grundlage ihrer Beziehungsebene und der vorhandenen Kartenbestände anzupassen und verschiedene Karten zu vergleichen.
Telekommunikation
Ein Abonnent fragt nach Telefonen und Plänen. Der Conversational AI-Agent kann Profile mit unstrukturierten Daten nutzen, um seine Empfehlungen auf der Grundlage seines aktuellen Plans, seines vorhandenen Geräts und seines Treuestatus anzupassen.
Automotive
Ein Besucher eines Kfz-Händlers hat bereits zuvor Interesse an Finanzierungsmöglichkeiten gezeigt. Der Conversational AI-Agent kann Profile mit unstrukturierten Daten nutzen, um dieses bekannte Interesse zu nutzen und relevante Kredit- und Leasingoptionen in das Gespräch einzubringen.
B2B
Ein Besucher zeigte zuvor Interesse an Steuerberatungsleistungen. Der Conversational AI-Agent kann Profile mit unstrukturierten Daten nutzen, um seine Empfehlungen anzupassen und relevante Services zu empfehlen.

Signalextraktion und Aktivierung

Einzelhandel
Ein Käufer erwähnt ein Training für einen Trail-Halbmarathon unter eisigen, windigen Bedingungen. Profile mit unstrukturierten Daten können die Outdoor-Leistungsabsicht für die Zielgruppen-Qualifizierung extrahieren und entsprechende Bekleidungsangebote auf der Website und per E-Mail für Trainingsbekleidung bei kaltem Wetter versenden.
Reisen und Gastgewerbe
Ein Reisender beschreibt eine Jubiläumsreise nach Japan mit Interesse an einer traditionellen Ryokan-, Onsen- und Teezeremonie. Profile mit unstrukturierten Daten können dieses japanische Interesse für die Zielgruppen-Qualifizierung extrahieren und relevante Reiseangebote unterbreiten, einschließlich eines personalisierten Website-Banners und einer „Flucht“-E-Mail zum Jahrestag.
Finanzdienstleistungen
Ein Kunde erwähnt, dass er seine Altersvorsorge überprüfen möchte. Profile mit unstrukturierten Daten können diese „Altersvorsorgeplanung“ für die Zielgruppen-Qualifizierung extrahieren und personalisierte Folgemaßnahmen einrichten, einschließlich einer Website-Einladung oder E-Mail, die einen Termin mit dem zugewiesenen Berater fördert.
Telekommunikation
Ein Abonnent beschreibt sein Telefon mit einer schlechten Akkulaufzeit und einem gebrochenen Bildschirm und erwähnt, dass er bereit ist, sein Telefon zu aktualisieren. Profile mit unstrukturierten Daten können die Absicht extrahieren, „ihr Gerät upzugraden“, und personalisierte Angebote einrichten, einschließlich Inzahlungnahmemöglichkeiten über die Website oder per E-Mail.
Automotive
Ein Besucher erwähnt, dass ihr Mietvertrag für ihr Auto bald endet, sodass sie ein neues Auto kaufen müssen. Profile mit unstrukturierten Daten können die Absichten zum Autoersatz extrahieren und personalisierte Finanzangebote anbieten, wenn der Besucher zur Website zurückkehrt.
B2B
Ein Besucher sagt, dass sein Unternehmen seine Jahresbücher schließen und Steuern einreichen muss. Profile mit unstrukturierten Daten können die Absicht des Jahresabschlusses extrahieren und Empfehlungen relevanter Buchhaltungs- und Steuerdienstleistungen anbieten.

Kontinuität

Cross-Agent (Einzelhandel)
Ein Käufer erwähnt einem Einkaufsassistenten, dass er eine Jacke für den Trail bei kaltem Wetter braucht. Später fragen sie einen Kundendienst-KI-Agenten nach der Dimensionierung. Ein Profil mit unstrukturierten Daten ermöglicht es dem Service-Agenten, Daten aus dem vorherigen Gesprächsverlauf und dem Kundenkontext zu verwenden, sodass der Käufer seine Anforderungen nicht wiederholen muss.
Cross-Channel (Reisen und Gastgewerbe)
Ein Reisender bespricht eine Jubiläumsreise nach Japan mit dem konversativen KI-Agenten einer Website, teilt bevorzugte Daten und ein Interesse an einem traditionellen Ryokan. Später kontaktiert der Reisende die Marke über WhatsApp. Wenn beide Interaktionen mit der Identität des Reisenden verknüpft sind, kann der WhatsApp-Agent Profile mit unstrukturierten Daten verwenden, die Website-Konversation mit dem WhatsApp-Agenten teilen und es ihm ermöglichen, die Planung fortzusetzen, anstatt die Entdeckung neu zu starten.
Geräteübergreifend (Einzelhandel)
Ein Käufer chattet anonym mit einem unterhaltsamen KI-Agenten auf seinem Laptop über Kleidung für den Trail bei kaltem Wetter, dann meldet er sich an, bevor er geht. Später meldet sich der Benutzer auf seinem Handy an. Sobald die anonyme Konversation mit ihrer angemeldeten Identität verknüpft ist, stellt das Profil mit unstrukturierten Daten diese anonyme Konversation geräteübergreifend zur Verfügung, sodass der Agent die Diskussion fortsetzen kann.
Cross-Session (Automotive)
Ein Kunde bespricht Fahrzeugoptionen, das Budget und einen bevorstehenden Ablauf der Nutzungsdauer für einen konversativen KI-Agenten. Der Benutzer kehrt einige Tage später zurück und beginnt eine neue Konversation. Ein Profil mit unstrukturierten Daten stellt den Verlauf der vorherigen Unterhaltung zur Verfügung, sodass der Agent die Suche basierend auf der Diskussion fortsetzen kann.

Probenfluss sample-flow

Man denke an einen retailer, der Bekleidung und Outdoor-Bekleidung verkauft.

In diesem Szenario besucht ein Kunde, John, die Website von retailer und startet einen Gesprächs-KI-Agenten, um nach Empfehlungen für Trainingsbekleidung zu fragen. Da John angemeldet ist, kann das Profil mit unstrukturierten Daten den konfigurierten Kundenkontext bereitstellen, einschließlich seiner Gold-Treuestufe, aktiver Kleidungsvorlieben und Interesse an Outdoor-Sport. Der Agent kann dann diesen Kontext verwenden, um seine Empfehlungen weiter anzupassen.

John sagt dann: „Ich trainiere für einen halben Marathon, und die Morgen sind eisig und windig. Ich brauche etwas, das mich warm hält, ohne zu überhitzen.“ Der Agent kann nun Johns angegebenen Bedürfnisse mit seinen bestehenden Vorlieben kombinieren, um eine geeignete Kleidung zu empfehlen, wie eine leichte, windresistente Laufjacke.

Darüber hinaus verwendet Experience Platform Profile mit unstrukturierten Daten, um ein von Marketingexperten definiertes „Outdoor-Leistungssignal“ aus den Gesprächen zu erkennen. Mit diesem Signal kann sich John daher für eine Zielgruppe mit „Outdoor-Leistungsabsicht“ qualifizieren und nachfolgende personalisierte Erlebnisse unterstützen.

Beispielsweise kann die retailer die Zielgruppe „Leistungsabsicht im Freien“ verwenden, um John bei seiner Rückkehr auf die Website ein Trainingsangebot für kaltes Wetter zu zeigen oder eine personalisierte E-Mail über eine Anwendung wie Adobe Journey Optimizer zu senden. Wenn die entsprechende Audience und die entsprechende Journey konfiguriert sind, kann diese E-Mail sowohl relevante Laufbekleidung als auch ein Gold-Mitglied mit Doppelpunkten enthalten.

Voraussetzungen für Beta prerequisites

Um Profile mit unstrukturierten Daten verwenden zu können müssen folgenden Voraussetzungen erfüllt sein:

  • Bereits ein bestehender Real-Time CDP- oder Adobe Journey Optimizer-Benutzer
  • Sie ​​das Healthcare Shield-Add-on

Wenn Sie alle diese Voraussetzungen erfüllen, wenden Sie sich an die Kundenunterstützung von Adobe, um weitere Informationen zur Anforderung der Aktivierung für Profile mit unstrukturierten Daten zu erhalten.

Anforderungen requirements

Bevor Sie mit der Einrichtung von Profilen mit unstrukturierten Daten fortfahren, müssen Sie die folgenden Schritte ausführen:

  • Aktivieren Verknüpfungsregeln für Identitätsdiagramme
  • Erstellen eines profilaktivierten Datensatzes und Aufnehmen mindestens eines Profils in diesen Datensatz
    • Auf diese Weise kann ein Profil mit unstrukturierten Daten die Profilbeschreibung erstellen. Dieser Datensatz ist getrennt von dem Datensatz, in den Konversationen und andere unstrukturierte Daten aufgenommen werden.

Sobald Profil mit unstrukturierten Daten aktiviert wurde, können Sie diese Funktion verwenden, indem Sie die folgenden Schritte einrichten:

  • Aufnehmen unstrukturierter Daten in Experience Platform
  • Konfigurieren des Profilkontexts, um Konversationen zu personalisieren
  • Konfigurieren von Signalen zur Extraktion von Daten aus unstrukturierten Daten für die Aktivierung

Aufnehmen unstrukturierter Daten ingest

Um unstrukturierte Daten im Rahmen Ihres Personalisierungsprozesses zu verwenden, müssen Sie diese Daten zunächst in Experience Platform aufnehmen.

Die Methode zur Aufnahme unstrukturierter Daten unterscheidet sich je nach Quelle der unstrukturierten Daten.

Standardrohtext

Für den Anwendungsfall „Standardidentität mit Rohtext“ können Sie ein ExperienceEvent-Schema und einen Datensatz verwenden, um die Daten in Experience Platform aufzunehmen. Dies eignet sich am besten für die meisten Anwendungsfälle, einschließlich des Imports von Transkripten, Konversationen, Notizen und Reviews.

Erstellen eines Schemas

note important
IMPORTANT
Aktivieren das Datenschema für das Profil nicht. für den unstrukturierten Datensatz für Profil und Identität.

Zunächst müssen Sie ein XDM ExperienceEvent-Schema für den Datensatz erstellen. Dieses Schema muss die folgenden Informationen enthalten:

  • Die unstructuredContent Feldergruppe. Weitere Informationen zur Feldergruppe „Unstrukturierter Inhalt“ finden Sie unter XDM GitHub.
  • Eine Identität, um die bekannte Person zu markieren. Diese Identität kann entweder eine Identitätszuordnung oder ein Feld sein, das als Identitätsdeskriptor markiert ist.

Informationen zum Erstellen eines Schemas finden Sie im Handbuch Erstellen eines Schemas.

Erstellen eines Datensatzes

note important
IMPORTANT
Aktivieren den Datensatz für Profil oder Identität nicht.

Nachdem Sie das Schema erstellt haben, können Sie einen Datensatz erstellen, der dieses Schema verwendet. Informationen zum Erstellen eines Datensatzes basierend auf einem vorhandenen Schema finden Sie im Handbuch Erstellen eines Datensatzes.

Nachdem Sie den Datensatz erstellt haben, können Sie eine PATCH-Anfrage an den v2/dataSets-Endpunkt stellen und dabei die ID des neu erstellten Datensatzes angeben. Auf diese Weise können Sie den Datensatz für die Verwendung mit Profildaten mit unstrukturierten Daten aktualisieren.

accordion
Beispielhafte PATCH-Anfrage und -Antwort, um den Datensatz für ein Profil mit unstrukturierten Daten zu aktivieren.
code language-shell
curl -X PATCH https://platform.adobe.io/data/foundation/catalog/v2/dataSets/67b3077efa10d92ab7a71858 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "extensions": {
        "adobe_unifiedProfile": {
            "semanticProfile": {
                "enablement": {
                    "status": "READY"
                }
            }
        },
        "adobe_dataContent": {
            "channel": "call_transcripts"
        }
    }
  }'

Bei einer erfolgreichen Antwort wird der HTTP-Status 200 mit der ID Ihres neu aktualisierten Datensatzes zurückgegeben.

code language-json
[
    "@/dataSets/67b3077efa10d92ab7a71858"
]

Aufnehmen von Daten

Nachdem das Schema und der Datensatz eingerichtet wurden, können Sie jetzt mit der Aufnahme von Daten in Experience Platform beginnen. Sie können einen standardmäßigen Quell-Connector verwenden, um die Daten in Experience Platform zu laden, da CSV, JSON und Parquet alle unterstützt werden. Fügen Sie bei der Aufnahme der Daten den unstrukturierten Text in das Feld rawText und die Identität in die Spalte identity ein.

Sie können sich jetzt mit Informationen wie der Organisations-ID, Sandbox-Informationen, Datensatzinformationen und Aufnahmemethode (einfache ID mit Rohtext-XDM) an die Adobe-Kundenunterstützung wenden, um die Einrichtung der Datenaufnahme abzuschließen.

WhatsApp Business
note availability
AVAILABILITY
Der WhatsApp-Connector befindet sich in geschlossenen Beta.

Informationen zum Einrichten des WhatsApp-Connectors finden Sie im WhatsApp Connector-.

Wenn Sie den WhatsApp-Connector einrichten, wird der WhatsAppWebhook- automatisch erstellt. Dieser Datensatz wird automatisch für Profile mit unstrukturierten Daten aktiviert, wobei die Kanalinformationen ebenfalls angewendet werden.

Wenden Sie sich nach der Einrichtung des WhatsApp-Connectors an die Kundenunterstützung von Adobe, um Informationen wie die Organisations-ID, Sandbox-Informationen, den Kanal (WhatsApp Business) und den Modus (Streaming oder Batch) zu erhalten, damit der Connector für Profile mit unstrukturierten Daten verwendet werden kann.

Brand Concierge-Konversationen

Für Brand Concierge-Konversationen werden automatisch drei Datensätze erstellt, die Benutzeraufforderungen, Agentenantworten und Feedback verfolgen.

Um diese Datensätze für Profile mit unstrukturierten Daten zu aktivieren, müssen Sie eine PATCH-Anfrage an den v2/dataSets-Endpunkt stellen und dabei die ID jedes der drei Datensätze angeben.

accordion
Beispielhafte PATCH-Anfrage und -Antwort, um den Datensatz für ein Profil mit unstrukturierten Daten zu aktivieren.
code language-shell
curl -X PATCH https://platform.adobe.io/data/foundation/catalog/v2/dataSets/67b3077efa10d92ab7a71858 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "extensions": {
        "adobe_unifiedProfile": {
            "semanticProfile": {
                "enablement": {
                    "status": "READY"
                }
            }
        }
    }
  }'

Bei einer erfolgreichen Antwort wird der HTTP-Status 200 mit der ID Ihres neu aktualisierten Datensatzes zurückgegeben.

code language-json
[
    "@/dataSets/67b3077efa10d92ab7a71858"
]

Konfigurieren des Profilkontexts

Nach der Aufnahme unstrukturierter Daten in Experience Platform können Sie den Profilkontext konfigurieren, um Ihre Konversationen zu personalisieren. Sie können diese Profilbeschreibung entweder mithilfe von Coworker oder mit den Experience Platform-APIs konfigurieren.

CX Enterprise Coworker

Sie können die Einrichtung mit der Frage „Ich möchte eine semantische Profilkonfiguration erstellen“ in Coworker starten.

Ein Mitarbeiter führt Sie durch die Schritte zum Einrichten eines Profils mit unstrukturierten Daten, indem er die folgenden Schritte durchführt:

  • Mitarbeiter werden fragen: „Was ist Ihr Anwendungsfall?“

  • Nach der Beschreibung Ihres Anwendungsfalls stellt der Mitarbeiter eine Liste der relevanten Attribute basierend auf dem Anwendungsfall bereit

  • Nachdem Sie bestätigt haben, dass die Attribute gut aussehen, führt Sie Coworker durch die verbleibenden Konfigurationsoptionen. Standardmäßig verfügt die Konfiguration über keine Zielgruppenbeschreibungen, verwendet eine präzise Profilbeschreibung, keine Marketing-Aktionsbezeichnungen und verwendet den Namespace Standard Person.

    • Wenn Sie die Zielgruppenbeschreibungen zur Profilbeschreibung hinzufügen möchten
      • Durch Einschließen der Zielgruppenbeschreibung wird Kontext zur Profilbeschreibung hinzugefügt, wenn sich das Profil für diese Zielgruppe qualifiziert. Das Hinzufügen von Zielgruppenbeschreibungen filtert nicht welche Kundinnen und Kunden die Personalisierung erhalten.
    • Die Präzision der Profilbeschreibung
    • Die Marketing-Aktionen
    • Der verwendete Personen-Namespace

Nachdem Sie diese Schritte durchlaufen haben, wird Ihr Profil mit unstrukturiertem Datenkontext erstellt.

API-Aufrufe

Sie können das Profil mit unstrukturiertem Datenkontext einrichten, indem Sie die Experience Platform-APIs verwenden.

Bevor Sie fortfahren, lesen Sie Erste Schritte , um Links zu entsprechenden Dokumentationen zu erhalten, eine Anleitung zum Lesen der Beispiel-API-Aufrufe in diesem Abschnitt und wichtige Informationen zu Kopfzeilen zu erhalten, die für das erfolgreiche Aufrufen einer Experience Platform-API erforderlich sind.

Kategorien abrufen get-categories

Sie müssen zunächst die Kategorien für den Profilkontext abrufen. Die Kategorien sind Gruppierungen von Profilattributen, die in Ihrer Sandbox verfügbar sind.

API-Format

code language-http
GET /semanticprofile/config/category

Anfrage

Mit der folgenden Anfrage wird eine Liste aller verfügbaren Kategorien und ihrer Attribute in Ihrer Sandbox abgerufen.

accordion
Eine Beispielanfrage zum Abrufen der verfügbaren Kategorien.
code language-shell
curl -X GET https://platform.adobe.io/data/core/semanticprofile/config/category \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Antwort

Bei einer erfolgreichen Antwort wird der HTTP-Status 200 mit einer Liste der für Ihre Organisation und Sandbox verfügbaren Kategorien zurückgegeben.

accordion
Eine Beispielantwort, die eine Liste der Kategorien und Attribute enthält, die zu Ihrer Organisation und Sandbox gehören
code language-json
{
  "requestId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "result": [
    {
      "categories": [
        {
          "name": "Customer Demographics",
          "attributes": [
            "person.name.firstName",
            "person.name.lastName",
            "person.gender",
            "person.maritalStatus"
          ]
        },
        {
          "name": "Contact Information",
          "attributes": [
            "personalEmail.address",
            "mobilePhone.number"
          ]
        }
      ]
    }
  ]
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
Feld Typ Beschreibung
requestId Zeichenfolge Die eindeutige ID der Anfrage.
result Array Ein Array, das die verfügbaren Kategorien für Ihre Sandbox enthält.
categories.name Zeichenfolge Der Name der Kategorie.
categories.attributes Array Ein Array, das die Liste der verfügbaren Attribute innerhalb der Kategorie enthält.

Erstellen einer Konfiguration

Nachdem Sie die verfügbaren Kategorien für Ihre Sandbox abgerufen haben, können Sie eine Konfiguration erstellen. Die Konfiguration enthält die Kategorien und Attribute der Profildaten, die Zielgruppen, die hervorgehoben werden sollen, die Marketing-Aktionen, die erzählerische Präzision sowie den Namespace.

API-Format

code language-http
POST /semanticprofile/config/configuration

Anfrage

Mit der folgenden Anfrage wird ein Profil mit einer unstrukturierten Datenkonfiguration erstellt, wobei die Kategorie Kundendemografie verwendet wird, einschließlich einer bestimmten Zielgruppe, ohne Marketing-Aktionen, ungenauer Erzählungspräzision und E-Mail-Namespace.

accordion
Eine Beispielanfrage zum Erstellen einer Profilkonfiguration.
code language-shell
curl -X POST https://platform.adobe.io/data/core/semanticprofile/config/configuration \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "data": {
        "name": "CustomerSummary",
        "configurationDetails": {
            "category": [
                {
                    "name": "Customer Demographics",
                    "attributes": [
                        "person.name.firstName",
                        "person.name.lastName"
                    ]
                }
            ],
            "segments": {
                "limit": 1,
                "selection_mode": "inclusion",
                "inclusion": [
                    {
                        "id": "b2cf20ca-5d07-4ef2-b50a-994eb2c11349",
                        "priority": "1"
                    }
                ],
                "exclusion": []
            },
            "marketingActions": [],
            "narrative_precision": "fuzzy",
            "personNamespace": {
                "isPersonNamespaceEnabled": true,
                "code": ["Email"]
            }
        }
    }
 }'
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4
Feld Erforderlich Typ Beschreibung
name Ja Zeichenfolge Der Name der Konfiguration. Dies wird als Schlüssel in der Erzählungs-API verwendet.
configurationDetails Ja Objekt Ein Objekt, das Details für die Konfiguration enthält, einschließlich der Kategorien, Zielgruppendetails, Marketing-Aktionen, narrative Präzision und Namespace.
category Ja Array Ein Array, das Informationen zu den Kategorien enthält, die Ihre Konfiguration verwenden soll.
category.name Ja Zeichenfolge Der Name der Kategorie, die Sie verwenden möchten. Dieser muss mit einem Wert aus dem GET categories-API-Aufruf übereinstimmen.
category.attributes Ja Array Ein Array von Attributen, die Sie verwenden möchten. Diese Attribute müssen Teil der von Ihnen verwendeten Kategorie sein.
segments Nein Objekt Ein -Objekt, das die Zielgruppen enthält, die Sie der Konfiguration hinzufügen möchten.
segments.limit Nein Nummer Die maximale Anzahl von Zielgruppen, die Sie der Konfiguration hinzufügen möchten.
segments.selection_mode Nein Zeichenfolge Die Methode, nach der die Zielgruppen ausgewählt werden. Derzeit wird nur inclusion unterstützt.
segments.inclusion Nein Array Ein Array, das die Zielgruppen enthält, die Sie einbeziehen möchten. Die Zielgruppen werden als Objekte geschrieben, die sowohl die Segmentdefinitions-ID als auch die Priorität enthalten, wobei eine niedrigere Zahl eine höhere Priorität bedeutet (sodass „1“ die höchste Priorität ist).
marketingActions Nein Array Ein Array, das die Marketing-Aktionen enthält, die Sie auf die Konfiguration anwenden möchten. Weitere Informationen zu Marketing-Aktionen finden Sie im Endpunkthandbuch zu Marketing-Aktionen.
narrative_precision Nein Zeichenfolge

Die Präzision, die die Konfigurationsbeschreibung aufweisen wird. Zu den unterstützten Werten gehören precise, fuzzy und value_only.

  • precise: Literale Werte mit beschreibendem Inhalt.
  • fuzzy: Bereiche oder Perzentile.
  • value_only: Präzise Werte ohne Bereich- oder Perzentil-Darstellung.
personNamespace Nein Objekt Ein -Objekt, das Details zum Identity-Namespace für die Konfiguration enthält. Wenn dieses Feld leer gelassen wird, wird der Standard-Namespace der Sandbox verwendet.
personNamespace.isPersonNamespaceEnabled Nein Boolesch Wenn auf true gesetzt, werden die in personNamespace.code aufgelisteten Namespaces verwendet. Andernfalls wird der Standard-Namespace der Sandbox verwendet.
personNamespace.code Nein Array Ein Array, das die Identity-Namespace-Codes auflistet, die die Erzählung verwenden soll.

Antwort

Bei einer erfolgreichen Antwort wird der HTTP-Status 200 mit einer eindeutigen Anfrage-ID und den Details der neu erstellten Konfiguration zurückgegeben.

accordion
Eine Beispielantwort, die die neu erstellte Konfiguration enthält.
code language-json
{
    "requestId": "aaaa479b53a61598",
    "result": {
        [
            "CustomerSummary"
        ],
        "configurations": [
            {
                "name": "",
                "configurationDetails": {
                    "category": [
                        {
                            "name": "Customer Demographics",
                            "llm_desc": "",
                            "attributes": [
                                {
                                    "field": "person.name.firstName",
                                    "xdm_desc": "First Name",
                                    "llm_desc": ""
                                },
                                {
                                    "field": "person.name.lastName",
                                    "xdm_desc": "Last Name",
                                    "llm_desc": ""
                                }
                            ]
                        }
                    ]
                },
                "segments": {
                    "limit": 1,
                    "selection_mode": "inclusion",
                    "inclusion": [
                        {
                            "id": "b2cf20ca-5d07-4ef2-b50a-994eb2c11349",
                            "priority": "1",
                            "name": "High Value Customers",
                            "description": "Customers with LTV > $500",
                            "totalProfiles": 125000
                        }
                    ],
                    "exclusion": []
                },
                "marketingActions": [],
                "narrative_precision": "fuzzy",
                "personNamespace": {
                    "isPersonNamespaceEnabled": true,
                    "code": [
                        {
                            "code": "Email",
                            "name": "Email"
                        }
                    ]
                }
            }
        ]
    }
}

Nachdem der Profilkontext erstellt wurde, können Sie die Konfiguration für Brand Concierge oder einen anderen kundenorientierten Agenten speichern.

Profilkontext in Brand Concierge profile-context-brand-concierge

Wählen Sie in Brand Concierge den Concierge aus, auf den Sie die Profilkonfiguration anwenden möchten.

Brand Concierge wird angezeigt und zeigt eine Liste der Concierges an.

Nachdem Sie den Concierge ausgewählt haben, wechseln Sie zur Registerkarte Personalization, wählen Sie die zuvor erstellte Konfiguration aus und klicken Sie auf Speichern, um die Profilkonfiguration anzuwenden.

Die Registerkarte Personalisierung wird in Brand Concierge angezeigt.

Profilkontext mit anderen kundenorientierten Agenten profile-context-other

Um Profilkontext mit anderen kundenorientierten Agenten zu verwenden, müssen Sie die Experience Platform-API verwenden, um den Profilkontext des Kunden nachzuschlagen und den Gesprächsverlauf abzurufen. Durch Abrufen dieser beiden Werte kann Ihr Agent ordnungsgemäß den vollständigen und relevanten Kontext abrufen, bevor er eine Konversation beginnt.

Um den Profilkontext des Kunden nachzuschlagen, müssen Sie eine GET-Anfrage an den /semanticprofile/lookup/narrative-Endpunkt stellen und dabei die entityIdNS, die entityId und die configurationName als Abfrageparameter angeben.

Beispielanfrage und -antwort zum Abrufen der Profilbeschreibung
code language-shell
curl -X GET "https://platform.adobe.io/data/core/semanticprofile/lookup/narrative?entityIdNS=Email&entityId=jane.doe%2B1@example.com&configurationName=CustomerSummary" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "x-api-key: {API_KEY}" \
  -H "x-gw-ims-org-id: {ORG_ID}" \
  -H "x-sandbox-name: {SANDBOX_NAME}"
table 0-row-2 1-row-2 2-row-2 3-row-2
Abfrageparameter Beschreibung
entityIdNS Der Identity-Namespace. Dies muss ein Namespace sein, der in Ihrer Sandbox definiert ist. Zu den möglichen Werten gehören Email, ECID und CRMID.
entityId Der Identitätswert innerhalb des Namespace. Sie müssen reservierte URL-Zeichen kodieren. Wenn die gesuchte E-Mail beispielsweise john+1@example.com lautet, muss dies wie john%2B1@example.com geschrieben werden.
configurationName Der Name der zuvor erstellten Konfiguration.

Eine erfolgreiche Antwort gibt den HTTP-Status-Code 200 mit Informationen zum Profilkontext zurück.

code language-json
{
    "requestId": "7f3a9c8e-4d7b-4a6e-9f2c-1b6e8d4a2c91",
    "narrative": "Jane Doe is a member of the 'High Value Loyalty' audience. Her primary email address is jane.doe+1@example.com."
}
table 0-row-2 1-row-2 2-row-2
Feld Beschreibung
requestId Die eindeutige ID, die für die Anfrage generiert wurde.
narrative Die generierte Zusammenfassung des natürlichen Sprachprofils.

Um den vorherigen Gesprächsverlauf eines Kunden nachzuschlagen, müssen Sie eine POST-Anfrage an den /semanticprofile/query/v1/profile-Endpunkt senden und dabei die entityIdNS und entityId als Abfrageparameter angeben.

Beispielanfrage und -antwort
code language-shell
curl -X POST "https://platform.adobe.io/data/core/semanticprofile/query/v1/profile?entityIdNS=Email&entityId=jane.doe%2B1@example.com" \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "conversations": {}
 }'
table 0-row-2 1-row-2 2-row-2
Abfrageparameter Beschreibung
entityIdNS Der Identity-Namespace. Dies muss ein Namespace sein, der in Ihrer Sandbox definiert ist. Zu den möglichen Werten gehören Email, ECID und CRMID.
entityId Der Identitätswert innerhalb des Namespace. Sie müssen reservierte URL-Zeichen kodieren.

| Anfragefeld | Typ | Beschreibung |
| ------------- | -------- | ---- | ----------- |
| conversations | Objekt | Ein -Objekt, das bestimmt, ob Informationen zu den Unterhaltungen zurückgegeben werden sollen. Wenn Sie es als leeres Objekt belassen, erhalten Sie automatisch Informationen über die Interaktionen, Metadaten und Signale. |

Eine Beispielantwort gibt den HTTP-Status-Code 200 mit Informationen zu den Konversationen für die angeforderte Entität zurück.

code language-json
{
    "conversations": {
        "items": [{
            "conversation_id": "conv-001",
            "channel": "web-chat",
            "created_at": "2026-05-02T14:03:11Z",
            "last_active_at": "2026-05-02T14:21:55Z",
            "participants": [{
                "identity_map": {
                    "Email": [{
                        "id": "jane.doe+1@example.com",
                        "primary": true
                    }]
                },
                "role": "customer",
                "is_author": true
            }],
            "interactions": [{
                "interaction_id": "int-001",
                "timestamp": "2026-05-02T14:03:11Z",
                "contents": [{
                    "content_value": "Hi, I'd like to upgrade my plan.",
                    "content_type": "TEXT"
                }]
            }]
        }],
    "has_more": true,
    "page_token": "eyJjdXJzb3IiOi…"
  }
}

Nachdem Sie sowohl die Erzählung als auch die Unterhaltungen erhalten haben, können Sie diese Informationen an Ihre KI-Agenten von Drittanbietern weiterleiten. Dadurch erhält der KI-Agent Informationen darüber, wer der Kunde ist, sowie Informationen darüber, was der Kunde besprochen hat.

Konfigurieren von Signalen zum Extrahieren von Daten configure-signals

Nachdem Sie den Profilkontext konfiguriert haben, können Sie jetzt Signale konfigurieren, um Daten aus Ihren unstrukturierten Daten zu extrahieren.

Sie können diesen Prozess beginnen, indem Sie zu einem Kollegen gehen und fragen: „Lassen Sie mich Signale aus Gesprächen extrahieren“. Der Kollege fragt dann, welche Signale Sie aus den Gesprächen erkennen möchten.

Was zu erkennen ist, wird in „Coworker“ angezeigt.

Als Nächstes fragt Coworker, zu welcher Art von Marke oder Unternehmen diese Gespräche gehören.

Mitarbeiter fragt den Benutzer nach der Marke oder dem Kontext für das Signal.

Schließlich werden Sie von Coworker gefragt, ob Sie eine neue Signalgruppe erstellen oder zu einer vorhandenen Signalgruppe hinzufügen möchten.

Sie werden gefragt, ob Sie ein neues Signal erstellen oder ein vorhandenes Signal aktualisieren möchten.

Sie können dann überprüfen, ob die oben genannten Schritte korrekt aussehen und ob Sie mit der Signalerstellung fortfahren möchten.

Der Mitarbeiter fragt, ob Sie bestätigen möchten, ob die Schritte korrekt aussehen.

Die Signalerstellung beginnt. Anschließend erstellt der Mitarbeiter ein -Signal, das automatisch zu Experience Platform hinzugefügt wird.

Coworker listet auf, was Sie kopieren und einfügen müssen, um das Signal einzufügen.

Nachdem das Signal erstellt wurde, können Sie es mit Audience Builder einer Audience hinzufügen. Die Signale werden als Erlebnisereignisse angezeigt.

Der Ort, an dem ein Signal für ein Profil mit unstrukturierten Daten hinzugefügt werden soll, wird in Audience Builder angezeigt.

Weitere Informationen zur Verwendung von Audience Builder finden Sie in der Audience Builder-Dokumentation.

Nachdem Sie eine Zielgruppe mit einem Signal erstellt haben, können Sie Profile extrahieren, die dieses Signal verwenden. Erkannte Signale sind Erlebnisereignisse mit dem Ereignistyp semantic.signalDetected.

Das extrahierte Signal für das Profil wird angezeigt.

Häufig gestellte Fragen faq

Im folgenden Abschnitt finden Sie häufig gestellte Fragen zu Profilen mit unstrukturierten Daten.

Sind Profile mit unstrukturierten Daten von einem normalen Kundenprofil getrennt?

Antwort
Nein. Unstrukturierte Profildaten erweitert Echtzeit-Kundenprofil. Infolgedessen können Sie zusätzlich zu den unstrukturierten Daten auch Ihre vorhandenen Profilgrunddaten verwenden. Dadurch das Echtzeit-Kundenprofil nicht ersetzt.

Was ist die Kontext-/Profilbeschreibung?

Antwort

Der Profilkontext (Profilbeschreibung) ist die konsolidierte Information, die einem KI-Agenten bereitgestellt wird, um eine Interaktion zu verbessern. Der Kontext kann die folgenden Daten kombinieren:

  • Profilattribute
  • Zielgruppenzugehörigkeit
  • Verhaltenshistorie
  • Navigationsaktivität
  • Vorherige Unterhaltungen

Was ist ein Signal?

Antwort

Ein Signal ist eine strukturierte, aktivierungsfähige Bedeutungsdarstellung, die innerhalb einer unstrukturierten Interaktion erkannt wird. Beispiele für Signale sind:

  • Produktinteresse
  • Stornierungsbedingung
  • Eine erklärte Präferenz
  • Ein Lebensereignis
  • Negative Erfahrungen
  • Eine Branche
  • A Buyer Role

Signale können entweder von Marketing-Experten definiert oder vom System durch Analyse einzelner in den Daten entdeckter Signale erzeugt werden.

Wie unterscheidet sich ein Signal vom Rohgespräch?

Antwort
Ein Signal stellt ein definiertes Geschäftskonzept dar, das mit profilbezogenen Ereignisdaten gespeichert werden kann, während die Rohkonversation die unstrukturierten Quelldaten sind.

Unterstützt Profil mit unstrukturierten Daten nur Brand Concierge?

Antwort
Nein. Das Profil mit unstrukturierten Daten unterstützt Adobe, kundenspezifische Agenten und Drittanbieter-Kundenagenten.

Welche Datenquellen kann ich verwenden?

Antwort

Die folgenden Quellen werden unterstützt:

  • Brand Concierge- und Nicht-Brand Concierge-Unterhaltungen
  • WhatsApp-Unterhaltungen
  • Suchanfragen
  • Callcenter-Transkripte
  • Chat-Protokolle
  • Umfragen
  • Webinar und Protokolle zu Verkaufsaufrufen
  • Andere textbasierte Interaktionen
recommendation-more-help
experience-platform-help-profile