获取来源统计数据
Get Vendor statistics 获取来源统计数据
VendorStatistics接口允许检索按收件人来源划分的表现统计数据. 可以选择特定时间区间. 有效数据与邮件统计相类似
请求数据格式
请求URL参数:
| 属性 | 类型 | 描述 |
|---|---|---|
| apiKey | string | 你的API Key, 需要验证. 必填. |
| startDate | date | 起始日期.选填. 如未指定, 会应用业务单元创建日期. 格式为YYYY-MM-DD. |
| endDate | date | 终止日期. 选填. 如未指定, 会采用当前日期. 格式为YYYY-MM-DD. |
示例:
| https://api.esv2.com/v2/Api/VendorStatistics?apiKey=YOUR_API_KEY_HERE https://api.esv2.com/v2/Api/VendorStatistics?apiKey=YOUR_API_KEY_HERE&startDate=2010-05-20&endDate=2010-05-22 |
应答数据元素:
| 元素/属性名称 | 类型 | 描述 |
|---|---|---|
| VendorStatistics | array[complex] | VendorStatistic元素组成的数组. |
VendorStatistic 子元素:
| 元素/属性名称 | 类型 | 描述 |
|---|---|---|
| Vendor | string | 来源名称. |
| 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/VendorStatistics?startDate=2011-04-01&apiKey=test_api_key1&endDate=2011-05-01 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 Server: Microsoft-IIS/7.5 X-AspNetMvc-Version: 2.0 X-AspNet-Version: 2.0.50727 Set-Cookie: TIMEZONE=Central European Standard Time; path=/ X-Powered-By: ASP.NET Date: Wed, 19 Oct 2011 11:15:44 GMT Content-Length: 617 <ApiResponse xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”> |