Subscriber Summary History

This document retrieves a subscriber summary for a specific account. Enter the subscriber_summary_id to retrieve details for a subscriber.

Element List

Data Element Type Length Conditional? Description
brand_id int True Brands ID
subscriber_summary_id Int True Subscriber summary ID
month_id Int True Month of the Year
year_id Int True Year
subscribers Int True Number of Subribers that subscribed this month
uploads Int True Number of subscribers uploaded
total Int True Total number of Subscribers to the brand
total_mailings Int True Number of mailings
sent Int True Number of mailings sent to individual subscribers
soft_bounce_count Int True Number of soft bounces
hard_bounce_count Int True Number of hard bounces
html_emails_count Int True Number of html emails
links_clicked_unique_count Int True Number of unique links clicked
ads_clicked Int True Number of ads clicked
ads_clicked_unique Int True Number of unique ads clicked
opens Int True Number of opens
opens_unique Int True Number of unique opens
clicks_facebook_count Int True Number of Facebook clicks
clicks_twitter_count Int True Number of Twitter clicks
clicks_linkedin_count Int True Number of LinkedIn clicks
clicks_addthis_count Int True Number of AddThis clicks
opens_facebook_count Int True Number of Facebook opens
opens_twitter_count Int True Number of Twitter opens
opens_linkedin_count Int True Number of LinkedIn opens
opens_addthis_count Int True Number of AddThis opens

Request 1

<GridRequest xmlns="http://partner.informz.net/aapi/2009/08/">
  <Password></Password>
  <Brand id="nnnn">Brand Name</Brand>
  <User>firstuser1@mail.com</User>
  <Grids>
    <Grid type="subscriber_summary_history">
      <ReturnFields>
        <DataElement>brand_id</DataElement>
        <DataElement>subscriber_summary_id</DataElement>
        <DataElement>month_id</DataElement>
        <DataElement>year_id</DataElement>
        <DataElement>form_subscribers</DataElement>
        <DataElement>uploaded_subscribers</DataElement>
        <DataElement>active_subscribers</DataElement>
        <DataElement>total_mailings</DataElement>
        <DataElement>sent</DataElement>
        <DataElement>soft_bounce_count</DataElement>
        <DataElement>hard_bounce_count</DataElement>
        <DataElement>links_clicked_unique_count</DataElement>
        <DataElement>ads_clicked</DataElement>
        <DataElement>ads_clicked_unique</DataElement>
        <DataElement>opens</DataElement>
        <DataElement>opens_unique</DataElement>
        <DataElement>clicks_facebook_count</DataElement>
        <DataElement>clicks_twitter_count</DataElement>
        <DataElement>clicks_linkedin_count</DataElement>
        <DataElement>clicks_addthis_count</DataElement>
        <DataElement>opens_facebook_count</DataElement>
        <DataElement>opens_twitter_count</DataElement>
        <DataElement>opens_linkedin_count</DataElement>
        <DataElement>opens_addthis_count</DataElement>
      </ReturnFields>
    </Grid>
  </Grids>
</GridRequest>

Request 2

Use the following XML for Demo Data:

<GridRequest xmlns="http://partner.informz.net/aapi/2009/08/">
<GridRequest xmlns="http://partner.informz.net/aapi/2009/08/">
  <Password>firstuser1@mail.com</Password>
  <Brand id="nnnn">Brand Name</Brand>
  <User></User>
  <Grids>
    <Grid type="subscriber_summary_history_demo">
      <ReturnFields>
        <DataElement>brand_id</DataElement>
        <DataElement>subscriber_summary_id</DataElement>
        <DataElement>month_id</DataElement>
        <DataElement>year_id</DataElement>
        <DataElement>form_subscribers</DataElement>
        <DataElement>uploaded_subscribers</DataElement>
        <DataElement>active_subscribers</DataElement>
        <DataElement>total_mailings</DataElement>
        <DataElement>sent</DataElement>
        <DataElement>soft_bounce_count</DataElement>
        <DataElement>hard_bounce_count</DataElement>
        <DataElement>links_clicked_unique_count</DataElement>
        <DataElement>ads_clicked</DataElement>
        <DataElement>ads_clicked_unique</DataElement>
        <DataElement>opens</DataElement>
        <DataElement>opens_unique</DataElement>
        <DataElement>clicks_facebook_count</DataElement>
        <DataElement>clicks_twitter_count</DataElement>
        <DataElement>clicks_linkedin_count</DataElement>
        <DataElement>clicks_addthis_count</DataElement>
        <DataElement>opens_facebook_count</DataElement>
        <DataElement>opens_twitter_count</DataElement>
        <DataElement>opens_linkedin_count</DataElement>
        <DataElement>opens_addthis_count</DataElement>
      </ReturnFields>
    </Grid>
  </Grids>
</GridRequest>