获取邮件统计数据

Get message statistics获取邮件统计数据

邮件统计数据(MessageStatistics) 接口允许检索特定邮件的表现数据。可以选择某一特定时间区间。统计数据包括已发送，已送达及退信，以及因此产生的点击，打开，退订等.

请求数据格式

请求 URL 参数:

参数 类型 描述
apiKey string 你的API Key, 需要验证. 必填.
ID int 邮件ID. 要求以地址一部分的形式应用 (非GET参数).见下例.
startDate date 起始日期. 选填. 如未指定, 将会采取邮件创建日期. 格式为YYYY-MM-DD.
endDate date 结束日期. 选填. 如未指定，会采用当前日期. 格式为YYYY-MM-DD .

示例：

https://api.esv2.com/v2/Api/MessageStatistics/123?apiKey=YOUR_API_KEY_HERE 

https://api.esv2.com/v2/Api/MessageStatistics/123?apiKey=YOUR_API_KEY_HERE&startDate=2010-05-20&endDate=2010-05-22

应答

应答数据元素:
元素/属性 类型 描述
Sent int 已发送邮件数目.
Bounced int 退信邮件数目.
Delivered int 已送达邮件数目 (已发送减去退信)
Opens int 已打开邮件数目.
UniqueOpens int 打开邮件的收件人数目.
Clicks int 链接点击数目.
UniqueClicks int 各个链接被不同收件人第一次点击的总次数.
Clickers int 点击链接的收件人数目.
Complaints int 垃圾邮件投诉数目.
Unsubscribes int 退订链接点击数目.

示例

请求:
GET 

https://api.esv2.com/v2/Api/MessageStatistics/764?apiKey=test_api_key1 HTTP/1.1 
Accept-Encoding: gzip,deflate 
User-Agent: Jakarta Commons-HttpClient/3.1 
Host: api.esv2.com
OK 应答:
HTTP/1.1 200 OK
Cache-Control: private
Content-Type: text/xml; charset=utf-8
Content-Encoding: gzip
Vary: Accept-Encoding
Server: Microsoft-IIS/7.5
Set-Cookie: ASP.NET_SessionId=conq5cmaq3mmpy455bkihvyd; path=/; HttpOnly
X-AspNetMvc-Version: 1.0
X-AspNet-Version: 2.0.50727
X-Powered-By: ASP.NET
Date: Mon, 24 May 2010 13:03:04 GMT
Content-Length: 351<ApiResponse
xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
 <Data>
  <Sent>9</Sent>
  <Bounced>0</Bounced>
  <Delivered>9</Delivered>
  <Opens>19</Opens>
  <UniqueOpens>1</UniqueOpens>
  <Clicks>12</Clicks>
  <UniqueClicks>3</UniqueClicks>
  <Clickers>3</Clickers>
  <Complaints>0</Complaints>
  <Unsubscribes>0</Unsubscribes>
 </Data>
</ApiResponse>