Profildaten senden

Entwickler können für Kunden zwei Wege einrichten, um Käuferprofil-Attribute an Einstein zu senden: Massen-Upload oder Aktivitätsverfolgung in Echtzeit. Sie können eine der Methoden (oder beide) verwenden, um Käuferprofildaten an Einstein zu senden.

Beachten Sie bei der Übermittlung von Daten an Einstein Folgendes:

Salesforce empfiehlt dringend, keine anderen personenbezogenen Daten an Einstein zu senden als die angegebenen empfohlenen Benutzerkennungen.
Alle erfassten Daten werden intern bis zu einem Jahr lang gespeichert. Nach Ablauf dieses Jahres gelten die Daten als veraltet und werden aus allen Einstein Datenbanken entfernt. Um diese Profildaten weiter zu verwenden, müssen Sie sie erneut an Einstein senden.
Wenn Einstein neuere Werte für bestehende Käuferprofil-Attribute erhält, werden die neueren Werte an die bestehenden Werte angehängt.
Einstein nutzt alle angegebenen Profildaten. Neue Daten werden nicht anders bewertet als bereits vorhandene Daten.

Massen-Upload

Salesforce bietet einen sicheren Endpunkt für den Massen-Upload, über den Kunden alle historischen Käuferprofildaten, die sie erfasst haben, hochladen können.

Die Massen-Upload-Option ist für folgende Zwecke gedacht:

Alle Käuferprofil-bezogenen Daten, die Sie verfolgt und erfasst haben.
Alle Daten von vertrauenswürdigen Drittanbietern, die Einstein für eine zusätzliche Käuferpersonalisierung verwenden soll.

Autorisierung

Das Hochladen großer Datenmengen kann erhebliche Auswirkungen auf die Daten in Einstein haben. Aus diesem Grund gestatten wir nur autorisierten Benutzern, große Datenmengen hochzuladen. Darüber hinaus muss jeder Upload-API-Aufruf ein von Account Manager erhaltenes erforderliches Autorisierungs-Header-Zugriffstoken (Bearer) übergeben.

Hinweis: Um die Belastung des Account Manager-Servers zu reduzieren, sollten Sie keine neuen Token generieren, bis das aktuelle Token abgelaufen ist. Weitere Informationen zu Aufrufen der Massen-Upload-API finden Sie in der API-Spezifikation.

Vorbereitung des Massen-Uploads von Daten

Stellen Sie sicher, dass Folgendes zutrifft, um den Massen-Upload von Daten zur Nutzung in Einstein vorzubereiten:

Bei der Massendatei handelt es sich um eine TSV-Datei (gzip, durch Registerkarten getrennte Werte).
Die TSV-Datei ist ordnungsgemäß formatiert und mit der Zeichencodierung UTF-8 gespeichert.
Der Mimetype der Datei ist zur Verwendung durch die gzip-Anwendung korrekt festgelegt.
Die Header-Zeile muss das ID-Feld login_id, das ID-Feld email_address oder beide enthalten.
Sie können weitere Spalten für jedes Käuferprofil-Attribut hinzufügen, das Sie senden möchten.
Werte sind entweder Zeichenfolgen oder Listen von Zeichenfolgen. Bei einer Liste von Zeichenfolgen müssen Sie die Werte unbedingt durch das Pipe-Trennzeichen (|) voneinander trennen. Beispiel: orange|yellow.
Leere Spalten werden ignoriert. Wenn Einstein eine leere Spalte erkennt, wird diese Spalte übersprungen und die Verarbeitung der verbleibenden Benutzerattributdaten fortgesetzt.

Massen-Upload von Benutzerkennungen

Um relevante Produktempfehlungen für jeden Käufer zu generieren, benötigt die Profile Connector API eine oder mehrere dieser Benutzerkennungen zur Identifizierung der Käufer beim Massen-Upload.

Feld	Beschreibung
login_id	Anmelde-ID des Käufers. In einigen Fällen ist dieser mit dem Wert email_address identisch.
email_address	Die vollständige E-Mail-Adresse des Käufers. Beispiel: Käufer1@somewhere.com.

Massen-Upload von Daten – Beispiel

Nachfolgend finden Sie ein Beispiel für den Massen-Upload von TSV-Daten mit zufälligen Spaltennamen für ein Käuferprofil:

login_id	email_address	Geschlecht	Farben	brand_list
Käufer1	shopper1@somewhere.com	männlich	orange\|gelb	MarkeA\|MarkeB
Käufer2	shopper2@somewhere.com	weiblich	blau\|schwarz	MarkeD
Käufer3	shopper3@somewhere.com	weiblich	rot\|schwarz\|lila	MarkeB\|MarkeE

Einschränkungen des Massen-Upload-Endpunkts für Käufer

Wenn Sie einen Massen-Upload von Käuferprofilen durchführen, beachten Sie die folgenden Einschränkungen für die Endpunkte:

Sie können immer nur eine Datei auf einmal hochladen. Sie können jedoch auch mehrere Dateien nacheinander hochladen.
Die maximal zulässige Dateigröße beträgt 2 GB.

Hochladen von großen Datenmengen aus Käuferprofilen in Einstein

Nachdem Sie die Dateien mit den großen Datenmengen der Käuferprofile vorbereitet haben, komprimieren Sie jede einzelne Datei mit gzip und laden sie in den Massen-Upload-Endpunkt für Käuferprofile von Einstein hoch. Weitere Informationen finden Sie im Kapitel Send bulk profile endpoint (Senden des Massen-Upload-Endpunkts).

Aktivitätsverfolgung in Echtzeit

Sie können die Aktivität updateProfile tracking endpoint verwenden, um Käuferprofile in Echtzeit aufzurufen und Aktualisierungen und Einstellungen in Echtzeit zu senden. Durch die Erfassung von Informationen, die ein Käufer in Ihrer Storefront in Echtzeit angibt, können diese Änderungen bei Empfehlungen sofort berücksichtigt werden.

Die Echtzeit-Aktivitätsverfolgungsoption ist für folgende Zwecke gedacht:

Erfassen von Käuferpräferenz-Aktivitäten in Echtzeit
Aktualisierung des Käuferprofils in Echtzeit

Um relevante Produktempfehlungen für jeden Käufer zu generieren, stellt die Profile Connector API zwei Benutzerkennungen für die Identifizierung von Käufern in Echtzeit zu Verfügung.

cookieId (erforderlich) – Eindeutige Kennung eines anonymen Käufers. In der Regel ist die cookieId der Wert eines Erstanbieter-Cookies.
- Wenn Sie API-Anfragen von einer herkömmlichen Commerce Cloud-Storefront aus stellen, übergeben Sie den Cookie-Wert cqcid, um die automatische Aktivitätsverfolgung für die herkömmliche Storefront abzugleichen. Weitere Informationen finden Sie unter Browser-Based Local Data Storage (Browserbasierter lokaler Datenspeicher).
- Wenn Sie OCAPI oder die Salesforce Commerce API nutzen, verwenden Sie den Wert visit_id aus der Antwort auf die Gastanmeldung für den Abgleich automatischer Aktivitäten. Weitere Informationen finden Sie im OCAPI Customer Document (OCAPI-Kundendokument).
userId (empfohlen) – Eindeutige Kennung eines angemeldeten Käufers. Dieser Parameter ermöglicht es Einstein, den gleichen angemeldeten Benutzer auf mehreren Geräten zu verknüpfen.
- Wenn Sie API-Anfragen von einer herkömmlichen Commerce Cloud-Storefront aus stellen, verwenden Sie den Cookie-Wert cquid, um die automatische Aktivitätsverfolgung für die herkömmliche Storefront abzugleichen. Weitere Informationen finden Sie unter Browser-Based Local Data Storage (Browserbasierter lokaler Datenspeicher).
- Wenn Sie OCAPI oder die Salesforce Commerce API nutzen, verwenden Sie den Wert hashed_login aus der Antwort auf die registrierte Anmeldung für den Abgleich automatischer Aktivitäten. Weitere Informationen finden Sie im OCAPI Customer Document (OCAPI-Kundendokument).

Um potenzielle böswillige Aktivitäten zu vermeiden, dürfen die Parameter der Benutzerkennungen nicht fortlaufend sein. Die Parameter sollten keine laufenden Nummern, Muster, IP-Adressen, E-Mail-Adressen, Namen oder sonstige mit einer bestimmten Person verbundenen Angaben enthalten. Alle Benutzerkennungsparameter müssen durch Hashing oder andere Methoden der Datenschutz-Grundverordnung (DSGVO) entsprechen.

Note