GetSubscriberByMailCode

Die Methode GetSubscriberByMailCode ermöglicht es, aus einem mailworx Link den Empfänger zu ermitteln.

Beim Klicken eines Links in einer mailworx E-Mail Kampagne landet der Abonnent z.B. auf einer Website. Auf dieser Website kann der URL Referrer ausgelesen werden. Der URL Referrer ist ein mailworx Link, der den Parameter „sub“ beinhaltet. Der Wert des „sub“-Parameters wird zum Ermitteln des Empfängers, der den Link geklickt hat, verwendet.

Request Properties

MailCode
Der Wert des „sub“ Parameters aus dem URL Referrer (zB „wZ0_00000“).
Typ der Eigenschaft: String

EncryptionIdentifier
Der Wert des „enc“ Parameters aus dem URL Referrer (zB „wZ0-00000“).
Typ der Eigenschaft: String

 

Der folgende Request verwendet den MailCode „kgA2qcnQCCM-1tB2Thv5t38_5y1Qtz5GXEK-lBeUzMlp0dU“, um den Empfänger, der auf den zugehörigen mailworx Link geklickt hat, zu ermitteln.

JSON

//https://sys.mailworx.info/Services/JSON/ServiceAgent.svc/GetSubscriberByMailCode
{
    "request":
    {
        "SecurityContext":
        {
            "Account":"account",
            "Username":"username",
            "Password": "*****",
            "Source":"application name"
        },
        "Language":"DE",
        "MailCode":"kgA2qcnQCCM-1tB2Thv5t38_5y1Qtz5GXEK-lBeUzMlp0dU",
		"EncryptionIndentifier": "AzHxdQp5qa1pw3I7U-twJK8Z4k0z0sRgQn6VzyhDPVEv271MO0oHiuOqGB-dktnA0"
    }
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ser="https://sys.mailworx.info/services/serviceagent.asmx">
   <soap:Header/>
   <soap:Body>
      <ser:GetSubscriberByMailCode>
         <ser:request>
            <ser:Language>DE</ser:Language>
            <ser:SecurityContext>
               <ser:Username>username</ser:Username>
               <ser:Password>*****</ser:Password>
               <ser:Account>account name</ser:Account>
               <ser:Source>application name</ser:Source>
            </ser:SecurityContext>
            <ser:MailCode>kgA2qcnQCCM-1tB2Thv5t38_5y1Qtz5GXEK-lBeUzMlp0dU</ser:MailCode>
			<ser:EncryptionIndentifier>AzHxdQp5qa1pw3I7U-twJK8Z4k0z0sRgQn6VzyhDPVEv271MO0oHiuOqGB-dktnA0</ser:EncryptionIndentifier>
         </ser:request>
      </ser:GetSubscriberByMailCode>
   </soap:Body>
</soap:Envelope>

Response Objekt

Subscriber
Enthält alle Daten des Empfängers.

Was this article helpful?

Related Articles