术语介绍

授权方式

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

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

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

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

功能介绍

要使用投放分析报表，首先要账户授权，神策才可以调用接口获取到相应广告账户的广告数据，目前神策支持字节-巨量广告、腾讯广告、百度营销平台、360点睛实效平台、搜狗广告投放平台（已下线）、阿里-超级汇川、快手-磁力智投、苹果搜索广告、华为应用商店、华为鲸鸿动能的账户授权。

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

字节-巨量广告

点击添加账户授权，授权版本支持「巨量引擎」「巨量引擎体验版」。支持在广告投放报表-「信息流报表」中查看巨量引擎（原版）以及巨量引擎体验版（升级版）的广告详细数据。

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

点击【同意授权】后， 跳转到如下页面，在此页面中，请等待1～2秒

回到授权管理页面，点击【确认】，即可完成授权

注意：

1、巨量引擎、巨量引擎体验版（升级版）共用一个广告账户。如投放巨量引擎体验版场景，请重新授权，并勾选「巨量引擎体验版」

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

腾讯广告

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

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

百度营销平台

点击添加账号，弹出、授权端口、授权同步、更多授权弹窗。授权端口主要是控制该账户信息在广告分析报表中的数据展示。授权同步可控制本次授权信息使用在哪个项目中。更多授权支持勾选基木鱼选项，拉取基木鱼相关数据。

点击「确定」按钮后，跳转至百度OAuth2.0模式授权页面，账号登录状态下选择需要授权的账号，点击「同意授权」按钮，完成授权操作。

注意：百度目前支持Oauth2.0方式授权，原有授权方式将于2022年年底下线，具体的通知：https://dev2.baidu.com/notice?noticeId=425

最迟请于2023年1月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发往您的邮箱

阿里-超级汇川

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

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

搜狗广告投放平台

搜狗官方通知，搜狗搜索平台于2022年2月15日停止广告投放，2022年2月28日正式下线。受此影响，神策广告分析不再支持「搜狗-搜索推广」渠道，可转移至腾讯广告平台投放搜索广告

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

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

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

快手-磁力智投

点击添加账号，弹出授权方式、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同步今天及以后投放数据

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

ASA-苹果搜索广告

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

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

华为应用商店

点击添加授权账户后，填写授权信息。

授权时需填写客户端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

华为账号ID获取方式：

账号登录状态下，点击「账户ID：xxxxxxx」位置，弹窗中的华为账号即为华为账号ID，账户类型需要为：投放操作账户，即具体投放广告的账号

华为鲸鸿动能

在华为鲸鸿动能账户列表页面中，点击【添加授权账户】弹出授权页面，即可开始进行华为鲸鸿动能广告账户授权，其中授权方式可选广告账户、管家账户，当选择管家账户时，授权成功后会将其子账户信息一并拉取回来。授权端口主要是控制该账户信息在广告分析报表中的数据展示。授权同步可控制本次授权信息使用在哪个项目中。

授权前准备

在进行广告账户授权前，需要获取账户ID、客户端ID、密钥信息，并进行相关权限的申请，具体步骤如下：

步骤一：进行华为联盟开发者认证

授权前，需要完成华为联盟开发者认证，开发者主体与广告投放账号主体一致。具体请参考如下文档：https://developer.huawei.com/consumer/cn/doc/distribution/promotion/ads_api06-0000001059044288

步骤二：创建客户端，获取客户端ID以及密钥

完成华为联盟开发者认证后，登录开发者账号，点击HMS API 服务>凭证>OAuth2.0客户端ID 创建客户端。

按照如下部分填写信息，其中回调地址、应用访问地址为：http://ads-authorization.sensorsdata.cn/ads/api/n/platform/callback/

创建完成后，即可获得【客户端ID】以及【密钥】

添加应用成功后，点击【编辑】，将客户端ID粘贴到步骤3中填写的回调地址以及应用访问地址的最末尾，即为如下格式：http://ads-authorization.sensorsdata.cn/ads/api/n/platform/callback/客户端ID，点击【提交】完成客户端的设置。

具体请参照此文档：https://developer.huawei.com/consumer/cn/doc/distribution/promotion/ads_api07-0000001057938571。

步骤三：为客户端ID申请调用权限

获取到客户端ID后和密钥后，需要为客户端ID申请调用权限，通过邮箱申请权限，主送产品经理liuqianhui1@huawei.com，抄送对应行业运营。

邮件模板如下：

邮件标题：申请开通鲸鸿动能Marketing API服务

邮件正文：申请开通如下应用的推广服务权限

登录开发者联盟的华为帐号：开发者联盟平台帐号

开发者企业名称：在开发者联盟实名认证的企业名称}

客户端ID：步骤二中获取到的客户端ID 

登录广告平台的华为帐号：鲸鸿动能投放平台帐号

广告主企业名称：在广告平台实名认证的企业名称

投放平台账户ID：投放账户ID

回调地址：与步骤二中申请客户端ID中的填写回调地址一致

认证方式：授权码模式

具体请参照此文档：https://developer.huawei.com/consumer/cn/doc/distribution/promotion/ads_api08-0000001059204274

其中投放平台账户ID获取位置如下：

进行授权操作：邮件申请权限通过后，即可进入添加账户授权页面，填写账户名称、账户ID、客户端ID、密钥等信息，完成账户授权

账户名称：用户标记广告广告账户

账户ID：与步骤三中邮件申请模板中的「投放平台账户ID」一致

客户端ID：步骤二中获取的客户端ID

密钥：步骤二中获取的密钥

并点击【确定】。进入华为账户登录页面。此时登录的广告账户需要与步骤三邮件申请中的投放平台账户、授权时填写的账户ID为同一广告账户。如不一致，会导致授权失败或者导致广告投放报表中无法拉取华为鲸鸿动能数据。

点击【登录】后，进入华为账号授权页面，点击【授权】，完成华为鲸鸿动能广告账户授权。

VIVO营销平台

在VIVO营销平台账户列表页面中，点击【添加授权账户】弹出授权页面，即可开始进行VIVO营销平台广告账户授权。授权端口主要是控制该账户信息在广告分析报表中的数据展示。授权同步可控制本次授权信息使用在哪个项目中。

点击【确定】，进入VIVO营销平台授权界面，登录需要授权的广告账户（非代理商平台账号），同意授权时请勾选「我已认真阅读并同意《vivo商业开放平台服务协议》」。

点击【同意授权】后，即可完成VIVO营销平台广告账户授权。

注：

VIVO营销平台广告账户授权之后，方可通过点击监测链接配置回传方案后回传用户行为数据场景。如变更广告账户授权，则会影响用户行为回传，请谨慎操作。

常见问题

华为应用商店广告账户如何区分是直接类型，还是客户投放伙伴类

登录广告账户，点击账户信息，可根据账户类型进行区分。

VIVO营销平台广告账户授权失败？

不支持二代账户进行VIVO营销平台广告账户授权，请使用广告主账户进行授权，具体二代账户、广告主账户的定义，请参考https://open-ad.vivo.com.cn/doc/index?id=163

巨量广告账户授权，为何存在No permission to operate account *问题

使用登录账号A进行授权，账号A下的广告账户为1、2、3。次后使用登录账号B进行授权，账号B下的广告账户为1、4、5。 此时广告账户1为重复授权的广告账户。因为会出现上述问题。此时，按照授权的先后循序，需要把登录账号A下的广告账户1关闭即可。