灵动创新 Unimarketing 邮件营销 EDM

/report/{scheduleID}?type=contact&status={statusName}

目录

/report/{scheduleID}?type=contact&status={statusName}

  • 查询发送任务:联系人送达明细报表

URL

  • {HOST}/services /report/{scheduleID}?type=contact&status={statusName}

支持格式

  • XML(Atom)

HTTP 请求方式

  • GET

认证方式

请求数限制

  • true

请求参数

字段名称 是否必选 字段类型 说明
auth String BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt String 通过该参数,你可以改变返回值的格式,目前支持的返回值格式包括:atom(默认) ,暂不支持json
sendTaskId Number 发送任务ID
type String contact 联系人信息类别
status String send:发送
derlived:已送达
fail:失败
hard:硬弹回
soft:软弹回
open:邮件打开(交易邮件除外,打开数将小于总数(因为统计数按联系人去重))
click:点击(交易邮件除外,点击数将小于总数(因为统计数按联系人去重))
survey:回答问卷(交易邮件除外,回答问卷将小于总数(因为统计数按联系人去重))
forward:推荐好友(交易邮件除外,推荐好友将小于总数(因为统计数按联系人去重))
unsub:退订
update:更新自身信息
unsubscribe:退订(总计)
ispunsubscribe:ISP退订
complaint:投诉(总计)
ispcomplaint:ISP投诉
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>10</openSearch:itemsPerPage>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:totalResults>3</openSearch:totalResults>
  <entry>
    <id>http://services.unimarketing.com.cn/contact/7937619</id>
    <email>unimail2011@163.com</email>
  </entry>
  <entry>
    <id>http://services.unimarketing.com.cn/contact/7937618</id>
    <email>unimail2012@163.com</email>
  </entry>
  <entry>
    <id>http://services.unimarketing.com.cn/contact/7924364</id>
    <email>dejian.liu@unimarketing.com.cn</email>
  </entry>
</feed>

  

字段说明

字段名称 意义 数据类型 备注
id 联系人ID Number
email 联系人Email地址 String

调用示例(Java 示例)

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

import org.apache.abdera.model.Feed;

import cn.unisoftware.api.client.ApiClient;
import cn.unisoftware.api.client.utils.AtomConstants;
import cn.unisoftware.api.client.utils.XmlUtil;

/**
 * @description 	获取发送联系人信息
 * @author DJ
 * @test  【true】
 */
public class QuerySendContactInfo {

	/**
	 * 字符串	
	send:发送
	derlived:已送达
	fail:失败
	hard:硬弹回
	soft:软弹回
	open:邮件打开
	click:点击
	survey:回答问卷
	forward:推荐好友
	unsub:退订
	update:更新自身信息
	unsubscribe:退订(总计)
	ispunsubscribe:ISP退订
	complaint:投诉(总计)
	ispcomplaint:ISP投诉

	 * @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"; 
		Feed feed = apiClient.querySendContactInfo(taskId, "derlived");
		XmlUtil.displayEncodeXml(feed);

	}

}
  
                  
 

备注

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