1. 术语介绍

术语	详细描述
广告账号	客户以直客广告主身份在渠道营销平台注册的账号。每个客户在广告平台可能有多个账号进行推广，每个账号有唯一的账号ID。
管家账号	为广告主提供广告管理服务的代理机构或者有大量账号需要统一管理的大型广告主，在渠道平台注册的账号。每个管家账号下会有多个广告主账号，每个管家账号有唯一的管家账号ID。
开发者	接入渠道MarketingAPI能力，以技术对接方式为代理商或广告主提供广告投放、数据获取等服务的第三方。代理商、广告主、独立第三方均可以是开发者。开发者需要先注册商业开放平台账号，并完成主体资质审核等。代理商、广告主作为开发者时，可直接使用原有账号。
开发者应用	商业开放平台为每个开发者分配的唯一应用。一个开发者可以注册多个应用，用于提供不同的服务（比如管理广告计划、广告数据拉取、用户数据上传等），也可以通过一个应用来实现所有功能。注意事项：（1）单个账号下正常都有最多允许创建个数，如需创建新的开发者应用，需删除旧应用，随之被分配应用的开发者将无法继续提供服务。（2）开发者应用指基于商业开放平台Marketing API开发的应用，而推广的应用程序是指广告主推广的目标APP，两者之间并无任何关联。
应用ID及密钥	每个开发者应用有唯一的ID，对应唯一密钥。由平台在应用审核通过后分配，开发者发起MarketingAPI 授权请求时需要携带。
授权令牌	开发者应用授权给广告主/代理商的凭证。完成授权流程后开发者可获取到令牌（access_token），用于每次调用接口时传入，包含了客户账号/授权范围/授权有效期等信息。

2. 授权方式

广告主或者广告主服务商接入渠道营销平台Marketing API的方式主要有两种，一种是通过Oauth2.0授权方式，另一种是通过账号&密码&token授权方式

Oauth2.0授权：申请渠道开发者->渠道商业开放平台创建应用->神策后台填写应用ID及Secret->跳转渠道授权界面点击授权->拉取广告账号及投放数据

账号密码授权：申请渠道开发者->渠道商业开放平台获取授权令牌->神策后台填写账号/密码/令牌→拉取广告账号及投放数据

注意事项：如果广告主修改了投放账户的密码后，需要重新在神策广告分析后台做 Marketing API授权或联系神策相关同事。

3. 功能介绍

要使用投放分析报表，首先要账户授权，神策才可以调用接口获取到相应广告账户的广告数据，目前神策支持巨量引擎、腾讯广告、百度营销平台、360点睛、搜狗搜索推广、阿里超级汇川、磁力引擎、Apple搜索广告8个广告平台的账户授权。

授权成功后，可在账号列表查看已授权账号

4. 巨量引擎

点击添加账号后，在巨量引擎授权界面选择授权账号，授权时请勾选「允许服务商管理敏感物料」，否则会影响橙子建站及素材功能的使用。

注：授权管理功能目前仅支持广告主管家账号。授权成功后，管家账号下的子账号投放数据，可以在广告投放报表页面查看分析。因还未对接星图MKT-API，故授权时请勿勾选星图账户信息。

5. 腾讯广告

点击添加账号后，在腾讯广告授权界面选择授权账号，分别支持QQ账号授权和微信账号授权，通常来说，腾讯广告用QQ账号授权，微信广告 MP 平台用微信账号授权

注：授权管理功能目前仅支持广告主管家账号。授权成功后，管家账号下的子账号投放数据，可以在广告投放报表页面查看分析。

6. 百度营销平台

点击添加账号，弹出授权方式、账户、密码、授权 token 、授权端口、授权同步弹窗。授权方式可选广告账户、管家账户，当选择管家账户时，授权成功后会将其子账户信息一并拉取回来。授权端口主要是控制该账户信息在广告分析报表中的数据展示。授权同步可控制本次授权信息使用在哪个项目中。

6.1. 百度营销平台-广告授权token获取方式

登录百度后台-找到「工具中心-百度营销API」点击进入

将鼠标移至登录用户名下，点击「个人中心」跳转至其相关页面。

选择「API权限管理」简单配置相关内容即可获得token，其中第一条「权限代码」可用于SAT平台-广告授权使用

注：目前暂不支持百度Oauth2.0授权方式。媒体文档请见：https://dev2.baidu.com/content?sceneType=0&pageId=100369&nodeId=16&subhead= 中【其他权限说明】部分。

7. 360点睛

点击添加账号，弹出授权方式、账户、密码、api key、api secret、授权端口、授权同步弹窗。授权方式可选广告账户、管家账户，当选择管家账户时，授权成功后会将其子账户信息一并拉取回来。授权同步可控制本次授权信息使用在哪个项目中。

获取api key、api secret详见：https://open.e.360.cn/api/application.html#%E5%BC%80%E9%80%9A%E6%B5%81%E7%A8%8B

注：提交开通api key、api secret申请，审批通过后系统会将ApiKey和ApiSecret发往您的邮箱

8. 阿里超级汇川

点击添加账号，弹出授权方式、账户、密码、授权token 、授权端口、授权同步弹窗。授权方式可选广告账户、管家账户，当选择管家账户时，授权成功后会将其子账户信息一并拉取回来。授权端口主要是控制该账户信息在广告分析报表中的数据展示。授权同步可控制本次授权信息使用在哪个项目中。

获取授权token详见https://open2.sm.cn/static/openweb/#/devcenter/api

9. 搜狗搜索推广

点击添加账号，可以选择添加两种授权方式：广告账户、管家子账户

选择广告账户时弹出账户、密码、授权token、授权端口、授权同步弹窗；选择管家子账户时弹出账户、管家账户、管家密码、管家授权token、授权端口、授权同步弹窗。

当授权方式选择管家账户时，授权成功后会将其子账户信息一并拉取回来。授权端口主要是控制该账户信息在广告分析报表中的数据展示。授权同步可控制本次授权信息使用在哪个项目中。

普通账号或者管家账号授权token说明详见：http://apihome.sogou.com/document/ss/doc1-5.jsp

获取token地址：http://apihome.sogou.com/myapi/loginaction!logout.action?accountId=23205958

10. 磁力引擎

点击添加账号，弹出授权方式、app_id、secret、授权端口、授权同步弹窗。授权方式为广告账户。授权端口主要是控制该账户信息在广告分析报表中的数据展示。授权同步可控制本次授权信息使用在哪个项目中。

如何获取appid、secret，请继续往下认真阅读配置详情

2.获取appid及secret前需要先找磁力引擎销售或者代理商开通开发者权限，详见：https://developers.e.kuaishou.com/docs/dsp/0.1

3.开发者注册成功后，进入应用管理-添加应用，并填写应用信息（下图标红1）及回调地址（下图标红2）

应用信息：代表广告主的mktapi授权给第三方的客户端，最多同时创建3个应用，用于同时授权相关权限给服务商，建议以“神策”为服务商单独创建应用，且保证不与其他服务商应用混用。

回调地址：http://ads-authorization.sensorsdata.cn/ads/api/n/platform/callback/{appid}

4.添加应用成功后，复制APPID（下图标红1），并点击设置将APPID粘贴到步骤3中填写的回调地址最末尾，并记录APPID及明文后的Secret（下图标红2），填写到步骤1中app_id、secret弹窗内。

5.将app_id、secret填写完成后，跳转快手广告授权界面选择授权账号，分别支持基于广告账户授权及基于用户授权，确认授权后即可开始通过mktapi同步今天及以后投放数据

注意：如需拉取授权日之前更早的数据，需要联系技术支持同学并给出需要开始同步的时间。

11. ASA-苹果搜索广告

点击添加账号，弹出私钥信息、公钥信息、clienid、teamid、keyid、授权端口、授权同步弹窗。授权端口主要是控制该账户信息在广告分析报表中的数据展示。授权同步可控制本次授权信息使用在哪个项目中。

详细请参考：ASA-苹果搜索广告