数字社会中，数字化企业的生存，就是不断挖掘数字用户资产价值，寻求用户的智能化运营，进而实现企业的精益成长。管理用户，洞察用户，企业需要好用的数字工具和解决方案。



但企业在选择数据分析及运营工具时，往往会遇到一个难题：企业本身的系统往往自有一套用户体系，分配了企业内部用户权限的角色。当使用新的数据工具时，企业往往就要从头到尾在数字工具里创建用户、分配角色和权限，一整套流程显得异常复杂和繁琐。



这无疑提高了企业数字化转型的成本。是否有办法将日常的程序体验顺移到数字工具中来呢？易观方舟Open API为此提供了解决之道。





易观方舟Open API输出面向的是开发者（客户方开发者、生态开发者、定制化开发者），将方舟的数据分析能力通过 Http 协议以标准化的形式开放出来，而这将起到桥梁作用，连接客户习惯性的日常工作软件和方舟的大数据分析能力。



数字工具既是基础设施，也可以被视作“后勤部门”。“后勤部门做的好的时候，往往是感受不到他们存在的。他们往往润物细无声。”



易观方舟通过提供Open API，将客户及其习惯的工作环境和易观方舟的数据分析能力连接起来，为企业更好地提供数据分析能力，助力企业的数字化转型。



目前，易观方舟的Open API可以分成五个大类。

第一个是分析类的API ，比如事件分析、留存分析、转化漏斗等。



第二个是用户类的API ，包括分群列表、查分群列表下面的用户明细等。



第三个是管理类的API ，比如获取元事件、元数据，获取用户角色集合等。



第四个是平台管理类的API ，易观方舟实行两级权限管理，一级是企业级、平台级的，一级是项目级的。由于可能会涉及一些重要操作，因此平台管理类 API 的权限会高于管理类的API 。



第五个是工具类的API ，包括SQL查询API 、OAuth2 授权登录以及是 LDAP登陆API 。





易观方舟Open API应用场景



易观方舟Open API的应用场景有哪些呢？这其实与Open API的分类密切相关。

分析类API的使用场景包括：



• 用户有在其他渠道查看方舟分析数据的需求。如，自身业务系统、其他 BI 系统、大屏展示。

• 用户需要对数据进行二次开发。如，订阅分析数据生成自定义的分析报告、与其自身数据整合展示等等。

• 用户需要获取分析数据进行一些监控或者作为一些规则的触发依据。

• 数据比对等等所有需要直接获取方舟分析模块分析数据的场景。



用户类 API 的使用场景包括：



• 用户有需要获取人群信息的需求。如，对接用户自身推送平台、获取人群进行二次分析。

• 打通方舟人群与用户其他系统的人群功能。如，对接用户自身的人群功能，用户可在其他系统直接创建、管理、使用方舟系统的人群。

管理类 API 的使用场景包括：



• 需要直接使用方舟底层数据。如，通过元数据相关 API 获取元数据，是用户自身分析模块、人群模块使用方舟底层数据的基础。

• 需要进行用户打通、统一管理的场景。如，直接对接用户其他管理系统，进行项目成员、权限的管理以及打通等。

• 需要批量维护项目成员的场景。如，批量导入项目成员、批量维护权限等。

平台管理类API的使用场景包括：



• 需要对接客户的项目管理系统，用户可在自己的项目管理中进行方舟项目的管理。如，直接创建项目、启动、停止数据流等。

• 支持通过API 形式批量创建平台用户，为用户分配项目权限。

工具类API的使用场景包括：



• 需要通过API 来实现一些方舟无法支持的分析指标的查询，支持客户编写自定义SQL进行API 查询。

• 不需要在方舟进行注册/添加成员的操作，可以直接依赖客户内部系统的用户体系，完成方舟的自动登录。

如何更好利用易观方舟Open API？



首先，易观方舟的Open API和产品在界面上的功能大体一致，界面上能统计的指标，Open API也都是支持的。唯一在功能上的区别是不支持人群对比和时间对比。



其次，内容主要输出在官网的帮助文档里。进入相关技术文档后点击API即可查阅。





第三，为了开发者能够快速使用这个功能，易观技术服务团队开发了界面一键获取指标 API 参数的功能，优化客户接入的体验。



第四，易观方舟Open API对标SQL，便于客户可以快速理解API参数和输出。



最后，限量和限并发是指查询结果，限量是限定条数；限并发就是查询频次不能高并发。