Mailing Activity

This document retrieves all mailing summary details. Enter the mailing_instance_id to retrieve details for that specific mailing instance.

Element List

Data Element Type Length Conditional? Description
aol_complaint_count Int False Number of AOL complaints
blocked_count Int False Number of blocks
bounces_resent_count Int False Number of resent blocked mailings (optional feature)
calculation_date DateTime False The "as of" DateTime for the stats
challenge_count Int False Number of ISP challenges
Count Int False Number of matches found based upon criteria used
forwards_unique_count Int False Number of unique forwards
hard_bounce_count Int False Number of hard bounces
html_emails_count             Int False Number of mailings specified to go in HTML format
html_emails_bounce_count Int False Number of HTML formats that bounced
links_clicked_unique_count Int False Number of unique clicked links
mailing_ID Int True Unique ID for a mailing
mailing_instance_ID Int False Unique ID for a mailing instance
opens_unique_count Int False Number of unique opens
opt_out_count Int False Number of opt outs that occurred
send_a_friend_count Int False Number of "Send a Friend" (forwards) that occurred
sent_count Int False Number sent
soft_bounce_count Int False Number of soft bounces
text_emails_count Int False Number of emails specified to go in text format
text_emails_bounce_count Int False Number of text formats that bounced
unsubscribes_count Int False Number of unsubscribes that occurred
opens_skim_count Int False Number of opens that skimmed the mailing
opens_read_count Int False Number of opens that read the mailing
clicks_facebook_count Int False Number of clicks on Facebook
clicks_twitter_count Int False Number of clicks on Twitter
clicks_linkedin_count Int False Number of clicks on LinkedIn
clicks_addthis_count Int False Number of clicks on Addthis
opens_mobile_count Int False Number of opens on Mobile Devices
opens_desktop_count Int False Number of opens on Desktop Computers
opens_unknown_count Int False Number of opens on Unknown Devices
opens_web_browser_count Int False Number of opens on web browsers
opens_web_based_email_count Int False Number of opens on web based emails
opens_facebook_count Int False Number of opens on Facebook
opens_twitter_count Int False Number of opens on Twitter
opens_linkedin_count Int False Number of opens on LinkedIn
opens_addthis_count Int False Number of opens on Addthis
clicks_mailing_post_facebook_count Int False Number of Mailing Posts to Facebook
clicks_mailing_post_twitter_count Int False Number of Mailing Posts to Twitter
web_track_sessions_count Int False Number of web tracking sessions
web_track_unique_sessions_count Int False Number of unique web tracking sessions
web_track_pages_count Int False Number of web tracking pages
web_track_duration_count Int False Web tracking duration
web_track_events_count Int False Number of web tracking events
web_track_transactions_count Int False Number of web tracking transactions
web_track_transaction_value Int False Total value of web tracking transactions
web_track_view_pages_count Int False Number of web tracking pages viewed
mailing_date DateTime False Date of the Mailing
mailing_name String 1000 False Name of the Mailing

Request 1

<GridRequest xmlns="http://partner.informz.net/aapi/2009/08/">
<Password></Password>
<Brand id="9999">Test Brand</Brand>
<User></User>
  <Grids>
  <Grid type="mailing_activity">
   <ReturnFields>
<DataElement>mailing_instance_id</DataElement>
<DataElement>mailing_id</DataElement>
<DataElement>brand_id</DataElement>
<DataElement>sent_count</DataElement>
<DataElement>soft_bounce_count</DataElement>
<DataElement>hard_bounce_count</DataElement>
<DataElement>aol_complaint_count</DataElement>
<DataElement>challenge_count</DataElement>
<DataElement>bounces_resent_count</DataElement>
<DataElement>blocked_count</DataElement>
<DataElement>text_emails_count</DataElement>
<DataElement>html_emails_count</DataElement>
<DataElement>links_clicked_unique_count</DataElement>
<DataElement>opens_unique_count</DataElement>
<DataElement>forwards_unique_count</DataElement>
<DataElement>unsubscribes_count</DataElement>
<DataElement>send_a_friend_count</DataElement>
<DataElement>calculation_date</DataElement>
<DataElement>text_emails_bounce_count</DataElement>
<DataElement>html_emails_bounce_count</DataElement>
<DataElement>opt_out_count</DataElement>
<DataElement>count</DataElement>
<DataElement>opens_skim_count</DataElement>
<DataElement>opens_read_count</DataElement>
<DataElement>clicks_facebook_count</DataElement>
<DataElement>clicks_twitter_count</DataElement>
<DataElement>clicks_linkedin_count</DataElement>
<DataElement>clicks_addthis_count</DataElement>
<DataElement>opens_mobile_count</DataElement>
<DataElement>opens_desktop_count</DataElement>
<DataElement>opens_unknown_count</DataElement>
<DataElement>opens_web_browser_count</DataElement>
<DataElement>opens_web_based_email_count</DataElement>
<DataElement>opens_facebook_count</DataElement>
<DataElement>opens_twitter_count</DataElement>
<DataElement>opens_linkedin_count</DataElement>
<DataElement>opens_addthis_count</DataElement>
<DataElement>clicks_mailing_post_facebook_count</DataElement>
<DataElement>clicks_mailing_post_twitter_count</DataElement>
<DataElement>web_track_sessions_count</DataElement>
<DataElement>web_track_unique_sessions_count</DataElement>
<DataElement>web_track_pages_count</DataElement>
<DataElement>web_track_pages_count</DataElement>
<DataElement>web_track_duration_count</DataElement>
<DataElement>web_track_events_count</DataElement>
<DataElement>web_track_transactions_count</DataElement>
<DataElement>web_track_transaction_value</DataElement>
<DataElement>web_track_view_pages_count</DataElement>
<DataElement>mailing_date</DataElement>
<DataElement>mailing_name</DataElement>
   </ReturnFields>
   </Grid>
 </Grids>

Request 2

Use the following XML for Demo Data:

<GridRequest xmlns="http://partner.informz.net/aapi/2009/08/">
 <Password></Password>
 <Brand id="9999">Test Brand</Brand>
 <User></User>
  <Grids>
  <Grid type="mailing_activity_demo">
   <ReturnFields>
<DataElement>mailing_instance_id</DataElement>
<DataElement>mailing_id</DataElement>
<DataElement>brand_id</DataElement>
<DataElement>sent_count</DataElement>
<DataElement>soft_bounce_count</DataElement>
<DataElement>hard_bounce_count</DataElement>
<DataElement>aol_complaint_count</DataElement>
<DataElement>challenge_count</DataElement>
<DataElement>bounces_resent_count</DataElement>
<DataElement>blocked_count</DataElement>
<DataElement>text_emails_count</DataElement>
<DataElement>html_emails_count</DataElement>
<DataElement>links_clicked_unique_count</DataElement>
<DataElement>opens_unique_count</DataElement>
<DataElement>forwards_unique_count</DataElement>
<DataElement>unsubscribes_count</DataElement>
<DataElement>send_a_friend_count</DataElement>
<DataElement>calculation_date</DataElement>
<DataElement>text_emails_bounce_count</DataElement>
<DataElement>html_emails_bounce_count</DataElement>
<DataElement>opt_out_count</DataElement>
<DataElement>count</DataElement>
<DataElement>opens_skim_count</DataElement>
<DataElement>opens_read_count</DataElement>
<DataElement>clicks_facebook_count</DataElement>
<DataElement>clicks_twitter_count</DataElement>
<DataElement>clicks_linkedin_count</DataElement>
<DataElement>clicks_addthis_count</DataElement>
<DataElement>opens_mobile_count</DataElement>
<DataElement>opens_desktop_count</DataElement>
<DataElement>opens_unknown_count</DataElement>
<DataElement>opens_web_browser_count</DataElement>
<DataElement>opens_web_based_email_count</DataElement>
<DataElement>opens_facebook_count</DataElement>
<DataElement>opens_twitter_count</DataElement>
<DataElement>opens_linkedin_count</DataElement>
<DataElement>opens_addthis_count</DataElement>
<DataElement>clicks_mailing_post_facebook_count</DataElement>
<DataElement>clicks_mailing_post_twitter_count</DataElement>
<DataElement>web_track_sessions_count</DataElement>
<DataElement>web_track_unique_sessions_count</DataElement>
<DataElement>web_track_pages_count</DataElement>
<DataElement>web_track_pages_count</DataElement>
<DataElement>web_track_duration_count</DataElement>
<DataElement>web_track_events_count</DataElement>
<DataElement>web_track_transactions_count</DataElement>
<DataElement>web_track_transaction_value</DataElement>
<DataElement>web_track_view_pages_count</DataElement>
<DataElement>mailing_date</DataElement>
<DataElement>mailing_name</DataElement>
   </ReturnFields>
  </Grid>
 </Grids>

Notes

Use the MailingDetails document to get the individual email addresses that make up these aggregated values.