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 Die API enthält mehrere Endpunkte, wie unten beschrieben. 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 die Referenz-Swagger zur Echtzeit-Kundenprofil-API.

Eine Anleitung zum Arbeiten mit Real-time Customer Profile Daten in der Experience Platform Benutzeroberfläche, siehe 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.

Sie können berechnete Attribute mithilfe der Variablen config/computedAttributes -Endpunkt. Informationen zur Verwendung berechneter Attribute finden Sie im Abschnitt Übersicht über berechnete Attribute. Besuchen Sie für API-Vorgänge den Abschnitt 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 für die Arbeit 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 zu Projektionskonfigurationen und Endpunkten.

Entitäten (Profile-Zugriff)

Über Adobe Experience Platform können Sie auf Real-time Customer Profile Daten mithilfe von RESTful-APIs oder der Benutzeroberfläche. Um zu erfahren, wie Sie mithilfe der API auf Entitäten zugreifen, die allgemein als "Profile"bezeichnet werden, führen Sie die Schritte aus, die im Abschnitt Endpunktleitfaden für Entitäten. So greifen Sie auf Profile zu, die Platform Benutzeroberfläche, siehe 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, lesen Sie bitte die Endpunktleitfaden für Segmentierungs-Exportaufträge , um mehr zu erfahren. Eine schrittweise Anleitung zum Erstellen und Verwalten von Exportaufträgen für Profilattribute finden Sie unter Endpunktleitfaden für Exportaufträge.

Zusammenführungsrichtlinien

Beim Zusammenführen von Daten aus mehreren Quellen in Experience Platform, sind Zusammenführungsrichtlinien Regeln, die Platform verwendet , um zu bestimmen, wie Daten priorisiert werden und welche Daten kombiniert werden, um individuelle Kundenprofile zu erstellen. Verwenden der Real-time Customer Profile API 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 innerhalb von Platform zu erfahren, lesen Sie zunächst das Übersicht ü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 /previewsamplestatus -Endpunkt, Teil der Echtzeit-Kundenprofil-API. 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. Erste Schritte mit der Verwendung von /profilepreviewstatus -Endpunkt, siehe Beispiel-Status-Endpunktleitfaden für die Vorschau.

Profilsystemaufträge

Profilaktivierte Daten, die in Platform wird im Data Lake sowie Real-time Customer Profile Datenspeicher. Gelegentlich kann es erforderlich sein, einen Datensatz oder Batch aus der Profile speichern, um Daten zu entfernen, die Sie nicht mehr benötigen oder die fehlerhaft hinzugefügt wurden. Dazu muss die API zum Erstellen einer Profile System Job, auch als bezeichnetdelete request", die bei Bedarf geändert, überwacht oder gelöscht werden können. Erfahren Sie, wie Sie Löschanfragen mit der /system/jobs -Endpunkt im Real-time Customer Profile API ausführen, folgen Sie den Schritten, die im Abschnitt Endleitfaden für Profilsystemaufträge.

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

So starten Sie Aufrufe mit dem Real-time Customer Profile API, lesen Sie die Erste Schritte Wählen Sie dann eine der Endpunktleitfäden aus, um zu erfahren, wie Sie bestimmte Profile-zugehörige Endpunkte. So arbeiten Sie mit Profile Daten, die Experience Platform Benutzeroberfläche, siehe Benutzerhandbuch zum Echtzeit-Kundenprofil.

Auf dieser Seite