Method: properties.runFunnelReport

string

選用設定。要追蹤事件的 Google Analytics GA4 資源 ID。指定在網址路徑，而不是內文。詳情請參閱「如何查看資源 ID」一文。在批次要求中，這個屬性應未指定或與批次層級屬性一致。

範例：properties/1234

{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}

boolean

在開放式漏斗中，使用者可以在任何步驟進入漏斗，而在封閉式漏斗中，使用者必須在第一個步驟中進入漏斗。選用設定。如果未指定，系統會使用封閉式漏斗。

object (FunnelStep)

這個漏斗的序列步驟。

{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}

string

這個步驟的專屬名稱。如未指定，步驟的名稱會以 1 為準的索引名稱 (例如「0.", "1.」等)。這個名稱定義了 funnelStepName 維度傳回的字串值。舉例來說，在要求的第三個漏斗步驟中指定 name = Purchase，即可在漏斗報表回應中產生 3. Purchase。

boolean

如果是 true，這個步驟必須直接接續上一個步驟。如果是 false，上一個步驟和這個步驟之間可能會出現事件。如未指定，isDirectlyFollowedBy 會視為 false。

object (FunnelFilterExpression)

使用者必須符合的條件，才會納入漏斗流程的步驟。

string (Duration format)

如有指定，此步驟必須在前步驟完成的時限內完成。withinDurationFromPriorStep 包含端點 (以微秒為單位)。舉例來說，時間長度為 5 秒的廣告可在 4.9 或 5.0 秒時完成，但不得為 5 秒和 1 微秒完成。

withinDurationFromPriorStep 是選用項目，如果沒有指定，步驟可以根據任何時間長度分隔。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」。範例："3.5s"。

{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}

object (FunnelFilterExpressionList)

andGroup 中的 FunnelFilterExpression 具有 AND 關係。

object (FunnelFilterExpressionList)

orGroup 中的 FunnelFilterExpression 具有 OR 關係。

object (FunnelFilterExpression)

FunnelFilterExpression 不是 notExpression。

object (FunnelFieldFilter)

維度或指標的漏斗篩選器。

object (FunnelEventFilter)

建立比對單一事件名稱事件的篩選器。如果指定參數篩選器運算式，則只有同時符合單一事件名稱和參數篩選器運算式的事件子集，就符合這個事件篩選器。

{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}

object (FunnelFilterExpression)

漏斗篩選器運算式清單。

{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}

string

維度名稱或指標名稱。

object (StringFilter)

字串相關篩選器。

object (InListFilter)

清單值中的篩選器。

object (NumericFilter)

數字或日期值的篩選器。

object (BetweenFilter)

用於兩個值的篩選器。

{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}

string

這個篩選器會比對這個單一事件名稱的事件。必須提供事件名稱。

object (FunnelParameterFilterExpression)

如有指定，此篩選器會比對同時符合單一事件名稱和參數篩選運算式的事件。

在參數篩選運算式中，只能使用參數篩選器。

{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}

object (FunnelParameterFilterExpressionList)

andGroup 中的 FunnelParameterFilterExpression 具有 AND 關係。

object (FunnelParameterFilterExpressionList)

orGroup 中的 FunnelParameterFilterExpression 具有 OR 關係。

object (FunnelParameterFilterExpression)

FunnelParameterFilterExpression 不是 notExpression。

object (FunnelParameterFilter)

原始漏斗參數篩選器。

{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}

object (FunnelParameterFilterExpression)

漏斗參數篩選運算式清單。

{

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}

string

這個篩選器會根據指定的事件參數進行評估。事件參數會記錄為事件參數。事件參數包含「firebase_screen」等欄位和「currency」。

事件參數只能用於區隔和程序，且只能用於 EventFilter 中的子系篩選器。在 EventFilter 的子系篩選器中，應使用事件或項目參數。

string

這個篩選器會根據指定的項目參數評估。項目參數會在項目陣列中記錄為參數。項目參數包含「item_name」等欄位和「item_category」。

項目參數只能用於區隔和程序，且只能用於 EventFilter 中的子系篩選器。在 EventFilter 的子系篩選器中，應使用事件或項目參數。

項目參數僅適用於電子商務事件。如要進一步瞭解電子商務事件，請參閱「評估電子商務」指南。

object (StringFilter)

字串相關篩選器。

object (InListFilter)

清單值中的篩選器。

object (NumericFilter)

數字或日期值的篩選器。

object (BetweenFilter)

用於兩個值的篩選器。

{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}

object (Dimension)

漏斗表格子報表回應中加入的維度欄。細分維度可細分每個漏斗步驟。指定 funnelBreakdown 時，必須提供有效的 breakdownDimension。

string (int64 format)

回應中要傳回的細分維度不重複值數量上限。如未指定限制，則會使用 5 的 limit。上限必須大於 0 且不得超過 15。

{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}

object (Dimension)

維度欄已新增至漏斗視覺呈現子報表回應。使用者完成第 i 個漏斗步驟後，下一個動作維度會傳回這個維度的下一個維度值。

nextActionDimension 目前只支援 eventName 和大多數的網頁 / 畫面維度，例如 pageTitle 和 pagePath。nextActionDimension 不能為維度運算式。

string (int64 format)

回應中要傳回的細分維度不重複值數量上限。如未指定限制，則會使用 5 的 limit。上限必須大於 0 且不得超過 5。

{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}

string

這個區隔的名稱。如果未指定，區隔將命名為「區隔」。這個名稱定義了 segment 維度傳回的字串值。segment 維度會在要求中以 1 為基礎的區隔索引號碼開頭 (例如「1.Segment", "2.區隔」等)。

object (UserSegment)

使用者區隔是指與您網站或應用程式互動的使用者子集。

object (SessionSegment)

工作階段區隔是指在您網站或應用程式上發生的工作階段。

object (EventSegment)

「事件區隔」是使用者在網站或應用程式中觸發的一大部分事件。

{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}

object (UserSegmentCriteria)

定義這個區隔包含的使用者。選填。

object (UserSegmentExclusion)

定義要在這個區隔中排除的使用者。選填。

{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}

object (UserSegmentConditionGroup)

如果使用者符合這些 andConditionGroups 和每個 andSequenceGroups，就符合這項條件。如果指定 andSequenceGroups，andConditionGroups 可以空白。

object (UserSegmentSequenceGroup)

如果使用者符合這些 andSequenceGroups 和每個 andConditionGroups，就符合這項條件。如果指定 andConditionGroups，andSequenceGroups 可以空白。

{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

enum (UserCriteriaScoping)

系統會根據是否符合條件群組的資料在區隔中納入或排除資料。此範圍定義在判定條件群組相符或不符之前，要評估 segmentFilterExpression 的事件數量。舉例來說，如果運算式為 conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION，系統會針對工作階段中的所有事件評估運算式，然後判斷該條件群組是否與這位使用者相符。舉例來說，如果是 conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT，運算式會先針對單一事件進行評估，然後判斷該條件群組是否與這位使用者相符。

選用設定。如未指定，系統會使用 conditionScoping = ACROSS_ALL_SESSIONS。

object (SegmentFilterExpression)

系統會根據是否符合這個運算式的資料，在區隔中納入或排除資料。用來表示維度、指標和/或參數的運算式；

{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}

object (SegmentFilterExpressionList)

「andGroup」中的 SegmentFilterExpression 具有 AND 關係。

object (SegmentFilterExpressionList)

「orGroup」中的 SegmentFilterExpression 具有 OR 關係。

object (SegmentFilterExpression)

SegmentFilterExpression 不是 notExpression。

object (SegmentFilter)

原始片段篩選器。

object (SegmentEventFilter)

建立比對單一事件名稱事件的篩選器。如果指定參數篩選器運算式，則只有同時符合單一事件名稱和參數篩選器運算式的事件子集，就符合這個事件篩選器。

{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}

object (SegmentFilterExpression)

區隔篩選運算式清單

{
  "fieldName": string,
  "filterScoping": {
    object (SegmentFilterScoping)
  },

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}

string

維度名稱或指標名稱。

object (SegmentFilterScoping)

指定篩選器的範圍。

object (StringFilter)

字串相關篩選器。

object (InListFilter)

清單值中的篩選器。

object (NumericFilter)

數字或日期值的篩選器。

object (BetweenFilter)

用於兩個值的篩選器。

{
  "atAnyPointInTime": boolean
}

boolean

如果 atAnyPointInTime 為 true，這個篩選器在要求日期範圍內的任何事件評估為 true 時，就會評估所有事件為 true。

這個 atAnyPointInTime 參數不會延長報表中事件的日期範圍。如果 atAnyPointInTime 為 true，則在評估這個篩選器時，只會納入報表日期範圍內的事件。

只有在條件範圍設為 ACROSS_ALL_SESSIONS 且無法依序指定時，才能指定這個 atAnyPointInTime。

如果條件範圍設為 ACROSS_ALL_SESSIONS，如未指定，系統會使用 atAnyPointInTime = false。

{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}

string

這個篩選器會比對這個單一事件名稱的事件。必須提供事件名稱。

object (SegmentParameterFilterExpression)

如有指定，此篩選器會比對同時符合單一事件名稱和參數篩選運算式的事件。

在參數篩選運算式中，只能使用參數篩選器。

{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}

object (SegmentParameterFilterExpressionList)

andGroup 中的 SegmentParameterFilterExpression 具有 AND 關係。

object (SegmentParameterFilterExpressionList)

orGroup 中的 SegmentParameterFilterExpression 具有 OR 關係。

object (SegmentParameterFilterExpression)

SegmentParameterFilterExpression 不是 notExpression。

object (SegmentParameterFilter)

原始區隔參數篩選器。

{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}

object (SegmentParameterFilterExpression)

區隔參數篩選運算式清單。

{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}

object (SegmentParameterFilterScoping)

指定篩選器的範圍。

string

這個篩選器會根據指定的事件參數進行評估。事件參數會記錄為事件參數。事件參數包含「firebase_screen」等欄位和「currency」。

事件參數只能用於區隔和程序，且只能用於 EventFilter 中的子系篩選器。在 EventFilter 的子系篩選器中，應使用事件或項目參數。

string

這個篩選器會根據指定的項目參數評估。項目參數會在項目陣列中記錄為參數。項目參數包含「item_name」等欄位和「item_category」。

項目參數只能用於區隔和程序，且只能用於 EventFilter 中的子系篩選器。在 EventFilter 的子系篩選器中，應使用事件或項目參數。

項目參數僅適用於電子商務事件。如要進一步瞭解電子商務事件，請參閱「評估電子商務」指南。

object (StringFilter)

字串相關篩選器。

object (InListFilter)

清單值中的篩選器。

object (NumericFilter)

數字或日期值的篩選器。

object (BetweenFilter)

用於兩個值的篩選器。

{
  "inAnyNDayPeriod": string
}

string (int64 format)

請先在指定天數內完成參數，再套用篩選器。只有在條件範圍限定為 ACROSS_ALL_SESSIONS 或 WITHIN_SAME_SESSION 時，系統才支援這個屬性。只有在參數是 event_count 時才會支援。

舉例來說，如果 inAnyNDayPeriod 為 3，eventName 為「purchase」，事件參數是「event_count」，而篩選條件的條件大於 5，則此篩選器會在報表日期範圍內，連續 3 天累積的購買事件數量；使用者連續 3 天的購買事件計數超過 5 時，就會通過此篩選器的條件，必須列入這個區隔。例如 2021-11-01 至 2021-11-03、2021-11-02 至 2021-11-04、2021-11-03 至 2021-11-05 等。

若要讓日期範圍開始接近完整 N 天，請不要延長日期範圍。舉例來說，如果報表是介於 2021-11-01 至 2021-11-10 之間，inAnyNDayPeriod = 3，則前 2 天的期間會縮短，因為系統不會讀取報表日期範圍以外的事件資料。例如，前四個期間實際上為：2021-11-01 至 2021-11-01、2021-11-01 至 2021-11-02、2021-11-01 至 2021-11-03 以及 2021-11-4021

inAnyNDayPeriod 為選用項目，如未指定，segmentParameterFilter 會個別套用至每個事件。

{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}

enum (UserCriteriaScoping)

指定範圍必須滿足所有序列步驟，使用者才能符合序列。例如，如果設為 sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION，則所有序列步驟都必須在一個工作階段中完成，使用者才能符合序列。我們不支援 sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT。

選用設定。如未指定，系統會使用 conditionScoping = ACROSS_ALL_SESSIONS。

string (Duration format)

定義必須發生整個序列的時間範圍；例如 30 分鐘sequenceMaximumDuration 包含端點 (以微秒為單位)。舉例來說，如果序列長度上限為 5 秒，則可在 4.9 或 5.0 秒時完成，但不得為 5 秒和 1 微秒完成。

sequenceMaximumDuration 是選用項目，如果未指定，序列可以在任何時間完成。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」。範例："3.5s"。

object (UserSequenceStep)

一組已排序的條件步驟。使用者的事件必須完成每個步驟，使用者才會與 UserSegmentSequenceGroup 相符。

{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

boolean

如果為 true，則滿足此步驟的事件必須是在像徵最後一個步驟的事件之後的下一個事件。如果為 false，則此步驟會間接遵循前一個步驟；例如先前步驟和這個步驟之間的事件。在第一個步驟中，isDirectlyFollowedBy 必須設為 false。

enum (UserCriteriaScoping)

指定範圍時必須滿足這個序列步驟，使用者才能符合序列。以 sequenceScoping = WITHIN_SAME_SESSION 為例，序列步驟必須在一個工作階段中完成，使用者才能比對順序。只有在 sequenceScoping = ACROSS_ALL_SESSIONS 情況下才能使用 stepScoping = ACROSS_ALL_SESSIONS。

選用設定。如果未指定，stepScoping 會使用與 sequenceScoping 相同的 UserCriteriaScoping。

object (SegmentFilterExpression)

如果使用者的事件符合這個運算式，就符合這個序列步驟。用來表示維度、指標和/或參數的運算式；

{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}

enum (UserExclusionDuration)

指定使用者符合 userExclusionCriteria 時，排除條件的持續時間。

選用設定。如未指定，系統會使用 USER_EXCLUSION_TEMPORARY 的 userExclusionDuration。

object (UserSegmentCriteria)

如果使用者符合這項條件，系統就會從「userExclusionDuration」的區隔成員資格中排除使用者。

{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}

object (SessionSegmentCriteria)

定義這個區隔包含的工作階段。選填。

object (SessionSegmentExclusion)

定義要在這個區隔中排除的工作階段。選填。

{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}

object (SessionSegmentConditionGroup)

如果工作階段符合這些andConditionGroups的各項條件，就會符合這項條件。

{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

enum (SessionCriteriaScoping)

系統會根據是否符合條件群組的資料在區隔中納入或排除資料。此範圍定義在判定條件群組相符或不符之前，要評估 segmentFilterExpression 的事件數量。舉例來說，如果運算式為 conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION，系統會針對工作階段中的所有事件評估運算式，然後判定該條件群組是否與這個工作階段相符。例如 conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT，運算式會先評估單一事件，然後判斷該條件群組是否與這個工作階段相符。

選用設定。如果未指定，系統會使用 WITHIN_SAME_SESSION 的 conditionScoping。

object (SegmentFilterExpression)

系統會根據是否符合這個運算式的資料，在區隔中納入或排除資料。用來表示維度、指標和/或參數的運算式；

{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}

enum (SessionExclusionDuration)

指定在工作階段與 sessionExclusionCriteria 相符的情況下，排除條件的持續時間。

選用設定。如果未指定，系統會使用 SESSION_EXCLUSION_TEMPORARY 的 sessionExclusionDuration。

object (SessionSegmentCriteria)

如果工作階段符合這項條件，系統就會從「sessionExclusionDuration」區隔的成員資格中排除該工作階段。

{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}

object (EventSegmentCriteria)

定義這個區隔中包含哪些事件。選填。

object (EventSegmentExclusion)

定義要在這個區隔中排除的事件。選填。

{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}

object (EventSegmentConditionGroup)

如果事件符合這些andConditionGroups的所有條件，就會符合這項條件。

{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}

enum (EventCriteriaScoping)

conditionScoping 應一律為 EVENT_CRITERIA_WITHIN_SAME_EVENT。

選用設定。如果未指定，系統會使用 EVENT_CRITERIA_WITHIN_SAME_EVENT 的 conditionScoping。

object (SegmentFilterExpression)

系統會根據是否符合這個運算式的資料，在區隔中納入或排除資料。用來表示維度、指標和/或參數的運算式；

{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}

enum (EventExclusionDuration)

eventExclusionDuration 應一律為 PERMANENTLY_EXCLUDE。

選用設定。如未指定，系統會使用 EVENT_EXCLUSION_PERMANENT 的 eventExclusionDuration。

object (EventSegmentCriteria)

如果事件符合這項條件，系統就會在「eventExclusionDuration」區隔的成員資格中排除該事件。

{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}

object (DimensionHeader)

說明維度欄。漏斗報表一律會在子報表回應中納入漏斗步驟維度。視需要在回應中加入其他維度，例如細目、日期和後續動作。

object (MetricHeader)

說明指標欄。程序報表一律會將活躍使用者納入子報表回應。漏斗表格包含其他指標，例如完成率、放棄率和放棄率。

object (Row)

報表中的維度值組合和指標值。

object (FunnelResponseMetadata)

漏斗報表的中繼資料。

{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}

object (SamplingMetadata)

如果漏斗報表結果是經過取樣，則是指漏斗報表中使用的事件百分比。每個日期範圍都會填入一個 samplingMetadatas。每個 samplingMetadatas 都會按照要求中所指定日期範圍的順序對應到日期範圍。

不過，如果結果並未經過取樣，就不會定義這個欄位。

{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}

string (int64 format)

這份取樣報表在特定日期範圍內讀取的事件總數。這是指在漏斗報表中分析的這項資源子集資料。

string (int64 format)

在這份漏斗報表中，可供在這份漏斗報表中分析的事件總數。取樣能夠揭露較大的資料集相關實用資訊，這也是大型資料集的大小。

如要計算這份報表中使用的可用資料百分比，請計算 samplesReadCount/samplingSpaceSize。

{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}

object (QuotaStatus)

標準 Analytics 資源每天最多可使用 200,000 個符記；Analytics 360 資源每天可使用 2,000,000 個符記。大多數要求使用的符記數量不到 10 個。

object (QuotaStatus)

標準 Analytics 資源每小時最多可使用 40,000 個符記；Analytics 360 資源每小時可使用 400,000 個符記。API 要求會耗用單一數量的權杖，這個數量會從所有每小時、每日和每項專案的每小時配額中扣除。

object (QuotaStatus)

標準 Analytics 資源最多可同時傳送 10 個要求；Analytics 360 資源最多可使用 50 個並行要求。

object (QuotaStatus)

標準 Analytics 資源和雲端專案組合每小時最多可能 10 個伺服器錯誤；Analytics 360 資源和雲端專案組合每小時最多可有 50 個伺服器錯誤。

object (QuotaStatus)

Analytics 資源每小時最多可傳送 120 個要求，且維度可能有閾值。在批次要求中，如果要求包含可能設有閾值的維度，則每項報表要求都會分別計入這個配額。

object (QuotaStatus)

Analytics 資源每小時最多可以使用每項專案 35% 的權杖。如果是標準 Analytics 資源，每項專案每小時最多可使用 14,000 個權杖，而 Analytics 360 資源每小時則可使用每項專案 140,000 個權杖。API 要求會耗用單一數量的權杖，這個數量會從所有每小時、每日和每項專案的每小時配額中扣除。

{
  "consumed": integer,
  "remaining": integer
}

integer

此要求耗用的配額。

integer

此要求後剩餘的配額。