本篇文章为大家带来华为鲸鸿动能广告Marketing API基本功能介绍，新近变化及后续演进。

一、华为鲸鸿动能广告Marketing API整体功能简介

1、鲸鸿动能Marketing API是什么

Marketing API是鲸鸿动能广告对外开放技术能力的开放平台，为开发者提供统一的鉴权、开发、管理等服务，在功能、性能、安全、技术支持等多个方向提供良好的开发体验。通过底层的应用程序接口调用，实现数据与服务功能的传输，让外部客户在本地也能远程使用鲸鸿动能平台系统，完成广告投放、报表分析、创意制作等功能，提升营销效率。

2、华为鲸鸿动能广告Marketing API具体的能力

• 华为广告投放：提供广告投放能力；管理支持对计划、任务、创意、推广产品进行增/删/改/查等操作

• 数据报表：提供广告投放的展示、点击、消耗、转化等数据；支持查询账户/计划/任务/创意/商品级数据

• 财务管理：提供财务数据管理；支持对账户余额、充值/转账记录，以及日消耗明细等财务数据进行查询

• 资产管理：提供账户资产的管理能力；帮助广告主管理落地页、素材、定向包、DPA商品库等

• 账户管理：提供账户信息管理；支持账户基本信息，Token关联账户及操作日志信息查询

3、华为鲸鸿动能广告Marketing API整体调用情况分析

二、近期华为鲸鸿动能广告Marketing API功能升级

1、近期鲸鸿动能Marketing API功能升级情况

2、重点特性介绍:支持服务商账户接入Marketing API

3、重点特性介绍:支持服务商账户接入Marketing API

查询资金账户日结算明细支持的消耗数据查询场景

（1）服务商身份接入时，支持查询如下场景的消耗数据：

• 服务商直接关联的下属某子客消耗(传入advertiser_id )

• 服务商的所有消耗(服务商传自身的agency_id或不传)

• 服务商下属子客服务商消耗(服务商传下属子客服务商的agency_id,同时不传advertiser_id )

• 子客服务商下属子客的消耗(服务商传子客服务商下属子客advertiser_id，同时不传agency_id或传子客服务商的agency_id )

（2）子客服务商身份接入时，支持查看如下场景的消耗数据：

• 子客服务商直接关联的下属某子客消耗(传入advertiser_id )

• 子客服务商的所有消耗(传子客服务商自身的agency_id或不传，同时不传advertiser_id )

4、重点特性介绍：优化通过Marketing API创建全域智投版位任务的体验

5、重点特性介绍:计划/任务状态管理优化

6、重点特性介绍:获取Token授权账户信息

优化前：服务商基于广告账户或经理账户管理旗下子客账户，token众多，映射关系管理困难，经常出现使用错误token调用的情况

优化后：新增“获取Token授权账户信息”，支持各类账户类型

开发者携带access‑token向鲸鸿动能mAPI发起请求，服务端校验后返回授权账户信息

7、重点特性介绍:其他优化项

定向包管理相关优化

• 对齐投放端，支持对性别、年龄等定向从“XX”修改为“不限”

• 智能扩量支持的枚举值对齐投放端，补充细分受众和媒体类型等

• 查询定向包接口增加已关联任务数

• 任务被删除后，不再占用“定向包最大关联任务数(500)”的额度

三、后续华为鲸鸿动能广告Marketing API产品演进

1、后续鲸鸿动能Marketing API产品演进规划

2、其他较多服务商关注但暂未接纳需求说明

四、FAQ

• Q：我推广的产品很明确是“Android应用”，在“创建OAuth2.0客户端ID”页面选择凭证类型也选择的是“Android应用”，但为什么在“授权管理页面”缺看不到鲸鸿动能Marketing API的权限申请入口呢?

  A：在“创建OAuth2.0客户端ID”操作页面您选择的凭证类型和您推广的产品并不是一回事，这里指的是机机接口的类型，请固定选择“服务器应用”。

• Q：我在首次“登录并获取access_token”阶段已按照示例手工拼接鲸鸿动能要求的“令牌登录获取地址”(其中包含了redirect_url)，但打不开授权登录页面并且浏览器出现报“<{>"error":1101,"error_description":"redirect_urinot registered","sub_error":20023<}>”，这是为什么?

  A：您可能在“创建OAuth2.0客户端ID”未填写回调地址导致后台校验失败，请返回凭证编辑页面补充redirect_url，然后直接重新发起授权即可。

• Q： 我们已经成功获取了token，但在有些接口请求时还是收到“操作没有权限”错误，这是为什么?

  A：请按如下步骤排查:

Step1：您可以先在“授权管理”页面检查您此前申请的功能权限范围(report/ promotion/ tools / account / finance)是否完整以及对应的状态是否为“已获取”;

Step2：您可以在“登录并获取access_token”或“刷新access_token”的响应中检查scope范围，如果没有对应的权限范围，请重新发起“登录并获取access_token”请求，补充完整scope值。

• Q： 我的token还在有效期，但请求时报错“User ID mismatch”，这是为什么?

  A：可能是由于您使用了经理账户或服务商授权的token，但传参时给的advertiser_id不在该经理账户或服务商关联的子客列表中;如您已不确认token是哪个华为广告账户授权的，您可通过我们新增的“查询Token关联账户列表信息”接口获取token的授权账户信息。

• Q：我使用了一个可以登录鲸鸿动能的华为账号进行授权并成功获取了token，但是使用该token发起请求时还是提示如下错误:{"code":"50000","message":"invalid account,may not be realName Verified or account is team account"}，这是是为什么?

  A：您可能使用了服务商体系的协作者的华为账号或者广告投放账号的团队成员的华为账号进行的授权，这一类账号不支持MAPI接入。请重新使用服务商/广告投放账户创建时的主华为账号进行授权。

特别提醒：由于浏览器有缓存机制，可能会导致授权用户在浏览器中输入了“手动拼接鲸鸿动能的令牌登录获取地址”后自动进行了登录(而该登录账号又不是服务商/广告投放账户创建时的主华为账号)。因此我们建议您的运营在登录授权操作中，使用浏览器无痕模式输入正确的账号和密码。

• Q：我创建创意时经常收到报错“创意不匹配版位...”的提示，这是为什么?

  A：全域智投版位覆盖多种元素规格，您可以在创建创意时通过“查询版位元素”接口了解对应全域智投版位支持的各个元素(图片/视频/文案等)的详细要求，并按要求创建创意。

想要了解更多关于华为广告推广和广告开户可以咨询【巨宣网络】联系电话：4009602809。