适用于 Grafana 的 Adobe Analytics 数据源

Adobe Analytics Grafana 数据源

注意
Adobe Analytics enterprise 数据源目前处于公开预览阶段。Grafana Labs 提供有限支持，功能正式发布前可能会发生重大变更。

Adobe Analytics 数据源插件允许您从 Adobe Analytics 中检索报告数据。

要求

此插件有以下要求

一个 Adobe Analytics 帐户
任何免费或付费的Grafana Cloud 计划或一个已激活的本地 Grafana Enterprise 许可证。合同云客户应参考其协议。

安装数据源

要安装数据源，请参考安装。

在 Grafana 中配置数据源

填写以下信息以添加数据源

连接

全局公司 ID

全局公司 ID 用于每个 API 请求的请求 URL。要找到您的全局公司 ID，请按照以下步骤操作

登录Adobe Experience Cloud。
点击“Analytics”
在顶部导航栏中，点击“Admin” → “All Admin”
点击“Company Settings home”
点击“API Access”选项卡，在加载的页面上找到您的“Global Company Id”。它应该显示为
您当前登录的 Analytics Company 的全局公司 ID 是值

认证

此插件支持 OAuth Server-to-Server API 认证。您需要提供 Client ID 和 Client Secret 作为认证凭据。要获取您的 Client ID 和 Client Secret，请按照以下步骤操作

前往Adobe Developer Console 下的“Projects”页面。
点击您希望使用 Adobe Analytics 数据源访问的项目
确保所选项目包含 Adobe Analytics API。如果未包含，点击“Add API”并从列表中选择“Adobe Analytics”。
确保所选项目包含“OAuth Server-to-Server”凭据。如果未包含，请添加。在Adobe Developer portal 上阅读更多关于凭据的信息。
进入“OAuth Server-to-Server”凭据设置，复制 Client ID 和 Client Secret，然后将其粘贴到 Adobe Analytics 数据源配置页面。

使用 Provisioning 配置数据源

可以使用 Grafana 的 Provisioning 系统通过配置文件配置数据源。要了解其工作原理，请参考Provisioning Grafana 数据源。

yaml

以下是使用 OAuth Server-to-Server 认证配置此数据源的 Provisioning 示例
apiVersion: 1
datasources:
  - name: Adobe Analytics
    type: grafana-adobeanalytics-datasource
    jsonData:
      variables:
        global_company_id: <YOUR_GLOBAL_COMPANY_ID>
      services:
        adobe_analytics:
          auth:
            clientId: <YOUR_CLIENT_ID>
    secureJsonData:
      adobe_analytics.clientSecret: <YOUR_CLIENT_SECRET>

查询数据源

插件允许查询报告数据。

您还可以选择查询指标列表、维度列表或报告列表，这些查询可能有助于创建变量，然后使用这些变量来查询报告数据。

查询报告时，您只能获取所选时间范围内的数据。请根据需要调整时间范围。

获取指标摘要数据

获取报告数据时，您可以在查询参数中仅提供指标而不提供维度。在这种情况下，只会返回每个指标的摘要数据。

获取时间序列数据

要获取时间序列指标数据，请在指标旁边选择一个时间序列维度（例如 Hour、Minute、Day 等）。

当提供指标参数以及非日期相关维度（例如 Product）时，响应将只包含表格数据。

使用 `Limit` 参数

Limit 参数影响响应中返回的最大项目数。默认值为 100。您可能需要增加 Limit 以获取所选时间范围内的所有数据点。

使用 `Search clause` 参数

您可以使用 Search clause 参数过滤维度。这对于限制返回的数据非常有用，以便报告仅显示您需要的值。例如，当使用 Product 维度并添加搜索子句 ( NOT CONTAINS 'Product-1' ) 时，响应将排除名称中包含 Product-1 的所有产品。
在Adobe API 文档中阅读更多关于使用搜索子句的信息。