Real-time Customer Profile-API-Handbuch

Real-time Customer Profile ermöglicht es Ihnen, eine ganzheitliche Sicht auf Ihre einzelnen Kunden in Adobe Experience Platform zu erhalten. Profile ermöglicht es Ihnen, verschiedene Kundendaten aus verschiedenen Kanälen wie Online-, Offline-, CRM- und Drittanbieterdaten in einer einheitlichen Ansicht zu bündeln, die eine ausführbare, mit Zeitstempel versehene Übersicht über jede Kundeninteraktion bietet.

Die Real-time Customer Profile-API enthält mehrere Endpunkte, wie unten dargestellt. Weitere Informationen zu erforderlichen Kopfzeilen, zum Lesen von Beispiel-API-Aufrufen und mehr finden Sie in den einzelnen Endpunkthandbüchern sowie in den Ersten Schritten.

Um alle verfügbaren Endpunkte und CRUD-Vorgänge anzuzeigen, besuchen Sie den Real-time Customer Profile API Reference Swagger.

Eine Anleitung zum Arbeiten mit Real-time Customer Profile-Daten in der Experience Platform-Benutzeroberfläche finden Sie im Profil-Benutzerhandbuch.

(Alpha) Berechnete Attribute

WICHTIG

Die Funktion für berechnete Attribute ist alphanumerisch und steht nicht allen Benutzern zur Verfügung. Dokumentation und Funktionalität können sich ändern.

Berechnete Attribute sind Funktionen, mit denen Daten auf Ereignisebene in Attribute auf Profilebene aggregiert werden. Diese Funktionen werden automatisch berechnet, sodass sie für die Segmentierung, Aktivierung und Personalisierung verwendet werden können.

Jedes berechnete Attribut enthält einen Ausdruck oder eine "Regel", der/die eingehende Daten auswertet und den resultierenden Wert in einem Profilattribut speichert. Mit diesen Berechnungen können Sie Fragen im Zusammenhang mit dem Kaufwert über die gesamte Lebensdauer, der Zeit zwischen Käufen oder der Anzahl der Anwendungsöffnungen leicht beantworten, ohne für jede benötigte Information manuell komplexe Berechnungen ausführen zu müssen. Diese berechneten Attributwerte können dann in einem Profil angezeigt, zum Erstellen eines Segments verwendet oder über verschiedene Zugriffsmuster aufgerufen werden.

Mithilfe des Endpunkts config/computedAttributes können Sie berechnete Attribute erstellen, anzeigen, bearbeiten und löschen. Informationen zur Verwendung berechneter Attribute finden Sie in der Übersicht über berechnete Attribute. Besuchen Sie für API-Vorgänge das Handbuch zum API-Endpunkt für berechnete Attribute.

Edge-Projektionen

Die Adobe Experience Platform ermöglicht eine Personalisierung von Kundenerlebnissen in Echtzeit, indem sie Daten auf strategisch platzierten Servern („Edge“-Server genannt) leicht zugänglich macht. Die Real-time Customer Profile-API bietet Endpunkte zum Arbeiten mit Edges über Komponenten, die als "Projektionen"bezeichnet werden. Dazu gehören Projektionskonfigurationen, um zu ermitteln, welche Daten auf die einzelnen Edge-Server projiziert werden sollen, sowie Projektionsziele, um zu definieren, wohin eine Projektion geleitet werden soll. Ausführliche Informationen zum Arbeiten mit Edge-Projektionen finden Sie im Handbuch Projektionskonfigurationen und Endpunkte .

Entitäten (Profile-Zugriff)

Über Adobe Experience Platform können Sie mithilfe von RESTful-APIs oder der Benutzeroberfläche auf Real-time Customer Profile Daten zugreifen. Um zu erfahren, wie Sie mithilfe der API auf Entitäten zugreifen können, die allgemein als "Profile"bezeichnet werden, führen Sie die Schritte aus, die im Endpoint-Handbuch für Entitäten beschrieben sind. Informationen zum Zugriff auf Profile mithilfe der Platform-Benutzeroberfläche finden Sie im Profil-Benutzerhandbuch.

Exportaufträge (Profile-Export)

Real-time Customer Profile -Daten können zur weiteren Verarbeitung in einen Datensatz exportiert werden, z. B. zum Exportieren von Zielgruppensegmenten zur Aktivierung oder zum Reporting von Profilattributen. Exportaufträge für Zielgruppensegmente sind Teil der Adobe Experience Platform Segmentation Service-API. Weitere Informationen finden Sie im Endpoint-Handbuch für Segmentierungsexportaufträge. Eine schrittweise Anleitung zum Erstellen und Verwalten von Exportaufträgen für Profilattribute finden Sie im Endpunkt für Exportaufträge.

Zusammenführungsrichtlinien

Beim Zusammenführen von Daten aus mehreren Quellen in Experience Platform dienen Zusammenführungsrichtlinien als jene Regeln, mit denen Platform bestimmt, wie Daten priorisiert werden und welche Daten kombiniert werden, um individuelle Kundenprofile zu erstellen. Mit der API Real-time Customer Profile können Sie neue Zusammenführungsrichtlinien erstellen, vorhandene Richtlinien verwalten und eine standardmäßige Zusammenführungsrichtlinie für Ihre Organisation festlegen. Informationen zum Arbeiten mit Zusammenführungsrichtlinien mithilfe der finden Sie im API-Endpunkthandbuch für Zusammenführungsrichtlinien.

Um mehr über Zusammenführungsrichtlinien und ihre Rolle in Platform zu erfahren, lesen Sie zunächst den Überblick über Zusammenführungsrichtlinien.

Musterstatus der Vorschau (Profile-Vorschau)

Da Daten in Platform erfasst werden, wird ein Beispielauftrag ausgeführt, um die Profilanzahl und andere datenbezogene Metriken des Echtzeit-Kundenprofils zu aktualisieren. Die Ergebnisse dieses Beispielauftrags können mit dem Endpunkt /previewsamplestatus angezeigt werden, der Teil der Echtzeit-Kundenprofil-API ist. Dieser Endpunkt kann auch verwendet werden, um Profilverteilungen nach Datensatz und Identitäts-Namespace aufzulisten und mehrere Berichte zu generieren, um Einblicke in die Zusammensetzung des Profilspeichers Ihres Unternehmens zu erhalten. Informationen zum Einstieg in die Verwendung des Endpunkts /profilepreviewstatus finden Sie im Handbuch zum Beispiel-Status-Endpunkt für die Vorschau.

Profilsystemaufträge

Profilaktivierte Daten, die in Platform erfasst werden, werden im Data Lake sowie im Real-time Customer Profile-Datenspeicher gespeichert. Gelegentlich kann es erforderlich sein, einen Datensatz oder Batch aus dem Profile-Speicher zu löschen, um nicht mehr benötigte oder fehlerhaft hinzugefügte Daten zu entfernen. Dies erfordert die Verwendung der API zum Erstellen eines Profile System Job, auch als "delete request"bezeichnet, das bei Bedarf geändert, überwacht oder gelöscht werden kann. Um zu erfahren, wie Sie Löschanfragen mithilfe des Endpunkts /system/jobs in der API Real-time Customer Profile verwenden, führen Sie die Schritte aus, die im Endpunkt Profilsystemaufträge beschrieben sind.

Profilattribute aktualisieren

Gelegentlich kann es erforderlich sein, Daten im Profilspeicher Ihrer Organisation zu aktualisieren. Vielleicht müssen Sie zum Beispiel Datensätze korrigieren oder einen Attributwert ändern. Dies kann durch Batch- oder Streaming-Aufnahme erfolgen und erfordert einen profilaktivierten Datensatz, der mit einem Upsert-Tag konfiguriert ist. Weitere Informationen zur Konfiguration eines Datensatzes für Attributaktualisierungen finden Sie im Tutorial zur Aktivierung eines Datensatzes für Profil und Upsert.

Nächste Schritte

Um Aufrufe mit der Real-time Customer Profile-API zu tätigen, lesen Sie das Erste Schritte-Handbuch und wählen Sie dann eine der Endpunkthandbücher aus, um zu erfahren, wie Sie bestimmte Profile-bezogene Endpunkte verwenden. Informationen zum Arbeiten mit Profile-Daten mithilfe der Experience Platform-Benutzeroberfläche finden Sie im Benutzerhandbuch zum Echtzeit-Kundenprofil.

Auf dieser Seite