灵动创新 Unimarketing 邮件营销 EDM

report/contact/summary?start-date=2012-01-01&finish-date=2012-12-12

目录

report/contact/summary?start-date=2012-01-01&finish-date=2012-12-12

  • 查询联系人:汇总报表

URL

  • {HOST}/services report/contact/summary?start-date=2012-01-01&finish-date=2012-12-12&start-index=1&max-results=10

支持格式

  • XML(Atom)

HTTP 请求方式

  • POST

认证方式

请求数限制

  • true

请求参数

字段名称 是否必选 字段类型 说明
auth String BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt String 通过该参数,你可以改变返回值的格式,目前支持的返回值格式包括:atom(默认) ,暂不支持json
start-date String 开始时间
finish-date String 结束时间
start-index Number 开始记录数
max-results Number 最大记录数

请求字符串

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
   <link href="http://services.unimarketing.com.cn/schedule/13801" rel="related"/>
 <entry>
    <email>405593861@qq.com</email>
 </entry>

</feed>

							

返回结果

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:gd="http://schemas.google.com/g/2005" xmlns:um="http://www.unimarketing.com.cn/xmlns/">
<entry>
<id>http://services.unimarketing.com.cn/contact/15070568</id>
<email>405593861@qq.com</email>
<um:sends>0</um:sends>
<um:deliveries>0</um:deliveries>
<um:opens>0</um:opens>
<um:clicks>0</um:clicks>
</entry>
</feed>
 

字段说明

字段名称 意义 数据类型 备注
um:sends 发送数 Number
um:deliveries 送达数 Number
um:bounces 弹回数 Number 此次接口不展现这个数据
um:opens 打开数 Number
um:clicks 点击数 Number

调用示例(Java 示例)

 package cn.unisoftware.api.client.example.report;

import java.io.IOException;
import java.io.StringReader;
import java.io.StringWriter;
import java.io.Writer;
import java.util.ArrayList;
import java.util.List;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;
import org.apache.abdera.model.Feed;
import org.w3c.dom.Document;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;

import com.sun.org.apache.xml.internal.serialize.OutputFormat;
import com.sun.org.apache.xml.internal.serialize.XMLSerializer;


import cn.unisoftware.api.client.UnimailClient;
import cn.unisoftware.api.client.utils.AtomConstants;

/**
 * @description 查询联系人报表汇总
 * @author chenlei
 * @test 【true】
 */
public class QueryContactsSummary {

	/**
	 * @Title: main
	 * @Description:
	 * @param @param args    设定文件
	 * @return void    
	 * @throws Exception 
	 * @throws
	 */
	public static void main(String[] args) throws Exception {
		UnimailClient unimailClient = UnimailClient.getClient(false,UnimailClient.AuthMode.BASIC, new String[] {AtomConstants.userName, AtomConstants.userPwd});
		List emails = new ArrayList();
		String scheduleId="11108";
		Feed feed = unimailClient.queryContactsSummary(scheduleId,"2012-06-25", "2014-05-05", emails);
		System.out.println(format(feed.toString()));
		
		
	}
                  
 

备注

  • 此接口仅仅支持群发邮件的报表数据,如需要触发邮件报表数据请使用Webhooks接口获取报表明细数据进行统计。
平台介绍
关于我们 | 联系我们 | 行业应用 | 专业术语 | 资源中心 | 隐私声明
© 2022 灵动创新(北京)科技有限公司 - 京ICP备16028763号-1