限制及考量 - AWS Glue

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

限制及考量

以下是 Google Analytics 4 連接器的限制：

  • 對於核心報告實體，僅允許在請求中傳送 9 個維度欄位和 10 個指標欄位。如果超過允許的欄位數量，則請求將失敗，連接器將擲回錯誤訊息。

  • 對於即時報告實體，僅允許 4 個維度欄位在請求中傳送。如果超過允許的欄位數量，則請求將失敗，連接器將擲回錯誤訊息。

  • Google Analytics 4 是 Beta 版免費工具，因此將定期更新新功能、實體增強、新增新欄位和取代現有欄位。

  • 核心報告欄位會動態填入，因此可以隨時新增、棄用和重新命名欄位，並對欄位實施新的限制。

  • 預設開始日期為 30 天，結束日期為昨天 （目前日期的前一天），如果使用者已設定值，則篩選表達式程式碼中會覆寫這些日期，或者如果流程是增量的，則會覆寫這些日期。

  • 根據文件，如果限制未傳入請求，則即時報告實體會傳回 10，000 個記錄，否則 API 會傳回每個請求最多 250，000 個資料列，無論您請求多少資料列。如需詳細資訊，請參閱 Google Analytics 文件中的 Method： properties.runRealtimeReport。

  • 即時報告實體不支援以記錄為基礎的分割區，因為它不支援分頁。此外，它不支援欄位型分割區，因為所有欄位都不符合定義的條件。

  • 由於可在請求中傳遞的欄位數量限制。我們正在指定限制內設定預設維度和指標欄位。如果選擇「全選」，則只會擷取這些預定欄位中的資料。

    • 核心報告

      • 根據 SAAS 的限制 - 請求最多只能允許 9 個維度和最多 10 個指標 （也就是說，請求最多可包含 19 個欄位 （指標 + 維度）。

      • 根據實作 - 如果使用者使用 SELECT_ALL 或選取的欄位超過 25 個，則預設欄位將傳入請求。

      • 下列欄位被視為 Core Report - "country"、"city"、"eventName"、"cityId"、"browser"、"date"、"currencyCode"、"deviceCategory"、"transactionId"、active1DayUsers"、"active28DayUsers"、"active7DayUsers"、"activeUsers"、"averagePurchaseRevenue"、"averageRevenuePerUser"、"averageSessionDuration"、"engagedSessions"、"eventCount"、"engagementRate" 的預設欄位。

    • 即時報告

      • 根據 SAAS 請求的限制，最多允許 4 個維度。

      • 如果使用者通過 SELECT_ALL 或選取的欄位超過 15 個，則預設欄位將傳入請求。

      • 下列欄位被視為 RealTime 報告的預設欄位 - "country"、"deviceCategory"、"city"、"cityId"、"activeUsers"、"conversions"、"eventCount"、"screenPageViews"。

  • 在核心報告實體中，如果日期欄位上的分割區和 startDate 上的篩選條件同時存在。在這種情況下，dateRange 值會以 startDate 篩選條件值覆寫，但由於分割區必須一律為優先順序，因此如果日期上的分割區欄位已存在，則會捨棄 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 粒度="WEEKLY"

  • 您也可以一次將所有篩選條件一起傳遞，也可以與其他篩選條件一起傳遞。

    • 範例 1 - filterPredicate：startDate 介於 "2023-05-09" 和 "2023-05-10" 之間，且 startOffset=1 AND endOffset=2 AND granularity="WEEKLY"

    • 範例 2 - filterPredicate： city=“xyz” AND startOffset=1 AND endOffset=2 AND granularity="WEEKLY"

  • 在群組請求中：