• 电话
    198-9888-5878

vivo广告推广:如何发起一次API请求

请求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(微信同号)咨询

微信公众号

vivo广告推广:MarketingAPI中涉及的业务术语
« 上一篇 2023-08-21 09:21
vivo联盟平台常见的广告违规行为有哪些
下一篇 » 2023-08-21 09:21