限制及考量

以下是 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 個，則預設欄位將傳入請求。

    • 下列欄位被視為核心報告的預設欄位：「國家」、「城市」、「eventName」、「cityId」、「瀏覽器」、「日期」、「currencyCode」、「deviceCategory」、「transactionId」、active1DayUsers」、「active28DayUsers」、「active7DayUsers」、「activeUsers」、「averagePurchaseRevenue」、「averageRevenuePerUser」、「averageSessionDuration」、「engagedSessions」、「eventCount」、「engagementRate」。

  • 即時報告

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

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

    • 下列欄位被視為 RealTime 報告的預設欄位 - "國家"、"deviceCategory"、"城市"、"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"

• 在群組請求中：

  • 如果請求中傳遞「cohortNthMonth」，則內部精細度值將設定為「MONTHLY」

  • 同樣地，如果傳遞「cohortNthWeek」，則精細度值將設定為「WEEKLY」

  • 此外，對於「cohortNthDay」的精細度值，將設定為「DAILY」。如需詳細資訊，請參閱：

    • https://developers.google.com/analytics/devguides/reporting/data/v1/advanced

    • https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/CohortSpec

  • 佈建會讓使用者覆寫 dateRange 和精細度預設值。請參閱上述表格。