限制及考量 - 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 個，則預設欄位將傳入請求。

      • 下列欄位被視為核心報告的預設欄位 - "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"。

  • 在核心報告實體中，如果日期欄位的分區和 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 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 請求中：