Exportieren von Empfängern

Die Methode ExportSubscribers ermöglicht es, Empfänger aus der eworx Marketing Suite zu exportieren.

Request Properties

ProfileGuid
Die Id der Zielgruppe von der die Empfänger ausgelesen werden sollen.
Typ der Eigenschaft: GUID

LastChange
Es werden nur jene Empfänger ausgelesen, die zuletzt nach dem angegebenen Datum geändert wurden.
Typ der Eigenschaft: DATETIME

Conditions
Die Bedingungen, die von den Empfängern erfüllt sein müssen, damit diese ausgelesen werden. Werden mehrere Bedingungen angegeben, so werden diese mit UND verknüpft.
Typ der Eigenschaft: Array von Condition

SubscriberIds
Eine Liste jener Empfänger-Ids, deren zugehörige Empfänger ausgelesen werden sollen.
Typ der Eigenschaft: Array von GUID

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

DateFormatForFields
Das Format, in dem Datumsfelder exportiert werden.
Informationen zu möglichen Formaten können in der .NET Doku geprüft werden.
Typ der Eigenschaft: STRING

IncludeDOIInformation
Steuert ob für die Empfänger Informationen betr. Double-Opt-In Status (u.a. Datum der letzten Änderung des Double-Opt-In Status, Datum der Bestätigung, Datum des Widerrufs, Informationen zu den Kampagnen/Links über die die Bestätigung oder der Widerruf erfolgte, ...) übermittelt werden sollen oder nicht.
Typ der Eigenschaft: BOOL

Beispiel Request „Exportieren von Empfängern“

Der folgende Request gibt alle Empfänger der angegebenen Empfängergruppe aus die zusätzlich auch den Nachnamen „Mustermann“ haben. Zusätzlich wird für jeden Empfänger das Empfängerfeld mit dem internen Namen „firstname“ ausgelesen.

//https://mailworx.marketingsuite.info/Services/JSON/ServiceAgent.svc/ExportSubscribers
{
  "request": {
    "Language": "DE",
    "SecurityContext": {
      "Account": "account",
      "Username": "username",
      "Password": "*****",
      "Source": "application name"
    },
    "ProfileGuid": "1ad0e7b2-83d2-4631-af34-f7ace5a78924",
    "Conditions":[
      {
        "Field":{
          "__type": "TextField:#Eworx.Mailworx.ServiceInterfaces",
          "InternalName": "lastname"
        },
        "Operator":0,
        "Value":"Mustermann"
      },
      {
        "Field":{
          "__type": "DateTimeField:#Eworx.Mailworx.ServiceInterfaces",
          "InternalName": "optoutdate"
        },
        "Operator": 2,
        "Value": "2025-04-23T18:25:43.511Z"
      }
    ],
    "Fields": [
      {
        "__type": "TextField:#Eworx.Mailworx.ServiceInterfaces",
        "InternalName": "firstname"
      }
    ],
    "DateFormatForFields": "MM/yyyy"
  }
}

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" 
xmlns:ser="http://www.mailworx.at/interfaces/serviceagent/"  
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <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>1ad0e7b2-83d2-4631-af34-f7ace5a78924</ser:ProfileGuid>
        <ser:Conditions>
		  <ser:Condition>
            <ser:Field  xsi:type="ser:TextField">
              <ser:InternalName>lastname</ser:InternalName>
            </ser:Field>
            <ser:Operator>Equals</ser:Operator>
            <ser:Value xsi:type="xsd:string">Mustermann</ser:Value>
          </ser:Condition>
        </ser:Conditions>
        <ser:Fields>
          <ser:Field  xsi:type="ser:TextField">
            <ser:InternalName>firstname</ser:InternalName>
          </ser:Field>
        </ser:Fields>
        <ser:DateFormatForFields>MM/yyyy</ser:DateFormatForFields>
      </ser:request>
    </ser:ExportSubscribers>
  </soap:Body>
 </soap:Envelope>

Response Objekt

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