Get email aggregate tracking metrics - GetAggregateTrackingForMailing

Extracts metrics for a specified Acoustic Campaign email.

Elements (Required)

MAILING_ID - Specifies the Mailing ID. You can get the Mailing ID from the Email campaigns view by hovering over the email name. The MAILING_ID extracts metrics for a sent mailing.

REPORT_ID - Specifies the Report ID.

Elements (Optional)

TOP_DOMAIN - Requests top domain statistics for each email.

PER_CLICK - Requests the total clicks for each link in the email by body type.

<Envelope>
  <Body>
    <GetAggregateTrackingForMailing>
      <MAILING_ID>123</MAILING_ID>
      <REPORT_ID>12332</REPORT_ID>
    </GetAggregateTrackingForMailing>
  </Body>
</Envelope>
<Envelope>
  <Body>
    <RESULT>
      <SUCCESS>TRUE</SUCCESS>
      <Mailing>
        <MailingId>9919</MailingId>
        <ReportId>108480</ReportId>
        <MailingName>
          <![CDATA[API Demo Mailing)]]>
        </MailingName>
        <SentDateTime>2011-09-21 08:49:55.0</SentDateTime>
        <NumSent>55520</NumSent>
        <NumSeeds>0</NumSeeds>
        <NumSuppressed>0</NumSuppressed>
        <NumBounceHard>3902</NumBounceHard>
        <NumBounceSoft>5016</NumBounceSoft>
        <NumUniqueOpen>2815</NumUniqueOpen>
        <NumGrossOpen>0</NumGrossOpen>
        <NumUniqueClick>2815</NumUniqueClick>
        <NumGrossClick>0</NumGrossClick>
        <NumUniqueAttach>0</NumUniqueAttach>
        <NumGrossAttach>0</NumGrossAttach>
        <NumUniqueClickstreams>0</NumUniqueClickstreams>
        <NumGrossClickstreams>0</NumGrossClickstreams>
        <NumUniqueMedia>0</NumUniqueMedia>
        <NumGrossMedia>0</NumGrossMedia>
        <NumGrossAbuse>0</NumGrossAbuse>
        <NumGrossChangeAddress>1113</NumGrossChangeAddress>
        <NumGrossMailBlock>1115</NumGrossMailBlock>
        <NumGrossMailRestriction>1115</NumGrossMailRestriction>
        <NumGrossOther>3903</NumGrossOther>
        <NumConversions>0</NumConversions>
        <NumConversionAmount>0</NumConversionAmount>
        <NumBounceHardFwd>0</NumBounceHardFwd>
        <NumBounceSoftFwd>0</NumBounceSoftFwd>
        <NumConversionAmountFwd>0</NumConversionAmountFwd>
        <NumAttachOpenFwd>0</NumAttachOpenFwd>
        <NumClickFwd>0</NumClickFwd>
        <NumUniqueForwardFwd>0</NumUniqueForwardFwd>
        <NumGrossForwardFwd>0</NumGrossForwardFwd>
        <NumUniqueConversionsFwd>0</NumUniqueConversionsFwd>
        <NumGrossConversionsFwd>0</NumGrossConversionsFwd>
        <NumUniqueClickstreamFwd>0</NumUniqueClickstreamFwd>
        <NumGrossClickstreamFwd>0</NumGrossClickstreamFwd>
        <NumUniqueClickFwd>0</NumUniqueClickFwd>
        <NumGrossClickFwd>0</NumGrossClickFwd>
        <NumUniqueAttachOpenFwd>0</NumUniqueAttachOpenFwd>
        <NumGrossAttachOpenFwd>0</NumGrossAttachOpenFwd>
        <NumUniqueMediaFwd>0</NumUniqueMediaFwd>
        <NumGrossMediaFwd>0</NumGrossMediaFwd>
        <NumUniqueOpenFwd>0</NumUniqueOpenFwd>
        <NumGrossOpenFwd>0</NumGrossOpenFwd>
        <NumAbuseFwd>0</NumAbuseFwd>
        <NumChangeAddressFwd>0</NumChangeAddressFwd>
        <NumMailRestrictionFwd>0</NumMailRestrictionFwd>
        <NumMailBlockFwd>0</NumMailBlockFwd>
        <NumOtherFwd>0</NumOtherFwd>
        <NumSuppressedFwd>0</NumSuppressedFwd>
        <NumUnsubscribes>5</NumUnsubscribes>
      </Mailing>
      <TopDomains>
        <TopDomain>
          <MailingId>9919</MailingId>
          <ReportId>108480</ReportId>
          <Domain>cs.com</Domain>
          <Sent>540</Sent>
          <Bounce>83</Bounce>
          <Open>122</Open>
          <Click>122</Click>
          <Unsubscribe>0</Unsubscribe>
          <Conversion>0</Conversion>
          <Conversion_amount>0</Conversion_amount>
          <Reply_abuse>0</Reply_abuse>
          <Reply_mail_block>14</Reply_mail_block>
          <Reply_mail_restriction>12</Reply_mail_restriction>
        </TopDomain>
        <TopDomain>
          <MailingId>9919</MailingId>
          <ReportId>108480</ReportId>
          <Domain>aol.com</Domain>
          <Sent>12866</Sent>
          <Bounce>2060</Bounce>
          <Open>1278</Open>
          <Click>1289</Click>
          <Unsubscribe>0</Unsubscribe>
          <Conversion>0</Conversion>
          <Conversion_amount>0</Conversion_amount>
          <Reply_abuse>0</Reply_abuse>
          <Reply_mail_block>259</Reply_mail_block>
          <Reply_mail_restriction>260</Reply_mail_restriction>
        </TopDomain>
      </TopDomains>
      <Clicks/>
    </RESULT>
  </Body>
</Envelope>

Elements (Results)

SUCCESS - True if successful; False if not.

Mailing - XML nodes that define the instances of the sent email.

The following elements are children of Mailing:

MailingId - Returns the Mailing ID.
ReportId - Returns the Report ID.
NumSent - Returns the number of contacts to whom Acoustic Campaign sent the email.
MailingName - Returns the email name.
SentDateTime - Returns the date and time the email was sent.
NumSeeds - Returns the number of contacts that are seeded into the email.
NumSuppressed - Returns the number of contacts that are suppressed from the email.

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.
NumGrossClicktreams - 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.
NumConversionsAmount - 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 email. Not populated if the option is not included in the request.

The following elements are children of TopDomain:

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 of the 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 of the 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.

Clicks - XML nodes that list tracking information for tracked hyperlinks. Not populated if you do not include this option in the request.

The following elements are children of Clicks:

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.