Datei laden load-file

Auf dieser Seite: Erfahren Sie, wie Sie mit der Daten-Management-Aktivität „Datei laden“ die Zielgruppe einer orchestrierten Kampagne aus einer externen CSV- oder TXT-Datei zum Ausführungszeitpunkt ansprechen können, ohne die Datei in Adobe Experience Platform aufnehmen zu müssen.

Die Aktivität Datei laden ist eine Daten-Management-Aktivität. Mit ihr können Sie mit Profilen und Daten arbeiten, die in einer externen Datei gespeichert sind. Sie unterstützt dateibasiertes Targeting in orchestrierten Kampagnen, wenn die Empfängerliste aus einem externen System stammt (z. B. einem CRM-Export oder der Datei eines Partners) und Sie eine Kampagne ausführen möchten, ohne zuvor eine komplette Aufnahme-Pipeline für Adobe Experience Platform erstellen zu müssen.

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.

AVAILABILITY
Die Datei laden-Aktivität ist derzeit nicht für die Verwendung mit Healthcare Shield verfügbar.

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 zum Zeitpunkt der Kampagnenausführung verwendet und nicht als Adobe Experience Platform-Datensatz gespeichert.

Einschränkungen für Aktivitäten in Verbindung mit Kanälen und Arbeitsflächen finden Sie unter Schutzmechanismen 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 eine oder ein Admin die folgende einmalige Einrichtung vornehmen.

Um die Aktivität Datei laden in einer orchestrierten Kampagne verwenden zu können, muss Benutzenden die Berechtigung Datei in orchestrierten Kampagnen verwalten zugewiesen werden.

Anweisungen zum Zuweisen von Berechtigungen finden Sie unter Verwalten von Benutzenden und Rollen.

Erstellen einer Dateityp-Zieldimension file-target-dimension

Mit einer Profil-Zielgruppendimension vom Typ Datei können orchestrierte Kampagnen Empfängerinnen und Empfänger aus einer hochgeladenen Datei auflösen, statt ein Adobe Experience Platform-Schema zu verwenden. Damit werden der Identity-Namespace und das Kennungsfeld definiert, die bei der Verarbeitung der Datei-Zielgruppe zum Zeitpunkt der Kampagnenausführung verwendet werden.

Erstellen Sie eine Zieldimension unter Administration > Konfigurationen > Zieldimension für Kampagne. Weitere Informationen zu Zielgruppendimensionen

Achten Sie beim Erstellen der Zielgruppendimension für dateibasiertes Targeting auf Folgendes:

  • Stellen Sie Dimensionsquelle auf Datei ein.
  • 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. email, sofern Ihre hochgeladenen Dateien die Spalte email aufweisen.
CAUTION
Die Werte für Schema und Identität können nach dem Speichern der Zielgruppendimension nicht mehr geändert werden. Überprüfen Sie den Identity-Namespace und den Identitätsfeldpfad, bevor Sie speichern.

Erstellen einer Kanalkonfiguration für den dateibasierten Versand file-channel-configuration

Erstellen Sie eine dedizierte Kanalkonfiguration, die die Zieldimension „Dateityp“ verwendet. Diese Konfiguration wird in der Nachrichtenaktivität ausgewählt, die der Aktivität Datei laden auf der Kampagnen-Arbeitsfläche folgt.

  1. Navigieren Sie zu Administration > Kanäle > Kanalkonfigurationen und erstellen Sie eine neue Konfiguration.

  2. Wählen Sie unter Ausführungsdetails die Registerkarte Orchestrierte Kampagnen aus und aktivieren Sie die Konfiguration für orchestrierte Kampagnen.

  3. Wählen Sie im Feld Profil-Zielgruppendimension die im vorherigen Schritt erstellte Dateityp-Zielgruppendimension aus.

  4. Füllen Sie die verbleibenden Felder für die Kanalkonfiguration aus und speichern Sie. Weitere Informationen zu Kanalkonfigurationen für orchestrierte Kampagnen

IMPORTANT
Standardmäßige profilbasierte Kanalkonfigurationen funktionieren nicht mit einer dateibasierten Zielgruppe. Verwenden Sie eine Kanalkonfiguration, die auf die Dateityp-Dimension für jede Nachrichtenaktivität abzielt, die einer Aktivität vom Typ Datei laden folgt.

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.

  1. Fügen Sie der Arbeitsfläche der orchestrierten Kampagne eine Aktivität des Typs Datei laden hinzu.

  2. Geben Sie ein Label 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 Kampagnenzielgruppe importiert.

  1. Wählen Sie im Abschnitt 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 Kampagnenzielgruppe importiert. Das Format muss mit den Dateien übereinstimmen, die bei der Ausführung der Kampagne geladen werden.
  2. Geben Sie in der Dropdown-Liste Dateityp an, ob die Datei getrennte Spalten oder Spalten mit fester Breite verwendet.

  3. 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 dem Datei-Header (schreibgeschützt).

    • Datentyp – Die Art der in der Spalte enthaltenen Daten.

    • NULL erlauben – Gibt an, wie leere Werte in der Spalte behandelt werden sollen:

      • Adobe Campaign-Standard – Generiert einen Fehler nur für numerische Felder. Fügt anderenfalls einen NULL-Wert ein.
      • Leer erlaubt – Autorisiert leere Werte. Der Wert NULL wird eingefügt.
      • Leer nicht erlaubt – Generiert einen Fehler bei leeren Werten.
    • Fehlerverarbeitung – Definiert den Umgang mit Fehlern in der Spalte:

      • Wert ignorieren – Der Wert wird ignoriert.
      • Zeile zurückweisen: Die gesamte Zeile wird nicht verarbeitet.
      • Bei Fehler Standardwert verwenden – Der den Fehler verursachende Wert wird durch den im Feld Standardwert gespeicherten Wert ersetzt.
      • Bei fehlender Neukodifizierung Standardwert verwenden – Der den Fehler verursachende Wert wird durch den im Feld Standardwert gespeicherten Wert ersetzt, es sei denn, für den fehlerhaften Wert wurde eine Zuordnung definiert.
      • Bei fehlender Neukodifizierung Zeile zurückweisen – 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.

    • Neukodifizierung der Werte – Ordnen Sie bestimmte Werte neuen Werten zu. Klicken Sie auf Zuordnung hinzufügen, um jede Zuordnung zu definieren (ersetzen Sie beispielsweise True/False durch 1/0).

    accordion
    Parameter für Zeichenfolgenspalten
    • Breite – Maximale Zeichenanzahl.
    • Datentransformation – Auf Zeichenfolgenwerte angewendete Groß-/Kleinschreibung (z. B. keine oder Groß-/Kleinschreibung).
    • Umgang mit Leerzeichen – Definiert den Umgang mit führenden oder nachgestellten Leerzeichen in Zeichenfolgenwerten.
    accordion
    Parameter für Spalten mit Ganzzahlen und Gleitkommazahlen
    • Format – Definiert, wie numerische Werte in der Datei gelesen werden:

      • Sonstige – Definiert Tausendertrennzeichen und Dezimaltrennzeichen im Abschnitt Trennzeichen.
      • 1.000.00 – Punkt als Tausendertrennzeichen und Komma als Dezimaltrennzeichen.
      • 1 000,00 – Leerzeichen als Tausendertrennzeichen und Komma als Dezimaltrennzeichen.
    • Trennzeichen (wenn für Format die Option Sonstige ausgewählt ist):

      • Tausendertrennzeichen – Zeichen, das Tausender in numerischen Werten gruppiert (leer lassen, wenn nicht verwendet).
      • Dezimaltrennzeichen – Zeichen, das für den Dezimalteil numerischer Werte verwendet wird (z. B. , oder .).
    accordion
    Parameter für Spalten mit Datum und Uhrzeit

    Die Optionen hängen davon ab, ob Datum, Uhrzeit oder Datum und Uhrzeit unter Datentyp ausgewählt ist.

    Datum

    • Datumsformat – Muster, das dem Format von Datumsangaben in der Datei entspricht (z. B. yyyy/mm/dd).

    • Trennzeichen:

      • Jahr, Monat, Tag – Zeichen zwischen den Angaben für Jahr, Monat und Tag (z. B. /).

    Zeit

    • Zeitformat – Muster, das dem Format von Uhrzeiten in der Datei entspricht (z. B. 13:30 für 24-Stunden-Format und Minuten).

    • Trennzeichen:

      • Stunde, Minute, Sekunde – Zeichen zwischen den Angaben für Stunde, Minuten und Sekunden (z. B. :).

    Datum und Uhrzeit

    • Datumsformat – Muster, das dem Format des Datums in der Datei entspricht.
    • Zeitformat – Muster, das dem Format der Zeitangabe in der Datei entspricht.
    • Trennzeichen – Zeichen zwischen Datums- und Zeitangaben.
  4. Geben Sie im Abschnitt Formatierung 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 für 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 Überschriftenzeile enthält.
    • Zeilennummer als Kennung verwenden – Wenn diese Option aktiviert ist, wird jede Zeile durch ihre Zeilennummer in der Datei identifiziert.
    • Mehrzeilige Einträge – Wenn diese Option aktiviert ist, kann ein einzelner Eintrag 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 – Zeichen-Codierung der Datei. Wählen Sie die Codierung aus, die Ihrer Quelldatei entspricht.
    • Zeichenfolgen-Trennzeichen – Zeichen, mit dem Zeichenfolgenwerte in der Datei eingeschlossen werden.
    • Spaltentrennzeichen – Zeichen, das Spalten in einer durch Trennzeichen getrennten Datei trennt.
  5. Klicken Sie auf Bestätigen, um die ausgewählte Konfiguration 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 Empfangenden abgeglichen werden soll.

  1. Wählen Sie im Abschnitt Zieldatei die CSV- oder TXT-Datei aus, die die anzusprechende Zielgruppe enthält.

    note caution
    CAUTION
    Stellen Sie sicher, dass die Zieldatei dasselbe Format, dieselbe Spaltenstruktur und dieselbe Spaltenanzahl aufweist wie die Beispieldatei.
  2. Definieren Sie im Abschnitt Zurückweisungsverwaltung, wie sich die Aktivität verhält, wenn bei der Dateiverarbeitung Fehler auftreten:

    • Erlaubte Fehleranzahl – Maximal zulässige Anzahl von Fehlern, bevor die Aktivität fehlschlägt.
    • Zurückweisungen in einer Datei speichern – Wenn diese Option aktiviert ist, werden Zeilen, die nicht geladen werden konnten, nach der Ausführung zur Prüfung in eine Zurückweisungsdatei auf dem Server geschrieben.
  3. Aktivieren Sie optional die Option Datei nach Import löschen, um die Originaldatei nach der Kampagnenausführung vom Server zu löschen.

Nachdem Datei laden die Zielgruppe aufgelöst hat, verbinden Sie die ausgehende Transition mit nachgelagerten Aktivitäten. Weitere Informationen zur Orchestrierung von Kampagnenaktivitäten

recommendation-more-help
journey-optimizer-help