Algolia User Profiles Daten über die Benutzeroberfläche in Experience Platform aufnehmen

Dieses Tutorial führt Sie mithilfe der -Benutzeroberfläche durch die Aufnahme von Daten aus Ihrem Algolia User Profiles-Konto in Adobe Experience Platform.

Erste Schritte

IMPORTANT
Bevor Sie beginnen, stellen Sie sicher, dass Sie die in der Algolia User Profiles beschriebenen Voraussetzungen erfüllt.

In diesem Tutorial wird davon ausgegangen, dass Sie mit den folgenden Experience Platform-Komponenten vertraut sind:

  • Experience Data Model (XDM) System: Das standardisierte Framework, das Experience Platform zum Organisieren von Kundenerlebnisdaten verwendet.

    • Grundlagen der Schemakomposition: Erfahren Sie mehr über die Schemakomposition, einschließlich der wichtigsten Prinzipien und Best Practices.
    • Tutorial zum Schema-Editor: Erfahren Sie, wie Sie benutzerdefinierte Schemata mithilfe der Benutzeroberfläche des Schema-Editors erstellen können.
  • Real-Time Customer Profile: Ein einheitliches Echtzeit-Kundenprofil, das auf aggregierten Daten aus verschiedenen Quellen basiert.

  • Quellen: Nehmen Sie Daten aus verschiedenen Quellen auf und verwenden Sie Experience Platform-Services, um die Daten zu strukturieren, zu kennzeichnen und zu verbessern.

Sammeln erforderlicher Anmeldedaten

Um Algolia mit Adobe Experience Platform zu verbinden, geben Sie die folgenden Anmeldeinformationen an:

Anmeldedaten
Beschreibung
Anwendungs-ID
Die Ihrem Algolia-Konto zugewiesene eindeutige Kennung.
API-Schlüssel
Die Berechtigung für die Authentifizierung und Autorisierung von API-Anfragen an die Services von Algolia.

Weitere Informationen finden Sie in der Algolia Authentifizierungsdokumentation.

Verbinden Ihres Algolia-Kontos

Wählen Sie in der Experience Platform-Benutzeroberfläche linken Navigationsbereich die Option Quellen“ aus, um den Arbeitsbereich Quellen zu öffnen. Verwenden Sie das Kategorien-Bedienfeld oder die Suchleiste, um Ihre gewünschte Quelle zu finden.

Um Algolia zu verbinden, wählen Sie die Quellkarte Algolia unter Daten- und Identitätspartner und wählen Sie Einrichten.

TIP
Wenn eine Quelle noch kein authentifiziertes Konto hat, wird die Option "". Nach der Authentifizierung ändert sich dies in Daten hinzufügen.

Der Quellkatalog mit der ausgewählten Algolia-Benutzerprofilquelle.

Authentifizierung

Vorhandenes Konto verwenden

Um ein vorhandenes Konto zu verwenden, wählen Sie Vorhandenes Konto und wählen Sie das Algolia User Profiles Konto aus, das Sie verwenden möchten. Wählen Sie dann Weiter aus.

Die vorhandene Kontoschnittstelle.

Neues Konto erstellen

Um ein neues Konto zu erstellen, wählen Sie Neues Konto und geben Sie dann einen Namen, eine optionale Beschreibung und Ihre Algolia Anmeldeinformationen ein. Wählen Sie Mit Quelle verbinden und warten Sie, bis die Verbindung hergestellt ist.

Die neue Kontoschnittstelle.

Daten hinzufügen

Nach der Erstellung Ihres Algolia User Profiles-Kontos wird der Schritt Daten hinzufügen angezeigt. Verwenden Sie sie, um Benutzerprofildaten für die Aufnahme auszuwählen und in der Vorschau anzuzeigen.

  • Geben Sie links optional Indizes und Affinität(en) ein.
  • Zeigen Sie rechts eine Vorschau von bis zu 100 Zeilen mit Benutzerprofilen an.

Wählen Sie anschließend "".

Der Schritt „Daten auswählen“ des Workflows.

Angeben von Datenflussdetails

Wenn Sie einen vorhandenen Datensatz verwenden, wählen Sie einen aus, der mit einem Schema verknüpft ist, das die Algolia Profile Feldergruppe enthält. Stellen Sie sicher, dass das Algolia User Token den Identity-Namespace der Algolia User Token verwendet. Wenn die Algolia User Token derzeit nicht erstellt oder zugewiesen ist, finden Sie unten Anweisungen.

Der Schritt „Vorhandener Datensatz“.

Wenn Sie einen neuen Datensatz erstellen, wählen Sie ein Schema mithilfe der Algolia Profile Feldergruppe aus.

Der neue Datensatzschritt.

Erstellen Algolia User Token Identity-Namespace

Sie müssen den Algolia User Token Identity-Namespace erstellen, falls er noch nicht in Ihrer Organisation vorhanden ist.

Verwenden Sie die linke Navigation und wählen Sie Identitäten aus, um auf den Arbeitsbereich Identity Service der Benutzeroberfläche zuzugreifen, und wählen Sie dann Identity-Namespace erstellen aus.

Geben Sie als Nächstes einen Anzeigenamen und ein Identitätssymbol für Ihren benutzerdefinierten Namespace an. In diesem Schritt müssen Sie auch den Typ Ihres Namespace konfigurieren. Klicken Sie abschließend auf Erstellen.

Bildschirm zum Erstellen von Identity-Namespaces.

Benutzerdefinierte Namespace-Konfiguration
Wert
Anzeigename
Algolia User Token
Identitätssymbol
AlgoliaUserToken
Typ auswählen
Cookie ID

Nach dem Hinzufügen wird der Namespace in der Liste angezeigt. Sie können sie jetzt in Ihrem Schema anwenden.

Erfolgreiche Erstellung des Algolia Identity-Namespace.

Anwenden eines Namespace auf Ihr Schema

Verwenden Sie die linke Navigation und wählen Sie Schemata aus, um auf den Arbeitsbereich Schemata der Benutzeroberfläche zuzugreifen. Verwenden Sie den Arbeitsbereich Schemata , um ein Schema mit der Algolia Profile Details Feldergruppe zu erstellen oder zu aktualisieren. Navigieren Sie dann zum Feld Benutzer-Token und wählen Sie in der rechten Leiste das Feld Identität aus. Verwenden Sie außerdem das Eingabefeld, um den Algolia User Token Identity-Namespace zu definieren. Klicken Sie abschließend auf Speichern.

Identität für Feld festlegen.

Nachdem dem Feld Benutzer-) der Algolia User Token Identity-Namespace zugewiesen wurde, wird die Identität für jedes Profil im Benutzerprofil angezeigt.

Die Benutzeroberfläche für Benutzerprofile.

Zuordnen von Datenfeldern zu einem XDM-Schema

Verwenden Sie die Zuordnungsschnittstelle, um Ihre Quelldaten Schemafeldern zuzuordnen. Weitere Informationen finden Sie im Zuordnungshandbuch.

Der Zuordnungsschritt.

Planen von Aufnahmedurchgängen

Verwenden Sie als Nächstes die Zeitplanungs-Schnittstelle, um den Aufnahmezeitplan Ihres Datenflusses zu definieren.

Der Planungsschritt des Quell-Workflows.

Konfiguration planen
Beschreibung
Häufigkeit

Konfigurieren Sie die Häufigkeit , um anzugeben, wie oft der Datenfluss ausgeführt werden soll. Sie können Ihre Häufigkeit auf Folgendes festlegen:

  • Einmal: Legen Sie für die Häufigkeit once fest, um eine einmalige Aufnahme zu erstellen. Konfigurationen für Intervall und Aufstockung sind beim Erstellen eines einmaligen Aufnahme-Datenflusses nicht verfügbar. Standardmäßig ist die Zeitplanfrequenz auf einmal festgelegt.
  • Minute: Legen Sie für die Häufigkeit minute fest, um Ihren Datenfluss so zu planen, dass Daten pro Minute aufgenommen werden.
  • Stunde: Legen Sie für die Häufigkeit hour fest, um den Datenfluss zu planen und Daten stündlich aufzunehmen.
  • Tag: Legen Sie für Ihre Häufigkeit day fest, um Ihren Datenfluss so zu planen, dass Daten täglich aufgenommen werden.
  • Woche: Legen Sie für Ihre Häufigkeit week fest, um Ihren Datenfluss zu planen und Daten pro Woche aufzunehmen.
Intervall

Nachdem Sie eine Häufigkeit ausgewählt haben, können Sie die Intervalleinstellung konfigurieren, um den Zeitrahmen zwischen jeder Aufnahme festzulegen. Wenn Sie beispielsweise Ihre Häufigkeit auf „Tag“ festlegen und das Intervall auf 15 konfigurieren, wird Ihr Datenfluss alle 15 Tage ausgeführt. Das Intervall kann nicht auf null festgelegt werden. Der akzeptierte Mindestintervallwert für jede Häufigkeit ist wie folgt:

  • Einmal: nicht zutreffend
  • Minute: 15
  • Stunde: 1
  • Tag: 1
  • Woche: 1
Startzeit
Der Zeitstempel für die projizierte Ausführung, dargestellt in UTC-Zeitzone.
Aufstockung
Die Aufstockung bestimmt, welche Daten anfänglich aufgenommen werden. Wenn die Aufstockung aktiviert ist, werden alle aktuellen Dateien im angegebenen Pfad während der ersten geplanten Aufnahme aufgenommen. Wenn die Aufstockung deaktiviert ist, werden nur die Dateien aufgenommen, die zwischen der ersten Aufnahme-Ausführung und der Startzeit geladen werden. Dateien, die vor der Startzeit geladen wurden, werden nicht aufgenommen.

Überprüfen des Datenflusses

Verwenden Sie die Überprüfungsseite für eine Zusammenfassung Ihres Datenflusses vor der Aufnahme. Die Details sind in die folgenden Kategorien unterteilt:

  • Verbindung - Zeigt den Quelltyp, den relevanten Pfad der ausgewählten Quelldatei und die Anzahl der Spalten innerhalb dieser Quelldatei an.
  • Datensatz- und Zuordnungsfelder zuweisen - Zeigt an, in welchen Datensatz die Quelldaten aufgenommen werden, einschließlich des Schemas, dem der Datensatz entspricht.
  • Planung - Zeigt den aktiven Zeitraum, die Häufigkeit und das Intervall der Aufnahme an.

Nachdem Sie Ihren Datenfluss überprüft haben, klicken Sie auf Beenden und gewähren Sie etwas Zeit für die Erstellung des Datenflusses.

Der Überprüfungsschritt des Quell-Workflows.

Nächste Schritte

In diesem Tutorial haben Sie erfolgreich einen Datenfluss erstellt, um Intent-Daten aus Ihrer Algolia in Experience Platform zu übertragen. Weitere Ressourcen finden Sie in der unten beschriebenen Dokumentation.

Überwachen Ihres Datenflusses

Nachdem Ihr Datenfluss erstellt wurde, können Sie die Daten überwachen, die über ihn aufgenommen werden, um Informationen zu Aufnahmegeschwindigkeiten, Erfolg und Fehlern anzuzeigen. Weitere Informationen zum Überwachen von Datenflüssen finden Sie im Tutorial Überwachen von Konten und Datenflüssen in der Benutzeroberfläche.

Aktualisieren des Datenflusses

Um Konfigurationen für die Planung, Zuordnung und allgemeine Informationen Ihrer Datenflüsse zu aktualisieren, besuchen Sie das Tutorial Aktualisieren von Quelldatenflüssen in der Benutzeroberfläche.

Löschen des Datenflusses

Datenflüsse, die nicht mehr erforderlich sind oder nicht korrekt erstellt wurden, können Sie löschen, indem Sie dazu die Funktion Löschen im Arbeitsbereich Datenflüsse verwenden. Weitere Informationen zum Löschen von Datenflüssen finden Sie im Tutorial Löschen von Datenflüssen in der Benutzeroberfläche.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089