details/{scheduleID}?event={eventName}&start-date={start-date}&finish-date={finish-date}&start-index={start-index}&max-results={max-results}

目录 1 details/{scheduleID}?event={eventName}&start-date={start-date}&finish-date={finish-date}&start-index={start-index}&max-results={max-results} 2 URL 3 支持格式 4 HTTP 请求方式 5 认证方式 6 请求数限制 7 请求参数 8 请求字符串 9 返回结果 10 调用实例

details/{scheduleID}?event={eventName}&start-date={start-date}&finish-date={finish-date}&start-index={start-index}&max-results={max-results}

• 查询发送任务:打开、链接点击明细报表

URL

• {HOST}/services /details/{scheduleID}?event={eventName}&start-date={start-date}&finish-date={finish-date}&start-index={start-index}&max-results={max-results}

支持格式

• XML(Atom)

HTTP 请求方式

• POST

认证方式

• 1. BASIC
  2. APIKEY
  3. OAUTH
  

请求数限制

• true

请求参数

字段名称	是否必选	字段类型	说明
auth	是	String	BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt	是	String	通过该参数，你可以改变返回值的格式，目前支持的返回值格式包括：atom(默认) ，暂不支持json
scheduleID	是	Number	发送计划ID
eventName	是	String	打开／点击(open/click)
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" xmlns:gd="http://schemas.google.com/g/2005" xmlns:um="http://www.unimarketing.com.cn/xmlns/" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/">
<openSearch:itemsPerPage>3</openSearch:itemsPerPage>
<openSearch:startIndex>1</openSearch:startIndex>
<openSearch:totalResults>5</openSearch:totalResults><entry>
<link href="http://www.unimarketing.com.cn/link/open" rel="related"></link>
<id>http://services.unimarketing.com.cn/contact/10809994</id>
<updated>2012-09-13T10:43:48.000Z</updated>
<um:location>其他/其他/其他</um:location>
<um:device></um:device>
<um:platform></um:platform>
<um:client></um:client>
</entry>
<entry>
<link href="http://www.unimarketing.com.cn/link/open" rel="related"></link>
<id>http://services.unimarketing.com.cn/contact/10809994</id>
<updated>2012-09-13T10:45:57.000Z</updated>
<um:location>中国/澳门/安庆</um:location>
<um:device></um:device>
<um:platform></um:platform>
<um:client></um:client>
</entry>
<entry>
<link href="http://www.unimarketing.com.cn/link/open" rel="related"></link>
<id>http://services.unimarketing.com.cn/contact/10809994</id>
<updated>2012-09-13T12:09:10.000Z</updated>
<um:location>中国/安徽/蚌埠</um:location>
<um:device></um:device>
<um:platform>Android</um:platform>
<um:client>Safari</um:client>
</entry>
</feed>
 

字段说明

字段名称	意义	数据类型	备注
updated	时间	日期
um:location	地理位置	字符串
um:device	设备	字符串
um:platform	操作系统平台	字符串
um:client	客户端	字符串

调用示例(Java 示例)

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

import java.util.ArrayList;
import java.util.List;

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

/**
 * @description 查询发送任务：打开、链接点击明细报表
 * @author chenlei
 * @test 【true】
 */
public class QueryReportEvent {

	/**
	 * @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});
		
		Long scheduleID = 11078;
		String eventName="open";
		String start-date="2006-03-04";
		String finish-date = "2014-05-05";
		int start-index=1;
		int max-result=100;
		unimailClient.queryReportEvent(scheduleID,eventName,start-date,finish-date,start-index,max-result);

	}

}

                  
 

备注

• 此接口仅仅支持群发邮件的报表数据，如需要触发邮件报表数据请使用Webhooks接口获取报表明细数据进行统计。