Sie können Produkt Events aus einer CSV- oder XLSX-Datei in Positive User importieren, um mehrere Datensätze schneller und effizienter hinzuzufügen. So vermeiden Sie die manuelle Einrichtung und können strukturierte Event-Daten einfacher in die Plattform übertragen. In diesem Artikel erfahren Sie, wie Sie Ihre Datei vorbereiten und Produkt Events korrekt importieren.
Bevor Sie starten, stellen Sie sicher, dass Ihre Datei korrekt strukturiert ist und dass Sie verstehen, wie Daten in Positive User gespeichert werden. Die Plattform verwendet sowohl Standard-Attribute (integrierte Felder wie E-Mail-Adresse oder Telefonnummer) als auch benutzerdefinierte Attribute (Felder, die Sie selbst erstellen).
Herkunft der Produkte: Legen Sie eine Strategie für die Produktverwaltung fest: wie neue Produkte in der App erstellt werden sollen, wie Sie diese aktualisieren möchten und wie Sie neue Produkt Event-Vorkommen senden.
Arten von Produkt Events: Prüfen Sie die Liste der verfügbaren Produkt Event-Typen in diesem Artikel. Andere Typen können nicht in den Workspace importiert werden.
Standard-Attribute zuordnen: Wenn die Spalten Ihrer Tabelle mit Standard-Attributen übereinstimmen, können Sie die Datei sofort importieren.
Benutzerdefinierte Attribute erstellen: Wenn Sie zusätzliche Informationen einbeziehen möchten, die standardmäßig nicht unterstützt werden, müssen Sie zunächst die entsprechenden benutzerdefinierten Attribute erstellen. Folgen Sie den Schritten in „So erstellen Sie ein benutzerdefiniertes Attribut".
Datentypen überprüfen: Stellen Sie sicher, dass jede Spalte den richtigen Attributwerttyp hat. Wenn Sie beispielsweise „Scoring" importieren möchten, muss Ihr Attribut vom Typ Integer sein. Wenn Sie ein „Datum" importieren möchten, muss das Attribut als Datetime festgelegt sein. Weitere Informationen zu den einzelnen Datentypen finden Sie unter „Was ist ein Attribut".
Stellen Sie vor dem Hochladen sicher, dass Ihre Datei korrekt formatiert ist. Wenn Sie sich nicht sicher sind, wie Ihre Datei aussehen soll, können Sie eine fertige Vorlage direkt aus der App herunterladen, indem Sie im Bereich „Daten" → „Import" auf die Schaltfläche „xlsx" oder „csv" klicken.
Weitere Tipps zur Datenformatierung finden Sie in unserem speziellen Artikel.
Pflichtfelder
Beim Import von Produkt Events laden Sie bestimmte Produkt Event-Vorkommen in zwei Verläufe hoch: den des Kontakts, der sie durchgeführt hat, und den des Produkts, mit dem interagiert wurde (z. B. der Kaufverlauf eines bestimmten Produkts). Deshalb ist es zwingend erforderlich, jedes Vorkommen mit einem bestimmten Kontakt und einem bestimmten Produkt zu verknüpfen. Dies erfolgt über „user_id"/„email" des Kontakts und „product_id" für das Produkt.
Das Feld „product_id" sollte niemals eine einfache Ganzzahl sein. Wir empfehlen dringend, sie zu kodieren.
Die Datei muss folgende Spalten enthalten:
product_id (benutzerdefinierte ID des Produkts aus Ihrer Datenbank)
user_id / email (Kennung des Kontakts, der die Aktion durchgeführt hat)
timestamp (Zeitstempel des Event-Vorkommens im ISO 8601-Format, z. B. 2017-07-25T14:14:08.612Z)
event_type (aus der Liste)
Die Angabe des Produktnamens ist optional. Wenn Sie ihn nicht angeben und das Produkt noch nicht existiert, wird das Produkt ohne Namen erstellt.
Spaltenüberschriften
Fügen Sie in der ersten Zeile Ihrer Datei immer Spaltenüberschriften ein. Vergeben Sie für Ihre Spalten möglichst genau dieselben Namen wie die bereits in Positive User vorhandenen Attribute. Wenn der Spaltenname mit dem Attributnamen identisch ist, ordnet das System sie beim Import automatisch zu.
Kodierung
Was ist Kodierung? Die Kodierung teilt dem Computer mit, wie die Textzeichen in Ihrer Datei zu interpretieren sind. Das Standardformat und dringend empfohlene Format ist UTF-8. Mit UTF-8 stellen Sie sicher, dass Sonderzeichen, Akzente und Symbole korrekt importiert werden und nicht in unlesbare Zeichen umgewandelt werden.
Trennzeichen
Was ist ein Trennzeichen? In CSV-Dateien (Comma Separated Values) ist ein Trennzeichen das Satzzeichen, das Ihren Text in einzelne Tabellenspalten unterteilt. Gängige Trennzeichen sind Kommas (,) oder Semikolons (;).
Prüfen Sie, wie Ihre Tabellenkalkulationssoftware die Datei exportiert hat, und stellen Sie sicher, dass Sie wissen, welches Zeichen Ihre Daten trennt.
Felder mit mehreren Werten
Wenn eine Spalte mehrere Werte enthält (zum Beispiel ein Attribut vom Typ „Feste Auswahl" mit mehreren zulässigen Werten), trennen Sie diese mit dem Pipe-Zeichen: „|"
Beispiel: Wert1|Wert2|Wert3
Wenn Sie aus Excel exportieren, stellen Sie sicher, dass Sie für jede Zelle die richtigen Datenformate festlegen.
Gehen Sie zu „Daten" → „Importers" und wählen Sie „Produkt Events importieren".
Laden Sie die Datei hoch oder ziehen Sie sie per drag & drop.
Wählen Sie die zu Ihrer Datei passende Kodierung (UTF-8 ist die Standardeinstellung).
Wählen Sie das in Ihrer Datei verwendete Trennzeichen.
In diesem Schritt ordnen Sie die Spaltenüberschriften aus Ihrer Datei den vorhandenen Attributen in Positive User zu.
Automatische Zuordnung: Wenn der Name der Spalte in Ihrer Datei exakt mit dem Attributnamen im System übereinstimmt, werden sie automatisch zugeordnet.
Manuelle Zuordnung: Wählen Sie bei nicht zugeordneten Spalten einfach das passende vorhandene Attribut aus dem Dropdown-Menü aus, um sie zu verknüpfen.
Stellen Sie sicher, dass Sie alle Spaltenüberschriften mit Attributen verknüpfen! Nicht zugeordnete Spalten werden nicht importiert!
Sobald alle Spalten Ihrer Datei mit Attributen verknüpft sind, klicken Sie auf „Weiter". Sie werden zum Schritt „Bestätigung" weitergeleitet.
Im Schritt „Bestätigung" prüfen Sie die Zusammenfassung des Imports und bestätigen den Vorgang. Nach der Bestätigung beginnt das System mit der Verarbeitung Ihrer Datei.
Sie können den Import-Vorgang verfolgen und die endgültigen Ergebnisse im Bereich „Import-Ergebnisse" einsehen, zu dem Sie automatisch weitergeleitet werden.
Sie können diesen Bereich jederzeit über den Pfad „Daten" → „Importers" → „Import-Ergebnisse" aufrufen.
Hier sehen Sie:
Import-Status (Gestartet/Ausstehend/Abgeschlossen/Archiviert)
Erstellungsdatum
Abgeschlossen am
Typ (welche Art von Daten importiert wurde)
Erstellt von (Nutzer, der die Datei hochgeladen hat)
Dateiname
Gesamtzeilen (aus Ihrer Datei)
Erfolgreich (endgültige Anzahl importierter Zeilen)
Fehlgeschlagen (zeigt die Anzahl der Fehler)
Wenn beim Import etwas schiefgeht, klicken Sie auf den Dateinamen, um einen detaillierten Fehlerbericht anzuzeigen.
Passen Sie Ihre Produktdaten an, indem Sie Attribute hinzufügen, die zu Ihren geschäftlichen Anforderungen passen, um präzisere Auswertungen und Analysen zu ermöglichen.
Positive User speichert keine historischen Werte von Produkt Event-Attributen (mit Ausnahme von event_type). Jedes neue Produkt Event aktualisiert die aktuellen Attributwerte im Produktprofil. Das bedeutet, dass ältere Werte überschrieben werden.
