本节将为您介绍如何成为Marketing API开发者,开启您的智能化营销体验生活。
1、如何成为开发者?
当您决定开始使用Marketing API进行接口调用,您需要首先登录商业开放平台,并完成协议签署:
Step 1:进入登录页面。点击开发者官网右上角登录按钮即可进入;
Tips:
营销平台账号是开发者登录的唯一凭证,且不能进行更改。
如果您已经是vivo广告平台的客户(代理商或广告主),建议您直接用代理商帐号或广告主帐号的营销平台账号直接登录。
2、如何创建应用程序并申请权限?
2.1 开发者应用的作用
通过vivo商业开放平台创建的应用程序是指基于Marketing API开发的应用,比如管理广告的投放平台、广告数据分析工具、自动化营销的脚本等。创建应用程序的目的是为了获取所需接口在正式环境的调用权限。单个账号下最多允许创建5个应用,如需再创建新应用,需先删除旧应用。
开发者官网的应用程序是指基于Marketing API开发的应用,而推广的应用程序是指广告主推广的目标应用。两者之间并无任何关联。
ps:如需对接推广服务模块,在获取正式环境的接口权限前,建议您先通过沙箱环境进行接口调试。
Tips:
该营销平台账号为开发者身份的唯一凭证,建议使用主账户进行登录,避免后续人员变动导致的账号权限问题。采用第三方授权(oAuth授权)方式,因此为了保证数据安全性,每个应用均需权限审核。
2.2 应用的申请及创建
Step1: 登录营销平台账号成为开发者后,进入应用管理看板,则界面会显示创建入口如下图:
Step 2:
1、点击“新建应用”进入创建应用程序界面,填写应用名称、应用介绍信息等。
2、选择对应的权限组分类,权限组分类的详细介绍可通过开发文档进一步了解 – 创建后,审核人员会在2-3个工作日内进行审核。
如您的应用还未开发完成,建议先使用沙箱环境进行调试。
开发者可根据获取到的应用程序id(client_id)及client_secret,以此发起OAuth 2.0 授权获得指定推广帐号的操作权限,详情参考Oauth2.0授权-授权流程。
应用图标:250 x 250 px 的应用图标,小于50kb。
显示在OAuth 2.0 授权页面中,作为推广客户(代理商/广告主)识别应用的标识
应用名称:应用名称全局唯一,不得重复(已删除应用不计入),不超过15个字符
显示在OAuth 2.0 授权页面中,作为推广客户(代理商/广告主)识别应用的标识
应用介绍:介绍您的应用程序希望基于Marketing API实现的功能及您需要功能通过审核的原因
回调地址将用于OAuth 2.0授权完成后的跳转及信息返回到您指定地址,供您获取相关返回信息,详情可参考Oauth2.0授权-授权URL中需获取的参数;
Access Token有效期:该应用下access token的有效时长;Refresh Token有效期:该应用下refresh token的有效时长,
refresh token有效期需大于access token;注:access token 和 refresh token详细介绍见Oauth2.0授权-token管理
3、常见问题
1、开发者官网的应用程序与推广的应用程序有什么关系?
开发者官网的应用程序是指基于Marketing API开发的应用,比如管理广告的平台、广告数据分析工具、自动化营销的脚本等等,而推广的应用程序是指广告主推广的目标应用。两者之间并无任何关联。
2、我需要为多个推广应用(APP)上报行为数据,需要分别创建应用程序么?
不需要。您只需创建一个MarketingAPI应用程序,并申请数据上报的权限即可。该API应用可以获得多个推广帐号的授权,从而上报数据到对应账户下的数据源。
3、应用程序审核通过后,是否就可以操作推广帐号了?
应用程序的审核是指给应用程序分配相应的接口权限,但是应用程序能操作哪些推广帐号,需要通过OAuth 2.0向指定的推广帐号发起授权申请,当指定的推广帐号同意授权后,应用程序即可调用接口对该帐号进行操作。
4、创建应用时,设置的回调地址需要注意什么?
创建应用时,设置的回调地址,不能设置一些根本不存在的地址,一定要确保设置的地址自己能够回调成功。
5、申请应用权限时,应该注意什么?
需确保申请了需要的权限,比如账号服务、vivo广告推广服务、人群管理、数据上传、工具服务权限都申请上,避免单独多次申请某一个分类,如果调用了未申请的接口权限,会导致调用报错。
有任何OPPO或vivo的广告需求,欢迎与我们取得联系。
欢迎扫码添加以下微信,或者拨打电话198-9888-5878(微信同号)咨询