Overview

Skill Level: Intermediate

Step-by-step

  1. Syntax of the request and response XML for GetAggregateTrackingForOrg

    Operation

    <GetAggregateTrackingForOrg>

    Elements

    DATE_START

    Required Starting Date in the format “mm/dd/yyyy hh: mm:

     

    DATE_END

    Required Ending Date in the format “mm/dd/yyyy hh:mm:ss”

     

    PRIVATE

    Optional parameter to retrieve private mailings. If private or shared is not passed to the
    API, the Acoustic Campaign returns both private and shared mailings.

     

    SHARED

    Optional parameter to retrieve shared mailings.

     

    SCHEDULED

    Optional Mailing Type parameter to retrieve scheduled mailings. If no mailing type is passed to the API, the Acoustic Campaign returns mailings of all types.

     

    SENT

    Optional Mailing Type parameter to retrieve sent mailings.

     

    SENDING

    Optional Mailing Type parameter to retrieve mailings while sending.

     

    OPTIN_CONFIRMATION

    Optional Mailing Type parameter to retrieve Opt-in Autoresponder mailings.

     

    PROFILE_CONFIRMATION

    Optional Mailing Type parameter to retrieve Edit Profile Autoresponder mailings.

     

    AUTOMATED

    Optional Mailing Type parameter to retrieve Custom Autoresponder mailings.

      CAMPAIGN_ACTIVE

    Optional Mailing Type parameter to retrieve active Groups of Automated Messages.

      CAMPAIGN_COMPLETED

    Optional Mailing Type parameter to retrieve completed Groups of Automated Messages.

      CAMPAIGN_CANCELLED

    Optional Mailing Type parameter to retrieve canceled Groups of Automated Messages.

      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.

      EXCLUDE_TEST_MAILINGS

    Optional parameter that requests to exclude Test Mailings. If you do not provide this element,
    the Acoustic Campaign includes all Test Mailings.

    Example
    <Envelope>
      <Body>
        <GetAggregateTrackingForOrg>
          <PRIVATE/>
          <SENT/>
          <DATE_START>07/25/2011 00:00:00</DATE_START>
          <DATE_END>09/30/2011 23:59:59</DATE_END>
        </GetAggregateTrackingForOrg>
      </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 Acoustic Campaign sent the mailing.

       

    NumSent

    Returns the number of contacts to whom the Acoustic Campaign sent the mailing.

       

    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.

       

    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 reports for the sent mailings. The node is not populated 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 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.

     

    InboxMonitored

    XML nodes define inbox monitoring reporting for the sent mailings. Child nodes are encapsulated in a “InboxMonitoring” Node. This node is not populated 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 contact.emails delivered to the inbox.

       

    Bulk

    Returns the number of inbox monitoring contact emails delivered to the bulk folder.

       

    NotReceived

    Returns the number of inbox monitoring contact 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

1 comment on"Get aggregate tracking metrics for an org"

  1. I am attempting to recreate a report using this API. The sample report I was provided has two fields that I cannot find here:
    Contact Source
    Subscribes

    Any help you can provide will be greatly appreciated.

Join The Discussion

Your email address will not be published. Required fields are marked *