菜单
文档breadcrumb arrow 插件breadcrumb arrow Adobe Analytics for Grafana 数据源

Adobe Analytics Grafana 数据源

注意

Adobe Analytics 企业数据源目前处于 公开预览。Grafana Labs 提供有限支持，在功能全面发布之前可能会出现破坏性更改。

Adobe Analytics 数据源插件允许您从 Adobe Analytics 获取报告数据。

要求

此插件有以下要求

安装数据源

要安装数据源，请参阅安装说明。

在Grafana中配置数据源

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

连接

全局公司ID

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

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

    您当前登录的Analytics公司的全局公司ID为值

身份验证

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

  • 转到Adobe开发者控制台下的“项目”页面
  • 点击您想要使用Adobe Analytics数据源访问的项目
  • 确保选定的项目包含Adobe Analytics API。如果没有，请点击“添加API”并从列表中选择“Adobe Analytics”。
  • 确保选定的项目包含“OAuth服务器到服务器”凭据。如果没有——请添加它。有关凭据的更多信息，请参阅Adobe开发者门户。
  • 进入“OAuth服务器到服务器”凭据设置，从那里复制客户端ID和客户端密钥，并将它们粘贴到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>

查询数据源

插件允许查询报告数据。

还有一个选项可以查询指标列表、维度列表或报告列表，这些查询可能对创建变量然后用于查询报告数据很有用。

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

获取指标摘要数据

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

获取时间序列数据

要获取时间序列指标数据，请选择一个时间序列维度（例如小时、分钟、日等）以及指标。

当提供与日期无关的维度（例如产品）的指标参数时，响应将仅包含表格数据。

使用Limit参数

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

使用Search clause参数

您可以使用Search clause参数进行维度筛选。当您想限制返回的数据，使报告只显示您需要的值时，这很有用。例如，当使用Product维度并添加搜索子句( NOT CONTAINS 'Product-1' )时，将排除所有名称中包含Product-1的产品。
有关使用搜索子句的更多信息，请参阅Adobe API文档。

已知限制

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

模板和变量

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

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

了解更多