获取营销活动报告

更新时间：2023-06-03 09:00

可以检索已发送邮件任务的统计数据。

身份验证

验证方式看这里。

检索任务的统计数据

POST /v5/campaign/mail/stats/get

请求参数

名称类型必填描述示例值
startDatestring是查询的时间范围的起始时间（包含此天）。YYYY-MM-DD格式。2025-05-01
endDatestring是查询的时间范围的结束时间（包含此天）。YYYY-MM-DD格式。2025-05-31
mailNamestring否邮件任务名称发送任务01

请求示例

{
	"startDate": "2025-05-01",
	"endDate": "2025-05-31",
	"mailName": "发送任务01"
}

返回参数

名称类型描述
codeint返回码
messagestring对返回码的文本描述内容
mailStatsListarray[object]邮件任务统计数据
mailStatsList.mailNamestring邮件任务名称
mailStatsList.mailSendDatetimestamp邮件任务发送时间
mailStatsList.sentCountint邮件任务发送数
mailStatsList.openCountint邮件任务打开数
mailStatsList.clickCountint邮件任务点击数
mailStatsList.bounceCountint邮件任务软退数
mailStatsList.unsentCountint邮件任务过滤数
mailStatsList.unsubscribeCountint邮件任务退订数
totalRecordsint查询时间段的邮件任务统计数据总数量

返回示例

{
	"code": 200,
	"message": null,
	"mailStatsList": [
		{
			"mailName": "发送任务01",
			"mailSendDate": 1747879200000,
			"sentCount": 1,
			"openCount": 0,
			"clickCount": 0,
			"bounceCount": 0,
			"unsentCount": 0,
			"unsubscribeCount": 0
		},
		{
			"mailName": "发送任务02",
			"mailSendDate": 1748594566000,
			"sentCount": 1,
			"openCount": 1,
			"clickCount": 1,
			"bounceCount": 0,
			"unsentCount": 0,
			"unsubscribeCount": 0
		}
	],
	"totalRecords": 2
}