@adobe/aio-lib-analytics

中文文档
4.0.2发布于 2025/09/04CommonJS近 30 天下载 2.6万

Adobe 分析 SDK

中文使用文档
文档目录26 节
  1. 安装
  2. 使用量
  3. 类
  4. 职能
  5. 分析算法
  6. 分析 CoreAPI.init( companyId, apiKey, 令牌) QQ AnalyticsCoreAPI
  7. 分析 CoreAPI.get 计算计量(选项)
  8. 分析 CoreAPI.get Calculated MetricById(id,选项)
  9. 分析 CoreAPI. 获得集合( 选项)
  10. 分析 CoreAPI.get CollectionById(lisid, 选项)
  11. 分析 CoreAPI.getDate Ranges( 选项)
  12. 分析 CoreAPI.getDate RangById(日期RangId,选项)
  13. 分析 CoreAPI.get Dimensions(sid, 选项)
  14. 分析 CoreAPI.get DimensionById(dimensionId, rsid, 选项)
  15. 分析 CoreAPI.get Metrics( 参数, 选项)
  16. 分析 CoreAPI.get MetricById(id, rsid, 选项)
  17. 分析 CoreAPI.get 报告(正文)
  18. 分析 CoreAPI.getSegments( 选项)
  19. 分析器 CoreAPI.validateSecment(sid,正文)
  20. 分析 CoreAPI.get users( 选项)
  21. 分析 CoreAPI.get 当前用户( )
  22. 分析 CoreAPI.getUsageLogs( 启动日期、 结束日期、 选项)
  23. init( companyId, apiKey, 代号) QQ Promise.<AnalyticsCoreAPI>
  24. 除错日志
  25. 捐款
  26. 许可证发放

Version Downloads/week Node.js CI License Codecov Coverage

Adobe I/O Adobe 分析 SDK

节点 Javascription 核心 SDK 包装 Adobe 分析2.0 APIs。 。 。 .

安装

$ npm install

使用量

  1. 初始化 SDK
var sdk = require('@adobe/aio-lib-analytics');

async function sdkTest() {
  //initialize sdk
  const analyticsClient = await sdk.init('<companyID>', 'x-api-key', '<valid auth token>')
}

Init 方法返回类实例 AnalyticsCoreAPI

  1. 使用初始化 sdk 的调用方法
var sdk = require('@adobe/aio-lib-analytics');

async function sdkTest() {
    //initialize sdk
    const analyticsClient = await sdk.init('<companyID>', '<x-api-key>', '<valid auth token>')

    //get report suites
    const collections = await analyticsClient.getCollections({limit:5, page:0})

    //get metrics
    const metrics = await analyticsClient.getMetrics(rsid)

    //generate report
    const report = await analyticsClient.getReport(queryJSON)
}

Sdk 下的所有可用方法都有记录 here

类

分析算法

这个类提供了将Adobe Analytics APIs称为的方法. 在调用任何方法之前, 通过调用它的方法初始化实例 带有有效公司代号、 apiKey 和 认证标志

职能

init( companyId, apiKey, 符号) ⇒ Promise.<AnalyticsCoreAPI>

返回以新的 Analytics CoreAPI 对象解析的保证 .

分析算法

这个类提供了将Adobe Analytics APIs称为的方法. 在调用任何方法之前, 通过调用它的方法初始化实例 带有有效公司代号、 apiKey 和 认证标志

仁爱: 全球类

分析 CoreAPI.init( companyId, apiKey, 令牌) QQ AnalyticsCoreAPI

初始化 sdk.

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
连号stringadobe Analytics公司使用公司ID.
键string您的 Api 密钥
符号string有效验证符

分析 CoreAPI.get 计算计量(选项)

检索出许多计算出的度量衡. 计算出的度量响应将始终包括这些默认项目: id,名称,描述,rsid,所有者,极性,精度,类型 其他属性可以通过“ 扩展” 字段选择请求:\ n\ n 修改:计量标准被最后一次修改的日期(ISO 8601) 定义:作为 JSON 对象的计算参数定义 相容性: 与该计量标准相容的产品 报告套件Name: 另返回 RSID 的友好报告套件名称 标记 *: 给出所有与已计算度量相关的已存在的标记

关于计算指标的更多信息 这里

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
选项Object来控制计算过的参数搜索.
选项。计算计算器过滤列表只包含在指定的列表\n(ID的comma-discription 列表)中计算出的度量衡.
选项.扩展逗号限制附加元数据字段列表\n在响应中包含.
选项。限制每页结果数。 默认10.
选项当地人.
选项。名称过滤列表只包含包含该名称的计算度量 .
选项。所有者ID过滤列表中仅包含由\n指定登录符拥有的计算度量 .
选项页号(基数为0-首页为"0"). 默认 0.
选项.rsids过滤列表只包含与指定的\nRSID列表(comma-delimited)绑定的已计算度量衡.
选项.tag名称过滤列表只包含含有\n标签之一的已计算度量 .

分析 CoreAPI.get Calculated MetricById(id,选项)

由 id 获取一个单个计算度量. 计算出的度量响应将始终包括这些默认项目: id,名称,描述,rsid,所有者,极性,精度,类型 其他属性可以通过“ 扩展” 字段选择请求:\ n\ n 修改:计量标准被最后一次修改的日期(ISO 8601) 定义:作为 JSON 对象的计算参数定义 相容性: 与该计量标准相容的产品 报告套件Name: 另返回 RSID 的友好报告套件名称 标记 *: 给出所有与已计算度量相关的已存在的标记

关于计算指标的更多信息 这里

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
编号string计算出要取回的度量ID .
选项Object用于控制计算出的计量结果
选项.扩展逗号限制附加元数据字段列表\n在响应中包含.
选项当地人.

分析 CoreAPI. 获得集合( 选项)

检索报告匹配给定过滤器的套件. 在一个集合中返回所有报告套件类型.

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
选项Object以控制报告套件搜索.
选项.扩展逗号限制添加元数据字段列表, 以包含 on\nreswer .
选项。限制每页结果数。 默认10.
选项页号(基数为0-首页为"0"). 默认 0.
选项.rsids过滤列表只包含此 RSID 列表\n( comma- delimited) 中的套接字 .
选项.rsidConters过滤列表中仅包含含有 rsidContains 的套件 .

分析 CoreAPI.get CollectionById(lisid, 选项)

取回身份报告套件. 在一个集合中返回所有报告套件类型.

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
瑞兹string套房的瑞斯德回来.
选项Object来控制 eport 套房搜索.
选项.扩展逗号限制添加元数据字段列表, 以包含 on\nreswer .

分析 CoreAPI.getDate Ranges( 选项)

返回用户的日期范围列表. 此功能允许用户存储常用的日期范围, 这样可以在整个产品中重新使用 .

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
选项Object以控制日期范围搜索.
选项.扩展逗号限制添加元数据字段列表, 以包含 on\nreswer .
选项。filterByIds过滤列表只包含指定列表\n( 共限制的ID列表) 的日期范围 .
选项。限制每页结果数。 默认10.
选项当地人.
选项页号(基数为0-首页为"0"). 默认 0.

分析 CoreAPI.getDate RangById(日期RangId,选项)

为 Date Range 获取配置...

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
日期范围string用于获取信息的 Date Range ID .
选项Object以控制日期范围结果.
选项.扩展逗号限制添加元数据字段列表, 以包含 on\nreswer .
选项当地人.

分析 CoreAPI.get Dimensions(sid, 选项)

返回特定报告套件的尺寸列表.

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
瑞兹string报告套件.
选项Object来控制维度搜索.
可分类仅包括可分类维度.
选项.扩展逗号限制附加元数据字段列表\n在响应中包含.
选项当地人.
选项只包括报告内有效的方面.
可选项仅包括某一段内有效的维度.

分析 CoreAPI.get DimensionById(dimensionId, rsid, 选项)

返回给定的报告套件的尺寸和尺寸 Id .

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
维度Idstring维度ID。 例如,有效的id就是"evar1"这样的值.
瑞兹string报告套件.
选项Object控制维度结果.
选项.扩展逗号限制附加元数据字段列表\n在响应中包含.
选项当地人.

分析 CoreAPI.get Metrics( 参数, 选项)

返回给定的报告套件的衡量标准列表. 这返回主要用于Analytics产品的度量衡列表. 平台身份 API 返回所支持系统所有可能的度量衡列表.

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
瑞兹string报告套件.
选项Object控制维度结果.
选项.扩展逗号限制附加元数据字段列表\n在响应中包含.
选项将命名为度量衡的系统重新定位.
可选项如果在段内有效,则通过过滤度量.

分析 CoreAPI.get MetricById(id, rsid, 选项)

返回给定的报告套件的衡量标准. 这返回主要用于Analytics产品的度量衡列表. 平台身份 API 返回所支持系统所有可能的度量衡列表.

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
编号string用于检索信息的指标的编号。 注 ids 是值\ nlike pageviews,而不是度量符/页面views.
瑞兹string报告套件.
选项Object控制维度结果.
选项.扩展逗号限制附加元数据字段列表\n在响应中包含.
选项将命名为度量衡的系统重新定位.

分析 CoreAPI.get 报告(正文)

为请求运行报告. 见 报告用户指南 详细情况.

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
机构Object报表查询.

分析 CoreAPI.getSegments( 选项)

收回所有部分.

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
选项Object以控制分区搜索.
选项.扩展逗号限制附加元数据字段列表\n在响应中包含.
选项。包含类型包含用户不拥有的额外片段 。 "所有"选项\n优先于"共享".
选项。限制每页结果数。 默认10.
选项将命名为度量衡的系统重新定位.
选项。名称过滤列表只包含包含“名称”的片段.
选项页号(基数为0-首页为"0"). 默认 0.
选项.rsids过滤列表只包含绑定在指定的 RSID 列表\n( comma- delimited) 的片段 .
选项过滤列表只包含指定的列表\n( 共限制的ID列表) .
选项.tag名称过滤列表只包含包含一个标记的片段 .

分析器 CoreAPI.validateSecment(sid,正文)

A 验证部分. 返回报告后正文所载段的验证.

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
瑞兹string报告套件.
机构ObjectJSON部分定义.

分析 CoreAPI.get users( 选项)

返回当前用户登录公司的用户列表 . 为 auth\ntoken 指定的公司检索所有用户列表 .

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
选项Object来控制用户搜索.
选项。限制每页结果数。 默认10.
选项页号(基数为0-首页为"0"). 默认 0.

分析 CoreAPI.get 当前用户( )

获取当前用户 .

仁爱: 实例方法 AnalyticsCoreAPI

分析 CoreAPI.getUsageLogs( 启动日期、 结束日期、 选项)

检索所提供的搜索标准的使用情况和访问日志. 这个 API 在3 个月内返回指定日期范围的使用和访问日志 。 此 API 用 IMS 用户令牌认证 .

仁爱: 实例方法 AnalyticsCoreAPI

参数类型说明
开始日期string以ISO-8601格式开始日期,最长为3个月.
结束日期stringISO-8601格式的结束日期,最长为3个月.
选项Object用于过滤日志的选项.
选项。loginstring您想要过滤日志的用户的登录值 .
选项.ipstring您想要过滤日志的 IP 地址 .
选项.rsidstring您想要过滤日志的报告套件 .
选项。eventTypestring您想要过滤日志的事件类型的数字 ID .
选项string您想要过滤日志的事件描述 。 不允许使用通配符 .
选项。限制number每页结果数。 默认10.
选项number页号(基数为0-首页为"0"). 默认 0.

init( companyId, apiKey, 代号) QQ Promise.<AnalyticsCoreAPI>

返回以新的 Analytics CoreAPI 对象解析的保证 .

仁爱:全球职能

参数类型说明
连号stringadobe Analytics公司使用公司ID.
键string您的 Api 密钥
符号string有效验证符

除错日志

LOG LEVEL = 调试 < your call here >

捐款

欢迎捐款! 读取 贡献指南 更多信息.

许可证发放

这个项目根据Apache V2许可证获得许可. 见 自由主义 更多信息.

版本与发布记录

@adobe/aio-lib-analytics 共发布 14 个版本,首次发布于 2019/10/14;过去 12 个月发布了 0 个版本。

版本发布日期距今
4.0.2latest2025/09/041.2 年前
4.0.12024/02/082 年前
4.0.02024/01/112 年前
3.0.1-pre.2024-01-08.sha-195ecf6anext2024/01/082 年前
3.0.12023/06/283 年前
3.0.02022/08/194 年前

关于 @adobe/aio-lib-analytics 的常见问题

@adobe/aio-lib-analytics 是什么?

Adobe 分析 SDK

如何安装 @adobe/aio-lib-analytics?

在项目目录运行 npm install @adobe/aio-lib-analytics,或使用 pnpm add / yarn add / bun add。

@adobe/aio-lib-analytics 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/adobe__aio-lib-analytics 是否存在。

@adobe/aio-lib-analytics 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@adobe/aio-lib-analytics 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@adobe/aio-lib-analytics 可以商用吗?

@adobe/aio-lib-analytics 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@adobe/aio-lib-analytics 的下载量有多少?

根据 npm 官方下载统计,@adobe/aio-lib-analytics 在 2026/10/05 – 2026/11/03 这 30 天内被下载 25,846 次,日均约 862 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@adobe/aio-lib-analytics 还在维护吗?

最新版本 4.0.2 发布于 2025/09/04(1.2 年前);至今共发布 14 个版本,其中过去 12 个月发布了 0 个;首次发布于 2019/10/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。