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 auch 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.mail 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 zwei Dateien in einem ZIP-File bereitgestellt:

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

adresse1@mail.de
adresse2@mail.de

Enthält den SOAP-API-Call, der nach dem automatischen Import ausgeführt werden soll. %CHECKSUM%, %REQUEST_ID% und %TARGETGROUP_ID% müssen genau so im File enthalten bleiben; diese Platzahlter werden nach dem Import automatisch ersetzt.

Die anderen Werte müssen korrekt ausgefüllt sein. Dabei muss insbesondere darauf geachtet werden, dass alle Texte vollständig Html-Entities nutzen.

 < => &lt;
 > => &gt;
etc.

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://api.promio-mail.com/1.4/soap/"
                   xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
                   SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
    <SOAP-ENV:Body>
        <ns1:createDelivery>
            <authentification xsi:type="ns1:authentification">
                <checksum xsi:type="xsd:string">%CHECKSUM%</checksum>
                <requestId xsi:type="xsd:string">%REQUEST_ID%</requestId>
                <requestIdBlockedMinutes xsi:type="xsd:integer">0</requestIdBlockedMinutes>
            </authentification>
            <delivery xsi:type="ns1:delivery">
                <format xsi:type="ns1:contentType">html</format>
                <clientId xsi:type="xsd:integer">$CLIENTID$</clientId>
                <deliveryReceiver xsi:type="ns1:deliveryReceiver">
                    <targetGroupAndSendFromId xsi:type="ns1:targetGroupAndSendFromId">
                        <targetGroupId xsi:type="xsd:integer">%TARGETGROUP_ID%</targetGroupId>
                        <sendFromId xsi:type="xsd:integer">$SEND_FROM_ID$</sendFromId>
                    </targetGroupAndSendFromId>
                </deliveryReceiver>
                <deliverySendTime xsi:type="ns1:deliverySendTime">
                    <sendDelayMinutes xsi:type="xsd:integer">$SEND_DELAY_MINUTES$</sendDelayMinutes>
                </deliverySendTime>
                <sendTestMail xsi:type="xsd:boolean">false</sendTestMail>
                <delivery xsi:type="xsd:boolean">false</delivery>
                <subject xsi:type="xsd:string">Betreffzeile</subject>
                <description xsi:type="xsd:string">Testcampaign</description>
                <campaignCode xsi:type="xsd:string">test</campaignCode>
                <contentHtml xsi:type="xsd:string">
                    &lt;h1&gt;Content&lt;/h2&gt;&lt;p&gt; some escaped HTML &lt;/p&gt;
                </contentHtml>
                <contentText xsi:type="xsd:string">Content text as text/plain</contentText>
            </delivery>
        </ns1:createDelivery>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Dieses ZIP-File muss mit dem vereinbarten Namensschema im SFTP-Ordner /upload/auto für die automatische Verarbeitung bereitgestellt werden.