MKTAPI3.0-Q&A

一、授权相关

1. 为什么提示 token 过期或者 Access token is invalid ?

一般情况下,Marketing API 的 access_token 有效期为 24 小时,refresh_token 有效期为 30 天,如果超过这个时间 token 会失效。如果是 access_token 过期但是 refresh_token 还未过期,您可以用 refresh_token 获得新的 access_token。如果是 refresh_token 过期,您需要向推广帐号的所有者重新发起 OAuth2.0 授权。

 

2. 为什么报接口调用次数超限错误或者 Application request limit has been exceeded ?

系统对每个应用程序(client_id)每个接口的调用有每天总量和每分钟频次的限制。默认情况下,新开通的应用每天总量限制为读接口 20000 次/接口,写接口 10000 次/接口。每分钟的频次均为 1000 次/接口,请检查您的调用是否超限。如果您发现默认的限制不符合您业务的需要,可联系接口的运营人员,我们会根据实际情况酌情调整。

 

3. 为什么正常访问接口报 The nonce has been used before ?

同一个 access_token 的 nonce 需要保证唯一,出现这个错误表示违反了此创意形式,需要更换 nonce 参数的值。

 

4. 为什么报访问接口没有权限或 The API you requested is out of the scope of authority ?

系统对每个应用程序(client_id)都分配了对应接口的权限,新开通的应用在审核时会授予常用接口的访问权限,如果您需要访问当前接口,可联系接口的运营人员开通权限。

 

5. 集团、主体、业务单元、账户的区别?

集团:存在合作关系的组织合集(可以是政策集团、客户简称等提供合作关系的主体集合等);
主体:企业类客户唯一营业执照/个人客户唯一身份证对应主体,管理实体;
业务单元:一个虚拟的营销组织集合,可以关联相关组织(如账户、成员等),并实现数据资产、资金等资源的共享;
账户:用户实际广告投放的账号(uid),承担业务隔离(如行业、品类、投放方式等)和考核管理(如代理、投手)的管理职责。

 

6. MKTAPI3.0 是否支持老 BM 授权?

不支持,MKTAPI3.0 新管理能力升级,v3.0 接口支持集团/主体/业务单元/广告主账户进行授权,不再支持老 BM 授权,注:老 v1.3 接口还支持老 BM 授权;

 

二、广告投放

1. 老 MP 账户是否可投放 3.0 广告?

老 MP 账户不支持通过 API 投放 3.0 广告,建议申请 ADQ 账户进行投放;

 

2. 创建广告时如何获取推广内容资产信息?


➢创建广告时,可通过获取可投放推广内容资产类型名称(marketing_target_types/get)接口查询可投放的推广内容类型、可通过获取可投放推广内容资产相关信息(marketing_target_assets/get)接口查询可投放的推广产品 id(MARKETING_ASSET_ID)以及所属的产品属性,注意:推广内容资产相关信息(marketing_target_assets/get)接口仅支持查询非通用类资产
➢通用类资产(app、小程序、小游戏、视频号、公众号、商品等)通过 adgroup 创建时 marketing_asset_outer_spec 表达; marketing_asset_outer_spec 具体支持通用资产可以参考如下表格:
marketing_target_typemarketing_asset_outer_idmarketing_asset_outer_sub_id
MARKETING_TARGET_TYPE_APP_ANDROID安卓应用 id安卓应用渠道包 id
MARKETING_TARGET_TYPE_APP_IOSIOS 应用 id-
MARKETING_TARGET_TYPE_WECHAT_MINI_GAME微信小游戏 id-
MARKETING_TARGET_TYPE_MINI_GAME_QQQQ 小游戏 id-
MARKETING_TARGET_TYPE_PC_GAME游戏域名-
MARKETING_TARGET_TYPE_CONSUMER_PRODUCT商品库 id商品 id
MARKETING_TARGET_TYPE_LOCAL_STORE格式:poi_id@owner_uid
poi_id:门店 id
owner_uid: 门店所属账号 uid
-
MARKETING_TARGET_TYPE_WECHAT_WORK企业微信 id-
MARKETING_TARGET_TYPE_COMMODITY_SET商品库 id商品集合 id
注:推广内容类型(MARKETING_TARGET_TYPE)为 电商商品(MARKETING_TARGET_TYPE_CONSUMER_PRODUCT)时,marketing_asset_outer_spec 通过 获取商品库接口(product_catalogs/get)&获取商品接口(product_items/get)获取对应商品库 id(product_catalog_id)和商品 id(product_outer_id)

 

3. 广告唯一性限制规则是什么?

新投放对广告唯一性有明确的限制,新建广告环节增加“卷基建”判断,杜绝无序创建,聚合转化数据以提升拿量效果,不同行业唯一性限制条件不同,主要通过推广内容和定向进行约束

 

三、数据报表

1. 请求图片报表时如何过滤 icon、视频封面等数据?

组件类型=品牌形象可以筛出来 icon 的数据,从接口获取时屏蔽该组件类型即可

 

2. 数据报表的时效性?

不同类型的报表数据更新时效性略有差异,具体如下:
报表分类数据更新时效性
日报表
(daily_reports/get)
(1)不使用版位(site_set)聚合数据(group by)情形:
3 分钟级别更新
(2)按照版位(site_set)聚合数据(group by)情形:
1 小时级别更新:
REPORT_LEVEL_MATERIAL_IMAGE, REPORT_LEVEL_MATERIAL_VIDEO
T+1 天更新:
REPORT_LEVEL_DYNAMIC_CREATIVE, REPORT_LEVEL_COMPONENT, REPORT_LEVEL_CHANNEL
小时报表(hourly_reports/get)3 分钟级别更新
定向标签报表(targeting_tag_reports/get)T+1 天
获取联盟广告位报表(ad_union_reports/get)T+1 天

 

3. 数据报表的聚合规则是什么?

不同类型的报表可选择聚合规则略有差异。详见:聚合规则