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_type marketing_asset_outer_id marketing_asset_outer_sub_id MARKETING_TARGET_TYPE_APP_ANDROID 安卓应用 id 安卓应用渠道包 id MARKETING_TARGET_TYPE_APP_IOS IOS 应用 id - MARKETING_TARGET_TYPE_WECHAT_MINI_GAME 微信小游戏 id - MARKETING_TARGET_TYPE_MINI_GAME_QQ QQ 小游戏 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. 数据报表的聚合规则是什么?
不同类型的报表可选择聚合规则略有差异。详见:聚合规则