什么是超级汇川Marketing API?

1、API:应用程序接口，可以实现计算机软件间快速、有效、安全的数据传输。

2、超级汇川Marketing API:开放超级汇川UC广告推广平台的数据管理与应用能力，是连结广告主自有平台与超级汇川各流量端的桥梁，为UC广告主提供稳定、友好的接口服务。

3、通过Marketing API获取数据-广告主可以在自有平台内，自主选取、调用超级汇川平台开放的功能，完成UC广告投放、数据获取。

4、通过Marketing API优化UC广告投放-广告主可以应用自有数据，实现自动化、个性化的控制UC广告投放，定制优化策略，提升UC广告投放效果。

超级汇川MarketingAPI目标用户定位

适用于具备一定技术能力的广告主。

行业头部广告主

1、有个性化UC广告投放需求

2、UC广告投放量大、物料多，需要支持批量操作

第三方工具开发者

1、专门为客户提供UC广告投放相关技术支持，需要与媒体平台打通

2、能够为UC广告超级汇川广告主提供广告搭建、数据获取、物料管理等方面的提效支持

广告代理/服务商

1、服务多家客户，UC广告投放产品/素材不一，需要高效完成UC广告投放操作

2、客户要求数据反馈及时，需要按时获取定制化的数据报告

3、数据监控时效要求高，需要及时发现问题、减少事故发生

4、其他有技术能力的客户

超级汇川Marketing API vs 传统手动操作投放功能效益对比

1、超级汇川Marketing API支持广告主快捷实现广告搭建、数据拉取、素材上传、人群和转化管理等批量化的UC广告投放操作;

2、基于物料准备，人群定向起投效果监测UC广告投放优化全流程的效益提升，支持广告主快速验证投放方案，促进消耗增长。

跨账户UC广告投放管理

1、支持指定多账户、或针对代理/管家户下的多个子UC广告账户进行批量操作。

2、优化师日维护账户数主要分布在10~20区间，平均操作3次/户，通过API提效30倍以上。

定制数据报告

1、支持广告主自选指标定制报告;支持分UC广告推广层级报告、定向报告和其它专项报告.

2、优化师日均分时段汇总报告达5次以上，需要20分钟，通过API操作仅需5分钟。

批量搭建广告

1、支持一次性批量搭建UC广告推广组/计划/创意。

2、优化师每创建200条推广计划，手动操作需3小时，通过API操作仅需15分钟。

UC广告投放异常监测

1、支持广告主基于实时返回的UC广告投放数据指标制定监控策略，及时发现异常、跟进优化。

2、优化师日均看盘3轮，通过API可实现分钟级系统自动巡查，监测效率提升5倍以上。

超级汇川Marketing API当前使用情况

相较2021年同期，超级汇川MarketingAPI完成了支持全链路、跨场景UC广告投放的产品升级;同步在物料批量搭建、账户资产共享及基本请求流程上进行了迭代优化，帮助广告主实现更轻便、高效的产品体验，提升基建能力和UC广告投放效率。

超级汇川Marketing API核心接口能力一览

1、账户信息服务：支持在广告主自有平台构建，UC广告投放账户体系及账户资金预算管理

2、素材管理服务：支持广告主搭建自有UC广告投放资产库，包含视频/图片素材，以及应用、建站、定向包等

3、数据报告服务：支持获取各UC广告推广层级报告及效果分析报告;支持广告主按需自建定制化报表

4、DMP人群管理服务：支持广告主跨账户高效管理人群，包含人群包的上传、获取、更新、共享等

5、推广层级管理服务：支持批量创建/更新/获取各个UC广告推广层级信息，高效完成UC广告投放操作

6、转化工具服务：支持UC广告主批量创建、获取、跨账户共享转化:支持全链路节点优化，帮助衡量和提升UC个阳光投放效果

Marketing API 应用案例

小鹿超级汇川助手-核心功能

1、支持系统:win7、win10

2、小鹿基于超级汇川Marketing API的开放能力，聚合团队协作管理、跨账户批量UC广告投放操作、资产管理、定制报告、7x24小时账户智能预警等核心功能，推出“小鹿超级汇川助手”应用，为广告主提供UC广告投放全流程的提效支持和数据展现。支持广告主构建内部统一的UC广告投放资产管理平台(素材/定向/转化),实现物料集中管理;一次提交，多账户同步。智能预警以系统替代人工自动巡检账户，帮助优化师快速处理异常，保护UC广告账户投放安全。

九枝兰汇川账户管理-核心功能

九枝兰对接超级汇川Marketing API，推出“九枝兰汇川账户管理”web工具，支持跨账户批量化的广告搭建、素材上传和数据效果分析等功能。在基本操作提效的基础上，通过账户数据监控提醒和自动化策略支持，帮助广告主及时获知账户数据波动情况、并可自动完成满足条件启停广告、预算调整等优化动作.

Marketing API亮点功能案例

知定堂系统

1、亮点功能:账户打标归类，形成项目管理机制，支持对账户打标绑定所属项目，同时支持批量上传素材时勾选主体和项目，实现项目维度的跨账户素材上传，便于广告主分类管理。

2、账户打标:添加行业、标签(可根据UC广告推广应用、产品线等分类)，并关联UC广告推广账户。

3、基于所选主体和项目，批量上传图片/视频素材，致维嗨景营销云

4、亮点功能:批量复制UC广告推广计划，为优化师提供了便捷的计划复制功能，一次最多可复制20条计划到账户下。

5、这项轻便的小功能将优化师计划搭建效率提升10倍+;服务客户数70+

Marketing API 接入指引

接入流程

1、【接入条件]超级汇川UC广告投放账户、代理户或管家户均可申请接入;需账户状态为正常，否则会提示无法通过。

2、如使用代理户或管家户申请，申请通过后可支持获取其下UC广告投放账户数据;无需再行使用投放账户逐一完成申请。

申请方式

1、在开放平台(https://open2.sm.cn/)登录拟申请的UC广告账户;

2、点击进入开发者中心UC广告超级汇川API申请，勾选同意协议并点击“提交申请”按钮即提交成功;

3、提交后系统自动审核，审核通过后将在此页面显示该UC广告账户的APIKey(即API请求时所需的token值);当发生接口请求，该token用于与账户名、密码同步进行身份验证。

Marketing API基本使用说明

总述

1、Marketing API又称投放API，旨在解决UC广告主投放操作、数据获取等场景的效率问题;不含转化API(转化数据回传)相关内容。

2、请求频次限制:账户维度QPS20，即同投放账户内至多请求20次/秒。

3、人群管理相关接口方法详见技术文档最后的DMP API文档”DMP开发者API介绍”;token与其它类接口共用，注意请

4、技术文档附录提供UC广告推广地域列表、错误编码、数据报告指标列取值、创意分类与标签功能账户行业白名单等。

请求格式

1、请求和返回的json消息一般包含header和body两部分，header包含账户名称、密码、token等字段。

2、如使用代理户/管家户请求，请务必填写target字段，内容为请求的子账户(UC广告投放账户)名称，不是账户ID。

3、详见文档”API请求及返回”部分(点击标题文字直达)。

API快速联调

您可通过获取账户信息接口，快速检验您是否能正常调用接口。

Marketing API常见问题答疑

1、请求提示”用户没有权限”如何处理?

1、这个情况说明请求域名或UC广告账户权限存在问题。

2、对应请求的username(账户名称)是否已在开放平台获取到

2、请求提示”请求头信息为空或不合法”如何处理?

1、如1中所述检查请求域名信息，注意不要带空格、且其后接口名与文档一致;

2、确认header信息填写正确:包括请求UC广告账户名、密码、token，如为代理/管家户请求需target到子账户名称。子账户需与请求账户在crm存在从属关系。

3、获取数据报告后，使用downloadFile接口下载文件为空，应如何处理?

1、建议UC广告日报任务获取时间安排在次日上午9:30后，保障数据正常产出;

2、推荐获取后先使用getFile查询下载任务状态，当返回状态为true时进行下载;

3、注意获取分析类报告后，getFile或downloadFile“adReport”字段为必填，需传false分析类报告包含:APP报告、受众分析报告、地域分析报告、安心赔付消费报告、UC广告超级巡量计划数据报告、超级巡量建议开启计划报告

4、超级汇川全链路转化升级后，哪些接口发生了变化?

1、UC广告推广计划和转化类接口发生了变化(需广告主对应开发);数据报告接口新增相关字段，广告主可按需对接(不开发仍可获取原有数据报告);其它接口无变化。

2、升级前后对比版文档-变更字段已标红(点击标题文字直达)

3、数据报告字段更新-新增字段已标红(点击标题文字直达)

5、数据报表接口可否支持实时获取?

基本支持实时。请求当日UC广告小时级报告时，最后一个小时会是截至当前的分钟级数据汇总。

6、下载任务的taskid会失效吗?同个taskid数据会更新吗?

不会失效;同个taskid数据会更新，通过taskid下载时，会在前一步获取数据的约束条件基础上，拉取最新UC广告数据下载。

7、通过接口下载报表后发现是”乱码”怎么办?

二进制流，需要在程序里面支持编码，换成gbk。

8、创建计划时提示素材不可用怎么办?

请检查素材是否在UC广告账户中存在且非审核拒绝状态。审核中、审核通过的素材均可用于创建计划。

接口SDK封装:更快捷的接入办法-现仅支持java

1、UC广告超级汇川Marketing API的Java SDK版本，在现有Marketing API基础上对功能与接口进行了封装。

2、相比直接接入API，使用SDK版本可以更简单快捷的接入所需功能，大幅降低新客户的接入成本。

注意

1、当接口发生升级，常规情况下会每次向前兼容，UC广告主仍可使用原有SDK包;

2、特殊情况下的重大升级，可能导致原有旧版SDK无法兼容平台最新功能，此时需要UC广告主到开放平台下载最新版本的SDK包。

3、发生重大升级时，在开放UC广告平台及其它官方渠道会发通知。

4、【下载入口]开放平台，技术文档(点击标题文字直达)

接口SDK版本优势

1、UC广告超级汇川平台官方提供，稳定维护有保障

2、新客友好、易用性强提供接入手册和使用示例，为开发者提供“保姆级”使用指引

3、大幅降低接口接入成本，除特殊定制化需求外，免去UC广告主后端开发工作量

4、新功能持续更新，SDK封装接口与Marketing API同步升级