10. Dezember 2021

· Whitepaper

GetSubscriberByMailCode

Inhaltsverzeichnis

xx Kapitel

Die Methode GetSubscriberByMailCode ermöglicht es, aus einem eworx Marketing Suite-Link den Empfänger zu ermitteln.

Beim Klicken eines Links in einer mailworx E-Mail Kampagne landet der Empfänger z.B. auf einer Website. Auf dieser Website kann der URL Referrer ausgelesen werden. Der URL Referrer ist ein eworx Marketing Suite-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.