/report/{scheduleID}?type=summary
URL
-
{HOST}/services
/report/{scheduleID}?type=summary
支持格式
HTTP 请求方式
认证方式
请求数限制
请求参数
字段名称 | 是否必选 | 字段类型 | 说明 |
auth | 是 | String | BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种 |
alt | 是 | String | 通过该参数,你可以改变返回值的格式,目前支持的返回值格式包括:atom(默认) ,暂不支持json |
sendTaskId
|
是
|
Number
|
发送计划ID
|
请求字符串
无
返回结果
<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:um="http://www.unimarketing.com.cn/xmlns/">
<title type="text">11</title>
<um:messageName>test0104</um:messageName>
<um:subject>111</um:subject>
<um:from>张三&lt;zeixun2cj5@yeah.net&lt;</um:from>
<um:reply>zhengtest@sina.com</um:reply>
<um:triggerMethod>time</um:triggerMethod>
<um:triggerCondition></um:triggerCondition>
<um:startupTime>2011-01-26 19:13:20</um:startupTime>
<um:optimizePolicy></um:optimizePolicy>
<um:analyticsPolicy></um:analyticsPolicy>
<link href="http://services.unimarketing.com.cn/message/9935" rel="related"></link>
<content type="application/xml">
<summary xmlns="">
<counts>2</counts>
<delivered>2</delivered>
<failured>0</failured>
<hardBounced>0</hardBounced>
<softBounced>0</softBounced>
<opened>0</opened>
<openedAndRepeat>0</openedAndRepeat>
<clicked>0</clicked>
<clickedAndRepeat>0</clickedAndRepeat>
<answer>0</answer>
<answeredAndRepeat>0</answeredAndRepeat>
<friend>0</friend>
<friendAndRepeat>0</friendAndRepeat>
<unsubscribed>0</unsubscribed>
<unsubscribedAndRepeat>0</unsubscribedAndRepeat>
<ispAbuse>0</ispAbuse>
<ispUnSubscribed>0</ispUnSubscribed>
<updated>0</updated>
<updatedAndRepeat>0</updatedAndRepeat>
</summary>
</content>
</entry>
字段说明
字段名称 | 意义 | 数据类型 | 备注 |
title |
发送计划名称 |
String |
|
um:messageName |
邮件名称 |
String |
|
um:subject |
邮件主题 |
String |
|
um:from |
邮件From地址 |
String |
|
um:reply |
回复地址 |
String |
|
um:triggerMethod |
触发方式 |
String |
按时间定时发送
|
um:triggerCondition |
触发条件 |
String |
是否立即触发(immediately)
|
um:startupTime |
开始发送时间 |
String |
|
um:optimizePolicy |
是否启动发送优化 |
String |
|
um:analyticsPolicy |
是否使用了GA分析 |
String |
|
link |
邮件ID |
Number |
|
content |
本次发送详细信息 |
String |
|
norepeat
|
点击数
|
整型
|
表示对于每封邮件的打开,链接点击不记重复数
|
repeat
|
点击数
|
整型
|
表示对于每封邮件的打开,链接点击都将记数
|
counts
|
邮件发送总量
|
整型
|
|
delivered
|
邮件送达总数
|
整型
|
|
failured
|
邮件未送达总数
|
整型
|
|
delivered
|
邮件送达总数
|
整型
|
|
hardBounced
|
邮件硬弹回数
|
整型
|
|
delivered
|
邮件送达总数
|
整型
|
|
softBounced
|
邮件软件弹回数
|
整型
|
|
opened
|
邮件打开不重复数
|
整型
|
|
openedAndRepeat
|
邮件打开重复数
|
整型
|
|
clicked
|
链接打开不重复数
|
整型
|
|
clickedAndRepeat
|
链接打开重复数
|
整型
|
|
answer
|
回答问卷不重复数
|
整型
|
|
answeredAndRepeat
|
回答问卷重复数
|
整型
|
|
delivered
|
邮件送达总数
|
整型
|
|
friend
|
推荐好友不重复数
|
整型
|
|
friendAndRepeat
|
推荐好友重复数
|
整型
|
|
unsubscribed
|
退订不重复数
|
整型
|
|
unsubscribedAndRepeat
|
退订重复数
|
整型
|
|
ispAbuse
|
isp投诉
|
整型
|
|
ispUnSubscribed
|
isp退订
|
整型
|
|
updated
|
联系人更新自身信息不重复数
|
整型
|
|
updatedAndRepeat
|
联系人更新自身信息重复数
|
整型
|
|
调用示例(Java 示例)
import org.apache.abdera.model.Entry;
import cn.unisoftware.api.client.ApiClient;
import cn.unisoftware.api.client.utils.AtomConstants;
import cn.unisoftware.api.client.utils.XmlUtil;
/**
* @description 获取单个发送任务报表数据
* @author DJ
*
*/
public class QuerySingleSendTaskInfo {
/**
* @param args
* @throws Exception
*/
public static void main(String[] args) throws Exception {
ApiClient apiClient = ApiClient.getApiClient(false,ApiClient.AuthMode.APIKEY, new String[]{AtomConstants.apikey,AtomConstants.apisecret});
String taskId = "7070";
Entry res = apiClient.querySingleSendTaskInfo(taskId);
XmlUtil.displayEncodeXml(res);
}
}
备注
- 此接口仅仅支持群发邮件的报表数据,如需要触发邮件报表数据请使用Webhooks接口获取报表明细数据进行统计。