Class: Mailchimp::Reports

Inherits:

Object

Object
Mailchimp::Reports

show all

Defined in:: lib/mailchimp/api.rb

Instance Attribute Summary collapse

#master ⇒ Object
Returns the value of attribute master.

Instance Method Summary collapse

#abuse(cid, opts = []) ⇒ Hash
Get all email addresses that complained about a given campaign.
#advice(cid) ⇒ Array
Retrieve the text presented in our app for how a campaign performed and any advice we may have for you - best suited for display in customized reports pages.
#bounce_message(cid, email) ⇒ Hash
Retrieve the most recent full bounce message for a specific email address on the given campaign.
#bounce_messages(cid, opts = []) ⇒ Hash
Retrieve the full bounce messages for the given campaign.
#click_detail(cid, tid, opts = []) ⇒ Hash
Return the list of email addresses that clicked on a given url, and how many times they clicked.
#clicks(cid) ⇒ Hash
The urls tracked and their click counts for a given campaign.
#domain_performance(cid) ⇒ Array
Get the top 5 performing email domains for this campaign.
#ecomm_orders(cid, opts = []) ⇒ Hash
Retrieve the Ecommerce Orders tracked by campaignEcommOrderAdd().
#eepurl(cid) ⇒ Hash
Retrieve the eepurl stats from the web/Twitter mentions for this campaign.
#geo_opens(cid) ⇒ Array
Retrieve the countries/regions and number of opens tracked for each.
#google_analytics(cid) ⇒ Array
Retrieve the Google Analytics data we've collected for this campaign.
#initialize(master) ⇒ Reports constructor
A new instance of Reports.
#member_activity(cid, emails) ⇒ Hash
Given a campaign and email address, return the entire click and open history with timestamps, ordered by time.
#not_opened(cid, opts = []) ⇒ Hash
Retrieve the list of email addresses that did not open a given campaign.
#opened(cid, opts = []) ⇒ Array
Retrieve the list of email addresses that opened a given campaign with how many times they opened.
#sent_to(cid, opts = []) ⇒ Hash
Get email addresses the campaign was sent to.
#share(cid, opts = []) ⇒ Hash
Get the URL to a customized VIP Report for the specified campaign and optionally send an email to someone with links to it.
#summary(cid) ⇒ Hash
Retrieve relevant aggregate campaign statistics (opens, bounces, clicks, etc.).
#unsubscribes(cid, opts = []) ⇒ Hash
Get all unsubscribed email addresses for a given campaign.

Constructor Details

#initialize(master) ⇒ `Reports`

Returns a new instance of Reports.



1695
1696
1697

# File 'lib/mailchimp/api.rb', line 1695

def initialize(master)
    @master = master
end

Instance Attribute Details

#master ⇒ `Object`

Returns the value of attribute master.



1693
1694
1695

# File 'lib/mailchimp/api.rb', line 1693

def master
  @master
end

Instance Method Details

#abuse(cid, opts = []) ⇒ `Hash`

Get all email addresses that complained about a given campaign

Parameters:

cid (String) —
the campaign id to pull abuse reports for (can be gathered using campaigns())
opts (Hash) (defaults to: []) —
various options for controlling returned data
- [Int] start optional for large data sets, the page number to start at - defaults to 1st page of data (page 0)
- [Int] limit optional for large data sets, the number of results to return - defaults to 25, upper limit set at 100
- [String] since optional pull only messages since this time - 24 hour format in GMT, eg "2013-12-30 20:30:00"

Returns:

(Hash) —

abuse report data for this campaign

[Int] total the total reports matched

[Array] data a struct for the each report, including:

- [String] date date/time the abuse report was received and processed
- [String] member the email address that reported abuse - will only contain email if the list or member has been removed
- [String] type an internal type generally specifying the originating mail provider - may not be useful outside of filling report views

# File 'lib/mailchimp/api.rb', line 1711

def abuse(cid, opts=[])
    _params = {:cid => cid, :opts => opts}
    return @master.call 'reports/abuse', _params
end

#advice(cid) ⇒ `Array`

Retrieve the text presented in our app for how a campaign performed and any advice we may have for you - best suited for display in customized reports pages. Note: some messages will contain HTML - clean tags as necessary

Parameters:

cid (String) —
the campaign id to pull advice text for (can be gathered using campaigns())

Returns:

(Array) —
of structs for advice on the campaign's performance, each containing:
- [String] msg the advice message
- [String] type the "type" of the message. one of: negative, positive, or neutral

# File 'lib/mailchimp/api.rb', line 1721

def advice(cid)
    _params = {:cid => cid}
    return @master.call 'reports/advice', _params
end

#bounce_message(cid, email) ⇒ `Hash`

Retrieve the most recent full bounce message for a specific email address on the given campaign. Messages over 30 days old are subject to being removed

Parameters:

cid (String) —
the campaign id to pull bounces for (can be gathered using campaigns())
email (Hash) —
a struct with one of the following keys - failing to provide anything will produce an error relating to the email address. Providing multiples and will use the first we see in this same order.
- [String] email an email address - this is recommended for this method
- [String] euid the unique id for an email address (not list related) - the email "id" returned from listMemberInfo, Webhooks, Campaigns, etc.
- [String] leid the list email id (previously called web_id) for a list-member-info type call. this doesn't change when the email address changes

Returns:

(Hash) —
the full bounce message for this email+campaign along with some extra data.
- [String] date date the bounce was received and processed
- [Hash] member the member record as returned by lists/member-info
- [String] message the entire bounce message received

# File 'lib/mailchimp/api.rb', line 1736

def bounce_message(cid, email)
    _params = {:cid => cid, :email => email}
    return @master.call 'reports/bounce-message', _params
end

#bounce_messages(cid, opts = []) ⇒ `Hash`

Retrieve the full bounce messages for the given campaign. Note that this can return very large amounts of data depending on how large the campaign was and how much cruft the bounce provider returned. Also, messages over 30 days old are subject to being removed

Parameters:

cid (String) —
the campaign id to pull bounces for (can be gathered using campaigns())
opts (Hash) (defaults to: []) —
various options for controlling returned data
- [Int] start optional for large data sets, the page number to start at - defaults to 1st page of data (page 0)
- [Int] limit optional for large data sets, the number of results to return - defaults to 25, upper limit set at 100
- [String] since optional pull only messages since this time - 24 hour format in GMT, eg "2013-12-30 20:30:00"

Returns:

(Hash) —
data for the full bounce messages for this campaign
- [Int] total that total number of bounce messages for the campaign
- [Array] data structs containing the data for this page
  - [String] date date the bounce was received and processed
  - [Hash] member the member record as returned by lists/member-info
  - [String] message the entire bounce message received

# File 'lib/mailchimp/api.rb', line 1753

def bounce_messages(cid, opts=[])
    _params = {:cid => cid, :opts => opts}
    return @master.call 'reports/bounce-messages', _params
end

#click_detail(cid, tid, opts = []) ⇒ `Hash`

Return the list of email addresses that clicked on a given url, and how many times they clicked

Parameters:

cid (String) —
the campaign id to get click stats for (can be gathered using campaigns())
tid (Int) —
the "tid" for the URL from reports/clicks
opts (Hash) (defaults to: []) —
various options for controlling returned data
- [Int] start optional for large data sets, the page number to start at - defaults to 1st page of data (page 0)
- [Int] limit optional for large data sets, the number of results to return - defaults to 25, upper limit set at 100
- [String] sort_field optional the data to sort by - "clicked" (order clicks occurred, default) or "clicks" (total number of opens). Invalid fields will fall back on the default.
- [String] sort_dir optional the direct - ASC or DESC. defaults to ASC (case insensitive)

Returns:

(Hash) —
containing the total records matched and the specific records for this page
- [Int] total the total number of records matched
- [Array] data structs for each email addresses that click the requested url
  - [Hash] member the member record as returned by lists/member-info
  - [Int] clicks Total number of times the URL was clicked by this email address

# File 'lib/mailchimp/api.rb', line 1771

def click_detail(cid, tid, opts=[])
    _params = {:cid => cid, :tid => tid, :opts => opts}
    return @master.call 'reports/click-detail', _params
end

#clicks(cid) ⇒ `Hash`

The urls tracked and their click counts for a given campaign.

Parameters:

cid (String) —
the campaign id to pull stats for (can be gathered using campaigns())

Returns:

(Hash) —
including:
- [Array] total structs for each url tracked for the full campaign
  - [String] url the url being tracked - urls are tracked individually, so duplicates can exist with vastly different stats
  - [Int] clicks Number of times the specific link was clicked
  - [Double] clicks_percent the percentage of total clicks "clicks" represents
  - [Int] unique Number of unique people who clicked on the specific link
  - [Double] unique_percent the percentage of unique clicks "unique" represents
  - [Int] tid the tracking id used in campaign links - used primarily for reports/click-activity. also can be used to order urls by the order they appeared in the campaign to recreate our heat map.
- [Array] a if this was an absplit campaign, stat structs for the a group
  - [String] url the url being tracked - urls are tracked individually, so duplicates can exist with vastly different stats
  - [Int] clicks Number of times the specific link was clicked
  - [Double] clicks_percent the percentage of total clicks "clicks" represents
  - [Int] unique Number of unique people who clicked on the specific link
  - [Double] unique_percent the percentage of unique clicks "unique" represents
  - [Int] tid the tracking id used in campaign links - used primarily for reports/click-activity. also can be used to order urls by the order they appeared in the campaign to recreate our heat map.
- [Array] b if this was an absplit campaign, stat structs for the b group
  - [String] url the url being tracked - urls are tracked individually, so duplicates can exist with vastly different stats
  - [Int] clicks Number of times the specific link was clicked
  - [Double] clicks_percent the percentage of total clicks "clicks" represents
  - [Int] unique Number of unique people who clicked on the specific link
  - [Double] unique_percent the percentage of unique clicks "unique" represents
  - [Int] tid the tracking id used in campaign links - used primarily for reports/click-activity. also can be used to order urls by the order they appeared in the campaign to recreate our heat map.

# File 'lib/mailchimp/api.rb', line 1800

def clicks(cid)
    _params = {:cid => cid}
    return @master.call 'reports/clicks', _params
end

#domain_performance(cid) ⇒ `Array`

Get the top 5 performing email domains for this campaign. Users wanting more than 5 should use campaign campaignEmailStatsAIM() or campaignEmailStatsAIMAll() and generate any additional stats they require.

Parameters:

cid (String) —
the campaign id to pull email domain performance for (can be gathered using campaigns())

Returns:

(Array) —
domains stricts for each email domains and their associated stats
- [String] domain Domain name or special "Other" to roll-up stats past 5 domains
- [Int] total_sent Total Email across all domains - this will be the same in every row
- [Int] emails Number of emails sent to this domain
- [Int] bounces Number of bounces
- [Int] opens Number of opens
- [Int] clicks Number of clicks
- [Int] unsubs Number of unsubs
- [Int] delivered Number of deliveries
- [Int] emails_pct Percentage of emails that went to this domain (whole number)
- [Int] bounces_pct Percentage of bounces from this domain (whole number)
- [Int] opens_pct Percentage of opens from this domain (whole number)
- [Int] clicks_pct Percentage of clicks from this domain (whole number)
- [Int] unsubs_pct Percentage of unsubs from this domain (whole number)

# File 'lib/mailchimp/api.rb', line 1946

def domain_performance(cid)
    _params = {:cid => cid}
    return @master.call 'reports/domain-performance', _params
end

#ecomm_orders(cid, opts = []) ⇒ `Hash`

Retrieve the Ecommerce Orders tracked by campaignEcommOrderAdd()

Parameters:

cid (String) —
the campaign id to pull orders for for (can be gathered using campaigns())
opts (Hash) (defaults to: []) —
various options for controlling returned data
- [Int] start optional for large data sets, the page number to start at - defaults to 1st page of data (page 0)
- [Int] limit optional for large data sets, the number of results to return - defaults to 25, upper limit set at 100
- [String] since optional pull only messages since this time - 24 hour format in GMT, eg "2013-12-30 20:30:00"

Returns:

(Hash) —
the total matching orders and the specific orders for the requested page
- [Int] total the total matching orders
- [Array] data structs for the actual data for each order being returned
- [String] store_id the store id generated by the plugin used to uniquely identify a store
- [String] store_name the store name collected by the plugin - often the domain name
- [String] order_id the internal order id the store tracked this order by
- [Hash] member the member record as returned by lists/member-info that received this campaign and is associated with this order
- [Double] order_total the order total
- [Double] tax_total the total tax for the order (if collected)
- [Double] ship_total the shipping total for the order (if collected)
- [String] order_date the date the order was tracked - from the store if possible, otherwise the GMT time we received it
- [Array] lines structs containing details of the order:
```
- [Int] line_num the line number assigned to this line
- [Int] product_id the product id assigned to this item
- [String] product_name the product name
- [String] product_sku the sku for the product
- [Int] product_category_id the id for the product category
- [String] product_category_name the product category name
- [Double] qty optional the quantity of the item ordered - defaults to 1
- [Double] cost optional the cost of a single item (ie, not the extended cost of the line) - defaults to 0
```

# File 'lib/mailchimp/api.rb', line 1831

def ecomm_orders(cid, opts=[])
    _params = {:cid => cid, :opts => opts}
    return @master.call 'reports/ecomm-orders', _params
end

#eepurl(cid) ⇒ `Hash`

Retrieve the eepurl stats from the web/Twitter mentions for this campaign

Parameters:

cid (String) —
the campaign id to pull stats for (can be gathered using campaigns())

Returns:

(Hash) —
containing tweets, retweets, clicks, and referrer related to using the campaign's eepurl
- [Hash] twitter various Twitter related stats
  - [Int] tweets Total number of tweets seen
  - [String] first_tweet date and time of the first tweet seen
  - [String] last_tweet date and time of the last tweet seen
  - [Int] retweets Total number of retweets seen
  - [String] first_retweet date and time of the first retweet seen
  - [String] last_retweet date and time of the last retweet seen
  - [Array] statuses an structs for statuses recorded including:
```
- [String] status the text of the tweet/update
- [String] screen_name the screen name as recorded when first seen
- [String] status_id the status id of the tweet (they are really unsigned 64 bit ints)
- [String] datetime the date/time of the tweet
- [Bool] is_retweet whether or not this was a retweet
```
- [Hash] clicks stats related to click-throughs on the eepurl
  - [Int] clicks Total number of clicks seen
  - [String] first_click date and time of the first click seen
  - [String] last_click date and time of the first click seen
  - [Array] locations structs for geographic locations including:
```
- [String] country the country name the click was tracked to
- [String] region the region in the country the click was tracked to (if available)
```
- [Array] referrers structs for referrers, including
  - [String] referrer the referrer, truncated to 100 bytes
  - [Int] clicks Total number of clicks seen from this referrer
  - [String] first_click date and time of the first click seen from this referrer
  - [String] last_click date and time of the first click seen from this referrer

# File 'lib/mailchimp/api.rb', line 1864

def eepurl(cid)
    _params = {:cid => cid}
    return @master.call 'reports/eepurl', _params
end

#geo_opens(cid) ⇒ `Array`

Retrieve the countries/regions and number of opens tracked for each. Email address are not returned.

Parameters:

cid (String) —
the campaign id to pull bounces for (can be gathered using campaigns())

Returns:

(Array) —
an array of country structs where opens occurred
- [String] code The ISO3166 2 digit country code
- [String] name A version of the country name, if we have it
- [Int] opens The total number of opens that occurred in the country
- [Array] regions struct of data for each sub-region in the country
  - [String] code An internal code for the region. When this is blank, it indicates we know the country, but not the region
  - [String] name The name of the region, if we have one. For blank "code" values, this will be "Rest of Country"
  - [Int] opens The total number of opens that occurred in the country

# File 'lib/mailchimp/api.rb', line 1961

def geo_opens(cid)
    _params = {:cid => cid}
    return @master.call 'reports/geo-opens', _params
end

#google_analytics(cid) ⇒ `Array`

Retrieve the Google Analytics data we've collected for this campaign. Note, requires Google Analytics Add-on to be installed and configured.

Parameters:

cid (String) —
the campaign id to pull bounces for (can be gathered using campaigns())

Returns:

(Array) —
of structs for analytics we've collected for the passed campaign.
- [Int] visits number of visits
- [Int] pages number of page views
- [Int] new_visits new visits recorded
- [Int] bounces vistors who "bounced" from your site
- [Double] time_on_site the total time visitors spent on your sites
- [Int] goal_conversions number of goals converted
- [Double] goal_value value of conversion in dollars
- [Double] revenue revenue generated by campaign
- [Int] transactions number of transactions tracked
- [Int] ecomm_conversions number Ecommerce transactions tracked
- [Array] goals structs containing goal names and number of conversions
  - [String] name the name of the goal
  - [Int] conversions the number of conversions for the goal

# File 'lib/mailchimp/api.rb', line 1982

def google_analytics(cid)
    _params = {:cid => cid}
    return @master.call 'reports/google-analytics', _params
end

#member_activity(cid, emails) ⇒ `Hash`

Given a campaign and email address, return the entire click and open history with timestamps, ordered by time. If you need to dump the full activity for a campaign and/or get incremental results, you should use the campaignSubscriberActivity Export API method, not this, especially for large campaigns.

Parameters:

cid (String) —
the campaign id to get stats for (can be gathered using campaigns())
emails (Array) —
an array of up to 50 email address struct to retrieve activity information for
- [String] email an email address
- [String] euid the unique id for an email address (not list related) - the email "id" returned from listMemberInfo, Webhooks, Campaigns, etc.
- [String] leid the list email id (previously called web_id) for a list-member-info type call. this doesn't change when the email address changes

Returns:

(Hash) —

of data and success/error counts

[Int] success_count the number of subscribers successfully found on the list
[Int] error_count the number of subscribers who were not found on the list

[Array] errors array of error structs including:

- [String] email whatever was passed in the email parameter
  - [String] email the email address added
  - [String] euid the email unique id
  - [String] leid the list member's truly unique id
- [String] msg the error message

[Array] data an array of structs where each activity record has:

- [String] email whatever was passed in the email parameter
  - [String] email the email address added
  - [String] euid the email unique id
  - [String] leid the list member's truly unique id
- [Hash] member the member record as returned by lists/member-info
- [Array] activity an array of structs containing the activity, including:
  - [String] action The action name - either open or click
  - [String] timestamp The date/time of the action (GMT)
  - [String] url For click actions, the url clicked, otherwise this is empty
  - [String] ip The IP address the activity came from

# File 'lib/mailchimp/api.rb', line 1895

def member_activity(cid, emails)
    _params = {:cid => cid, :emails => emails}
    return @master.call 'reports/member-activity', _params
end

#not_opened(cid, opts = []) ⇒ `Hash`

Retrieve the list of email addresses that did not open a given campaign

Parameters:

cid (String) —
the campaign id to get no opens for (can be gathered using campaigns())
opts (Hash) (defaults to: []) —
various options for controlling returned data
- [Int] start optional for large data sets, the page number to start at - defaults to 1st page of data (page 0)
- [Int] limit optional for large data sets, the number of results to return - defaults to 25, upper limit set at 100

Returns:

(Hash) —
a total of all matching emails and the specific emails for this page
- [Int] total the total number of members who didn't open the campaign
- [Array] data structs for each campaign member matching as returned by lists/member-info

# File 'lib/mailchimp/api.rb', line 1908

def not_opened(cid, opts=[])
    _params = {:cid => cid, :opts => opts}
    return @master.call 'reports/not-opened', _params
end

#opened(cid, opts = []) ⇒ `Array`

Retrieve the list of email addresses that opened a given campaign with how many times they opened

Parameters:

cid (String) —
the campaign id to get opens for (can be gathered using campaigns())
opts (Hash) (defaults to: []) —
various options for controlling returned data
- [Int] start optional for large data sets, the page number to start at - defaults to 1st page of data (page 0)
- [Int] limit optional for large data sets, the number of results to return - defaults to 25, upper limit set at 100
- [String] sort_field optional the data to sort by - "opened" (order opens occurred, default) or "opens" (total number of opens). Invalid fields will fall back on the default.
- [String] sort_dir optional the direct - ASC or DESC. defaults to ASC (case insensitive)

Returns:

(Array) —
array containing the total records matched and the specific records for this page
- [Int] total the total number of records matched
- [Array] data structs for the actual opens data, including:
```
- [Hash] member the member record as returned by lists/member-info
- [Int] opens Total number of times the campaign was opened by this email address
```

# File 'lib/mailchimp/api.rb', line 1925

def opened(cid, opts=[])
    _params = {:cid => cid, :opts => opts}
    return @master.call 'reports/opened', _params
end

#sent_to(cid, opts = []) ⇒ `Hash`

Get email addresses the campaign was sent to

Parameters:

cid (String) —
the campaign id to pull members for (can be gathered using campaigns())
opts (Hash) (defaults to: []) —
various options for controlling returned data
- [String] status optional the status to pull - one of 'sent', 'hard' (bounce), or 'soft' (bounce). By default, all records are returned
- [Int] start optional for large data sets, the page number to start at - defaults to 1st page of data (page 0)
- [Int] limit optional for large data sets, the number of results to return - defaults to 25, upper limit set at 100

Returns:

(Hash) —
a total of all matching emails and the specific emails for this page
- [Int] total the total number of members for the campaign and status
- [Array] data structs for each campaign member matching
  - [Hash] member the member record as returned by lists/member-info
  - [String] status the status of the send - one of 'sent', 'hard', 'soft'
  - [String] absplit_group if this was an absplit campaign, one of 'a','b', or 'winner'
  - [String] tz_group if this was an timewarp campaign the timezone GMT offset the member was included in

# File 'lib/mailchimp/api.rb', line 2000

def sent_to(cid, opts=[])
    _params = {:cid => cid, :opts => opts}
    return @master.call 'reports/sent-to', _params
end

Get the URL to a customized VIP Report for the specified campaign and optionally send an email to someone with links to it. Note subsequent calls will overwrite anything already set for the same campign (eg, the password)

Parameters:

cid (String) —
the campaign id to share a report for (can be gathered using campaigns())
opts (Array) (defaults to: []) —
optional various parameters which can be used to configure the shared report
- [String] to_email optional - optional, comma delimited list of email addresses to share the report with - no value means an email will not be sent
- [Int] theme_id optional - either a global or a user-specific theme id. Currently this needs to be pulled out of either the Share Report or Cobranding web views by grabbing the "theme" attribute from the list presented.
- [String] css_url optional - a link to an external CSS file to be included after our default CSS (http://vip-reports.net/css/vip.css) only if loaded via the "secure_url" - max 255 bytes

Returns:

(Hash) —
details for the shared report, including:
- [String] title The Title of the Campaign being shared
- [String] url The URL to the shared report
- [String] secure_url The URL to the shared report, including the password (good for loading in an IFRAME). For non-secure reports, this will not be returned
- [String] password If secured, the password for the report, otherwise this field will not be returned

# File 'lib/mailchimp/api.rb', line 2016

def share(cid, opts=[])
    _params = {:cid => cid, :opts => opts}
    return @master.call 'reports/share', _params
end

#summary(cid) ⇒ `Hash`

Retrieve relevant aggregate campaign statistics (opens, bounces, clicks, etc.)

Parameters:

cid (String) —
the campaign id to pull stats for (can be gathered using campaigns())

Returns:

(Hash) —
the statistics for this campaign
- [Int] syntax_errors Number of email addresses in campaign that had syntactical errors.
- [Int] hard_bounces Number of email addresses in campaign that hard bounced.
- [Int] soft_bounces Number of email addresses in campaign that soft bounced.
- [Int] unsubscribes Number of email addresses in campaign that unsubscribed.
- [Int] abuse_reports Number of email addresses in campaign that reported campaign for abuse.
- [Int] forwards Number of times email was forwarded to a friend.
- [Int] forwards_opens Number of times a forwarded email was opened.
- [Int] opens Number of times the campaign was opened.
- [String] last_open Date of the last time the email was opened.
- [Int] unique_opens Number of people who opened the campaign.
- [Int] clicks Number of times a link in the campaign was clicked.
- [Int] unique_clicks Number of unique recipient/click pairs for the campaign.
- [String] last_click Date of the last time a link in the email was clicked.
- [Int] users_who_clicked Number of unique recipients who clicked on a link in the campaign.
- [Int] emails_sent Number of email addresses campaign was sent to.
- [Int] unique_likes total number of unique likes (Facebook)
- [Int] recipient_likes total number of recipients who liked (Facebook) the campaign
- [Int] facebook_likes total number of likes (Facebook) that came from Facebook
- [Hash] absplit If this was an absplit campaign, stats for the A and B groups will be returned - otherwise this is empty
  - [Int] bounces_a bounces for the A group
  - [Int] bounces_b bounces for the B group
  - [Int] forwards_a forwards for the A group
  - [Int] forwards_b forwards for the B group
  - [Int] abuse_reports_a abuse reports for the A group
  - [Int] abuse_reports_b abuse reports for the B group
  - [Int] unsubs_a unsubs for the A group
  - [Int] unsubs_b unsubs for the B group
  - [Int] recipients_click_a clicks for the A group
  - [Int] recipients_click_b clicks for the B group
  - [Int] forwards_opens_a opened forwards for the A group
  - [Int] forwards_opens_b opened forwards for the B group
  - [Int] opens_a total opens for the A group
  - [Int] opens_b total opens for the B group
  - [String] last_open_a date/time of last open for the A group
  - [String] last_open_b date/time of last open for the BG group
  - [Int] unique_opens_a unique opens for the A group
  - [Int] unique_opens_b unique opens for the B group
- [Array] timewarp If this campaign was a Timewarp campaign, an array of structs from each timezone stats exist for. Each will contain:
```
- [Int] opens opens for this timezone
- [String] last_open the date/time of the last open for this timezone
- [Int] unique_opens the unique opens for this timezone
- [Int] clicks the total clicks for this timezone
- [String] last_click the date/time of the last click for this timezone
- [Int] unique_opens the unique clicks for this timezone
- [Int] bounces the total bounces for this timezone
- [Int] total the total number of members sent to in this timezone
- [Int] sent the total number of members delivered to in this timezone
```
- [Array] timeseries structs for the first 24 hours of the campaign, per-hour stats:
```
- [String] timestamp The timestemp in Y-m-d H:00:00 format
- [Int] emails_sent the total emails sent during the hour
- [Int] unique_opens unique opens seen during the hour
- [Int] recipients_click unique clicks seen during the hour
```

# File 'lib/mailchimp/api.rb', line 2076

def summary(cid)
    _params = {:cid => cid}
    return @master.call 'reports/summary', _params
end

#unsubscribes(cid, opts = []) ⇒ `Hash`

Get all unsubscribed email addresses for a given campaign

Parameters:

cid (String) —
the campaign id to pull bounces for (can be gathered using campaigns())
opts (Hash) (defaults to: []) —
various options for controlling returned data
- [Int] start optional for large data sets, the page number to start at - defaults to 1st page of data (page 0)
- [Int] limit optional for large data sets, the number of results to return - defaults to 25, upper limit set at 100

Returns:

(Hash) —
a total of all unsubscribed emails and the specific members for this page
- [Int] total the total number of unsubscribes for the campaign
- [Array] data structs for the email addresses that unsubscribed
  - [String] member the member that unsubscribed as returned by lists/member-info
  - [String] reason the reason collected for the unsubscribe. If populated, one of 'NORMAL','NOSIGNUP','INAPPROPRIATE','SPAM','OTHER'
  - [String] reason_text if the reason is OTHER, the text entered.

# File 'lib/mailchimp/api.rb', line 2092

def unsubscribes(cid, opts=[])
    _params = {:cid => cid, :opts => opts}
    return @master.call 'reports/unsubscribes', _params
end

Class: Mailchimp::Reports

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(master) ⇒ Reports

Instance Attribute Details

#master ⇒ Object

Instance Method Details

#abuse(cid, opts = []) ⇒ Hash

#advice(cid) ⇒ Array

#bounce_message(cid, email) ⇒ Hash

#bounce_messages(cid, opts = []) ⇒ Hash

#click_detail(cid, tid, opts = []) ⇒ Hash

#clicks(cid) ⇒ Hash

#domain_performance(cid) ⇒ Array

#ecomm_orders(cid, opts = []) ⇒ Hash

#eepurl(cid) ⇒ Hash

#geo_opens(cid) ⇒ Array

#google_analytics(cid) ⇒ Array

#member_activity(cid, emails) ⇒ Hash

#not_opened(cid, opts = []) ⇒ Hash

#opened(cid, opts = []) ⇒ Array

#sent_to(cid, opts = []) ⇒ Hash

#share(cid, opts = []) ⇒ Hash

#summary(cid) ⇒ Hash

#unsubscribes(cid, opts = []) ⇒ Hash

#initialize(master) ⇒ `Reports`

#master ⇒ `Object`

#abuse(cid, opts = []) ⇒ `Hash`

#advice(cid) ⇒ `Array`

#bounce_message(cid, email) ⇒ `Hash`

#bounce_messages(cid, opts = []) ⇒ `Hash`

#click_detail(cid, tid, opts = []) ⇒ `Hash`

#clicks(cid) ⇒ `Hash`

#domain_performance(cid) ⇒ `Array`

#ecomm_orders(cid, opts = []) ⇒ `Hash`

#eepurl(cid) ⇒ `Hash`

#geo_opens(cid) ⇒ `Array`

#google_analytics(cid) ⇒ `Array`

#member_activity(cid, emails) ⇒ `Hash`

#not_opened(cid, opts = []) ⇒ `Hash`

#opened(cid, opts = []) ⇒ `Array`

#sent_to(cid, opts = []) ⇒ `Hash`

#share(cid, opts = []) ⇒ `Hash`

#summary(cid) ⇒ `Hash`

#unsubscribes(cid, opts = []) ⇒ `Hash`