Auf dieser Seite Sie, wie Sie mit der Aktivität Dateidaten-Management laden eine orchestrierte Kampagnenzielgruppe aus einer externen CSV- oder TXT-Datei zur Ausführungszeit ansprechen können, ohne die Datei in Adobe Experience Platform aufzunehmen.
Die Aktivität Datei laden ist eine Daten-Management-Aktivität. Verwenden Sie diese Option, um mit Profilen und Daten zu arbeiten, die in einer externen Datei gespeichert sind. Es unterstützt dateibasiertes Targeting in orchestrierten Kampagnen, wenn Ihre Empfängerliste von einem externen System stammt (z. B. einem CRM-Export oder einer Partnerdatei) und Sie eine Kampagne ausführen möchten, ohne zuvor eine vollständige Adobe Experience Platform-Aufnahme-Pipeline zu erstellen.
Während der Dateieinrichtung können Sie Spaltenzuordnungen, Datentypen, die NULL-Verarbeitung und Fehlerrichtlinien pro Spalte definieren. Zeilen, die bei der Validierung fehlschlagen, werden abgelehnt und protokolliert, bevor die Kampagne ausgeführt wird. Dadurch wird die Zielgruppe ohne manuelle Vorverarbeitung sauber gehalten.
Berechtigungen permissions
Um die Aktivität Datei laden in einer orchestrierten Kampagne verwenden zu können, müssen Benutzenden die richtigen Berechtigungen zugewiesen werden. Beide Berechtigungen sind in der Benutzeroberfläche für Berechtigungen unter Adobe Experience Platform > Adobe Journey Optimizer > Orchestrierte) verfügbar.
- Datei in orchestrierten Kampagnen anzeigen - Gewährt schreibgeschützten Zugriff. Benutzer mit dieser Berechtigung können die Ergebnisse einer orchestrierten Kampagne, die eine Aktivität Datei laden enthält, in der Vorschau anzeigen, aber keine Aktivität hinzufügen oder eine Datei hochladen.
- Datei in orchestrierten Kampagnen verwalten - Erforderlich, um eine Aktivität Datei laden zur Kampagnenfläche hinzuzufügen und Dateien hochzuladen. Weisen Sie diese Berechtigung allen Benutzern zu, die eine Aktivität vom Typ „Datei laden erstellen oder müssen.
Anweisungen zum Zuweisen von Berechtigungen finden Sie unter Verwalten von Benutzern und Rollen.
Leitlinien und Einschränkungen limitations
Die folgenden Einschränkungen gelten für die Aktivität Datei laden :
- Sie können bis zu 50 MB pro Datei hochladen.
- Es werden nur CSV- und TXT-Dateien mit flachen Strukturen unterstützt.
- Hochgeladene Daten werden bei der Kampagnenausführung verwendet und nicht als Adobe Experience Platform-Datensatz gespeichert.
Einschränkungen für Kanal- und Arbeitsflächen-Aktivitäten finden Sie unter Leitplanken und Einschränkungen.
Voraussetzungen prerequisites
Bevor Sie eine Aktivität Datei laden zu einer orchestrierten Kampagne hinzufügen und sie mit einer Nachrichtenaktivität verbinden können, muss ein Administrator die folgende einmalige Einrichtung durchführen.
Erstellen einer Zieldimension vom Typ Datei file-target-dimension
Mit Profil-Ziel-Dimension vom Typ Datei können orchestrierte Kampagnen Empfänger aus einer hochgeladenen Datei anstelle eines Adobe Experience Platform-Schemas auflösen. Er definiert den Identity-Namespace und das Kennungsfeld, die bei der Verarbeitung der Audience-Datei bei der Kampagnenausführung verwendet werden.
Erstellen Sie eine Zieldimension unter Administration > Konfigurationen > Campaign Target Dimension. Erfahren Sie mehr über Zieldimensionen
Achten Sie beim Erstellen der Zieldimension für dateibasiertes Targeting auf Folgendes:
- Legen Sie Dimension-Quelle auf "".
- Wählen Sie den Identity-Namespace aus, der der Kennungsspalte in Ihren Dateien entspricht, z. B „E-Mail.
- Geben Sie den Identitätsfeldpfad ein. Verwenden Sie das Dateifeld, das die Kennung enthält, z. B.
emailwenn Ihre hochgeladenen Dateien eineemailSpalte enthalten.
Erstellen einer Kanalkonfiguration für den dateibasierten Versand file-channel-configuration
Erstellen Sie eine dedizierte Kanalkonfiguration, die die Zieldimension vom Typ Datei verwendet. Diese Konfiguration wird in der Nachrichtenaktivität ausgewählt, die der Aktivität Datei laden auf der Kampagnen-Arbeitsfläche folgt.
-
Navigieren Sie zu Administration > Kanäle > Kanalkonfigurationen und erstellen Sie eine neue Konfiguration.
-
Wählen unter „Ausführungsdetails die Registerkarte Orchestrierte Kampagnen und aktivieren Sie die Konfiguration für orchestrierte Kampagnen.
-
Wählen Sie Feld Profil-Dimension die im vorherigen Schritt erstellte Zieldimension „Dateityp“ aus.
-
Füllen Sie die verbleibenden Kanalkonfigurationsfelder aus und speichern Sie. Erfahren Sie mehr über Kanalkonfigurationen für orchestrierte Kampagnen
Konfigurieren der Aktivität „Datei laden“ load-file-configuration
Konfigurieren Sie die Aktivität in zwei Teilen: Definieren Sie die erwartete Dateistruktur mit einer Beispieldatei und geben Sie dann die Datei an, die bei der Ausführung der Kampagne geladen werden soll.
-
Fügen Sie orchestrierten Kampagnen Arbeitsfläche die Aktivität „Datei laden“ hinzu.
-
Geben Sie einen Titel für die Aktivität ein.
Definieren der Beispieldatei sample-file
Verwenden Sie eine Beispieldatei zum Konfigurieren von Spalten und Formatierung. Die Beispieldaten werden nicht als Kampagnen-Audience importiert.
-
Wählen Sie im Beispieldatei die lokale Datei aus, die die erwartete Struktur definiert.
note NOTE Die Beispieldatei wird nur zum Konfigurieren von Spalten und zur Formatierung verwendet. Die Daten werden nicht als Kampagnentität importiert. Das Format muss mit den Dateien übereinstimmen, die bei der Ausführung der Kampagne geladen werden. -
Geben in der Dropdown Liste Dateityp an, ob die Datei Spalten mit Trennzeichen oder Spalten mit fester Breite verwendet.
-
Erweitern Sie im Abschnitt Spalten jede Spalte und konfigurieren Sie deren Eigenschaften.
Nachdem Sie einen Datentyp ausgewählt haben, werden zusätzliche Optionen für diesen Typ angezeigt. Erweitern Sie die folgenden Abschnitte für Parameter, die für alle Spalten gelten, und für typspezifische Optionen.
accordion Allgemeine Spaltenparameter -
Spalte ignorieren - Schließt die Spalte aus dem Import aus, wenn ausgewählt.
-
label - Anzeigename für die Spalte (z. B.
email). -
Interner Name - Systemname für die Spalte, abgeleitet aus der Dateikopfzeile (schreibgeschützt).
-
Datentyp - Datentyp in der Spalte.
-
NULL zulassen - Gibt an, wie leere Werte in der Spalte verwaltet werden:
- Adobe Campaign-Standard - Generiert einen Fehler nur für numerische Felder. Fügt andernfalls einen NULL-Wert ein.
- Leerer Wert zulässig - Autorisiert leere Werte. Der Wert NULL wird eingefügt.
- Immer befüllt - Generiert einen Fehler, wenn ein Wert leer ist.
-
Fehlerverarbeitung - Definiert das Verhalten, wenn ein Fehler in der Spalte auftritt:
- Wert ignorieren - Der Wert wird ignoriert.
- Zeile ablehnen - Die gesamte Zeile wird nicht verarbeitet.
- Standardwert im Fehlerfall verwenden - Ersetzt den Wert, der den Fehler verursacht, durch einen Standardwert, der im Feld Standardwert definiert ist.
- Standardwert verwenden, falls der Wert nicht neu zugeordnet wurde - Ersetzt den den Fehler verursachenden Wert durch einen Standardwert, der im Feld Standardwert“ ist, es sei denn, für den fehlerhaften Wert wurde eine Zuordnung definiert.
- Zeile ablehnen, wenn kein Neuzuordnungswert vorhanden ist - Die gesamte Zeile wird nicht verarbeitet, es sei denn, für den fehlerhaften Wert wurde eine Zuordnung definiert.
-
Standardwert - Standardwert, der verwendet wird, wenn Fehlerverarbeitung auf die Verwendung eines Standardwerts eingestellt ist.
-
Wert-Neuzuordnung - Ordnen Sie bestimmte Werte neuen Werten zu. Klicken Sie Zuordnung hinzufügen, um jede Zuordnung zu definieren (ersetzen Sie beispielsweise
True/Falsedurch1/0).
accordion Parameter der Zeichenfolgenspalten - Breite - Maximale Zeichenanzahl.
- Datenumwandlung — Auf Zeichenfolgenwerte angewendete Groß-/Kleinschreibung (z. B. keine oder Groß-/Kleinschreibung).
- Leerraum-Management - Umgang mit führenden oder nachfolgenden Leerzeichen in Zeichenfolgenwerten.
accordion Parameter für Spalten mit Ganzzahlen und unverankerten Zahlen -
Format - Definiert, wie numerische Werte in der Datei gelesen werden:
- Sonstige - Definieren Sie Tausendertrennzeichen und Dezimaltrennzeichen im Abschnitt Trennzeichen.
- 1.000.00 - Komma als Tausendertrennzeichen und Punkt als Dezimaltrennzeichen.
- 1 000,00 — Leerzeichen als Tausendertrennzeichen und Komma als Dezimaltrennzeichen.
-
Trennzeichen (wenn format den Wert Other hat):
- Tausendertrennzeichen - Zeichen, das Tausende in numerischen Werten gruppiert (leer lassen, wenn es nicht verwendet wird).
- Dezimaltrennzeichen - Zeichen, das für den Dezimalteil numerischer Werte verwendet wird (z. B.
,oder.).
accordion Parameter für Datums- und Uhrzeitspalten Die Optionen hängen davon ab, ob Datentyp "Datum, Uhrzeit oder Datum und Uhrzeit ist.
Datum
-
Datumsformat - Muster, das dem Aussehen von Datumsangaben in der Datei entspricht (z. B.
yyyy/mm/dd). -
Trennzeichen:
- Jahr, Monat,: Zeichen zwischen den Komponenten für Jahr, Monat und Tag (z. B.
/).
- Jahr, Monat,: Zeichen zwischen den Komponenten für Jahr, Monat und Tag (z. B.
Zeit
-
Zeitformat - Muster, das dem Aussehen der Zeiten in der Datei entspricht (z. B.
13:30für 24-Stunden-Stunden und -Minuten). -
Trennzeichen:
- Stunde, Minute, Sekunde - Zeichen zwischen der Stunde, Minute und der zweiten Komponente (z. B.
:).
- Stunde, Minute, Sekunde - Zeichen zwischen der Stunde, Minute und der zweiten Komponente (z. B.
Datum und Uhrzeit
- Datumsformat - Das Muster, das dem Aussehen des Datumsbereichs in der Datei entspricht.
- Zeitformat - Muster, das dem Aussehen des Zeitabschnitts in der Datei entspricht.
- Trennzeichen - Zeichen zwischen Datums- und Zeitkomponenten.
-
-
Geben im Abschnitt an, wie die Datei strukturiert ist, damit Zeilen und Spalten bei der Kampagnenausführung korrekt gelesen werden. Die Zieldatei muss dieselbe Formatierung wie die Beispieldatei verwenden.
- Erste Zeile als Spaltenüberschrift verwenden - Wenn diese Option aktiviert ist, wird die erste Zeile der Datei als Spaltenname behandelt. Diese Option ist normalerweise aktiviert, wenn Sie das Beispiel aus einer Datei konfigurieren, die eine Kopfzeile enthält.
- Zeilennummer als Kennung verwenden - Wenn diese Option aktiviert ist, wird jede Zeile durch ihre Zeilennummer in der Datei identifiziert.
- Datensätze erstrecken sich über mehrere Zeilen - Wenn diese Option aktiviert ist, kann ein einzelner Datensatz mehrere Zeilen in der Datei umfassen (z. B. wenn Felder Zeilenumbrüche enthalten).
- Zu ignorierende Zeilen - Anzahl der Zeilen, die am Anfang der Datei übersprungen werden sollen, bevor Daten gelesen werden (z. B. Kommentar- oder Metadatenzeilen).
- Zeitzone - Zeitzone, die beim Importieren von Datums- und Zeitwerten angewendet wird.
- Codierung - Zeichencodierung der Datei. Wählen Sie die Kodierung aus, die Ihrer Quelldatei entspricht.
- Zeichenfolgen-Trennzeichen - Zum Einschließen von Zeichenfolgenwerten in die Datei verwendetes Zeichen.
- Spaltentrennzeichen - Zeichen, das Spalten in einer durch Trennzeichen getrennten Datei trennt.
-
Klicken Sie Bestätigen, um die Beispieldateikonfiguration zu validieren.
Definieren der Zieldatei target-file
Geben Sie die Datei an, die bei der Kampagnenausführung geladen werden soll, und wie jede Zeile mit den vorhandenen Empfängern abgeglichen werden soll.
-
Wählen Sie im Abschnitt Target die CSV- oder TXT-Datei aus, die die anzusprechende Audience enthält.
note caution CAUTION Stellen Sie sicher, dass die Zieldatei demselben Format, derselben Spaltenstruktur und derselben Spaltenanzahl folgt wie die Beispieldatei. -
Definieren Sie Abschnitt Zurückweisungsverwaltung“, wie sich die Aktivität verhält, wenn bei der Dateiverarbeitung Fehler auftreten:
- Anzahl der zulässigen Fehler — Maximal zulässige Anzahl von Fehlern, bevor die Aktivität fehlschlägt.
- Zurückweisungen in einer Datei beibehalten - Wenn diese Option aktiviert ist, werden Zeilen, die nicht geladen werden konnten, nach der Ausführung zur Überprüfung in eine Zurückweisungsdatei auf dem Server geschrieben.
-
Optional können Sie Datei nach Import löschen aktivieren, um die hochgeladene Datei nach der Kampagnenausführung vom Server zu entfernen.
Nachdem Datei laden die Zielgruppe aufgelöst hat, verbinden Sie die ausgehende Transition mit nachgelagerten Aktivitäten. Weitere Informationen zur Orchestrierung von Kampagnenaktivitäten