限制和注意事项 - AWS Glue

限制和注意事项

Google Analytics 4 连接器的限制如下：

  • 对于核心报告实体，只允许在请求中发送 9 个维度字段和 10 个指标字段。如果超出允许的字段数，则请求将会失败，并且连接器将发出一条错误消息。

  • 对于实时报告实体，只允许在请求中发送 4 个维度字段。如果超出允许的字段数，则请求将会失败，并且连接器将发出一条错误消息。

  • Google Analytics 4 是一款测试版的免费工具，因此会定期发布有关新功能、实体增强、增加新字段和弃用现有字段的更新。

  • 核心报告字段是动态填充的，因此可能随时会增加、弃用和重命名字段，以及对字段实施新的限制。

  • 默认开始日期为 30 天，结束日期为昨日（当前日期前一日）。如果用户设置了该值或者流程属于增量，则这些日期将在筛选表达式代码中被覆盖。

  • 根据文档的说明，如果请求中未传递限制值，则实时报告实体将返回 1 万条记录，否则无论请求的行数为多少，API 将最多为每个请求返回 25 万行。有关更多信息，请参阅 Google Analytics 文档中的 Method: properties.runRealtimeReport。

  • 实时报告实体不支持基于记录的分区，因为它不支持分页。此外，这种实体不支持基于字段的分区，因为没有任何字段符合定义的标准。

  • 由于可以在请求中传递的字段数存在限制，我们在指定限制范围内设置默认维度和指标字段。如果选择“全选”，则将仅检索这些预先确定字段中的数据。

    • 核心报告

      • 根据 SAAS 规定的限制，最多允许请求 9 个维度和最多 10 个指标，即一条请求最多可以包含 19 个字段（指标+维度）。

      • 根据具体实现，如果用户使用 SELECT_ALL 或选定的字段数超过 25 个，则系统将在请求中传递默认字段。

      • 以下字段属于核心报告的默认字段：“country”、“city”、“eventName”、“cityId”、“browser”、“date”、“currencyCode”、“deviceCategory”、“transactionId”、“active1DayUsers”、“active28DayUsers”、“active7DayUsers”、“activeUsers”、“averagePurchaseRevenue”、“averageRevenuePerUser”、“averageSessionDuration”、“engagedSessions”、“eventCount”、“engagementRate”。

    • 实时报告

      • 根据 SAAS 规定的限制，最多允许请求 4 个维度。

      • 如果用户使用 SELECT_ALL 或选定的字段数超过 15 个，则系统将在请求中传递默认字段。

      • 以下字段属于实时报告的默认字段：“country”、“deviceCategory”、“city”、“cityId”、“activeUsers”、“conversions”、“eventCount”、“screenPageViews”。

  • 在核心报告实体中，如果同时存在基于 date 字段的分区和基于 StartDate 的筛选条件，则在这种情况下，dateRange 值会被 startDate 筛选条件值覆盖。但是，由于分区必须始终优先，因此，如果已经存在基于 date 字段上的分区，则会丢弃 startDate 筛选条件。

  • 由于现在 cohortSpecs 也是核心报告请求正文的一部分，因此我们对当前核心报告实体进行了增强，增加了对 cohortSpec 属性的支持。在 cohortSpecs 请求正文中，几乎所有字段都要求用户输入。为了解决这一问题，我们为这些属性/字段设置了默认值，并提供了让用户在需要时覆盖这些值的功能。

    FieldName 默认值 传入 filterPredicate 选项以覆盖默认值的示例查询
    startDate 当前日期之前 30 天 “StartDate 介于“2023-05-09”和“2023-05-10”之间
    endDate 当前日期之前 1 天 “StartDate 介于“2023-05-09”和“2023-05-10”之间
    startOffset 0 startOffset=2
    endOffset 1 endoffset=10
    粒度 DAILY granularity="WEEKLY"

  • 您也可以一次性传递所有这些筛选条件，或与其他筛选条件一起传递。

    • 示例 1 – filterPredicate：startDate between "2023-05-09" and "2023-05-10" AND startOffset=1 AND endOffset=2 AND granularity="WEEKLY"

    • 示例 2 – filterPredicate: city=“xyz” AND startOffset=1 AND endOffset=2 AND granularity="WEEKLY"

  • 在 cohort 请求中：