Import: Welche Möglichkeiten bietet der Batch-Prozess?

Bitte laden Sie csv-Dateien mit Adressen oder Zielgruppen mit Kunden-IDs oder E-Mail-Adressen nach /upload/manual.

Klicken Sie auf Adressen > Listen, wählen Sie die Aktion Adressen importieren und folgen Sie den dort beschriebenen Schritten. Eine Anleitung finden Sie im Artikel „Wie werden Adressen importiert?“.

Es wird ein Set an Standard-Feldern angelegt. Individuelle Felder können definiert werden. Bei der Wahl der Feldbezeichnung berücksichtigen Sie, dass diese als Variablen in allen E-Mail-Bestandteilen genutzt werden können und das Schema möglichst einheitlich sein sollte.

Grundsätzlich sind zwei Typen zu unterscheiden:

Es wird der komplette Positiv-Datenbestand täglich zur Verfügung gestellt und synchronisiert. Die Selektion von Zielgruppen erfolgt in promio.connect bzw. durch Import von Zielgruppen-Definitionen (Kunden-ID, E-Mail, interne promio.connect ID; jeweils einspaltige csv).

Es werden lediglich Zielgruppen, also Untermengen des Gesamtbestandes, importiert. Hierbei stehen folgende Optionen zur Verfügung:

• Prüfung auf neue Dateien erfolgt täglich oder alle 5 Minuten
• Die Zielgruppe steht anschließend im System bereit zur weiteren Verarbeitung (Standard).
• Die Zielgruppe wird automatisch in einen bestehenden Newsletter-Verteiler eingepflegt und steht somit anschließend als Auto-Zielgruppe zur Verfügung. Hierüber lassen sich sehr einfach Auto-Kampagnen (Lifecycle-Mailings) steuern.

• Untermandanten ja/nein: Sollen in einer Datei auch Adressen für auswählbare Untermandanten zusammengefasst werden? Die Zuordnung erfolgt über das Feld b2b_user_id.
• Uhrzeit der Prüfung auf neue Dateien (nur bei täglicher Prüfung, in vollen Stunden 0-24)

Dateistruktur / Nomenklatur Namen:

• Format: .csv
• Kompression (optional): bzip2, gzip mit den Endungen .bz2, .Z
• Verschlüsselung (optional): DES openssh
• Filename:
  • [SENDERID]_[NAME]_[CHARSET]_[IMPORTTEMPLATEID]_YYYYMMDDHHMMSS.csv
    • SENDERID: ID des Mandanten, in welchen die Datei importiert wird
    • NAME: Zielgruppenbezeichnung, die anschließend als Name im System benutzt wird. Hierbei keine Umlaute, Sonderzeichen und Unterstriche benutzen
    • CHARSET: [utf8|latin]
    • IMPORTTEMPLATEID: Integer, ein von promio.net gelieferter Wert, der alle Informationen für den definierten FileTyp definiert (Spalten und Typ-Zuordnungen müssen immer konstant sein)
• Validierung: Folgende Werte werden automatisch validiert:
  • Filename auf korrekte Syntax
  • Anzahl der Zeilen in der Datei vs. Anzahl der Zeilen nach Import in eine temporäre Tabelle
  • Typ mail auf korrekte Syntax und unique Werte
• Logfile: Es wird nach Import ein Logfile im System hinterlegt und zusätzlich eine E-Mail an einen zu liefernden Verteiler mit Fehler- und Warnungsinformationen versendet
• die Dateien sind auf dem promio.connect SFTP-Server in das Verzeichnis /upload/auto/ hochzuladen

Standard-Feldstruktur (kann beliebig erweitert werden).

Nach Ausführen eines automatischen Zielgruppen-Imports können weitere Aktionen durch Aufruf eines API-Calls ausgeführt werden. Eine häufige Anwendung ist dabei das automatische Anlegen einer E-Mail mit anschließendem Versand.

Voraussetzung ist die Konfiguration eines automatischen Import-Prozesses durch den promio.net Support.

Hierzu werden die zwei Dateien user.csv und action.json in einem ZIP-File bereitgestellt.
Das ZIP-File muss mit dem vereinbarten Namensschema im SFTP-Ordner /upload/auto für die automatische Verarbeitung bereitgestellt werden.

Enthält die für den automatischen Import konfigurierten Daten.

adresse1@mail.de
adresse2@mail.de

Enthält Kampagnen- und Zielgruppeninformationen im JSON-Format.
Diese werden nach dem automatischen Import für die Ausführung von REST API Calls genutzt.

{
 "clientId": 10105,
 "campaign": { 
   "name": "Meine Kampagne", 
   "code": "ABC-123-DEF",
   "clientId": 12125,
   "newsletterId": 82384
 },
 "message": { 
     "templateId": 2861485, 
     "format": "html",
     "name": "Mein Creative", 
     "sendFromId": 12944,
     "sendFromName": "promio.net Newsletter",
     "locale": "de_DE",
     "creative": {
       "content": "<html>\n <head>\n   <title>My first message</title>\n </head>\n <body>\n   <p>Hello World!</p>\n </body>\n</html>\n",
       "subject": "Meine Betreffzeile"
     },
     "text": {
       "content": "Hello World.\n"
     }
 },
 "targetGroup": {
   "filter": {
     "includes": [
       315089
     ],
     "excludes": [
       {
         "type": "list",
         "id": 100898
       }
     ]
   },
   "limit": {
     "amount": 50000,
     "type": "mostActive"
   }
 },
 "delivery": {
   "schedule": {
     "scheduledForDeliveryAt": "2025-03-01 12:00" 
   },
   "start": {
     "mailsPerHourLimit": 5000,
     "resetStatistics": true,
     "refreshAutoTargetGroup": true
   },
   "sendTest": {
     "recipients": [
       {
         "custId": "abc-1234",
         "mail": "max.mustermann@musterdomain.de",
         "lastName": "Mustermann",
         "firstName": "Manfred",
         "gender": 1,
         "street": "Musterstraße 4",
         "city": "Musterstadt",
         "countryCode": "DE",
         "postcode": "12345",
         "birthday": "1986-02-12",
         "phoneNumber": 4912345678
       }
     ]
   }
 }
}

• clientId:
  • wird benötigt. ID des Mandanten eintragen.
• campaign:
  • Pflichtfeld, Pflichtfeld innerhalb: name
  • Doku: REST API - create campaign
• message:
  • Pflichtfeld
  • wenn templateId vorhanden ist
    • Creative wird aus einem Template gebaut
    • Pflichtfeld: name
  • wenn templateId fehlt
    • Pflichtfeld: name
    • Doku: REST API - create message
  • creative:
    • Verpflichtend bei Creatives, die nicht durch ein Template erzeugt werden
    • Pflichtfelder: content, subject
  • text:
    • optional. Nur notwendig bei abweichendem Text-Part. Ohne Angabe von text wird der Text-Part automatisch aus dem HTML der Multipart E-Mail erzeugt.
• targetGroup
  • optional. Nur notwendig, um filter und limit einstellen zu können.
  • Die ZielgruppenId wird automatisch zugewiesen.
  • Doku: REST API - assign target group
• delivery
  • optional. Nur notwendig, wenn der Versand terminiert und gestartet werden soll.
  • Einstellmöglichkeiten zum Versand
  • schedule
    • Terminierung des Versands
    • Pflichtfeld: scheduledForDeliveryAt
    • Doku: REST API - schedule delivery
  • start
    • nur, wenn start gesetzt ist, wird der Versand auch gestartet.
    • keine Pflichtfelder
    • Doku: REST API - start delivery
  • sendTest
    • optional. Start eines Testversands.
    • Doku: REST API - send test mail

Wichtig:
Der Quelltext in creative und text muss für json „vorbereitet sein“. Auf folgender (externer) Webseite stehen Angaben, wie maskiert werden muss, sowie eine Möglichkeit, Quelltext automatisch maskieren zu lassen: https://www.freeformatter.com/json-escape.html

Beispiel für die Erstellung eines Creatives via HTML-Quellcode (incl. Versandstart):

{
 "clientId": 10105,
  "campaign": {
    "name": "Meine Kampagne"
  },
  "message": {
    "format": "html",
    "name": "Mein Creative",
    "sendFromId": 12944,
    "sendFromName": "promio.net Newsletter",
    "creative": {
      "content": "<html>\n  <head>\n    <title>My first message</title>\n </head>\n <body>\n   <p>Hello World!</p>\n </body>\n</html>\n",
      "subject": "Meine Betreffzeile"
    }
  },
  "delivery": {
    "schedule": {
      "scheduledForDeliveryAt": "2025-03-01 12:00"
    },
    "start": {
    }
  }
}

Beispiel für die Erstellung eines Creatives via Template (ohne Versandstart):

{
 "clientId": 10105,
  "campaign": {
    "name": "Meine Kampagne"
  },
  "message": {
    "name": "Mein Creative",
    "templateId": 2861485
  }
}