请求URL
Marketing API 请求URL约定了使用的协议、域名、模块、版本、资源及动作,详细定义如下:
正式环境为 https://marketing-api.vivo.com.cn/openapi/<API_VERSION>/<RESOURCE_NAME>/<RESOURCE_ACTION>
沙箱环境为 https://sandbox-marketing-api.vivo.com.cn/openapi/<API_VERSION>/<RESOURCE_NAME>/<RESOURCE_ACTION>
其中:
协议:正式环境和沙箱环境均使用 HTTPS;
API_VERSION:版本号,当前最新版本号为 v1;
RESOURCE_NAME:表示要操作的资源,如campaigns、adcreatives,可能是一级,也可能是二级,以最终请求url里的为准;
RESOURCE_ACTION:表示对资源的动作,如 query、add及modify。
各接口对应的 <RESOURCE_NAME>/<RESOURCE_ACTION> 在文档中描述为接口请求路径,例如:正式环境新建一个创意,接口文档中描述的请求路径为 /ad/creative/add,完整地址为 https://marketing-api.vivo.com.cn/openapi/v1/ad/creative/add。
HTTP Method
调用方应根据具体接口的要求设置 HTTP Method为 GET或POST。
HTTP Header
调用方应遵循HTTP协议设置相应的 Header,目前支持的Header有:Content-Type,用于指定数据格式。例如:Content-Type: application/json
编码方式
Marketing API支持的编码方式为 UTF-8。
接口调用限制
类别 | 限制描述 |
接口功能 | 不同应用程序在接口功能上可能存在差异,由开发者创建应用的时候根据应用的使用场景进行选择 |
调用天频次 | 1、达到限制后,您当日将无法继续调用超限的接口,第二天可自动恢复正常2、如需要调整限制可以联系您的运营接口人 |
调用分钟频次 | 1、系统对每个应用程序调用每个接口都有调用分钟频次限制,不同应用等级下的调用次数不同,具体可通过应用程序管理页面了解2、达到限制后,您需要暂停对该接口的调用,1分钟后可自动恢复正常3、如需要调整限制可以联系您的运营接口人 |
特殊字符限制
如无特殊声明,API接口所有输入参数的值均不能包含以下这些特殊字符:< > & ‘ ” / \ 以及TAB、换行、回车键。
请求通用参数
1、每个请求接口中的均需传入以下通用参数,详细定义如下表所示:
名称 | 类型 | 描述 |
access_token 必填 | string | 授权令牌,完成 OAuth 2.0 授权后获得,参考Oauth2.0授权-授权流程章节。以Query Parameter方式在请求路径中传递。 |
timestamp 必填 | timestamp | 当前的时间戳,单位为毫秒,允许客户端请求最大时间误差为600秒。MarketingAPI 所使用的时间戳,若无特殊说明,均为毫秒级时间戳。MarketingAPI 所使用的时区为GMT+8,例如当时间戳为1598451101338时,表示 2020-08-26 22:11:41以Query Parameter方式在请求路径中传递。 |
nonce 必填 | string | 随机字串标识,不超过32个字符,由调用方自行生成,需保证全局唯一性。以Query Parameter方式在请求路径中传递。 |
advertiser_id | String | 账户ID。如果授权帐号是二代账户,需要填写要操作的对应投放账户id(可通过查询二代下属广告主接口获取,取UUID字段);如果授权账户是广告主投放账户则可以不填;以Query Parameter方式在请求路径中传递。 |
个人在vivo平台怎样投放广告?家装企业投放vivo信息流广告的优势是什么?那么又该如何运营vivo账户呢?如何帮助广告主实现在vivo推广营销的价值?现在的费用是多少?广告主可以咨询我们沃木网络,专业的广告人员为您解答,现在开户费用还比较低,5000元即可开户,有需要的广告主可以在线咨询哦!
有任何OPPO或vivo的广告需求,欢迎与我们取得联系。
欢迎扫码添加以下微信,或者拨打电话198-9888-5878(微信同号)咨询