入门与指南专题介绍帐号管理营销资产广告管理数据洞察人群管理数据接入接口清单
授权认证 帐号管理 营销资产 广告管理 数据洞察 辅助工具 用户行为数据 用户人群数据 用户标签数据 用户属性数据
附录

注册开发者和创建应用

本节将为您介绍如何注册成为开发者以及成为开发者后如何创建应用。

在调用Marketing API接口前,您必须先注册成为开发者并创建应用申请对应的接口权限。以下将分别为您介绍注册成为开发者以及创建应用的具体流程。


如何注册成为开发者?

Step 1:进入注册页面。点击开发者官网右上角【注册】按钮即可进入;

Step 2:关联QQ号作为开发者登录凭证。进入注册页面后,如果当前电脑已经登录QQ客户端,则默认显示以当前登录QQ号作为快捷登录,您也可以点击“帐号密码登录”换用其他QQ号;

  • 关联QQ号是开发者登录的唯一凭证,且不能进行修改。对于企业开发者,建议使用公用QQ帐号进行注册,并妥善保管。
  • 如果您已经腾讯社交广告的客户(代理商或广告主),建议您直接用代理商帐号或广告主帐号的开户QQ进行注册。

 

Step 3:完善开发者资料。将资料填写完整并通过手机验证码验证通过后,即完成开发者注册。

如何创建应用程序并申请权限?

通过腾讯社交广告开发者专区创建的应用程序是指基于Marketing API开发的应用,比如管理广告的投放平台、广告数据分析工具、自动化营销的脚本等等。创建应用程序的目的是为了获取所需接口在正式环境的调用权限。在获取正式环境的接口权限前,建议您先通过沙箱环境进行接口调试。

Step 1:注册为开发者后,在开发者官网进行登录并进入【应用程序管理】看板

Step 2:点击“创建新应用”进入创建应用程序界面

Step 3:填写应用详情,包括应用图标、应用名称、应用介绍、回调地址、所需权限。

    • 应用图标
      • 360 x 360 px 的应用图标
      • 显示在OAuth 2.0 授权页面中,作为推广客户(服务商/广告主)识别应用的标识
    • 应用名称
      • 应用程序的名称,多个应用程序不允许重名
      • 显示在OAuth 2.0 授权页面中,作为推广客户(服务商/广告主)识别应用的标识
    • 应用介绍
      • 介绍您的应用程序希望基于Marketing API实现的功能及您需要功能通过审核的原因
    • 回调地址
      • 将用于OAuth 2.0授权完成后的跳转及信息返回,详情参考【授权认证】章节

    • 所需权限
      • 根据您的需求选择对应的权限组分类,权限组分类的详细介绍可通过【权限等级】进一步了解
      • 当您选择帐号管理、广告洞察、广告管理、人群管理权限时,需要提供您基于此权限开发的系统或工具页面截图,以作为审核判断依据。如您上传的页面截图与所申请权限无关、或截图不清晰不完整,您将无法获取相应权限
      • 如您的应用还未开发完成,建议先使用沙箱环境进行调试

Step 4:提交应用审核。应用提交后,我们通常将在2~3个工作日内进行审核。

应用审核通过后,您将获得一个对应的 client_id 和 client_secret(见下图示意),并可以用此发起OAuth 2.0 授权获得指定推广帐号的操作权限,详情参考【授权认证】章节。

常见问题

1、开发者官网的应用程序与推广的应用程序有什么关系?

开发者官网的应用程序是指基于Marketing API开发的应用,比如管理广告的投放平台、广告数据分析工具、自动化营销的脚本等等,而推广的应用程序是指广告主推广的目标应用。两者之前并无任何关联。

2、我需要为多个应用上报行为数据,需要分别创建应用程序么?

不需要。您只需创建一个应用程序,并申请数据上报的权限即可。一个应用可以获得多个推广帐号的授权,从而帮多个推广帐号上报数据。如何获得推广帐号的操作授权,可参考【授权认证】章节。

3、应用程序审核通过后,是否就可以操作推广帐号了?

应用程序的审核是指给应用程序分配相应的接口权限,但是应用程序能操作哪些推广帐号,需要通过OAuth 2.0向指定的推广帐号发起授权申请,当指定的推广帐号同意授权后,应用程序即可调用接口对该帐号进行操作。OAuth 2.0授权可参考【授权认证】章节进一步了解。