10. Dezember 2021

· Whitepaper

GetSubscriberIdByMailCode

Inhaltsverzeichnis

xx Kapitel

Die Methode GetSubscriberIdByMailCode ermöglicht es, aus einem eworx Marketing Suite-Link die Empfänger-ID 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 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/GetSubscriberIdByMailCode
{
    "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:GetSubscriberIdByMailCode>
         <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:GetSubscriberIdByMailCode>
   </soap:Body>
</soap:Envelope>

Response Objekt

SubscriberId
Enthält die Id des Empfängers. Die Daten des Empfängers können über diese Id mittels ExportSubscribers abgerufen werden.
Typ der Eigenschaft: GUID