Öffnungen auslesen
Request Properties:
SubscriberIds: Die Ids der Empfänger, deren Öffnungen ausgelesen werden sollen.
Typ: Liste von Guid
StartTimePoint: Der Anfangszeitpunkt des Zeitraums, in dem die Öffnungen ausgelesen werden sollen.
Typ: DateTime
EndTimePoint: Der Endzeitpunkt des Zeitraums, in dem die Öffnungen ausgelesen werden sollen.
Typ: DateTime
Response Properties:
Subscribers: Liste aller Öffnungen in dem Zeitraum, gruppiert nach Empfänger und Mandant.
Typ: Liste von SubscriberOpenedMails
SubscriberOpenedMails Properties:
Der Typ SubscriberOpenedMails beinhaltet alle Öffnungen eines Empfängers in einem bestimmten Mandanten.
SubscriberId: Die Id des Empfängers.
Typ: Guid
AccountId: Die Id des Mandanten.
Typ: Guid
OpenedMails: Die Öffnungen des Empfängers in diesem Zeitraum
Typ: Liste von OpenedMail
OpenedMail Properties:
Der Typ OpenedMail repräsentiert eine Öffnung einer E-Mail Kampagne.
CampaignId: Die Id der Kampagne, die geöffnet wurde.
Typ: Guid
Timepoint: Der Zeitpunkt der Öffnung.
Typ: Datetime
ReadTime: Falls eine Lesezeitmessung durchgeführt wurde, die Lesezeit in Sekunden.
Typ: Nullable Int
MailClientType: Der bei der Öffnung verwendete Mailclient.
Typ: MailClientType
MailClientType Enum Werte:
0: Web
1: Mobile
2: Application
3: Unknown
Beispiel Request „Öffnungen auslesen“
Der folgende Request liefert die Öffnungen der Empfänger mit den IDs „F73A86E8-E58B-4B3F-A4A8-5D2F9417EB12“ und „C82F397C-3F36-45A6-93D4-C9AC743B9861“ im Zeitraum vom 01.01.2023 bis 01.02.2023.
//https://mailworx.marketingsuite.info/Services/JSON/ServiceAgent.svc/GetOpeningsOfSubscriber
{
"request": {
"Language": "DE",
"SecurityContext": {
"Account": "account",
"Username": "username",
"Password": "******",
"Source": "application name"
},
"SubscriberIds": [
"F73A86E8-E58B-4B3F-A4A8-5D2F9417EB12",
"C82F397C-3F36-45A6-93D4-C9AC743B9861"
],
"StartTimePoint": "\/Date(1672531200000)\/",
"EndTimePoint": "\/Date(1675209600000)\/"
}
}
XML
<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:GetOpeningsOfSubscriber>
<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:SubscriberIds>
<ser:guid>F73A86E8-E58B-4B3F-A4A8-5D2F9417EB12</ser:guid>
<ser:guid>C82F397C-3F36-45A6-93D4-C9AC743B9861</ser:guid>
</ser:SubscriberIds>
<ser:StartTimePoint>2023-01-01T00:00:00</ser:StartTimePoint>
<ser:EndTimePoint>2023-02-01T00:00:00</ser:EndTimePoint>
</ser:request>
</ser:GetOpeningsOfSubscriber>
</soap:Body>
</soap:Envelope>