菜单
文档breadcrumb arrow 插件breadcrumb arrow breadcrumb arrow 适用于 Grafana 的 Adobe Analytics 数据源

Adobe Analytics Grafana 数据源

注意

Adobe Analytics 适用于 Grafana 的企业数据源目前处于 公开预览 状态。Grafana Labs 提供有限的支持，并且在功能正式发布之前可能会出现重大更改。

Adobe Analytics 数据源插件允许你从 Adobe Analytics 检索报表数据。

要求

此插件具有以下要求

安装数据源

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

在 Grafana 中配置数据源

添加数据源，方法是填写以下信息

连接

全局公司 ID

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

  • 登录 Adobe Experience Cloud
  • 点击“分析”
  • 在顶部导航栏中点击“管理”→“所有管理”
  • 点击“公司设置主页”
  • 点击“API 访问”选项卡，并在加载的页面上找到你的“全局公司 ID”。它应该被提及为

    你当前登录的 Analytics 公司的全局公司 ID 为 VALUE

身份验证

此插件支持 OAuth 服务器到服务器 API 身份验证。你需要提供 Client ID 和 Client Secret 作为身份验证凭据。要获取你的 Client ID 和 Client Secret，请按照以下步骤操作

  • 转到 Adobe Developer Console 中的“项目”页面
  • 点击你想要使用 Adobe Analytics 数据源访问的项目
  • 确保选定的项目包含 Adobe Analytics API。如果没有，请点击“添加 API”，然后从列表中选择“Adobe Analytics”。
  • 确保选定的项目包含“OAuth 服务器到服务器”凭据。如果没有，请添加它。在 Adobe 开发人员门户 上阅读有关凭据的更多信息。
  • 进入“OAuth 服务器到服务器”凭据设置，从那里复制 Client ID 和 Client Secret，并将它们粘贴到 Adobe Analytics 数据源配置页面。

使用配置配置数据源

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

以下是使用 OAuth 服务器到服务器身份验证为此数据源配置的示例

yaml 
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 文档 中使用搜索子句的更多信息，请参阅。

已知限制

目前，无法使用插件获取细分维度数据。如果您需要它，请随时创建功能请求并告诉我们您的用例。

模板和变量

要添加新的 Adobe Analytics 查询变量，请参考 添加查询变量。使用您的 Adobe Analytics 数据源作为您的数据源，并在查询构建器中填写字段。

创建变量后，您可以使用 变量语法 在 Adobe Analytics 查询中使用它。有关变量的更多信息，请参考 模板和变量。

了解更多

相关文档