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

Exportieren von Abonnenten – ExportSubscribers

Exportieren von Abonnenten

Die Methode ExportSubscribers ermöglicht es, Abonnenten aus mailworx zu exportieren.

Request Properties

ProfileGuid
Die Id der Abonnentengruppe von der die Abonnenten ausgelesen werden sollen. Wird für diese Eigenschaft kein Wert gesetzt, dann wird nach LastChange gefiltert.
Typ der Eigenschaft: GUID

LastChange
Es werden nur jene Abonnenten ausgelesen, die zuletzt nach dem angegebenen Datum geändert wurden.
Wird auch für diese Eigenschaft kein Wert gesetzt, dann wird nach Conditions gefiltert.
Typ der Eigenschaft: DATETIME

Conditions
Die Bedingungen, die von den Abonnenten erfüllt sein müssen, damit diese ausgelesen werden. Werden mehrere Bedingungen angegeben, so werden diese mit UND verknüpft. Wird auch für diese Eigenschaft kein Wert gesetzt, dann wird nach SubscriberIds gefiltert.
Typ der Eigenschaft: Array von Condition

SubscriberIds
Eine Liste jener Abonnenten-Ids, deren zugehörige Abonnenten ausgelesen werden sollen.
Wird auch für diese Eigenschaft kein Wert gesetzt, dann werden alle Abonnenten des Mandanten ausgelesen.
Typ der Eigenschaft: Array von GUIDs

HINWEIS: Von den obenstehenden Request Properties wird immer nur eines angewendet und zwar das Erste das gesetzt wurde. Wenn also beispielweise eine ProfileGuid angegeben wird, dann wird nur nach dieser Eigenschaft gefiltert, egal ob zB LastChange oder Condition ebenfalls gesetzt ist.

Fields
Eine Liste von Abonnentenfeldern, die ausgelesen werden sollen.
Typ der Eigenschaft: Array von Field

Beispiel Request "Exportieren von Abonnenten"

Der folgende Request gibt alle Abonnenten der angegebenen Abonnentengruppe aus. Zusätzlich wird für jeden Abonnenten das Abonnentenfeld mit dem internen Namen „age“ ausgelesen.

JSON
//https://sys.mailworx.info/Services/JSON/ServiceAgent.svc/ExportSubscribers
{
  "request": {
    "Language": "DE",
    "SecurityContext": {
      "Account": "account",
      "Username": "username",
      "Password": "*****",
      "Source": "application name"
    },
    "ProfileGuid": "1ad0e7b2-83d2-4631-af34-f7ace5a78924",
    "Fields": [
      {
        "__type": "TextField:#Eworx.Mailworx.ServiceInterfaces",
        "InternalName": "firstname"
      }
    ]
  }
}
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:ExportSubscribers>
    <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:ProfileGuid>94175568-4ad0-400d-8a69-6f994675ecee</ser:ProfileGuid>
     <ser:Fields>
      <ser:Field>
       <ser:InternalName>age</ser:InternalName>
      </ser:Field>
     </ser:Fields>
    </ser:request>
   </ser:ExportSubscribers>
  </soap:Body>
 </soap:Envelope>

Response Objekt

Subscribers
Eine Liste von Abonnenten mit ihren Metadaten und den Abonnentenfeldwerten, die über den Request-Parameter Fields zum Auslesen deklariert wurden.
Typ der Eigenschaft: Array von Subscriber