Informationen zur Datendatei und den Datenquellen für Kundenattribute

Datendateianforderungen und mehrere Datenquellen für das Hochladen von Kundenattributen in der Experience Cloud.

Sie benötigen Zugriff auf CRM-Daten oder ähnliche Daten aus Ihrem Unternehmen. Die in die Experience Cloud hochzuladenden Daten müssen im .csv-Format vorliegen. Wenn das Upload über FTP oder sFTP erfolgt, wird auch eine .fin-Datei hochgeladen.

Kundenattribute sind für die Verarbeitung einiger Dateien pro Tag ausgelegt. Um das Problem einer großen Anzahl kleiner Dateien zu reduzieren, die die Verarbeitung verzögern, werden Dateien, die innerhalb von 30 Minuten nach einem vorherigen Batch von derselben Organisation gesendet werden, in eine Warteschlange mit niedrigerer Priorität weitergeleitet.

Zulässige Dateitypen und Namensanforderungen section_6F64FA02ACCC4215B0862CB6A1821FBF

Dateityp
Beschreibung
.csv

Eine Datei mit kommagetrennten Werten (z. B. eine in Excel erstellte Datei). Diese Datei enthält die Kundenattributdaten.

Namensanforderungen: Stellen Sie sicher, dass Dateinamenerweiterungen keine Leerzeichen enthalten.

.fin

(Erforderlich) Die .fin-Datei teilt dem System mit, dass das Upload der Daten abgeschlossen ist. .fin- und .csv-Datei müssen den gleichen Namen haben.

Adobe empfiehlt die Erstellung einer leeren Textdatei mit der Erweiterung .fin. Eine leere Datei spart Speicherplatz und Übertragungszeit.

Hinweis: Nach dem Upload darf die .fin-Datei nicht mehr umbenannt werden. Die .fin-Datei muss gesondert hochgeladen werden, und es darf sich nicht um eine schon einmal hochgeladene Datei handeln, die einfach umbenannt wurde.

Nach dem Hochladen der .fin-Datei auf die FTP-Site mit den Kundenattributen ruft das System die Daten unverzüglich ab (innerhalb einer Minute). Dies unterscheidet sich von anderen FTP-Systemen von Adobe, die die Daten weniger häufig sammeln (etwa einmal pro Stunde).

Beim Upload mittels Drag & Drop ist keine .fin-Datei erforderlich.

.gz oder .zip

.gz (gzip) oder .zip – bei komprimierten Dateien. Eine .zip-Datei darf nur eine Datei enthalten.

Namensanforderungen: Die .zip- bzw. .gz-Datei und die .csv-Datei sollten den gleichen Namen haben. Beispiel: Wenn der Name der .csv-Datei crm_klein.csv lautet, sollte der Name der .zip-Datei crm_klein.csv.zip lauten.

Der Name der .fin-Datei muss mit dem Namen der .csv-Datei übereinstimmen.

Voraussetzungen für Attributdatendateien section_169FBF5B7BBA47CE825B7A330CF3FE98

Beispiel-CSV

Die CSV-Datei muss das folgende Format aufweisen:

Voraussetzungen für die Attributdatendateien

Anzeige derselben Datei in einem Texteditor:

Voraussetzungen für die Attributdatendateien

Leitlinien

Element
Beschreibung
Drag & Drop

Die Drag & Drop-Datei sollte kleiner als 100 Megabyte sein.

Beim Upload mittels Drag & Drop ist keine .fin-Datei erforderlich.

Spalte mit Kunden-ID

Die erste Spalte muss eine Unique-Customer-ID sein. Die verwendete ID muss der ID entsprechen, die an den Experience Cloud ID-Dienst übergeben wird.

Bei Analytics wird die ID in einer prop oder eVar gespeichert.

setCustomerID-Wert für Target: (Siehe Analytics und Adobe Target – Synchronisieren der Kunden-ID)

Diese Kunden-ID ist die eindeutige Kennung, die Ihr CRM-System für jede Person in Ihrer Datenbank verwendet. Die übrigen Spalten sind Attribute, die von Ihrem CRM-System stammen. Sie legen fest, wie viele Attribute hochgeladen werden sollen.

Für Spaltenüberschriften werden benutzerfreundliche, lesbare Namen empfohlen. Sie sind jedoch nicht erforderlich. Wenn Sie das Schema nach dem Hochladen validieren, können Sie den hochgeladenen Zeilen und Spalten benutzerfreundliche Namen zuordnen.

Informationen zu Kunden-IDs

In der Regel verwendet ein Unternehmen eine Kunden-ID aus einem CRM-System. Diese ID wird mithilfe des Aufrufs setCustomerIDs festgelegt, wenn sich eine Person anmeldet. Diese ID wird auch als Schlüssel in der CRM-Datei verwendet, die in die Experience Cloud hochgeladen wird. Eine Alias-ID ist ein benutzerfreundlicher Name für einen Datenspeicher in Audience Manager, in dem die Aliasdaten gespeichert werden. Das System sendet Aliase an diesen Datenspeicher (über setCustomerIDs). Die CRM-Datei wird auf die Daten in diesem Datenspeicher angewendet.

Informationen zu setCustomerIDs finden Sie unter Kunden-IDs und Authentifizierungszustände.

Nachfolgende Überschriften und Spalten

Die nachfolgenden Überschriften sollten den Namen der einzelnen Attribute widerspiegeln.

Diese Spalten sollten Kundenattribute enthalten, die aus dem CRM-System stammen.

Attributbeschränkungen

Sie können Hunderte von CSV-Spalten für den Kundenattributservice in die Experience Cloud hochladen. Bei der Konfiguration von Abonnements und der Auswahl von Attributen gelten jedoch je nachdem, welche Programme Sie besitzen, die folgenden Einschränkungen:

  • Analytics Standard: 3 insgesamt
  • Analytics Premium: 200 pro Report Suite
  • Adobe Target Standard: 5
  • Adobe Target Premium: 200
Zeilenbeschränkungen
Für die Anzahl Zeilen ist keine Einschränkung bekannt.
Spaltenbeschränkungen
Die Anzahl Spalten sollte aus praktischen Gründen auf etwa 200 begrenzt werden.
Zeichenbeschränkungen
Beim Erstellen eines Analytics-Abonnements werden die Feldlängen für die hochgeladenen Dateien auf 255 gekürzt.
FTP-Richtlinien und Größenbeschränkungen
  • Die maximale Dateigröße für die Übertragung mittels FTP ist 4 GB pro Upload.
  • Die minimale Dateigröße für jeden Upload-Vorgang ist 10 MB.
  • Sie können jede halbe Stunde eine Datei hochladen.
  • Sie sollten Ihre .csv-Datei (und auch die .fin-Datei) im Stammordner der FTP-Site ablegen.

Wichtig: Der zulässige Gesamtspeicherplatz für das FTP-Konto beträgt 40 GB. Es liegt in Ihrer Verantwortung, verarbeitete Dateien zu löschen.

Dateianforderungen

Jede Attributquelle sollte dieselbe Anzahl kommagetrennter Felder enthalten.

Felder mit Zeilenumbruch, doppelte Anführungszeichen oder Kommas müssen in Anführungszeichen gesetzt werden.

Doppelte Anführungszeichen in einem Feld müssen mit einem umgekehrten Schrägstrich (\) geschützt werden.

Leere Spalten werden als null.

Mehrere Dateien

Wenn Sie Kundenattributdaten in mehrere Dateien in schneller Folge hochladen möchten und die Dateien groß sind, stellen Sie sicher, dass die vorherige Datei verarbeitet wurde, bevor Sie die nächste Datei hochladen. Sie können dies überwachen, indem Sie überprüfen, wann die vorherige Datei in den Ordner mit verarbeiteten oder fehlgeschlagenen Vorgängen innerhalb Ihres FTP-Kontos für Kundenattribute verschoben wurde.

Die Aufspaltung einer großen Datei in kleinere Dateien und deren schnelle Übermittlung kann die Verarbeitung verlangsamen, es sei denn, Sie können sicherstellen, dass jede Datei verarbeitet wird, bevor Sie die nächste versenden.

Zeichenkodierung
Für Japan ist UTF-8 obligatorisch.
Historische Daten

Kundenattribute sind an das zugrunde liegende Besucherprofil in Analytics gebunden. Als solche sind Kundenattribute mit dem Besucher für die gesamte Lebensdauer dieses Besucherprofils in Analytics verknüpft. Dies umfasst das Verhalten, das vor der erstmaligen Anmeldung des Kunden aufgetreten ist.

Wenn Sie die Data Warehouse-Methode zum Aufstocken verwenden, sind die Daten an einen post_visid_high/low-Wert gebunden, der auf der Analytics-ID (AID) basiert. Wenn Sie den Experience Cloud ID-Dienst verwenden, sind die Daten an einen post_visid_high/low-Wert gebunden, der auf Experience Cloud ID (MID) basiert.

Beachten Sie, dass die Aufstockungsmethode für Data Warehousen ab Oktober 2022 nicht mehr verfügbar sein wird.

Datenfeeds
Kundenattribute sind in Datenfeeds nicht verfügbar.

Verwenden verschiedener Datenquellen section_76DEB6001C614F4DB8BCC3E5D05088CB

Beim Erstellen, Ändern oder Löschen von Kundenattributquellen dauert es ca. eine Stunde, bis die IDs mit der neuen Datenquelle synchronisiert werden.

Die Alias-ID für jede Kundenattributquelle muss eindeutig sein. Wenn Sie über mehrere Datenquellen verfügen, die dieselbe ID verwenden, sollten diese wie folgt eingerichtet werden:

In VisitorAPI.js oder dem Experience Cloud ID-Tool im dynamischen Tag-Management:

Legen Sie zwei Kunden-IDs fest, die mit den entsprechenden Datenquellen übereinstimmen:

Visitor.setCustomerIDs({
     "ds_id1":"123456",
     "ds_id2":"123456"
});

(Weitere Informationen finden Sie unter Kunden-IDs und Authentifizierungszustände).

In der Experience Cloud > Personen > Kundenattribute:

Erstellen Sie zwei Kundenattributquellen mit eindeutigen Alias-IDs, die den Kunden-IDs oben entsprechen. Mithilfe dieser Methode kann dieselbe Referenz-ID an mehrere Kundenattributquellen gesendet werden.

recommendation-more-help
872fc4ed-f5f7-4b59-a6f8-4ddabe5aac1f