Real-Time Customer Profile-API-Handbuch

Real-Time Customer Profile können Sie sich einen ganzheitlichen Überblick über Ihre einzelnen Kunden in Adobe Experience Platform verschaffen. Mit Profile können Sie unterschiedliche Kundendaten aus verschiedenen Kanälen, wie Online-, Offline-, CRM- und Drittanbieterdaten, in einer zentralen Ansicht zusammenführen, die eine aussagekräftige, Darstellung jeder Kundeninteraktion mit Zeitstempel bietet.

Die Real-Time Customer Profile-API umfasst mehrere Endpunkte, die unten beschrieben werden. 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 Echtzeit-Kundenprofil-API-Referenz-Swagger.

Eine Anleitung zum Arbeiten mit Real-Time Customer Profile in der Experience Platform-Benutzeroberfläche finden Sie im Benutzerhandbuch für Profile.

Berechnete Attribute computed-attributes

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

Jedes berechnete Attribut enthält einen Ausdruck oder eine „Regel“, 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, zur Erstellung einer Zielgruppe verwendet oder über verschiedene Zugriffsmuster aufgerufen werden.

Sie können berechnete Attribute mithilfe des ca/attributes/-Endpunkts erstellen, anzeigen, bearbeiten und löschen. Informationen zur Verwendung berechneter Attribute finden Sie unter Berechnete Attribute - Übersicht. Informationen zu API-Vorgängen finden Sie im Handbuch zu API-Endpunkten für berechnete Attribute.

Entitäten (Profile-Zugriff) entities

Über Adobe Experience Platform können Sie mithilfe von RESTful-APIs oder der Benutzeroberfläche auf Real-Time Customer Profile Daten zugreifen. Um mithilfe der API auf Entitäten zuzugreifen, die gemeinhin als „Profile“ bezeichnet werden, führen Sie die Schritte aus, die im Handbuch für Entitäten-Endpunkte“ beschrieben. Informationen zum Zugriff auf Profile über die Platform Benutzeroberfläche finden Sie im Benutzerhandbuch für Profile.

Exportaufträge (Profile-Export) profile-export

Real-Time Customer Profile Daten können zur weiteren Verarbeitung in einen Datensatz exportiert werden, z. B. zum Exportieren von Zielgruppen zur Aktivierung oder Profilattributen für das Reporting. Exportvorgänge für Zielgruppen sind Teil der Adobe Experience Platform Segmentation Service-API. Weitere Informationen finden Sie HandbuchSegmentierungsexportvorgänge . Schrittweise Anweisungen zum Erstellen und Verwalten von Exportvorgängen für Profilattribute finden Sie im Handbuch zu Exportvorgängen.

Zusammenführungsrichtlinien merge-policies

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 sollen, um individuelle Kundenprofile zu erstellen. Mit 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 API finden Sie im Handbuch zu Endpunkten von Zusammenführungsrichtlinien.

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

Musterstatus der Vorschau (Profile-Vorschau) profile-preview

Bei der Aufnahme von Daten in Platform wird ein Beispielvorgang ausgeführt, um die Profilanzahl und andere Metriken zu aktualisieren, die sich auf das Echtzeit-Kundenprofil beziehen. Die Ergebnisse dieses Beispielauftrags können mit dem /previewsamplestatus-Endpunkt, der Teil der Echtzeit-Kundenprofil-API ist, angezeigt werden. Dieser Endpunkt kann auch verwendet werden, um Profilverteilungen sowohl nach Datensatz als auch nach Identity-Namespace aufzulisten und mehrere Berichte zu generieren, um einen Einblick in die Zusammensetzung des Profilspeichers Ihres Unternehmens zu erhalten. Informationen zu den ersten Schritten mit dem /profilepreviewstatus-Endpunkt finden Sie im Handbuch zum Vorschaubeispielstatus-Endpunkt.

Profilsystemaufträge profile-system-jobs

Profilaktivierte Daten, die in Platform aufgenommen werden, werden sowohl im Data Lake als auch im Real-Time Customer Profile gespeichert. Gelegentlich kann es erforderlich sein, mit einem Datensatz verknüpfte Profildaten aus dem Profilspeicher zu löschen, um nicht mehr benötigte oder irrtümlich hinzugefügte Daten zu entfernen. Dazu muss mithilfe der -API ein Profile System Job erstellt werden, das auch als "delete request" bezeichnet wird und bei Bedarf geändert, überwacht oder gelöscht werden kann. Um zu erfahren, wie Sie mit Löschanfragen unter Verwendung des /system/jobs-Endpunkts in der Real-Time Customer Profile-API arbeiten, folgen Sie den Schritten, die im Handbuch zum Vorgangs-Endpunkt von Profile System beschrieben sind.

Aktualisieren von Profilattributen update-profile

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

Um mit Aufrufen mit der Real-Time Customer Profile-API zu beginnen, lesen Sie Erste Schritte und wählen Sie dann eines der Endpunkthandbücher aus, um zu erfahren, wie Sie bestimmte Profile Endpunkte verwenden. Informationen zum Arbeiten mit Profile Daten über die Experience Platform-Benutzeroberfläche finden im Benutzerhandbuch zum Echtzeit-Kundenprofil.