E-Mail Marketing Studie zum 1. Halbjahr 2018 - inklusive Bonusmaterial! Jetzt herunterladen >

Abonnenten importieren – ImportSubscribers

Abonnenten importieren

Die Methode ImportSubscribers ermöglicht es, Abonnenten nach mailworx zu importieren.

Request Properties

Subscribers
Liste der Abonnenten die importiert werden sollen.
Typ der Eigenschaft: Liste von Subscriber

DuplicateCriteria
Der interne Name des Abonnentenfeldes, das als Duplikatskriterium verwendet werden soll.
Typ der Eigenschaft: STRING

BeforeImportActions
Die Aktionen, die vor dem Importieren aller Abonnenten ausgeführt werden sollen.
Typ der Eigenschaft: Liste von BeforeImportAction

PreSubscriberActions
Die Aktionen, die vor dem Importieren jedes einzelnen Abonnenten ausgeführt werden sollen. Aktuell gibt es noch keine konkreten PreSubscriberActions, die hier angegegeben werden könnten.
Typ der Eigenschaft: Liste von PreSubscriberAction

PostSubscriberActions
Die Aktionen, die nach dem Importieren jedes einzelnen Abonnenten ausgeführt werden sollen.
Typ der Eigenschaft: Liste von PostSubscriberAction

AfterImportActions
Die Aktionen, die nach dem Importieren aller Abonnenten ausgeführt werden sollen.
Typ der Eigenschaft: Liste von AfterImportAction

SubscriberFieldsToIgnore
Die Abonnentenfelder, die bei diesem Import ignoriert bzw. nicht mit importiert werden sollen.
Typ der Eigenschaft: Liste von STRING

Beispiel Request "Abonnenten importieren"

Der folgende Request importiert die Abonnenten mit den definierten Daten nach mailworx.
Es wird im Vorhinein mit Hilfe einer BeforeImportAction anhand der E-Mail Adresse überprüft, ob in der Menge an übergebenen Abonnenten Duplikate enthalten sind und diese gegebenenfalls entfernt.
Die übrigen Abonnenten werden importiert. Es wird anhand der E-Mail Adresse abgeglichen, ob die Abonnenten schon bestehen oder neu angelegt werden müssen.
Ist der Import abgschlossen, so wird aufgrund der übergebenen AfterImportAction ein Benachrichtigungsmail verschickt.

JSON
{
    "request": {
        "Language": "DE",
        "SecurityContext": {
            "Account": "account",
            "Username": "username",
            "Password": "*****",
            "Source": "application name"
        },
 "Subscribers": {
     "Subscriber 1": {
         "email": "service@mailworx.info",
         "Language": "DE",
         "Status": "SubscriberStatus.Active",
         "OptIn": "true",
         "Mailformat": "Mailformat.Multipart",
         "DOIStatus": "DOIStatus.Unknown"
     },
     "Subscriber 2": {  
		"email": "office@mailworx.info",
         "Language": "DE",
         "Status": "SubscriberStatus.Active",
         "OptIn": "true",
         "Mailformat": "Mailformat.Multipart",
         "DOIStatus": "DOIStatus.Unknown"
     }
 },
 "DuplicateCriteria": "email",

	 "AfterImportActions": {
		"__type": "SendNotifiationActon:#Eworx.Mailworx.ServiceInterfaces-.Subscribers.SubscriberImport",

		"FromEmail": "service@mailworx.info",
		"FromName": "mailworx Import",
		"RecipientEmail": "customer@mailworx.info",
		"RecipientName": "mailworx Customer",
		"Subject": "Import completed",
		"Body": "Your import was successfully completed."
        },
	 
	 "BeforeImportActions": {
		"__type": "RemoveDuplicatesAction:#Eworx.Mailworx.ServiceInterfaces-.Subscribers.SubscriberImport",
		"DuplicateProperty": "email",
		"IsMetaInfo":	"false"
        }
    }
}
XML
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ser="https://sys.mailworx.info/Services/ServiceAgent.asmx"  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <soap:Header/>
  <soap:Body>
   <ser:ImportSubscribers>
    <ser:request>
     <ser:Language>DE</ser:Language>
      <ser:SecurityContext>
       <ser:Account>account</ser:Account>
       <ser:Username>username</ser:Username>
       <ser:Password>*****</ser:Password>
       <ser:Source>application name</ser:Source>
     </ser:SecurityContext>
     <ser:Subscribers>
      <ser:Subscriber 1>
       <ser:email>service@mailworx.info</ser:email>
       <ser:Language>DE</ser:Language>
       <ser:Status>SubscriberStatus.Active</ser:Status>
       <ser:OptIn>true</ser:OptIn>
       <ser:Mailformat>Mailformat.Multipart</ser:Mailformat>
       <ser:DOIStatus>DOIStatus.Unknown</ser:DOIStatus>
      </ser:Subscriber 1>
      <ser:Subscriber 2>
       <ser:email>office@mailworx.info</ser:email>
       <ser:Language>DE</ser:Language>
       <ser:Status>SubscriberStatus.Active</ser:Status>
       <ser:OptIn>true</ser:OptIn>
       <ser:Mailformat>Mailformat.Multipart</ser:Mailformat>
       <ser:DOIStatus>DOIStatus.Unknown</ser:DOIStatus>
      </ser:Subscriber 2>
     </ser:Subscribers>
     <ser:DuplicateCriteria>email</ser:DuplicateCriteria>
     <ser:AfterImportActions>
      <ser:__type>SendNotificationAction:#Eworx.Mailworx.ServiceInterfaces-
                  .Subscribers.SubscriberImport</ser:__type>
      <ser:FromEmail>service@mailworx.info</ser:FromEmail>
      <ser:FromName>mailworx Import</ser:FromName>
      <ser:RecipientEmail>customer@mailworx.info</ser:RecipientEmail>
      <ser:RecipientName>mailworx Customer</ser:RecipientName>
      <ser:Subject>Import completed</ser:Subject>
      <ser:Body>Your import was successfully completed.</ser:Body>
     </ser:AfterImportActions>
     <ser:BeforeImportActions>
      <ser:__type>RemoveDuplicatesAction:#Eworx.Mailworx.ServiceInterfaces-
                  .Subscribers.SubscriberImport</ser:__type>
      <ser:DuplicateProperty>email</ser:DuplicateProperty>
      <ser:IsMetaInfo>false</ser:IsMetaInfo>
     </ser:BeforeImportActions>
    </ser:request>
   </ser:ImportSubscribers>
  </soap:Body>
 </soap:Envelope>

Response Objekt

Imported
Die Anzahl der neu importierten Abonnenten.
Typ der Eigenschaft: INT

Updated
Die Anzahl der bereits bestehenden Abonnenten, die aktualisiert wurden.
Typ der Eigenschaft: INT

Duplicates
Die Anzahl der Abonnenten, die als Duplikate erkannt wurden.
Typ der Eigenschaft: INT

Errors
Die Anzahl der Abonnenten, bei denen ein Fehler aufgetreten ist.
Typ der Eigenschaft: INT

FeedbackData
Eine Liste mit den Informationen, welche Aktionen für die einzelnen Abonnenten durchgeführt wurden bzw. Details zu den Fehlern, die aufgetreten sind.
Typ der Eigenschaft: Liste von SubscriberResponseEntry