C/2/proxy/aim/campaign/create
(以“{{Api_desc_business| uri=proxy/aim/campaign/create| desc=创建一个广告计划。| httpMethod=POST| needAuth=是| rateLimit={{B_rate_limit}}| params={{api_args|cu...”为内容创建页面) |
|||
(未显示1个用户的1个中间版本) | |||
第7行: | 第7行: | ||
params={{api_args|customer_id|true|int64|广告主的微博UID。}} | params={{api_args|customer_id|true|int64|广告主的微博UID。}} | ||
{{api_args|campaign_name|true|string|广告计划名称。}} | {{api_args|campaign_name|true|string|广告计划名称。}} | ||
− | {{api_args|device|true|string| | + | {{api_args|device|true|string|指定投放平台类型,多个类型以逗号分隔。1101:PC;110200:无线其他;110201:无线苹果;110202:无线安卓。}} |
{{api_args|start_time|true|timestamp|广告计划开始时间。}} | {{api_args|start_time|true|timestamp|广告计划开始时间。}} | ||
{{api_args|end_time|true|timestamp|广告计划结束时间。}} | {{api_args|end_time|true|timestamp|广告计划结束时间。}} | ||
{{api_args|price|true|int|广告计划单价/CPM(范围: 100 - 400)。}} | {{api_args|price|true|int|广告计划单价/CPM(范围: 100 - 400)。}} | ||
− | {{api_args|budget|true|int|广告计划日限额( | + | {{api_args|budget|true|int|广告计划日限额(最小值500),0为不设置限额。}} |
{{api_args|receiver_uids|true|string|定向投放的UID列表(以英文逗号分割, 最大100万个)。}} | {{api_args|receiver_uids|true|string|定向投放的UID列表(以英文逗号分割, 最大100万个)。}} | ||
{{api_args|mid|false|int64|指定投放微博的ID(数字组成的字符串)。}} | {{api_args|mid|false|int64|指定投放微博的ID(数字组成的字符串)。}} |
2014年9月9日 (二) 14:17的最后版本
proxy/aim/campaign/create
创建一个广告计划。
URL
https://c.api.weibo.com/2/proxy/aim/campaign/create.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
请求所有商业接口:
- 50000次/小时/IP;
- 50000次/小时/IP;
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
customer_id | true | int64 | 广告主的微博UID。 |
campaign_name | true | string | 广告计划名称。 |
device | true | string | 指定投放平台类型,多个类型以逗号分隔。1101:PC;110200:无线其他;110201:无线苹果;110202:无线安卓。 |
start_time | true | timestamp | 广告计划开始时间。 |
end_time | true | timestamp | 广告计划结束时间。 |
price | true | int | 广告计划单价/CPM(范围: 100 - 400)。 |
budget | true | int | 广告计划日限额(最小值500),0为不设置限额。 |
receiver_uids | true | string | 定向投放的UID列表(以英文逗号分割, 最大100万个)。 |
mid | false | int64 | 指定投放微博的ID(数字组成的字符串)。 |
timestamp | true | timestamp | 调用方服务器当前时间的UNIX时间戳,此时间戳与我们服务器的时间差的绝对值在120秒内。 |
signature | true | string | 认证签名。加密方式为signature = md5(customer_id + secret_key + timestamp)。 |
注意事项
- 广告主需申请得到一个secret_key,与广告主的微博UID对应;
返回结果
JSON示例
//成功返回 { "data": { "campaign_id": 1 } } //失败返回 { "request": "/aim/campaign/create.json", "error_code": 271XX, "error": "error message." }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
无
文档更新时间: 2014-09-09