文档
测试

adq批量新建

POST
http://yunbian-gateway-sit.cloud.bz/tencent-data/accountAd/batchCreate

响应参数

参数名
类型
描述
必填
status
int
状态码
必填
msg
String
消息
必填

说明 / 示例

**请求示例** **request** ```javascript { "accountId": "17692672", "operator":"test",//操作人 "tencentAdqAddList": [ { "type": 1, "campaignId": null, "campaignsAddRequest": { "campaignName": "yunbian原生推广页测试0930-01", "campaignType": "CAMPAIGN_TYPE_NORMAL", // 计划类型 CAMPAIGN_TYPE_NORMAL 普通展示广告 CAMPAIGN_TYPE_SEARCH 搜索广告,仅支持读 "promotedObjectType": "PROMOTED_OBJECT_TYPE_ECOMMERCE", // 推广目标 "speedMode":"SPEED_MODE_FAST", //投放模式 SPEED_MODE_FAST 加速投放 SPEED_MODE_STANDARD标准投放 "dailyBudget": 10000, // 计划日预算 可选 不传或者设置为 0 表示不设预算(即不限),日预算要介于 5,000 分– 4,000,000,000 分之间 "totalBudget": 100000 // 计划总预算 可选 不传或者设置为 0 表示不设预算(即不限),总预算需介于 5,000 分- 4,000,000,000 分之间 }, "adgroupsAddRequestList": [ { "virtualId": "10", "promotedObjectType": "PROMOTED_OBJECT_TYPE_ECOMMERCE", // 推广目标 "adgroupName": "广告名称1", "siteSet":["SITE_SET_MOMENTS"], //投放版位 "beginDate": "2021-10-15", //开始投放时间 "endDate": "", // 结束投放日期,日期格式:YYYY-MM-DD,大于等于今天,且大于等于 begin_date ;如果希望长期投放,传空字符串 "firstDayBeginTime":"", //首日开始投放时间:HH:ii:ss 可选 "timeSeries": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111", "dailyBudget": 5000, // 广告组预算 单位为分,设置为 0 表示不设预算(即不限),日预算要求介于 5,000 分– 4,000,000,000 分之间 "bidMode":"BID_MODE_OCPM", // 出价方式 BID_MODE_OCPM BID_MODE_CPM-广告组预算必填 "bidAmount": 5000, // 广告出价 "optimizationGoal": "OPTIMIZATIONGOAL_ECOMMERCE_ORDER", // 优化目标 "smartBidType":"SMART_BID_TYPE_CUSTOM", // 出价类型 SMART_BID_TYPE_CUSTOM 手动出价 SMART_BID_TYPE_SYSTEMATIC 自动出价(没有一键起量和深度优化,广告组预算必填,不能不限) "bidStrategy": "BID_STRATEGY_PRIORITY_LOW_COST", // 出价策略 BID_STRATEGY_AVERAGE_COST 稳定拿量 BID_STRATEGY_TARGET_COST 优先拿量 BID_STRATEGY_PRIORITY_LOW_COST 优先低成本 "goal":"OPTIMIZATIONGOAL_CLICK", //深度优化目标 "deepConversionType":"DEEP_CONVERSION_BEHAVIOR",//深度优化类型 DEEP_CONVERSION_WORTH 优化 ROI DEEP_CONVERSION_BEHAVIOR 优化转化行为 "deepPrice":100,// 优化转化行为的出价 单位为分,最小值 10,最大值 1000000; 优化转化行为 必填 "expectedRoi": 1.1,//深度优化价值效果值 最小值 0.001,最大值 1000,最多保留 3 位小数 优化 ROI必填 "autoAcquisitionEnabled": false, // 是否一键起量 "autoAcquisitionBudget": null, // 一键起量预算设置后不可修改 开启一键起量必填 最小值 20000,最大值 10000000 "targeting": { "minAge": 18, "maxAge": 45, "gender": "MALE", "locationTypes": "LIVE_IN", "regions": [ 430000 ], "excludedDimension":"EXCLUDED_DIMENSION_CAMPAIGN",//排除已转化用户 "conversionBehaviorList":["OPTIMIZATIONGOAL_BRAND_CONVERSION"],//自定义转化行为 "interestCategoryIdList": [],//兴趣标签id列表 "behaviorCategoryIdList": [],//兴趣标签 "behaviorKeywordList": ["互联网/电子产品"],//行为标签id列表 "interestKeywordList": ["旅游控"],//行为标签 "scene": ["BEHAVIOR_INTEREST_SCENE_ALL"],//行为场景,选择了行为必填 "timeWindow": "BEHAVIOR_INTEREST_TIME_WINDOW_THIRTY_DAY",//行为时效性,选择了行为必填 "intensity": "BEHAVIOR_INTEREST_INTENSITY_ALL",//行为强度,选择了行为必填 "actions":["WECHAT_MOMENTS_AD_LIKE"],// 微信再营销 "excludedActions": [ "WECHAT_OFFICIAL_ACCOUNT_AD_LIKE" ], //排除营销 "customAudience": [ ],//自定义定向用户群 "excludedCustomAudience": [ ] //自定义排除用户群 }, "expandEnabled": true, //智能定向 cpm 不支持 "expandTargeting": [ "geo_location", "age", "gender" ], // 扩量不可突破定向 可选值:{ age, gender, geo_location } "coldStartAudience": [ ], //扩量种子人群 数组最大长度 10 "poiList":[],//门店id,推广目标为门店推广是必填,其余选填 "creativeDisplayType":""//创意展现形式 CREATIVE_DISPLAY_TYPE_INTELLIGENCE:优选模式;CREATIVE_DISPLAY_TYPE_AVERAGE:轮播模式 } ], "adcreativesAddRequestList": [ { "adcreativeName": "创意名称01", "siteSet":["SITE_SET_MOMENTS"], //投放版位 "promotedObjectType": "PROMOTED_OBJECT_TYPE_ECOMMERCE", "title": "这是广告的文案", "description":"",//创意形式描述 "pageType": "PAGE_TYPE_MINI_PROGRAM_WECHAT", "linkPageType": "LINK_PAGE_TYPE_MINI_PROGRAM_WECHAT", "adcreativeTemplateId": 641, "imageList": [ "2276228046", "2276224222", "2275978203" ], "videoId":2356692684,//视频id "linkNameType": "VIEW_DETAILS", "pageId":1968500120,//落地页id "pageUrl":"",//自定义链接 http https开头 "overrideCanvasHeadOption":"",//原生推广页顶部素材和广告创意素材之间的替换关系;OPTION_CANVAS_OVERRIDE_CREATIVE 原生页头部素材替换创意素材;OPTION_CREATIVE_OVERRIDE_CANVAS 创意素材替换原生页头部素材 "miniProgramId":"gh_8f9505f3366d",//小程序id "miniProgramPath":"pages/index/index",//小程序路径 "miniProgramPaths":["pages/index/index"],//小程序路径集合 "conversionDataType":"CONVERSION_DATA_ADMETRIC",//数据展示的数据类型 "conversionTargetType":"CONVERSION_TARGET_BUY", //数据展示转化行为 "shareTitle":"", //分享标题,只有简版原生页可填 "shareDescription":"",//分享描述,只有简版原生页可填 "webviewUrl":"",//简版原生页内嵌url地址 只有简版原生页可填&&简版原生页子类型==默认模板 "simpleCanvasSubType","",//简版原生页子类型 只有简版原生页可填 SIMPLE_CANVAS_SUB_TYPE_DEFAULT 默认模板; SIMPLE_CANVAS_SUB_TYPE_URL 自定义链接; IMPLE_CANVAS_SUB_TYPE_SLIDE_UP 上滑 H5 "profileId":43238,//朋友圈头像昵称跳转页 id,仅微信朋友圈广告(site_set=SITE_SET_MOMENTS)的创意形式支持且必填 "adcreativeLabelList":[{ "content":"", "type":"",//LABEL_TYPE_COMMON普通文本标签 LABEL_TYPE_CUSTOMIZETEXT自定义标签 LABEL_TYPE_ICON图标标签 }], "shopImage":"",//卖点图 80*80的 "countdownTimeType":"",//倒计时类型 COUNTDOWN_TIME_START距离活动开始;COUNTDOWN_TIME_END距离活动结束 "countdownSwitch":ture,//倒计时开关 "countdownBegin":1634884431,//unix时间戳(秒) "countdownExpiringTimestamp":1634884431,//unix时间戳(秒) "countdownPrice":"",//价格 支持 0 ~ 9999.99 的数字,且最多两位小数 "productCatalogId":"商品库id", "productSource":"商品id", "pageTrackUrl": "",//页面级转化跟踪 URL(可选) "virtualId": 1 } ], "virtualIdMap": { "10": [ 1 ] } } ] } //1.CPM CPM 出价限制:介于 150 分-99,900 之间(1.5 元-999 元,单位为人民币) //2.OCPM oCPC/oCPM 出价限制:介于 10 分-500,000 分之间(0.1 元-5000 元,单位为人民币) //3.CPM 只可以填写出价,不能开启智能定向 //4.CPM 排除已转化用户仅仅支持同商品和不限 同商品都不支持自定义转化行为 //5.OCPM-自动出价 不能填写出价,一键起量,深度优化,广告日预算必填 ``` **response** ```javascript { "status": 0, "msg": "成功" } ```