灵动创新 Unimarketing 邮件营销 EDM

/report/{scheduleID}?type=summary

目录

/report/{scheduleID}?type=summary

  • 查询发送任务:汇总报表

URL

  • {HOST}/services /report/{scheduleID}?type=summary

支持格式

  • XML(Atom)

HTTP 请求方式

  • GET

认证方式

请求数限制

  • true

请求参数

字段名称 是否必选 字段类型 说明
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>张三&amp;lt;zeixun2cj5@yeah.net&amp;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接口获取报表明细数据进行统计。
平台介绍
关于我们 | 联系我们 | 行业应用 | 专业术语 | 资源中心 | 隐私声明
© 2022 灵动创新(北京)科技有限公司 - 京ICP备16028763号-1