Sie befinden sich hier:
Benutzerprofilobjekt-ETL-Datenfeed
Aktualisieren Sie mithilfe des ETL-Datenfeeds für Benutzerprofilobjekte die von Ihnen erstellten Benutzerprofilobjekte.
Informationen zur Aufnahme von Benutzerprofilobjektdaten
Beim Zusammenführen von Benutzerprofilen werden durch die Personalisierung alle Benutzerprofilobjekte an das neue kombinierte Benutzerprofil angehängt. Wenn die resultierende Anzahl der Benutzerprofilobjekte für einen Objekttyp die Obergrenze von 100 überschreitet, behält die Personalisierung die 100 neuesten Objekte basierend auf ihrem Erstelldatum bei.
Eine freigegebene Objekt-ID führt nicht zum Zusammenführen von Benutzerprofilen. Wenn die Personalisierung Benutzerprofile zusammenführt, die eine gemeinsame Objekt-ID aufweisen, werden das zuletzt erstellte Benutzerprofilobjekt und seine Metadaten beibehalten.
Anforderungen
- ETL-Dateien müssen im CSV-Dateiformat vorliegen, das dem Schema für den Datenfeed entspricht. Dateien, die nicht den Dateibenennungskonventionen oder dem entsprechenden Schema entsprechen, führen zu Fehlern und können nicht verarbeitet werden.
- Bevor Sie einen ETL-Datenfeed für ein Benutzerprofilobjekt hochladen, überprüfen Sie, ob das Benutzerprofilobjekt auf der Seite "Katalog- und Profilobjekte" konfiguriert und aktiviert ist. Fügen Sie dem Benutzerprofilobjekt außerdem alle relevanten verwandten Katalogobjekte und Attribute hinzu.
Hinweis Wenn die ETL-Datei Daten für ein Benutzerprofilobjekt, ein verwandtes Katalogobjekt oder ein Attribut enthält, das nicht konfiguriert ist, wendet die Personalisierung diese Daten nicht an. Konfigurieren Sie Benutzerprofilobjekte, verwandte Katalogobjekte und Attribute, bevor Sie die ETL-Datei hochladen. - Überprüfen Sie die Obergrenzen für Benutzerprofilobjekte, bevor Sie Benutzerprofilobjektdaten hochladen.
- Wenn ein ETL-Datenfeed dazu führt, dass ein Benutzerprofil 100 Benutzerprofilobjekte eines bestimmten Typs überschreitet, behält die Personalisierung die 100 neuesten Objekte bei.
- Die ETL-Datei des Benutzerprofilobjekts weist ein eindeutiges Spaltenüberschriftsformat für Identitätsattribute auf. Statt wie in anderen ETL-Dateien
attribute:zu verwenden, verwenden SieidentityAttribute:. - Benutzerprofilobjekt-ETL-Dateien müssen vor dem Hochladen nach Identität sortiert werden, damit alle einem Benutzer zugeordneten Objekte gruppiert werden. Wenn Sie das System mit mehreren Identitäten nicht verwenden, sortieren Sie die Datei nach userId. Wenn Sie das System mit mehreren Identitäten verwenden:
- Sortieren Sie die Datei so, dass alle Objekte für jeden Benutzer gruppiert sind.
- Wenn mehrere Identitätsattributspalten in der Datei vorhanden sind und ein Benutzer in mehreren Zeilen angezeigt wird, müssen für jede dieser Zeilen dieselben Identitätswerte vorhanden sein. Wenn Sie beispielsweise eine Leasing-Profilobjektdatei hochladen und ein einzelner Benutzer über mehrere Leasing-Objekte verfügt, muss jede Zeile dieselben Identitätsattributwerte für diesen Benutzer enthalten. Wenn sich also vier Identitätsattributspalten in der Datei befinden und der Benutzer über Werte für drei von ihnen verfügt, müssen diese drei Werte in jeder Zeile für diesen Benutzer vorhanden sein. Wenn die Identitätswerte für einen Benutzer nicht zeilenübergreifend konsistent sind, können Daten überschrieben, falsch angewendet oder ignoriert werden.
- Jede ETL-Datei des Benutzerprofilobjekts kann nur auf einen einzelnen Objekttyp verweisen. Der Objekttyp ist im Dateinamen definiert und muss dem Benutzerprofilobjektnamen auf der Seite "Katalog- und Profilobjekte" zugeordnet werden. Wenn Sie also vier Benutzerprofilobjekte auf der Seite "Katalog- und Profilobjekte" konfiguriert haben und Daten für jedes Objekt hochladen möchten, benötigen Sie eine Datei für jeden Objekttyp.
- Fügen Sie Informationen in alle Spalten für ein Benutzerprofilobjekt ein, auch wenn sich die Daten nicht ändern. Wenn Sie eine Spalte leer lassen, löscht die Personalisierung den vorhandenen Wert für das Benutzerprofilobjekt. Um einen vorhandenen Wert beizubehalten, müssen Sie ihn in die Datei aufnehmen.
- Die Objekttyp-ID und der Dateimodus sind entscheidend für die Verarbeitung der Informationen in der Datei durch die Personalisierung.
- Anhand der Dateinummer am Ende des Dateinamens können Sie Aktualisierungen an Benutzerprofilobjekten verfolgen. Dies wirkt sich nicht darauf aus, wie die Datei ausgeführt oder verarbeitet wird.
- Feldnamen, die mit
attribute:beginnen, müssen mit den benutzerdefinierten Attributnamen im Abschnitt "Attribute" der Seite "Katalog- und Profilobjekte" für dieses Benutzerprofilobjekt übereinstimmen. Feldnamen, die mitidentityAttribute:beginnen, müssen mit den Namen benutzerdefinierter Attribute auf der Seite "Einstellungen" > "Identitätstypen" übereinstimmen.
Delta- und Ersetzungsmodi
Die ETL-Datei des Benutzerprofilobjekts weist zwei Modi auf: delta und ersetzen. Der Dateimodus ist im Dateinamen definiert.
| Modus | Beschreibung |
|---|---|
| Delta-Modus |
|
| Ersetzen-Modus |
|
Dateinamenformat
user-profile-objects-<objectTypeId>-<delta/replace>-<file
number>.csv
Schema
| Feldname | Beschreibung | Beispielwerte | Maximale Länge | Datentyp |
|---|---|---|---|---|
|
Pflichtangabe. Nur eindeutige Identitäten können über einen ETL-Feed aufgenommen und aktualisiert werden. Dieses Feld muss mindestens vier Zeichen lang sein. Wenn Sie das System für mehrere Identitäten der Personalisierung nicht verwenden, muss eine Benutzer-ID enthalten sein. Bei dieser ID muss es sich um eine ID handeln, die im System verfolgt wird, damit die Ereignisse mit dem jeweiligen Benutzerprofil verknüpft werden können. Wenn Sie das System für mehrere Identitäten der Personalisierung verwenden, wird in ETL-Dateien nicht auf Das richtige Kopfzeilenformat für Identitätsattribute ist |
jdoe john.doe@example.com C2e384084c8ac233 identityAttribute:emailAddress identityAttribute:sfmcContactKey identityAttribute:customerId identityAttribute:sfcrmContactId identityAttribute:sfcrmLeadId |
120 |
Zeichenfolge |
objectId
|
Für jedes Objekt für einen Benutzer ist eine Objekt-ID erforderlich, die von der Personalisierung für Aktualisierungen und Ersetzungen verwendet wird. Die Eine Objekt-ID muss alphanumerisch sein und darf nur Buchstaben, Zahlen, Bindestriche und Unterstriche enthalten. Eine Objekt-ID kann über mehrere Benutzer hinweg vorhanden sein. |
mortgage1 lease1 case123 |
30 |
Zeichenfolge |
attribute:<attribute name>
|
Die benutzerdefinierten Attribute für das Benutzerprofilobjekt. Das Attribut muss auf der Seite "Katalog- und Profilobjekte" vorkonfiguriert sein. Der ETL-Datenfeed kann kein Attribut für ein Benutzerprofilobjekt erstellen. Spaltenüberschriften beginnen mit Wenn Sie eine Attributspalte leer lassen, löscht die Personalisierung den vorhandenen Wert für das Objekt. Um einen vorhandenen Wert beizubehalten, müssen Sie ihn in die Datei aufnehmen, auch wenn er sich nicht ändert. |
Zeichenfolge:
Integer/Decimal:
Boolean:
Datum:
Das Format ist eine Datums-/Uhrzeitzeichenfolge nach ISO 8601. Zeitzonenverschiebungen werden nicht unterstützt. |
Abhängig vom Datentyp |
Zeichenfolge, Dezimalzeichen, boolesch, Ganzzahl, date |
|
Die verwandten Katalogobjekte, die für das Benutzerprofilobjekt konfiguriert sind. Das zugehörige Katalogobjekt muss dem Benutzerprofilobjekt auf der Seite "Katalog- und Profilobjekte" zugewiesen sein. Wenn ein verwandtes Katalogobjekt in der Datei dem Benutzerprofilobjekt nicht zugewiesen ist, wird es von der Personalisierung ignoriert. Spaltenüberschriften beginnen mit "relatedCatalogObject:" und gefolgt vom Namen des Katalogobjekts. Wenn die Kardinalität des zugehörigen Katalogobjekts "Viele pro Element" lautet, trennen Sie die Werte durch das Pipeline-Symbol (|). |
Hypothekenbeispiel: Produkt: creditCard|debitCard MortgageType: fixedRateMortgage Beispiel für Autoleasing: CarMake: carMake1 CarModel: carModel1 |
255 |
Zeichenfolge |
remove
|
Fügen Sie zum Löschen eines Benutzerprofilobjekts aus einem Benutzerprofil die Spaltenüberschrift "entfernen" ein und legen Sie den Wert auf true fest. Wenn die Kopfzeile "entfernen" vorhanden und leer ist, ist der Standardwert false. Sie können ein Benutzerprofilobjekt nicht wiederherstellen, nachdem es gelöscht wurde. |
TRUE true |
1023 |
Zeichenfolge |
Beispieldateistruktur: Nichtverwendung des Systems mit mehreren Identitäten
user-profile-objects-Lease-delta-1.csv
| userId | objectId | attribute:startDate | attribute:endDate | attribute:Kilometerstand | attribute:active | relatedCatalogObject:Make | relatedCatalogObject:Modell | relatedCatalogObject:Jahr | entfernen |
jdoe123 |
lease1 |
2022-01-01T00:00:00.000Z |
2024-01-01T00:00:00.000Z |
30000 |
TRUE |
Jeep |
Wrangler |
2022 |
|
jdoe123 |
lease2 |
2022-01-01T00:00:00.000Z |
2024-01-01T00:00:00.000Z |
50000 |
TRUE |
Jeep |
Grand Cherokee |
2022 |
|
user103925 |
lease3 |
2022-01-01T00:00:00.000Z |
2026-01-01T00:00:00.000Z |
75000 |
TRUE |
Chrysler |
Pacifica |
2022 |
|
a30bkcqfo941afc |
lease4 |
2022-01-01T00:00:00.000Z |
2026-01-01T00:00:00.000Z |
50000 |
TRUE |
Ford |
Ranger |
2022 |
|
personalizationuser |
lease5 |
TRUE |
Beispieldateistruktur: Verwenden des Systems mit mehreren Identitäten
user-profile-objects-Mortgage-delta-1.csv
| userId | objectId | attribute:startDate | attribute:endDate | attribute:APR | attribute:active | relatedCatalogObject:Mortgage | relatedCatalogObject:Product | entfernen |
jdoe123 |
mortgage1 |
2022-01-01T00:00:00.000Z |
2024-01-01T00:00:00.000Z |
0.4 |
TRUE |
fixedRateMortgage |
debitCard |
|
jdoe123 |
mortgage2 |
2022-01-01T00:00:00.000Z |
2024-01-01T00:00:00.000Z |
0,25 |
TRUE |
adjustableRateMortgage |
creditCard |
|
user103925 |
mortgage3 |
2022-01-01T00:00:00.000Z |
2026-01-01T00:00:00.000Z |
0.3 |
TRUE |
conventionalLoan |
creditCard |
|
a30bkcqfo941afc |
mortgage4 |
2022-01-01T00:00:00.000Z |
2026-01-01T00:00:00.000Z |
0.35 |
TRUE |
fixedRateMortgage |
debitCard |
|
personalizationuser |
mortgage5 |
TRUE |
