获取短信/彩信链接统计数据

Get Link Statistics 获取短信/彩信链接数据统计

SmsMmsLinkStatistic链接统计接口允许检索指定短信/彩信消息中各个链接的具体统计数据. 包含每个链接的点击和独立点击的数目.

请求数据格式

请求URL参数:
参数 类型 描述
apiKey string 你的API Key, 需要验证. 必填.
ID int 短信/彩信消息ID. 要求以地址一部分的形式应用 (非GET参数). 见下例.
startDate date 起始日期. 选填. 所有参数 (startDate，endDate) 都必须用来指定统计范围. 否则会被忽略. YYYY-MM-DD 格式.
endDate date 见起始日期.
示例:
https://api.esv2.com/v2/Api/SmsMmsLinkStatistics/123?apiKey=YOUR_API_KEY_HERE 
https://api.esv2.com/v2/Api/SmsMmsLinkStatistics/123?apiKey=YOUR_API_KEY_HERE&startDate=2017-05-20&endDate=2017-05-22

应答

应答数据元素:
元素/属性 类型 描述
LinkStatistics array[complex] LinkStatistic元素组成的数组


LinkStatistic子元素:

元素/属性 类型 描述
Url string URL链接
Title string 链接名称. 选填.
Clicks int 链接点击数量
UniqueClicks int 独立点击任意链接的收件人数量.

示例

请求:
GET 

https://api.esv2.com/v2/Api/SmsMmsLinkStatistics/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 2017 13:05:25 GMT
Content-Length: 286

<ApiResponse xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
 <Data>
  <LinkStatistics>
   <LinkStatistic>
    <Url>http://www.msn.com</Url>
    <Clicks>5</Clicks>
    <UniqueClicks>1</UniqueClicks>
   </LinkStatistic>
   <LinkStatistic>
    <Url>http://www.google.com</Url>
    <Title>Google Link</Title>
    <Clicks>2</Clicks>
    <UniqueClicks>1</UniqueClicks>
   </LinkStatistic>
   <LinkStatistic>
    <Url>http://www.cnn.com</Url>
    <Title>CNN</Title>
    <Clicks>5</Clicks>
    <UniqueClicks>2</UniqueClicks>
   </LinkStatistic>
  </LinkStatistics>
 </Data>
</ApiResponse>