创建广告单元创意组
需要携带 Token,详情看 Token
通过此接口可用于新建创意组
请求地址
https://ss-api.mintegral.com/api/open/v1/creative_set
请求方法
POST
请求示例
json
POST /api/open/v1/creative_set HTTP/1.1
Host: ss-api.mintegral.com
Content-Type: application/json
{
"creative_set_name": "test_create_group_1",
"offer_id": 100,
"geos": [
"ALL"
],
"ad_outputs": [
211,
212,
213
],
"creatives": [
{
"creative_name": "test_creative_1",
"creative_md5": "abcd"
},
{
"creative_name": "test_creative_2",
"creative_md5": "cdfg"
}
]
}
请求参数
字段 | 类型 | 是否必填 | 说明 | 默认值 |
---|---|---|---|---|
creative_set_name | string | Y | 创意组名称 | - |
combination_method | int | N | 创意组装方式。1表示程序化创意,2表示自定义创意 | 1 |
offer_id | int | N | 创意组新建后期望绑定的广告单元 | — |
geos | array<string> | N | 创意组投放地区 | ["ALL"] |
ad_outputs | array<int> | Y | 创意类型,枚举类型及要求见[枚举值 - 创意类型类型及要求尺寸] | - |
creatives | array<object> | Y | 创意组包含的素材信息 | - |
creative_name | string | Y | 素材在该创意组内的名称 | - |
creative_md5 | string | Y | 素材md5 | - |
响应结果
字段 | 类型 | 说明 |
---|---|---|
code | int | 200 表示成功,其他表示失败 |
msg | string | 成功,返回"success",失败返回相应的错误信息 |
data | json | 成功,返回素材组信息,失败返回具体的错误信息 |
creative_set_name | string | 创意组名称 |
creative_set_id | int | 创意组id |
offer_id | int | 创意组绑定的广告单元ID |
应答示例
json
{
"msg": "success",
"code": 200,
"data": {
"creative_set_name": "test_create_group_1",
"creative_set_id": 2001,
"offer_id": 100
}
}