Overview
Skill Level: Intermediate
Step-by-step
-
Syntax of the request and response XML for GetAggregateTrackingForMailing
Operation
<GetAggregateTrackingForMailing>
Elements
MAILING_ID
Required parameter that specifies the Mailing ID.
 REPORT_ID
Required parameter that specifies the Report ID.
 TOP_DOMAIN
Optional parameter that requests top domain statistics for each mailing.
 INBOX_MONITORING
Optional parameter that requests Inbox Monitoring statistics for each mailing.
 PER_CLICK
Optional parameter that requests the total clicks for each link in the mailing by Body Type.
Example <Envelope> <Body> <GetAggregateTrackingForMailing> <MAILING_ID>123</MAILING_ID> <REPORT_ID>12332</REPORT_ID> </GetAggregateTrackingForMailing> </Body> </Envelope>
Response
<RESULT>
Elements
SUCCESS
True if successful.
 Mailing
XML nodes that define the instances of the sent mailing.
 Child Element MailingID Returns the Mailing ID.   ReportId Returns the Report ID.   MailingName Returns the mailing name.   SentDateTime Returns the date and time the mailing was sent.   NumSent Returns the number of contacts to whom the mailing was sent.   NumSeeds Returns the number of contacts that are seeded into the mailing.   NumSuppressed Returns the number of contacts that are suppressed from the mailing.   NumInboxMonitored Returns the number of Inbox Monitoring addresses seeded into this mailing.   NumBounceHard Returns the number of hard bounces.   NumBounceSoft Returns the number of soft bounces.   NumUniqueOpen Returns the number of unique opens.   NumGrossOpen Returns the number of gross opens.   NumUniqueClick Returns the number of unique clicks.   NumGrossClick Returns the number of gross clicks.   NumUniqueAttach
Returns the number of unique attachment downloads.
  NumGrossAttach
Returns the number of gross attachment downloads.
  NumUniqueClickstreams
Returns the number of unique clickstream clicks.
  NumGrossClickstreams
Returns the number of gross clickstream clicks.
  NumUniqueMedia
Returns the number of unique media plays.
  NumUniqueAttach
Returns the number of unique attachment downloads.
  NumGrossAttach
Returns the number of gross attachment downloads.
  NumUniqueClickstreams
Returns the number of unique clickstream clicks.
  NumGrossClickstreams
Returns the number of gross clickstream clicks.
  NumUniqueMedia
Returns the number of unique media plays.
  NumGrossMedia
Returns the number of gross media plays.
  NumGrossAbuse
Returns the number of abuse complaints.
  NumGrossChangeAddress
Returns the number of change of address replies.
  NumGrossMailBlock
Returns the number of mail block replies.
  NumGrossMailRestriction
Returns the number of mail restriction replies.
  NumGrossOther
Returns the number of other replies.
  NumConversions
Returns the number of conversions.
  NumConversionAmount
Returns the total conversion amount.
  NumBounceHardFwd
Returns the number of hard bounces that occurred for forwarded contacts.
  NumBounceSoftFwd
Returns the number of soft bounces that occurred for forwarded contacts.
  NumConversionAmountFwd
Returns the total conversion amount that occurred for forwarded contacts.
  NumClickFwd
Returns the number of clicks for forwarded contacts.
  NumUniqueForwardFwd
Returns the number of unique forwards by forwarded contacts.
  NumGrossForwardFwd
Returns the number of gross forwards by forwarded contacts.
  NumUniqueConversionsFwd
Returns the number of unique conversions by forwarded contacts.
  NumGrossConversionsFwd
Returns the number of gross conversions by forwarded contacts.
  NumUniqueClickstreamFwd
Returns the number of unique clickstream clicks by forwarded contacts.
  NumGrossClickstreamFwd
Returns the number of gross clickstream clicks by forwarded contacts.
  NumUniqueClickFwd
Returns the number of unique clicks by forwarded contacts.
  NumGrossClickFwd
Returns the number of gross clicks by forwarded contacts.
  NumUniqueAttachOpenFwd
Returns the number of unique attachment downloads by forwarded contacts.
  NumGrossAttachOpenFwd
Returns the number of gross attachment downloads by forwarded contacts.
  NumUniqueMediaFwd
Returns the number of unique media plays by forwarded contacts.
  NumGrossMediaFwd
Returns the number of gross media plays by forwarded contacts.
  NumUniqueOpenFwd
Returns the number of unique opens by forwarded contacts.
  NumGrossOpenFwd
Returns the number of gross opens by forwarded contacts.
  NumAbuseFwd
Returns the number of abuse complaints by forwarded contacts.
  NumChangeAddressFwd
Returns the number of change address replies by forwarded contacts.
  NumMailRestrictionFwd
Returns the number of mail restriction replies by forwarded contacts.
  NumMailBlockFwd
Returns the number of mail block replies by forwarded contacts.
  NumOtherFwd
Returns the number of other replies by forwarded contacts.
  NumSuppressedFwd
Returns the number of suppressed forwards.
  NumUnsubscribes
Returns the number of Opt Outs.
  TopDomain
XML nodes that define top domain reporting for the sent mailings. If you do not include TopDomain in the request, the Acoustic Campaign does not populate this node.
 Child Element MailingId
Returns the Mailing ID.
  ReportId
Returns the Report ID.
  Domain
Returns the domain name.
  Sent
Returns the number of contacts that are sent for the domain.
  Bounce
Returns the number of bounces for the domain.
  Open
Returns the number of opens for contacts of the domain.
  Click
Returns the number of clicks for contacts of the domain.
  Unsubscribe
Returns the number of unsubscribe requests for contacts on that domain.
  Conversion
Returns the number of conversions for contacts of the domain.
  Conversion_Amount
Returns the total conversion amount for contacts of the domain.
  Reply_abuse
Returns the number of abuse complaint replies for contacts on that domain.
  Reply_mail_block
Returns the number of mail block replies for contacts of the domain.
  Reply_mail_restriction
Returns the number of mail restriction replies for contacts of the domain.
 InboxMonitored
XML nodes that define inbox monitoring reporting for the sent mailings. Child nodes are
encapsulated in a “InboxMonitoring” Node. This node deoes not populate if the option is not included in the request. Child Element MailingId
Returns the Mailing ID.
  ReportId
Returns the Report ID.
  Domain
Returns the domain name.
  Sent
Returns the number of inbox monitoring contacts sent for the domain.
  Inbox
Returns the number of inbox monitoring contacts emails delivered to the inbox.
  Bulk
Returns the number of inbox monitoring contacts emails delivered to the bulk folder.
  NotReceived
Returns the number of inbox monitoring contacts emails not delivered.
     Clicks XML nodes that list tracking information for tracked hyperlinks. Child nodes encapsulated in a “Click” node. Not populated if the option is not included in the request.  Child Element MailingId
Returns the Mailing ID.
  ReportId
Returns the Report ID.
  LinkName
Returns the link name.
  LinkURL
Returns the link URL.
  TotalHTML
Returns the number of clicks on the link in the HTML body.
  TotalWEB
Returns the number of clicks on the link in the WEB body.
  TotalTEXT
Returns the number of clicks on the link in the TEXT body.
Example See the example results for GetAggregateTrackingForUser.