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搜索广告、华为应用商店的账户授权。
授权成功后，可在账号列表查看已授权账号
4. 巨量引擎
点击添加账户授权，授权版本支持「巨量引擎」「巨量引擎体验版」。支持在广告投放报表-「信息流报表」中查看巨量引擎（原版）以及巨量引擎体验版（升级版）的广告详细数据。
点击添加账号后，在巨量引擎授权界面选择授权账号，授权时请勾选「允许服务商管理敏感物料」，否则会影响橙子建站及素材功能的使用。
注：
1、巨量引擎、巨量引擎体验版（升级版）共用一个广告账户。如投放巨量引擎体验版场景，请重新授权，并勾选「巨量引擎体验版」
2、授权管理功能目前仅支持广告主管家账号。授权成功后，管家账号下的子账号投放数据 ，可以在广告投放报表页面查看分析。因还未对接星图MKT-API，故授权时请勿勾选星图账户信息。
5. 腾讯广告
点击添加账户授权，授权端口支持「信息流推广」「SEM搜索推广」，支持在广告投放报表-「信息流报表」中查看计划类型为展示广告的广告详细数据，支持在广告投放报表-「SEM报表」中查看广告计划类型为搜索广告的广告详细数据
点击添加账号后，在腾讯广告授权界面选择授权账号，分别支持QQ账号授权和微信账号授权，通常来说，腾讯广告用QQ账号授权，微信广告 MP 平台用微信账号授权
注：授权管理功能目前仅支持广告主管家账号。授权成功后，管家账号下的子账号投放数据 ，可以在广告投放报表页面查看分析。
6. 百度营销平台
点击添加账号，弹出、授权端口、授权同步、更多授权弹窗。授权端口主要是控制该账户信息在广告分析报表中的数据展示。授权同步可控制本次授权信息使用在哪个项目中。更多授权支持勾选基木鱼选项，拉取基木鱼相关数据。
点击「确定」按钮后，跳转至百度OAuth2.0模式授权页面，账号登录状态下选择需要授权的账号，点击「同意授权」按钮，完成授权操作。
注意：百度目前支持Oauth2.0方式授权，原有授权方式将于2022年年底下线，具体的通知： https://dev2.baidu.com/notice?noticeId=425
最迟请于2023年1月7日前完成重新授权。授权前，请截图备份历史授权配置情况，以免配置新账户时找不到参考.
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. 搜狗搜索推广
注意：搜狗搜索平台于2023年2月28日正式下线。受此影响，不再支持搜狗搜索推广渠道。可转移至腾讯广告平台投放搜索广告。搜索广告不再支持创建广告账号授权、编辑广告授权账户，仅支持查看广告账户。
点击添加账号，可以选择添加两种授权方式：广告账户、管家子账户
选择广告账户时弹出账户、密码、授权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-苹果搜索广告
12. 华为应用商店
点击添加授权账户后，填写授权信息。
12.1. 授权时需填写华为API客户端权限下的客户端ID和密钥。
获取流程请见华为文档： https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agcapi-getstarted-0000001111845114#section103mcpsimp。
若您为客户投放伙伴，需要使用客户投放伙伴主账号创建API客户端。并且客户端对应的角色应该为【管理员】。暂不支持直客账户授权。
客户伙伴主账号类型（需要与上图中的账号一致）
注意：创建完客户端后，还需要向华为发送邮件申请开通Marketing API 权限,请见华为文档 https://developer.huawei.com/consumer/cn/doc/distribution/promotion/bp-functions-marketing_api-apply-0000001385274412
APP名称：投放操作账号正在推广的APP名称
APPID：投放操作账号正在推广的APP ID（华为侧APP ID）
客户投放伙伴主账户UID： 代理侧提供此账号ID
12.2. 华为账号ID获取方式：
账号登录状态下，点击「账户ID：xxxxxxx」位置，弹窗中的华为账号即为华为账号ID，账户类型需要为【投放操作账户】
13. 常见问题
13.1. 华为应用商店广告账户如何区分是直接类型，还是客户投放伙伴类
登录广告账户，点击账户信息，可根据账户类型进行区分。
热门搜索