获取链接统计数据
Get link statistics 获取链接统计数据
链接统计(LinkStatistics)接口允许检索单一指定邮件中各个链接的具体表现数据。适用于任意有点击数及独立点击数统计的链接。
请求数据格式
请求 URL 参数:
| 参数 | 类型 | 描述 |
|---|---|---|
| apiKey | string | 你的API Key, 需要验证. 必填. |
| ID | int | 邮件 ID. 要求以地址一部分的形式应用 (非 GET 参数). 见下例. |
| startDate | date | 起始日期. 选填. 所有参数 (startDate，endDate) 都用来指定统计范围。否则会被忽略. YYYY-MM-DD 格式. |
| endDate | date | 见 startDate. |
示例:
| https://api.esv2.com/v2/Api/LinkStatistics/123?apiKey=YOUR_API_KEY_HERE
https://api.esv2.com/v2/Api/LinkStatistics/123?apiKey=YOUR_API_KEY_HERE&startDate=2010-05-20&endDate=2010-05-22
|
应答
应答数据元素:
| 元素/属性 | 类型 | 描述 |
|---|---|---|
| LinkStatistics | array[complex] | LinkStatistic元素组成的数组. |
LinkStatistic 子元素:
| 元素/属性 | 类型 | 描述 |
|---|---|---|
| Url | string | 链接 URL. |
| Title | string | 链接标题. 选填. |
| Clicks | int | 点击链接次数. |
| UniqueClicks | int | 各个链接被不同收件人第一次点击的总次数. |
示例
请求:
| GET
https://api.esv2.com/v2/Api/LinkStatistics/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=znbbf255rwgtzketrup04q55; path=/; HttpOnly X-AspNetMvc-Version: 1.0 X-AspNet-Version: 2.0.50727 X-Powered-By: ASP.NET Date: Mon, 24 May 2010 13:05:25 GMT Content-Length: 286 <ApiResponse |