AB测试发送

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

A/B测试是指在大批量发送前将数据按照比例随机抽样，对不同样本进行如主题、内容等差异化发送，以选择效果更好的样本用于大批量的发送，有助于进一步提升邮件营销效果。

身份验证

验证方式看这里。

建立AB测试发送任务

POST /v5/campaign/mail/sends_abtest

向指定的单个或多个联系组的人群发送指定的内容，调用此方法前请确保已经把人群数据导入到对应的联系组中。

请求参数

名称类型必填描述示例值
mailNamestring是邮件任务名称，最大200 byte。如到期未产生优胜者，则继续使用此主版本的主题和内容进行发送AB测试邮件任务01
subjectstring是邮件主题AB测试邮件
contentstring是邮件内容AB测试邮件_邮件内容
senderNamestring是发送方名称亿业科技
senderMailstring是发送方邮箱norply@market.domain.com
replyTostring否回复地址reply@market.domain.com
sendDatestring否发送时间。不填时为立即发送。发送时间值不能晚于当前时间30天。使用UTC时间按照ISO8601标准，格式为YYYY-MM-DDThh:mm:ssZ。如，北京时间2023年1月10日20点0分0秒表示为2023-01-10T12:00:00Z。
sendListNamesarray[string]是发送组名称列表。各发送组对应的联系人总数不能少于10个["发送组01","发送组02"]
repelListNamesarray[string]否排斥组名称列表["排斥组01"]
abTestVersionsarray[object]是AB测试其他版本内容配置。其他版本数量最少为1，最大为4。其中subject和content按需使用，但一个版本中不可都不填
abTestVersions.subjectobject否AB测试该版本的邮件主题AB测试邮件B
abTestVersions.contentobject否AB测试该版本的邮件内容AB测试邮件_邮件内容B
timeLimitstring是测试期限（单位：小时）1
percentstring是测试版本百分比。各测试版本百分比相同，剩余百分比即胜出版本的发送量。10
abTestTypestring否AB测试指标类型。取值范围：open、click。打开率（open），点击率（click），默认openclick

请求示例

{
	"mailName": "AB测试邮件任务01",
	"subject": "AB测试邮件",
	"content": "AB测试邮件_邮件内容",
	"senderName": "亿业科技",
	"senderMail": "norply@market.domain.com",
	"replyTo": "reply@market.domain.com",
	"sendDate": "2023-03-10T12:00:00Z",
	"sendListNames": [
		"发送组01",
		"发送组02"
	],
	"repelListNames": [
		"排斥组01"
	],
	"abTestVersions": [
		{
			"subject": "AB测试邮件B",
			"content": "AB测试邮件_邮件内容B"
		}
	],
	"timeLimit": 1,
	"percent": 10,
	"abTestType": "click"
}

返回参数

名称类型描述
codeint返回码
messagestring对返回码的文本描述内容

返回示例

{
	"code": 200,
	"message": ""
}

常见返回值说明

codemessage说明
400参数不足有必填参数未填写
400mailName超长mailName参数值超过允许的最大长度
400发送时间值非法sendDate参数值的格式不正确
403发送时间值不能早于当前时间1小时sendDate参数值过早
403发送时间值不能晚于当前时间30天sendDate参数值过晚
400未填写发送组未填写sendListNames参数
400未填写AB测试其他版本未填写abTestVersions参数
400AB测试版本最多支持5个abTestVersions参数中的版本数最多为4个
400AB测试版本中Subject和Content不可都为空abTestVersions参数中的Subject和Content不可都为空
400timeLimit范围仅支持1-100（小时）timeLimit值的范围为1-100
400percent结合版本数量已超过100%percent值与版本数叠加超过了100%
400不支持的abTestType类型abTestType参数值不在允许值的范围
500添加邮件任务失败
500创建AB测试邮件任务失败此时会保留此次创建的主版本邮件任务
500AB测试邮件任务检查未通过此时会保留此次创建的所有版本的AB测试邮件任务