新增推广组

新增推广组

HTTP请求方式

POST

请求地址

https://ms-api.e.360.cn/v1/group/add

Headers 请求参数
字段 类型 必须 描述
Content-Type string yes application/x-www-form-urlencoded
apiKey string yes 注册时分配到的api key，该参数作为HTTP HEAD字段传递。
accessToken string yes 访问token
Body 请求参数
字段 类型 必须 描述
group string yes JSON 格式的推广组对象数组
groups示例
{
    "name": "openApi-test-plan",
    "plan_id": 607121399,
    "area_code": 1,
    "area_country": [2, 3, 4],
    "area_province": [2, 3, 4],
    "area_city": [2, 3, 4],
    "price": 1230,
    "crowd_sex": [1,2],
    "crowd_life_stage": 1,
    "ages": [2,  4],
    "stages": [2, 4],
    "media_type":27,
    "smart_goods":2,
    "smart_goods_recommendation":{"qid":1234,"product_pack_id":123}
}
字段说明
字段 类型 必须 描述
name string Yes 推广组名称，最多可输入40个汉字或80个字符
plan_id Number Yes 所属推广计划ID
smart_goods Number No 智能商品投放：0不限、1商品重定向、2商品包智能推荐。（默认为0。当指定商品重定向时，必须设置360人群管家"动态创意人群"定向；当指定"商品包智能推荐"时，必须设置 smart_goods_recommendation）
smart_goods_recommendation Json No 商品包智能推荐，子项说明详见上方示例及《商品包智能推荐字段说明》，当smart_goods等于2时必填。
shop_direct Number No 商店直投:1是、2否(默认为2，当推广目的为"应用下载"或"移动网站推广"，且有商店直投权限时，才可设置为1)
area_code Number Yes 地域定向：1不限；2指定地域。
area_country Array No 地域定向：国家（值类型是Number，可填值详见地域列表），area_code=2时有效
area_region Array No 地域定向：大区（值类型是Number，可填值详见地域列表），area_code=2时有效
area_province Array No 地域定向：省（值类型是Number，可填值详见地域列表）， area_code=2时有效
area_city Array No 地域定向，市（值类型是Number，可填值详见地域列表）， area_code=2时有效
crowd_audience_desc Number No 受众描述：0不限、1兴趣特征、2人群管家、3关键词、4行业优选人群。默认为0。当smart_goods=1时不填。
crowd_interest Array No 兴趣特征定向，数组子项说明详见《兴趣特征定向列表说明》。当crowd_audience_desc=1时必填。
crowd_steward Array No 360人群管家定向，数组子项说明详见《360人群管家定向列表说明》。当smart_goods=1时，必须填delivery_type=2的360人群管家列表；当smart_goods不等于1时，且crowd_audience_desc=2时，必须填delivery_type=1的360人群管家列表。
crowd_industry Array No 行业优选人群定向，（值类型是Number，可填值详见行业优选人群列表），数组内子项为行业优选人群ID。当crowd_audience_desc=4时必填。
keywords Array No 定向投放：关键词列表。当crowd_audience_desc=3时必填。
crowd_sex Array No 性别定向：1男、2女、99未知，如果传空数组[]则不限。默认不限
crowd_life_stage Number No 阶段： 0不限；1指定年龄；2指定人生阶段，该字段传1时，ages字段有效，传2时，stages字段有效，传0时，均无效。默认不限
ages Array No 年龄定向（值类型是Number，可填值详见人群-人口属性），当crowd_life_stage=1时，该字段必传
stages Array No 人生阶段定向（值类型是Number，可填值详见人群-人口属性），当crowd_life_stage=2时，该字段比传
system_recommendation Number No 系统推荐开关：1打开、0关闭。当crowd_audience_desc=0时不填，否则选填。默认为0。
crowd_exclude Number No 排除人群：0不排除、1排除。默认为0。
crowd_ids_exclude Array No 排除人群列表，数组子项说明详见《360人群管家定向列表说明》。当crowd_exclude=1时必填。
network_type Number No 网络环境定向:0不限、1仅wifi、2仅移动网络。默认为0。当所属计划广告模式为PMP时，仅能填0或1
equipment Number No 设备类型定向:0不限、1仅智能手机、2仅平板电脑。当所属计划的广告模式为RTB时必填，否则不填。默认为0。
delivery_scope Number Yes 投放范围：1信息流、2应用商店。计划推广目的为"应用激活"或"移动网站推广"时，投放范围仅能填信息流
media_type Number Yes 媒体定向类别：27全网通投、26指定媒体包、102指定应用、1优选资源位。当投放范围为"应用商店"时，媒体定向类别只能是"指定媒体包"。
price_type Number Yes 出价方式：1 CPC、2 CPM、3 oCPC、4 oCPM
rtb_media_list Array No 媒体定向：媒体包列表，数组子项为媒体包最细粒度ID（值类型是Number，可填值详见媒体包列表）。当media_type等于26时必填，否则不填。当投放范围指定'信息流'时，不能投放'应用商店'类型的媒体包；当投放范围指定'应用商店'时，不能投放'信息流'类型的媒体包
ad_space_type_ids Array No 广告类型ID列表，多个用英文逗号分隔，空代表不限，ID含义详见广告位类型列表。默认不限。当媒体定向类别不是“优选资源位”时可填（如果指定媒体定向，所填广告类型必须在媒体支持的范围内，媒体包支持的广告类型详见媒体包列表；媒体应用支持的广告类型详见媒体应用列表），否则不填
pmp_pack_list Array No 媒体定向：媒体资源列表，数组子项字段说明详见《媒体资源列表字段说明》。当media_type=1时必填，否则不填。投'搜索广告'条件：所属计划的推广目的为'应用下载'，且操作系统定向为'Android'。不能同时选择'搜索广告'媒体和其他媒体资源同时投放。
media_app_list Array No 媒体定向：应用列表，数组子项为publisher_id，可填值详见《媒体应用列表》。当media_type=102时必填，否则不填。
price Number No 组出价（单位为分），出价范围：CPM/oCPM出价方式时为100-99900，CPC/oCPC出价方式时为10-99900。
convert_id Number No 转化目标ID，可填值详见转化目标列表。当有oCPC权限且出价方式为oCPC或oCPM时必填，否则不填。当所属计划'推广目的'为'应用下载'，只能设置类型为'API转化回传'的转化目标。
convert_price Number No 目标转化成本，单位是分，出价范围100-99900。仅设置convert_id时可填。当设置的convert_id为'打开类'时，convert_price必填。
operator string No 运营商 传空数组[]则不限(默认不限)，指定[1,2,3...]//0不限、1移动、2联通、3电信
phone_brands string No 手机品牌 传空数组[]则不限(默认不限)，指定[1,2,3...]
phone_version string No 手机版本号 传空数组[]则不限(默认不限)，指定[["<","1"],["=","2"],[">=","5"]] //标识符有>=、>、<=、<、= 示例表示投放小于1，=2和大于等于5
network_type string No 网络类型 传空数组[]则不限(默认不限)，指定[1,2,3...]//1WIFI、2 2G、3 3G、4 4G、6 5G
app_exclude_flag Number No app安装过滤：0 不过滤、1过滤。默认为0。
兴趣特征定向列表说明 （可填值详见兴趣标签列表）
字段 类型 必须 描述
interest_id Number No 兴趣特征标签ID
interest_type Number No 兴趣特征标签类型
360人群管家定向列表说明 （可填值详见360人群管家列表）
字段 类型 必须 描述
pack_id Number No 人群ID
qid Number No 人群所属用户ID
商品包智能推荐字段说明 （可填值详见 商品包智能推荐）
字段 类型 必须 描述
qid Number No 商品包添加人ID
product_pack_id Number No 商品包ID
媒体资源列表字段说明 （可填值详见 媒体资源列表）
字段 类型 必须 描述
pack_id Number No 媒体资源ID
app_search_keyword Array No APP搜索词定向列表，数组内为关键词列表。当定向为"搜索广告"类型的PMP媒体包时必填，否则不填。当所属计划投放的APP不是官网包时,不允许设置APP搜索词定向
手机品牌列表字段说明 （可填值详见 手机品牌列表）
请求示例
curl --location --request POST 'https://ms-api.e.360.cn/v1/group/add' \
--header 'accessToken: 44aa55220b1078b050606f0b1c022e0bac668aa5ea37c57af' \
--header 'apiKey: 111' \
--form 'group={
    "name": "openApi-test-plan",
    "plan_id": 607121399,
    "area_code": 1,
    "area_country": [2, 3, 4],
    "area_province": [2, 3, 4],
    "area_city": [2, 3, 4],
    "price": 1230,
    "crowd_sex": [1,2],
    "crowd_life_stage": 1,
    "ages": [2,  4],
    "stages": [2, 4],
        "media_type":27,
    "operator": [1,2,3, 4],
    "phone_brands": [1,2,3],
    "phone_version": [["<","1"],["=","2"],[">=","5"]],
    "network_type": [1,2,3,4,6]
}'
返回结果
{
  "err_no": 10000,
  "err_msg": "",
  "data": 123456
}
返回结果说明
字段 类型 描述
err_no int 错误码，详见 错误码对照
err_msg string 错误描述
data int 成功时返回创建的组id，失败时返回null

results matching ""

    No results matching ""