GetCampaignBouncesByCategory

Bounces einer versendeten Kampagne auslesen

Die Methode GetCampaignBouncesByCategory ermöglicht es Bounces einer versendeten Kampagne auszulesen.

Request Properties

CampaignId
Die ID der Kampagne von welcher die Bounces ausgelesen werden sollen.
Typ der Eigenschaft: GUID

BounceCategory
Die Kategorie der Bounces, die ausgelesen werden sollen. Wird kein Wert angegeben werden alle Bounces unabhängig von der Kategorie ausgelesen.
Typ der Eigenschaft: BounceCategoryFilter (Nullable)

Deactivated
Gibt an ob nur Empfänger zurückgegeben werden, die aufgrund von Bounces deaktiviert wurden.
Wird kein Wert angegeben, werden alle Bounces unabhängig davon ausgelesen, ob der Empfänger deaktiviert ist oder nicht.
Typ der Eigenschaft: BOOL (Nullable)

From
Das Startdatum, ab dem die Bounces ausgelesen werden sollen.
Wird kein Wert angegeben, werden alle Bounces unabhängig vom Zeitpunkt ausgelesen.
Typ der Eigenschaft: DATETIME (Nullable)

To
Das Enddatum, bis zu dem die Bounces ausgelesen werden sollen.
Wird kein Wert angegeben, werden alle Bounces unabhängig vom Zeitpunkt ausgelesen.
Typ der Eigenschaft: DATETIME

Falls ein Zeitraum angegeben wird, müssen immer From und To gesetzt sein. Weiters dürfen die Zeitpunkte nicht weiter als einen Monat auseinanderliegen.

Beispiel Request „Bounces einer versendeten Kampagne auslesen“

Der folgende Request liest Bounces der Kampagne mit der Id d9e51aeb-e74d-4e2b-9f8c-b5a0d8bc6081 aus. Es werden nur Bounces geliefert, die die Bounce Kategorie "AddressStatus" aufweisen (Email Adresse existiert nicht), deren Empfänger nicht deaktiviert sind und welche zwischen dem 01.06.2025 und 15.06.2025 aufgetreten sind.

JSON

//https://sys.mailworx.info/Services/JSON/ServiceAgent.svc/GetCampaignBouncesByCategory
{
    "request": {
        "Language": "DE",
        "SecurityContext": {
            "Account": "account",
            "Username": "username",
            "Password": "*****",
            "Source": "mwTestApp"
       },
        "CampaignId" : "d9e51aeb-e74d-4e2b-9f8c-b5a0d8bc6081",
        "BounceCategory" : 0,
        "Deactivated": false,
        "From": "\/Date(1748736000000)\/",
        "To": "\/Date(1749945600000)\/"

    }
}

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:GetCampaignBouncesByCategory>
      <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:CampaignId>97102282-7c35-4c10-8add-080f4c8ee4de</ser:CampaignId>
        <ser:BounceCategory>0</ser:BounceCategory>
        <ser:Deactivated>false</ser:Deactivated>
        <ser:From>2025-06-01</ser:From>
        <ser:To>2025-06-15</ser:To>
      </ser:request>
    </ser:GetCampaignBouncesByCategory>
  </soap:Body>
 </soap:Envelope>

Response Objekt

Bounces
Die Liste der Bounces
Typ der Eigenschaft: Liste von CampaignBounce