Method: properties.runFunnelReport

Trả về báo cáo phễu tuỳ chỉnh của dữ liệu sự kiện Google Analytics. Dữ liệu mà API trả về sẽ ở dạng bảng với các cột cho những phương diện và chỉ số được yêu cầu.

Kỹ thuật khám phá phễu cho phép bạn thể hiện các bước mà người dùng cần thực hiện để hoàn tất một hành động bằng hình ảnh, và xem nhanh mức độ mà họ hoàn tất hoặc không hoàn tất ở mỗi bước. Ví dụ: hành trình mà khách hàng tiềm năng trở thành người mua sắm và sau đó trở thành khách hàng diễn ra như thế nào? Hành trình mà khách hàng mua một lần trở thành khách hàng mua thường xuyên diễn ra như thế nào? Với thông tin này, bạn có thể cải thiện những hành trình không hiệu quả hoặc bị bỏ qua của khách hàng. Để tìm hiểu thêm, hãy xem bài viết Khám phá phễu GA4.

Phương thức này được ra mắt với độ ổn định alpha, nhằm mục đích thu thập thông tin phản hồi về cú pháp và chức năng trước khi chuyển sang giai đoạn thử nghiệm beta. Để cung cấp ý kiến phản hồi về API này, hãy hoàn tất Ý kiến phản hồi về Báo cáo phễu Google Analytics Data API.

Yêu cầu HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
property

string

Không bắt buộc. Giá trị nhận dạng tài sản GA4 của Google Analytics có các sự kiện được theo dõi. Được chỉ định trong đường dẫn URL chứ không phải trong nội dung. Để tìm hiểu thêm, hãy xem cách tìm mã tài sản của bạn. Trong một yêu cầu theo lô, tài sản này cần phải được chỉ định hoặc nhất quán với tài sản cấp lô.

Ví dụ: thuộc tính/1234

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
Trường
dateRanges[]

object (DateRange)

Không bắt buộc. Phạm vi ngày của dữ liệu cần đọc. Nếu bạn yêu cầu nhiều phạm vi ngày, thì mỗi hàng phản hồi sẽ chứa một chỉ mục phạm vi ngày dựa trên 0. Nếu hai phạm vi ngày trùng lặp, thì dữ liệu sự kiện của những ngày bị trùng lặp sẽ được đưa vào các hàng phản hồi cho cả hai phạm vi ngày.
funnel

object (Funnel)

Không bắt buộc. Cấu hình phễu của yêu cầu này. Cấu hình phễu này là bắt buộc.
funnelBreakdown

object (FunnelBreakdown)

Không bắt buộc. Nếu được chỉ định, bảng chi tiết này sẽ thêm một phương diện vào phản hồi trong báo cáo phụ bảng phễu. Phương diện phân tích này mở rộng từng bước phễu thành các giá trị riêng biệt của phương diện phân tích đó. Ví dụ: bảng chi tiết theo phương diện deviceCategory sẽ tạo ra các hàng cho mobile, tablet, desktop và tổng số.
funnelNextAction

object (FunnelNextAction)

Không bắt buộc. Nếu được chỉ định, hành động tiếp theo sẽ thêm một phương diện vào phản hồi báo cáo phụ của hình ảnh phễu. Phương diện hành động tiếp theo này mở rộng từng bước trong phễu thành các giá trị riêng biệt của hành động tiếp theo. Ví dụ: một hành động tiếp theo của phương diện eventName sẽ tạo hàng cho một số sự kiện (ví dụ: session_start và click) và tổng số sự kiện.

Hành động tiếp theo chỉ hỗ trợ eventName và hầu hết các kích thước Trang / Màn hình như pageTitle và pagePath.
funnelVisualizationType

enum (FunnelVisualizationType)

Không bắt buộc. Loại hình ảnh phễu kiểm soát các phương diện có trong mục phản hồi báo cáo phụ về hình ảnh phễu. Nếu không chỉ định, STANDARD_FUNNEL sẽ được sử dụng.
segments[]

object (Segment)

Không bắt buộc. Cấu hình của phân đoạn. Phân đoạn là các nhóm nhỏ dữ liệu của một tài sản. Trong báo cáo phễu có phân đoạn, phễu sẽ được đánh giá trong từng phân đoạn.

Mỗi phân khúc được chỉ định trong yêu cầu này tạo ra một hàng riêng biệt trong phản hồi. Trong phản hồi, mỗi phân khúc được xác định theo tên của phân khúc đó.

Thông số phân đoạn là không bắt buộc. Yêu cầu chỉ được có tối đa 4 phân đoạn.
limit

string (int64 format)

Không bắt buộc. Số hàng cần trả về. Nếu không chỉ định, hàm sẽ trả về 10.000 hàng. API trả về tối đa 250.000 hàng cho mỗi yêu cầu, bất kể bạn yêu cầu bao nhiêu hàng. limit phải là số dương.

API cũng có thể trả về ít hàng hơn limit được yêu cầu nếu không có nhiều giá trị phương diện như limit.
dimensionFilter

object (FilterExpression)

Không bắt buộc. Bộ lọc phương diện chỉ cho phép bạn yêu cầu một số giá trị phương diện cụ thể trong báo cáo. Để tìm hiểu thêm, hãy xem bài viết Tạo báo cáo: Bộ lọc phương diện để xem ví dụ. Không thể sử dụng chỉ số trong bộ lọc này.
returnPropertyQuota

boolean

Không bắt buộc. Bật/tắt tính năng trả về trạng thái hiện tại của hạn mức của Tài sản Analytics này. Hạn mức được trả về trong PropertyQuota.

Nội dung phản hồi

Nội dung phản hồi trong báo cáo phễu chứa 2 báo cáo phụ. Hai báo cáo phụ này là sự kết hợp khác nhau giữa phương diện và chỉ số.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "funnelTable": {
    object (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
Trường
funnelTable

object (FunnelSubReport)

Bảng phễu là một báo cáo có bước phễu, phân đoạn, phương diện phân tích, người dùng đang hoạt động, tỷ lệ hoàn thành, số lượt bỏ ngang và tỷ lệ bỏ ngang.

Thứ nguyên phân đoạn chỉ xuất hiện trong phản hồi này nếu phân đoạn được yêu cầu. Phương diện phân tích chỉ xuất hiện trong phản hồi này nếu được yêu cầu.
funnelVisualization

object (FunnelSubReport)

Hình ảnh phễu là một báo cáo có bước phễu, phân đoạn, ngày, phương diện hành động tiếp theo và người dùng đang hoạt động.

Thứ nguyên phân đoạn chỉ xuất hiện trong phản hồi này nếu phân đoạn được yêu cầu. Phương diện ngày chỉ xuất hiện trong phản hồi này nếu được yêu cầu thông qua loại phễu TRENDED_FUNNEL. Phương diện hành động tiếp theo chỉ xuất hiện trong phản hồi khi được yêu cầu.
propertyQuota

object (PropertyQuota)

Trạng thái hạn mức của Tài sản Analytics này bao gồm cả yêu cầu này.
kind

string

Xác định loại tài nguyên này của thông báo. kind này luôn là chuỗi cố định "analyticsData#runFunnelReport". Hữu ích để phân biệt các loại phản hồi trong JSON.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau đây:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

DateRange

Một nhóm ngày liền nhau: startDate, startDate + 1, ..., endDate. Hệ thống cho phép yêu cầu có tối đa 4 phạm vi ngày.

Biểu diễn dưới dạng JSON 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Trường
startDate

string

Ngày bắt đầu bao gồm cho truy vấn ở định dạng YYYY-MM-DD. Không được sau endDate. Định dạng NdaysAgo, yesterday hoặc today cũng được chấp nhận và trong trường hợp đó, ngày sẽ được suy ra dựa trên múi giờ báo cáo của tài sản.
endDate

string

Ngày kết thúc bao gồm cho truy vấn ở định dạng YYYY-MM-DD. Không được trước startDate. Định dạng NdaysAgo, yesterday hoặc today cũng được chấp nhận và trong trường hợp đó, ngày sẽ được suy ra dựa trên múi giờ báo cáo của tài sản.
name

string

Gán tên cho phạm vi ngày này. Phương diện dateRange được đánh giá bằng tên này trong phản hồi báo cáo. Nếu được đặt thì không được bắt đầu bằng date_range_ hoặc RESERVED_. Nếu không được đặt, phạm vi ngày sẽ được đặt tên theo chỉ mục dựa trên 0 trong yêu cầu: date_range_0, date_range_1, v.v.

Phễu

Thiết lập phễu trong yêu cầu báo cáo phễu. Phễu báo cáo về người dùng khi họ thực hiện một trình tự các bước.

Kỹ thuật khám phá phễu cho phép bạn thể hiện các bước mà người dùng cần thực hiện để hoàn tất một hành động bằng hình ảnh, và xem nhanh mức độ mà họ hoàn tất hoặc không hoàn tất ở mỗi bước. Ví dụ: hành trình mà khách hàng tiềm năng trở thành người mua sắm và sau đó trở thành khách hàng diễn ra như thế nào? Hành trình mà khách hàng mua một lần trở thành khách hàng mua thường xuyên diễn ra như thế nào? Với thông tin này, bạn có thể cải thiện những hành trình không hiệu quả hoặc bị bỏ qua của khách hàng.

Biểu diễn dưới dạng JSON 
{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}
Trường
isOpenFunnel

boolean

Trong một phễu mở, người dùng có thể tham gia vào phễu ở bất kỳ bước nào và trong một phễu đóng, người dùng phải tham gia vào phễu ở bước đầu tiên. Không bắt buộc. Nếu không chỉ định, thì phễu kín sẽ được sử dụng.
steps[]

object (FunnelStep)

Các bước tuần tự của phễu này.

FunnelStep

Các bước xác định hành trình của người dùng mà bạn muốn đo lường. Các bước chứa một hoặc nhiều điều kiện mà người dùng phải đáp ứng để được đưa vào bước đó trong hành trình phễu.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
Trường
name

string

Tên riêng biệt cho bước này. Nếu không chỉ định, các bước sẽ được đặt tên theo 1 tên được lập chỉ mục dựa trên (ví dụ: "0. ", "1. ", v.v.). Tên này xác định giá trị chuỗi do phương diện funnelStepName trả về. Ví dụ: việc chỉ định name = Purchase trong bước phễu thứ ba của yêu cầu sẽ tạo ra 3. Purchase trong phản hồi báo cáo phễu.
isDirectlyFollowedBy

boolean

Nếu đúng, bước này phải ngay sau bước trước đó. Nếu giá trị sai, có thể có các sự kiện giữa bước trước đó và bước này. Nếu không chỉ định thì isDirectlyFollowedBy sẽ được coi là sai.
filterExpression

object (FunnelFilterExpression)

Điều kiện mà người dùng phải đáp ứng để được đưa vào bước này trong hành trình phễu.
withinDurationFromPriorStep

string (Duration format)

Nếu được chỉ định, bước này phải hoàn tất trong khoảng thời gian này khi hoàn tất bước trước đó. withinDurationFromPriorStep bao gồm điểm cuối ở độ chi tiết một phần triệu giây. Ví dụ: thời lượng 5 giây có thể được hoàn thành ở 4,9 hoặc 5,0 giây, chứ không phải 5 giây và 1 micrô giây.

withinDurationFromPriorStep là không bắt buộc và nếu chưa chỉ định, các bước có thể được phân tách theo bất kỳ khoảng thời gian nào.

Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

FunnelFilterExpression

Thể hiện các kiểu kết hợp bộ lọc phễu.

Biểu diễn dưới dạng JSON 
{

  // 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.
}
Trường
Trường hợp expr. Chỉ định một loại bộ lọc cho FunnelFilterExpression. expr chỉ có thể là một trong những trạng thái sau:
andGroup

object (FunnelFilterExpressionList)

KênhFilterExpression trong andGroup có mối quan hệ AND.
orGroup

object (FunnelFilterExpressionList)

phễuFilterExpression trong orGroup có mối quan hệ OR.
notExpression

object (FunnelFilterExpression)

phễuFilterExpression KHÔNG thuộc notExpression.
funnelFieldFilter

object (FunnelFieldFilter)

Bộ lọc phễu cho một phương diện hoặc chỉ số.
funnelEventFilter

object (FunnelEventFilter)

Tạo bộ lọc so khớp với các sự kiện của một tên sự kiện. Nếu bạn chỉ định một biểu thức lọc thông số, thì chỉ một nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức lọc thông số mới khớp với bộ lọc sự kiện này.

FunnelFilterExpressionList

Danh sách các biểu thức lọc phễu.

Biểu diễn dưới dạng JSON 
{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}
Trường
expressions[]

object (FunnelFilterExpression)

Danh sách các biểu thức lọc phễu.

FunnelFieldFilter

Biểu thức để lọc các giá trị thứ nguyên hoặc chỉ số.

Biểu diễn dưới dạng JSON 
{
  "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.
}
Trường
fieldName

string

Tên phương diện hoặc tên chỉ số.
Trường hợp one_filter. Chỉ định một loại bộ lọc. one_filter chỉ có thể là một trong những trạng thái sau:
stringFilter

object (StringFilter)

Bộ lọc liên quan đến chuỗi.
inListFilter

object (InListFilter)

Bộ lọc cho các giá trị trong danh sách.
numericFilter

object (NumericFilter)

Bộ lọc cho các giá trị số hoặc ngày.
betweenFilter

object (BetweenFilter)

Bộ lọc giữa hai giá trị.

StringFilter

Bộ lọc cho chuỗi

Biểu diễn dưới dạng JSON 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Trường
matchType

enum (MatchType)

Kiểu khớp cho bộ lọc này.
value

string

Giá trị chuỗi được dùng để so khớp.
caseSensitive

boolean

Nếu đúng, giá trị chuỗi có phân biệt chữ hoa chữ thường.

MatchType

Kiểu khớp của bộ lọc chuỗi

Enum
MATCH_TYPE_UNSPECIFIED Không xác định
EXACT Khớp chính xác giá trị chuỗi.
BEGINS_WITH Bắt đầu bằng giá trị chuỗi.
ENDS_WITH Kết thúc bằng giá trị chuỗi.
CONTAINS Chứa giá trị chuỗi.
FULL_REGEXP Kết quả khớp đầy đủ cho biểu thức chính quy có giá trị chuỗi.
PARTIAL_REGEXP Khớp một phần cho biểu thức chính quy với giá trị chuỗi.

InListFilter

Kết quả phải nằm trong danh sách giá trị chuỗi.

Biểu diễn dưới dạng JSON 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
Trường
values[]

string

Danh sách các giá trị chuỗi. Không được để trống.
caseSensitive

boolean

Nếu đúng, giá trị chuỗi có phân biệt chữ hoa chữ thường.

NumericFilter

Bộ lọc cho các giá trị số hoặc ngày.

Biểu diễn dưới dạng JSON 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
Trường
operation

enum (Operation)

Loại toán tử cho bộ lọc này.
value

object (NumericValue)

Giá trị số hoặc giá trị ngày.

Hoạt động

Thao tác được áp dụng cho bộ lọc số

Enum
OPERATION_UNSPECIFIED Không xác định.
EQUAL Bằng
LESS_THAN Nhỏ hơn
LESS_THAN_OR_EQUAL Nhỏ hơn hoặc bằng
GREATER_THAN Lớn hơn
GREATER_THAN_OR_EQUAL Lớn hơn hoặc bằng

NumericValue

Để biểu diễn một số.

Biểu diễn dưới dạng JSON 
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
Trường
Trường hợp one_value. Một trong các giá trị số one_value chỉ được là một trong các giá trị sau:
int64Value

string (int64 format)

Giá trị số nguyên
doubleValue

number

Gấp đôi giá trị

BetweenFilter

Để thể hiện rằng kết quả phải nằm giữa hai số (bao gồm).

Biểu diễn dưới dạng JSON 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Trường
fromValue

object (NumericValue)

Bắt đầu bằng số này.
toValue

object (NumericValue)

Kết thúc bằng số này.

FunnelEventFilter

Tạo bộ lọc so khớp với các sự kiện của một tên sự kiện. Nếu bạn chỉ định một biểu thức lọc thông số, thì chỉ một nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức lọc thông số mới khớp với bộ lọc sự kiện này.

Biểu diễn dưới dạng JSON 
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
Trường
eventName

string

Bộ lọc này khớp với các sự kiện của tên sự kiện duy nhất này. Bạn phải nhập tên sự kiện.
funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

Nếu được chỉ định, bộ lọc này sẽ so khớp những sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức lọc thông số.

Bên trong biểu thức lọc thông số, chỉ có bộ lọc tham số.

FunnelParameterFilterExpression

Thể hiện các tổ hợp bộ lọc phễu trên thông số.

Biểu diễn dưới dạng JSON 
{

  // 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.
}
Trường
Trường hợp expr. Chỉ định một loại bộ lọc cho FunnelParameterFilterExpression. expr chỉ có thể là một trong những trạng thái sau:
andGroup

object (FunnelParameterFilterExpressionList)

KênhParameterFilterExpression trong andGroup có mối quan hệ AND.
orGroup

object (FunnelParameterFilterExpressionList)

KênhParameterFilterExpression trong orGroup có mối quan hệ OR.
notExpression

object (FunnelParameterFilterExpression)

KênhParameterFilterExpression KHÔNG phải là notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

Bộ lọc tham số phễu chính.

FunnelParameterFilterExpressionList

Danh sách các biểu thức lọc thông số phễu.

Biểu diễn dưới dạng JSON 
{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}
Trường
expressions[]

object (FunnelParameterFilterExpression)

Danh sách các biểu thức lọc thông số phễu.

FunnelParameterFilter

Biểu thức để lọc các giá trị thông số trong phễu.

Biểu diễn dưới dạng JSON 
{

  // 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.
}
Trường
Trường hợp one_parameter. Trường đang được lọc. one_parameter chỉ có thể là một trong những trạng thái sau:
eventParameterName

string

Bộ lọc này sẽ được đánh giá dựa trên thông số sự kiện được chỉ định. Thông số sự kiện được ghi lại dưới dạng thông số của sự kiện. Thông số sự kiện bao gồm các trường như "firebase_screen" và "currency".

Bạn chỉ có thể dùng thông số sự kiện trong các phân đoạn và phễu, đồng thời chỉ có thể dùng trong một bộ lọc cấp dưới từ một Bộ lọc sự kiện. Trong bộ lọc con từ EventFilter, bạn nên sử dụng thông số sự kiện hoặc mục.
itemParameterName

string

Bộ lọc này sẽ được đánh giá dựa trên thông số mục được chỉ định. Thông số mặt hàng được ghi lại dưới dạng thông số trong mảng mặt hàng. Thông số mặt hàng bao gồm các trường như "item_name" và "item_category".

Bạn chỉ có thể dùng thông số mục trong các phân đoạn và phễu, đồng thời chỉ có thể dùng trong một bộ lọc cấp dưới từ một EventFilter. Trong bộ lọc con từ EventFilter, bạn nên sử dụng thông số sự kiện hoặc mục.

Thông số mặt hàng chỉ có trong sự kiện thương mại điện tử. Để tìm hiểu thêm về các sự kiện thương mại điện tử, hãy xem hướng dẫn Đo lường sự kiện thương mại điện tử.
Trường hợp one_filter. Chỉ định một loại bộ lọc. one_filter chỉ có thể là một trong những trạng thái sau:
stringFilter

object (StringFilter)

Bộ lọc liên quan đến chuỗi.
inListFilter

object (InListFilter)

Bộ lọc cho các giá trị trong danh sách.
numericFilter

object (NumericFilter)

Bộ lọc cho các giá trị số hoặc ngày.
betweenFilter

object (BetweenFilter)

Bộ lọc giữa hai giá trị.

FunnelBreakdown

Bảng chi tiết thêm một phương diện vào nội dung phản hồi cho báo cáo phụ bảng phễu.

Biểu diễn dưới dạng JSON 
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
Trường
breakdownDimension

object (Dimension)

Đã thêm cột phương diện vào phản hồi cho báo cáo phụ của bảng phễu. Phương diện phân tích chi tiết từng bước trong phễu. Bạn phải có breakdownDimension hợp lệ nếu đã chỉ định funnelBreakdown.
limit

string (int64 format)

Số lượng giá trị riêng biệt tối đa của phương diện phân tích trả về trong câu trả lời. limit là 5 được sử dụng nếu không chỉ định giới hạn. Giới hạn phải vượt quá 0 và không được vượt quá 15.

Phương diện

Thứ nguyên là thuộc tính dữ liệu của bạn. Ví dụ: thành phố của phương diện cho biết thành phố nơi một sự kiện bắt nguồn. Giá trị phương diện trong phản hồi của báo cáo là chuỗi; ví dụ: thành phố có thể là "Paris" hoặc "New York".

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Trường
name

string

Tên phương diện. Xem phần Phương diện API để biết danh sách tên phương diện được các phương pháp báo cáo chính hỗ trợ (chẳng hạn như runReport và batchRunReports). Hãy xem mục Phương diện theo thời gian thực để biết danh sách các tên phương diện mà phương thức runRealtimeReport hỗ trợ. Xem mục Phương diện phễu để biết danh sách các tên phương diện mà phương thức runFunnelReport hỗ trợ.

Nếu bạn chỉ định dimensionExpression, name có thể là chuỗi bất kỳ mà bạn muốn trong bộ ký tự cho phép. Ví dụ: nếu dimensionExpression nối country và city, bạn có thể gọi phương diện đó là countryAndCity. Tên phương diện bạn chọn phải khớp với biểu thức chính quy ^[a-zA-Z0-9_]$.

Các phương diện được name tham chiếu trong dimensionFilter, orderBys, dimensionExpression và pivots.
dimensionExpression

object (DimensionExpression)

Một phương diện có thể là kết quả của một biểu thức của nhiều phương diện. Ví dụ: phương diện "country, city": concatenate(country, ", ", city).

DimensionExpression

Được dùng để thể hiện một phương diện là kết quả của công thức của nhiều phương diện. Ví dụ về cách sử dụng: 1) lowerCase(dimension) 2) concatenate(dimension1, character, dimension2).

Biểu diễn dưới dạng JSON 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
Trường
Trường hợp one_expression. Chỉ định một loại biểu thức phương diện cho DimensionExpression. one_expression chỉ có thể là một trong những trạng thái sau:
lowerCase

object (CaseExpression)

Được dùng để chuyển đổi giá trị thứ nguyên thành chữ thường.
upperCase

object (CaseExpression)

Được dùng để chuyển đổi giá trị thứ nguyên thành chữ hoa.
concatenate

object (ConcatenateExpression)

Dùng để kết hợp các giá trị phương diện thành một phương diện duy nhất. Ví dụ: phương diện "country, city": concatenate(country, ", ", city).

CaseExpression

Được dùng để chuyển đổi một giá trị thứ nguyên sang một trường hợp duy nhất.

Biểu diễn dưới dạng JSON 
{
  "dimensionName": string
}
Trường
dimensionName

string

Tên của một phương diện. Tên này phải tham chiếu đến tên trong trường phương diện của yêu cầu.

ConcatenateExpression

Dùng để kết hợp các giá trị phương diện thành một phương diện duy nhất.

Biểu diễn dưới dạng JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Trường
dimensionNames[]

string

Tên phương diện. Các tên này phải tham chiếu đến tên trong trường phương diện của yêu cầu.
delimiter

string

Dấu phân cách giữa các tên phương diện.

Dấu phân cách thường là các ký tự đơn như "|" hoặc "," nhưng có thể là các chuỗi dài hơn. Nếu một giá trị kích thước chứa dấu phân cách, cả hai sẽ xuất hiện trong phản hồi mà không có sự khác biệt. Ví dụ: nếu giá trị của phương diện 1 = "US,FR", giá trị của phương diện 2 = "JP" và dấu phân cách = ", thì nội dung phản hồi sẽ chứa "US,FR,JP".

FunnelNextAction

Các hành động tiếp theo nêu rõ giá trị của một phương diện sau khi người dùng đã đạt được một bước nhưng trước khi người dùng đó hoàn thành bước tiếp theo. Ví dụ: nếu nextActionDimension là eventName, thì nextActionDimension trong hàng bước trong phễu thứ i sẽ trả về sự kiện đầu tiên sau sự kiện đã giúp người dùng đủ điều kiện tham gia bước trong phễu thứ i, nhưng trước khi người dùng đạt được bước thứ i+1 trong phễu.

Biểu diễn dưới dạng JSON 
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
Trường
nextActionDimension

object (Dimension)

Đã thêm cột phương diện vào nội dung phản hồi trong báo cáo phụ về hình ảnh phễu. Phương diện hành động tiếp theo sẽ trả về giá trị phương diện tiếp theo của phương diện này sau khi người dùng đạt đến bước thứ i trong phễu.

nextActionDimension hiện chỉ hỗ trợ eventName và hầu hết các kích thước Trang / Màn hình như pageTitle và pagePath. nextActionDimension không được là một biểu thức phương diện.
limit

string (int64 format)

Số lượng giá trị riêng biệt tối đa của phương diện phân tích trả về trong câu trả lời. limit là 5 được sử dụng nếu không chỉ định giới hạn. Giới hạn phải vượt quá 0 và không được vượt quá 5.

FunnelVisualizationType

Kiểm soát các phương diện có trong nội dung phản hồi của báo cáo phụ về hình ảnh phễu.

Enum
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Loại không xác định.
STANDARD_FUNNEL Phễu chuẩn (dạng bậc). Báo cáo phụ về hình ảnh phễu trong phản hồi sẽ không chứa ngày.
TRENDED_FUNNEL Một phễu theo xu hướng (biểu đồ dạng đường). Báo cáo phụ về hình ảnh phễu trong phản hồi sẽ chứa phương diện ngày.

Phân khúc

Phân đoạn là một nhóm nhỏ chứa dữ liệu Analytics của bạn. Ví dụ: trong toàn bộ nhóm người dùng, thì phân đoạn có thể là một nhóm nhỏ gồm những người dùng đến từ một quốc gia hoặc thành phố cụ thể. Một phân khúc khác có thể bao gồm những người dùng mua một dòng sản phẩm cụ thể hoặc những người truy cập vào một phần cụ thể của trang web hay kích hoạt một số sự kiện nhất định trong ứng dụng của bạn.

Để tìm hiểu thêm, hãy xem bài viết Trình tạo phân đoạn GA4.

Biểu diễn dưới dạng JSON 
{
  "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.
}
Trường
name

string

Tên cho phân đoạn này. Nếu bạn chưa chỉ định, các phân đoạn sẽ có tên là "Phân đoạn". Tên này xác định giá trị chuỗi do phương diện segment trả về. Tên phân khúc có tiền tố phương diện segment theo số chỉ mục dựa trên 1 của phân khúc trong yêu cầu (ví dụ: "1. Phân đoạn", "2. phân đoạn", v.v.).
Trường hợp one_segment_scope. Phân đoạn được chỉ định trong một phạm vi. one_segment_scope chỉ có thể là một trong những trạng thái sau:
userSegment

object (UserSegment)

Phân khúc người dùng là nhóm nhỏ gồm những người dùng đã tương tác với trang web hoặc ứng dụng của bạn.
sessionSegment

object (SessionSegment)

Phân đoạn phiên hoạt động là nhóm nhỏ các phiên hoạt động xảy ra trên trang web hoặc ứng dụng của bạn.
eventSegment

object (EventSegment)

Phân khúc sự kiện là nhóm nhỏ những sự kiện được kích hoạt trên trang web hoặc ứng dụng của bạn.

UserSegment

Phân khúc người dùng là một nhóm nhỏ những người dùng đã tương tác với trang web hoặc ứng dụng của bạn. Ví dụ: người dùng đã từng mua hàng; người dùng đã thêm sản phẩm vào giỏ hàng nhưng chưa hoàn tất giao dịch mua.

Biểu diễn dưới dạng JSON 
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
Trường
userInclusionCriteria

object (UserSegmentCriteria)

Xác định những người dùng được đưa vào phân khúc này. Không bắt buộc.
exclusion

object (UserSegmentExclusion)

Xác định những người dùng bị loại trừ trong phân khúc này. Không bắt buộc.

UserSegmentCriteria

Người dùng sẽ khớp với một tiêu chí nếu sự kiện của người dùng đó đáp ứng các điều kiện trong tiêu chí đó.

Biểu diễn dưới dạng JSON 
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
Trường
andConditionGroups[]

object (UserSegmentConditionGroup)

Một người dùng sẽ khớp tiêu chí này nếu người dùng đó khớp với từng andConditionGroups trong số này và từng andSequenceGroups. andConditionGroups có thể trống nếu bạn chỉ định andSequenceGroups.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

Một người dùng sẽ khớp tiêu chí này nếu người dùng đó khớp với từng andSequenceGroups trong số này và từng andConditionGroups. andSequenceGroups có thể trống nếu bạn chỉ định andConditionGroups.

UserSegmentConditionGroup

Các điều kiện cho Analytics biết những dữ liệu cần thêm vào hoặc loại trừ khỏi phân đoạn.

Biểu diễn dưới dạng JSON 
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Trường
conditionScoping

enum (UserCriteriaScoping)

Dữ liệu được thêm vào hoặc bị loại trừ khỏi phân khúc dựa trên việc dữ liệu đó có khớp với nhóm điều kiện hay không. Phạm vi này xác định số lượng sự kiện mà segmentFilterExpression được đánh giá trước khi nhóm điều kiện được xác định là khớp hay không. Ví dụ: nếu conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, biểu thức được đánh giá trên tất cả các sự kiện trong một phiên, sau đó nhóm điều kiện được xác định là có khớp hoặc không khớp cho người dùng này. Ví dụ: nếu conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, biểu thức được đánh giá dựa trên một sự kiện và sau đó, nhóm điều kiện được xác định là có khớp hoặc không cho người dùng này.

Không bắt buộc. Nếu không chỉ định thì conditionScoping = ACROSS_ALL_SESSIONS sẽ được sử dụng.
segmentFilterExpression

object (SegmentFilterExpression)

Dữ liệu được đưa vào hoặc bị loại trừ khỏi phân khúc dựa trên việc dữ liệu đó có khớp với biểu thức này hay không. Biểu thức thể hiện tiêu chí về thứ nguyên, chỉ số và/hoặc thông số.

UserCriteriaScoping

Phạm vi cho biết những sự kiện nào được xem xét khi đánh giá xem người dùng có đáp ứng tiêu chí hay không.

Enum
USER_CRITERIA_SCOPING_UNSPECIFIED Phạm vi tiêu chí chưa được chỉ định. Không nêu rõ.
USER_CRITERIA_WITHIN_SAME_EVENT Nếu đáp ứng các tiêu chí trong một sự kiện, thì người dùng sẽ khớp với các tiêu chí đó.
USER_CRITERIA_WITHIN_SAME_SESSION Nếu đáp ứng tiêu chí trong một phiên, người dùng sẽ khớp với tiêu chí.
USER_CRITERIA_ACROSS_ALL_SESSIONS Nếu có sự kiện nào đó đáp ứng tiêu chí của người dùng, thì người dùng đó sẽ khớp với tiêu chí đó.

SegmentFilterExpression

Thể hiện sự kết hợp của các bộ lọc phân khúc.

Biểu diễn dưới dạng JSON 
{

  // 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.
}
Trường
Trường hợp expr. Chỉ định một loại bộ lọc cho SegmentFilterExpression. expr chỉ có thể là một trong những trạng thái sau:
andGroup

object (SegmentFilterExpressionList)

segmentationFilterExpression trong andGroup có mối quan hệ AND.
orGroup

object (SegmentFilterExpressionList)

segmentationFilterExpression trong orGroup có mối quan hệ OR.
notExpression

object (SegmentFilterExpression)

segmentationFilterExpression KHÔNG phải là notExpression.
segmentFilter

object (SegmentFilter)

Bộ lọc phân đoạn gốc.
segmentEventFilter

object (SegmentEventFilter)

Tạo bộ lọc so khớp với các sự kiện của một tên sự kiện. Nếu bạn chỉ định một biểu thức lọc thông số, thì chỉ một nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức lọc thông số mới khớp với bộ lọc sự kiện này.

SegmentFilterExpressionList

Danh sách các biểu thức lọc phân đoạn.

Biểu diễn dưới dạng JSON 
{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}
Trường
expressions[]

object (SegmentFilterExpression)

Danh sách các biểu thức lọc phân đoạn

SegmentFilter

Biểu thức để lọc các giá trị thứ nguyên hoặc chỉ số.

Biểu diễn dưới dạng JSON 
{
  "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.
}
Trường
fieldName

string

Tên phương diện hoặc tên chỉ số.
filterScoping

object (SegmentFilterScoping)

Chỉ định phạm vi cho bộ lọc.
Trường hợp one_filter. Chỉ định một loại bộ lọc cho Filter. one_filter chỉ có thể là một trong những trạng thái sau:
stringFilter

object (StringFilter)

Bộ lọc liên quan đến chuỗi.
inListFilter

object (InListFilter)

Bộ lọc cho các giá trị trong danh sách.
numericFilter

object (NumericFilter)

Bộ lọc cho các giá trị số hoặc ngày.
betweenFilter

object (BetweenFilter)

Bộ lọc giữa hai giá trị.

SegmentFilterScoping

Phạm vi chỉ định cách xem xét phương diện và chỉ số của nhiều sự kiện khi đánh giá một bộ lọc phân đoạn.

Biểu diễn dưới dạng JSON 
{
  "atAnyPointInTime": boolean
}
Trường
atAnyPointInTime

boolean

Nếu atAnyPointInTime là true, bộ lọc này sẽ đánh giá là true cho tất cả sự kiện nếu nó có giá trị là true cho mọi sự kiện trong phạm vi ngày của yêu cầu.

Thông số atAnyPointInTime này không mở rộng phạm vi ngày của sự kiện trong báo cáo. Nếu atAnyPointInTime đúng, thì chỉ những sự kiện trong phạm vi ngày của báo cáo mới được xem xét khi đánh giá bộ lọc này.

Bạn chỉ có thể chỉ định atAnyPointInTime này nếu phạm vi tiêu chí là ACROSS_ALL_SESSIONS và không thể được chỉ định theo trình tự.

Nếu phạm vi tiêu chí là ACROSS_ALL_SESSIONS, thì atAnyPointInTime = false sẽ được sử dụng nếu không chỉ định.

SegmentEventFilter

Tạo bộ lọc so khớp với các sự kiện của một tên sự kiện. Nếu bạn chỉ định một biểu thức lọc thông số, thì chỉ một nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức lọc thông số mới khớp với bộ lọc sự kiện này.

Biểu diễn dưới dạng JSON 
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
Trường
eventName

string

Bộ lọc này khớp với các sự kiện của tên sự kiện duy nhất này. Bạn phải nhập tên sự kiện.
segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

Nếu được chỉ định, bộ lọc này sẽ so khớp những sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức lọc thông số.

Bên trong biểu thức lọc thông số, chỉ có bộ lọc tham số.

SegmentParameterFilterExpression

Thể hiện các tổ hợp bộ lọc phân khúc dựa trên các thông số.

Biểu diễn dưới dạng JSON 
{

  // 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.
}
Trường
Trường hợp expr. Chỉ định một loại bộ lọc cho SegmentParameterFilterExpression. expr chỉ có thể là một trong những trạng thái sau:
andGroup

object (SegmentParameterFilterExpressionList)

segmentationParameterFilterExpression trong andGroup có mối quan hệ AND.
orGroup

object (SegmentParameterFilterExpressionList)

segmentationParameterFilterExpression trong orGroup có mối quan hệ OR.
notExpression

object (SegmentParameterFilterExpression)

segmentationParameterFilterExpression KHÔNG phải là notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

Bộ lọc tham số phân đoạn gốc.

SegmentParameterFilterExpressionList

Danh sách các biểu thức lọc tham số phân đoạn.

Biểu diễn dưới dạng JSON 
{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}
Trường
expressions[]

object (SegmentParameterFilterExpression)

Danh sách các biểu thức lọc tham số phân đoạn.

SegmentParameterFilter

Một biểu thức để lọc các giá trị thông số trong một phân đoạn.

Biểu diễn dưới dạng JSON 
{
  "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.
}
Trường
filterScoping

object (SegmentParameterFilterScoping)

Chỉ định phạm vi cho bộ lọc.
Trường hợp one_parameter. Trường đang được lọc. one_parameter chỉ có thể là một trong những trạng thái sau:
eventParameterName

string

Bộ lọc này sẽ được đánh giá dựa trên thông số sự kiện được chỉ định. Thông số sự kiện được ghi lại dưới dạng thông số của sự kiện. Thông số sự kiện bao gồm các trường như "firebase_screen" và "currency".

Bạn chỉ có thể dùng thông số sự kiện trong các phân đoạn và phễu, đồng thời chỉ có thể dùng trong một bộ lọc cấp dưới từ một Bộ lọc sự kiện. Trong bộ lọc con từ EventFilter, bạn nên sử dụng thông số sự kiện hoặc mục.
itemParameterName

string

Bộ lọc này sẽ được đánh giá dựa trên thông số mục được chỉ định. Thông số mặt hàng được ghi lại dưới dạng thông số trong mảng mặt hàng. Thông số mặt hàng bao gồm các trường như "item_name" và "item_category".

Bạn chỉ có thể dùng thông số mục trong các phân đoạn và phễu, đồng thời chỉ có thể dùng trong một bộ lọc cấp dưới từ một EventFilter. Trong bộ lọc con từ EventFilter, bạn nên sử dụng thông số sự kiện hoặc mục.

Thông số mặt hàng chỉ có trong sự kiện thương mại điện tử. Để tìm hiểu thêm về các sự kiện thương mại điện tử, hãy xem hướng dẫn Đo lường sự kiện thương mại điện tử.
Trường hợp one_filter. Chỉ định một loại bộ lọc. one_filter chỉ có thể là một trong những trạng thái sau:
stringFilter

object (StringFilter)

Bộ lọc liên quan đến chuỗi.
inListFilter

object (InListFilter)

Bộ lọc cho các giá trị trong danh sách.
numericFilter

object (NumericFilter)

Bộ lọc cho các giá trị số hoặc ngày.
betweenFilter

object (BetweenFilter)

Bộ lọc giữa hai giá trị.

SegmentParameterFilterScoping

Phạm vi cho biết cách nhiều sự kiện sẽ được xem xét khi đánh giá một bộ lọc thông số phân đoạn.

Biểu diễn dưới dạng JSON 
{
  "inAnyNDayPeriod": string
}
Trường
inAnyNDayPeriod

string (int64 format)

Tích luỹ thông số trong khoảng thời gian ngày được chỉ định trước khi áp dụng bộ lọc. Chỉ được hỗ trợ nếu phạm vi tiêu chí là ACROSS_ALL_SESSIONS hoặc WITHIN_SAME_SESSION. Chỉ được hỗ trợ nếu tham số là event_count.

Ví dụ: nếu inAnyNDayPeriod là 3, eventName là "purchase", thông số sự kiện là "event_count" và tiêu chí của Bộ lọc lớn hơn 5, thì bộ lọc này sẽ tích luỹ số lượng sự kiện mua hàng trong khoảng thời gian 3 ngày liên tiếp trong phạm vi ngày của báo cáo. Người dùng sẽ vượt qua tiêu chí của Bộ lọc này để được đưa vào phân đoạn này nếu số lượng sự kiện mua hàng của họ vượt quá 5 trong khoảng thời gian 3 ngày liên tiếp. Ví dụ: các khoảng thời gian 2021-11-01 đến 2021-11-03, 2021-11-02 đến 2021-11-04, 2021-11-03 đến 2021-11-05, v.v. sẽ được xem xét.

Phạm vi ngày không được mở rộng vì mục đích có toàn bộ khung thời gian N ngày gần bắt đầu phạm vi ngày. Ví dụ: nếu báo cáo dành cho ngày 1/11/2021 đến ngày 10/11/2021 và inAnyNDayPeriod = 3, thì khoảng thời gian 2 ngày đầu tiên sẽ được rút ngắn một cách hiệu quả vì không có dữ liệu sự kiện nào nằm ngoài phạm vi ngày của báo cáo sẽ được đọc. Ví dụ: 4 giai đoạn đầu tiên sẽ là: 2021-11-01 đến 2021-11-01, 2021-11-01 đến 2021-11-02, 2021-11-01 đến 2021-11-03 và 2021-11-01-01 đến 2021-11-01-1

inAnyNDayPeriod là không bắt buộc. Nếu bạn không chỉ định, segmentParameterFilter sẽ được áp dụng riêng cho từng sự kiện.

UserSegmentSequenceGroup

Xác định các điều kiện phải xảy ra theo thứ tự cụ thể để người dùng trở thành thành viên của phân khúc.

Biểu diễn dưới dạng JSON 
{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}
Trường
sequenceScoping

enum (UserCriteriaScoping)

Bạn phải đáp ứng tất cả các bước trong trình tự khi xác định phạm vi để người dùng khớp với trình tự. Ví dụ: nếu sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, thì tất cả các bước trong trình tự phải hoàn thành trong một phiên để người dùng khớp với trình tự. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT không được hỗ trợ.

Không bắt buộc. Nếu không chỉ định thì conditionScoping = ACROSS_ALL_SESSIONS sẽ được sử dụng.
sequenceMaximumDuration

string (Duration format)

Xác định khoảng thời gian mà toàn bộ trình tự phải xảy ra; ví dụ: 30 phút. sequenceMaximumDuration bao gồm điểm cuối ở độ chi tiết một phần triệu giây. Ví dụ: một chuỗi có thời lượng tối đa là 5 giây có thể được hoàn thành ở 4,9 hoặc 5,0 giây, nhưng không thể hoàn tất trong 5 giây và 1 micrô giây.

sequenceMaximumDuration là không bắt buộc. Nếu chưa chỉ định, trình tự có thể hoàn tất trong bất kỳ khoảng thời gian nào.

Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
userSequenceSteps[]

object (UserSequenceStep)

Một trình tự sắp xếp các bước điều kiện. Sự kiện của người dùng phải hoàn tất từng bước để người dùng đó khớp với UserSegmentSequenceGroup.

UserSequenceStep

Một điều kiện phải xảy ra theo thứ tự bước đã chỉ định để người dùng này khớp với trình tự.

Biểu diễn dưới dạng JSON 
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Trường
isDirectlyFollowedBy

boolean

Nếu đúng, sự kiện đáp ứng bước này phải là sự kiện tiếp theo sau khi sự kiện đáp ứng bước cuối cùng. Nếu giá trị sai, bước này sẽ gián tiếp đứng sau bước trước đó; ví dụ: có thể có các sự kiện giữa bước trước và bước này. isDirectlyFollowedBy phải là false cho bước đầu tiên.
stepScoping

enum (UserCriteriaScoping)

Bạn phải đáp ứng bước trình tự này trong việc xác định phạm vi để người dùng khớp với trình tự. Ví dụ: nếu sequenceScoping = WITHIN_SAME_SESSION, thì các bước trình tự này phải hoàn thành trong một phiên để người dùng khớp với trình tự. stepScoping = ACROSS_ALL_SESSIONS chỉ được phép nếu là sequenceScoping = ACROSS_ALL_SESSIONS.

Không bắt buộc. Nếu không chỉ định thì stepScoping sẽ sử dụng cùng một UserCriteriaScoping với sequenceScoping.
segmentFilterExpression

object (SegmentFilterExpression)

Người dùng sẽ so khớp bước này trong trình tự nếu các sự kiện của họ khớp với biểu thức này. Biểu thức thể hiện tiêu chí về thứ nguyên, chỉ số và/hoặc thông số.

UserSegmentExclusion

Chỉ định những người dùng bị loại trừ trong phân khúc này.

Biểu diễn dưới dạng JSON 
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
Trường
userExclusionDuration

enum (UserExclusionDuration)

Chỉ định khoảng thời gian áp dụng một tiêu chí loại trừ nếu người dùng khớp với userExclusionCriteria.

Không bắt buộc. Nếu không chỉ định thì userExclusionDuration/USER_EXCLUSION_TEMPORARY sẽ được sử dụng.
userExclusionCriteria

object (UserSegmentCriteria)

Nếu đáp ứng điều kiện này thì người dùng sẽ bị loại khỏi tư cách thành viên trong phân khúc đối với userExclusionDuration.

UserExclusionDuration

Liệt kê các tuỳ chọn về thời gian loại trừ nếu người dùng khớp với userExclusionCriteria.

Enum
USER_EXCLUSION_DURATION_UNSPECIFIED Khoảng thời gian loại trừ chưa chỉ định. Không nêu rõ.
USER_EXCLUSION_TEMPORARY Tạm thời loại trừ người dùng khỏi phân khúc trong các khoảng thời gian khi người dùng đáp ứng điều kiện userExclusionCriteria.
USER_EXCLUSION_PERMANENT Loại trừ vĩnh viễn người dùng khỏi phân khúc nếu người dùng đó đã từng đáp ứng điều kiện userExclusionCriteria.

SessionSegment

Phân đoạn phiên hoạt động là nhóm nhỏ các phiên xảy ra trên trang web hoặc ứng dụng của bạn (ví dụ: tất cả các phiên bắt nguồn từ một chiến dịch quảng cáo cụ thể).

Biểu diễn dưới dạng JSON 
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
Trường
sessionInclusionCriteria

object (SessionSegmentCriteria)

Xác định những phiên nào được đưa vào phân đoạn này. Không bắt buộc.
exclusion

object (SessionSegmentExclusion)

Xác định những phiên bị loại trừ trong phân đoạn này. Không bắt buộc.

SessionSegmentCriteria

Một phiên khớp với một tiêu chí nếu các sự kiện của phiên đó đáp ứng các điều kiện trong tiêu chí đó.

Biểu diễn dưới dạng JSON 
{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}
Trường
andConditionGroups[]

object (SessionSegmentConditionGroup)

Một phiên khớp với tiêu chí này nếu phiên đó khớp với từng andConditionGroups.

SessionSegmentConditionGroup

Các điều kiện cho Analytics biết những dữ liệu cần thêm vào hoặc loại trừ khỏi phân đoạn.

Biểu diễn dưới dạng JSON 
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Trường
conditionScoping

enum (SessionCriteriaScoping)

Dữ liệu được thêm vào hoặc bị loại trừ khỏi phân khúc dựa trên việc dữ liệu đó có khớp với nhóm điều kiện hay không. Phạm vi này xác định số lượng sự kiện mà segmentFilterExpression được đánh giá trước khi nhóm điều kiện được xác định là khớp hay không. Ví dụ: nếu conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, biểu thức được đánh giá trên tất cả các sự kiện trong một phiên, sau đó nhóm điều kiện được xác định là khớp hoặc không khớp cho phiên này. Ví dụ: nếu conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, biểu thức được đánh giá dựa trên một sự kiện, và sau đó, nhóm điều kiện được xác định là khớp hoặc không cho phiên này.

Không bắt buộc. Nếu không chỉ định thì hệ thống sẽ sử dụng conditionScoping là WITHIN_SAME_SESSION.
segmentFilterExpression

object (SegmentFilterExpression)

Dữ liệu được đưa vào hoặc bị loại trừ khỏi phân khúc dựa trên việc dữ liệu đó có khớp với biểu thức này hay không. Biểu thức thể hiện tiêu chí về thứ nguyên, chỉ số và/hoặc thông số.

SessionCriteriaScoping

Phạm vi cho biết những sự kiện nào được xem xét khi đánh giá xem một phiên có đáp ứng tiêu chí hay không.

Enum
SESSION_CRITERIA_SCOPING_UNSPECIFIED Phạm vi tiêu chí chưa được chỉ định. Không nêu rõ.
SESSION_CRITERIA_WITHIN_SAME_EVENT Nếu bạn đáp ứng tiêu chí trong một sự kiện, thì phiên đó sẽ khớp với tiêu chí.
SESSION_CRITERIA_WITHIN_SAME_SESSION Nếu đáp ứng tiêu chí trong một phiên, thì phiên đó sẽ khớp với tiêu chí.

SessionSegmentExclusion

Xác định những phiên bị loại trừ trong phân khúc này.

Biểu diễn dưới dạng JSON 
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
Trường
sessionExclusionDuration

enum (SessionExclusionDuration)

Chỉ định khoảng thời gian mà một tiêu chí loại trừ sẽ kéo dài nếu một phiên khớp với sessionExclusionCriteria.

Không bắt buộc. Nếu không chỉ định thì hệ thống sẽ sử dụng sessionExclusionDuration là SESSION_EXCLUSION_TEMPORARY.
sessionExclusionCriteria

object (SessionSegmentCriteria)

Nếu một phiên đáp ứng điều kiện này, phiên đó sẽ bị loại trừ khỏi tư cách thành viên trong phân khúc cho sessionExclusionDuration.

SessionExclusionDuration

Liệt kê các tuỳ chọn về thời lượng của một tiêu chí loại trừ nếu một phiên hoạt động khớp với sessionExclusionCriteria.

Enum
SESSION_EXCLUSION_DURATION_UNSPECIFIED Khoảng thời gian loại trừ chưa chỉ định. Không nêu rõ.
SESSION_EXCLUSION_TEMPORARY Tạm thời loại trừ các phiên khỏi phân đoạn trong các khoảng thời gian khi phiên đó đáp ứng điều kiện sessionExclusionCriteria.
SESSION_EXCLUSION_PERMANENT Loại trừ vĩnh viễn các phiên khỏi phân đoạn nếu phiên đó đã từng đáp ứng điều kiện sessionExclusionCriteria.

EventSegment

Phân khúc sự kiện là nhóm nhỏ các sự kiện được kích hoạt trên trang web hoặc ứng dụng của bạn (ví dụ: tất cả các sự kiện mua hàng được thực hiện tại một vị trí cụ thể; các sự kiện app_exception xảy ra trên một hệ điều hành cụ thể).

Biểu diễn dưới dạng JSON 
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
Trường
eventInclusionCriteria

object (EventSegmentCriteria)

Xác định những sự kiện được đưa vào phân đoạn này. Không bắt buộc.
exclusion

object (EventSegmentExclusion)

Xác định những sự kiện bị loại trừ trong phân khúc này. Không bắt buộc.

EventSegmentCriteria

Một sự kiện sẽ khớp với một tiêu chí nếu sự kiện đó đáp ứng các điều kiện trong tiêu chí đó.

Biểu diễn dưới dạng JSON 
{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}
Trường
andConditionGroups[]

object (EventSegmentConditionGroup)

Một sự kiện sẽ khớp với tiêu chí này nếu sự kiện đó khớp với từng tiêu chí trong số andConditionGroups.

EventSegmentConditionGroup

Các điều kiện cho Analytics biết những dữ liệu cần thêm vào hoặc loại trừ khỏi phân đoạn.

Biểu diễn dưới dạng JSON 
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Trường
conditionScoping

enum (EventCriteriaScoping)

conditionScoping phải luôn là EVENT_CRITERIA_WITHIN_SAME_EVENT.

Không bắt buộc. Nếu không chỉ định thì hệ thống sẽ sử dụng conditionScoping là EVENT_CRITERIA_WITHIN_SAME_EVENT.
segmentFilterExpression

object (SegmentFilterExpression)

Dữ liệu được đưa vào hoặc bị loại trừ khỏi phân khúc dựa trên việc dữ liệu đó có khớp với biểu thức này hay không. Biểu thức thể hiện tiêu chí về thứ nguyên, chỉ số và/hoặc thông số.

EventCriteriaScoping

Phạm vi cho biết những sự kiện nào được xem xét khi đánh giá xem một sự kiện có đáp ứng tiêu chí hay không.

Enum
EVENT_CRITERIA_SCOPING_UNSPECIFIED Phạm vi tiêu chí chưa được chỉ định. Không nêu rõ.
EVENT_CRITERIA_WITHIN_SAME_EVENT Nếu bạn đáp ứng tiêu chí trong một sự kiện, thì sự kiện đó sẽ khớp với tiêu chí.

EventSegmentExclusion

Chỉ định những sự kiện bị loại trừ trong phân khúc này.

Biểu diễn dưới dạng JSON 
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
Trường
eventExclusionDuration

enum (EventExclusionDuration)

eventExclusionDuration phải luôn là PERMANENTLY_EXCLUDE.

Không bắt buộc. Nếu không chỉ định, hệ thống sẽ sử dụng eventExclusionDuration là EVENT_EXCLUSION_PERMANENT.
eventExclusionCriteria

object (EventSegmentCriteria)

Nếu một sự kiện đáp ứng điều kiện này, sự kiện đó sẽ bị loại trừ khỏi danh sách thành viên trong phân khúc đối với eventExclusionDuration.

EventExclusionDuration

Liệt kê các lựa chọn về thời gian loại trừ nếu một sự kiện khớp với eventExclusionCriteria.

Enum
EVENT_EXCLUSION_DURATION_UNSPECIFIED Khoảng thời gian loại trừ chưa chỉ định. Không nêu rõ.
EVENT_EXCLUSION_PERMANENT Loại trừ vĩnh viễn các sự kiện khỏi phân khúc nếu sự kiện đó đã từng đáp ứng điều kiện eventExclusionCriteria.

FilterExpression

Để thể hiện bộ lọc phương diện hoặc chỉ số. Các trường trong cùng một FilterExpression cần phải là tất cả phương diện hoặc tất cả chỉ số.

Biểu diễn dưới dạng JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
Trường
Trường hợp expr. Chỉ định một loại biểu thức lọc cho FilterExpression. expr chỉ có thể là một trong những trạng thái sau:
andGroup

object (FilterExpressionList)

FilterExpressions trong andGroup có mối quan hệ AND.
orGroup

object (FilterExpressionList)

FilterExpression trong orGroup có mối quan hệ OR.
notExpression

object (FilterExpression)

FilterExpression KHÔNG phải là của notExpression.
filter

object (Filter)

Bộ lọc gốc. Trong cùng một FilterExpression, tên trường của bộ lọc cần phải là tất cả phương diện hoặc chỉ số.

FilterExpressionList

Danh sách các biểu thức lọc.

Biểu diễn dưới dạng JSON 
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
Trường
expressions[]

object (FilterExpression)

Danh sách các biểu thức lọc.

Lọc

Biểu thức để lọc các giá trị thứ nguyên hoặc chỉ số.

Biểu diễn dưới dạng JSON 
{
  "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.
}
Trường
fieldName

string

Tên phương diện hoặc tên chỉ số. Phải là tên được xác định trong phương diện hoặc chỉ số.
Trường hợp one_filter. Chỉ định một loại bộ lọc cho Filter. one_filter chỉ có thể là một trong những trạng thái sau:
stringFilter

object (StringFilter)

Bộ lọc liên quan đến chuỗi.
inListFilter

object (InListFilter)

Bộ lọc cho các giá trị trong danh sách.
numericFilter

object (NumericFilter)

Bộ lọc cho các giá trị số hoặc ngày.
betweenFilter

object (BetweenFilter)

Bộ lọc giữa hai giá trị.

FunnelSubReport

Báo cáo phụ phễu chứa các giá trị dữ liệu phương diện và chỉ số. Ví dụ: 12 người dùng đã tiếp cận bước thứ hai của phễu.

Biểu diễn dưới dạng JSON 
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
Trường
dimensionHeaders[]

object (DimensionHeader)

Mô tả các cột phương diện. Báo cáo phễu luôn bao gồm phương diện bước phễu trong ý kiến phản hồi cho báo cáo phụ. Các phương diện bổ sung như bảng chi tiết, ngày và hành động tiếp theo có thể xuất hiện trong phản hồi nếu được yêu cầu.
metricHeaders[]

object (MetricHeader)

Mô tả các cột chỉ số. Báo cáo phễu luôn bao gồm người dùng đang hoạt động trong phản hồi báo cáo phụ. Bảng phễu bao gồm các chỉ số bổ sung như tỷ lệ hoàn thành, số lượt bỏ ngang và tỷ lệ bỏ ngang.
rows[]

object (Row)

Các hàng gồm các kiểu kết hợp giá trị phương diện và giá trị chỉ số trong báo cáo.
metadata

object (FunnelResponseMetadata)

Siêu dữ liệu cho báo cáo phễu.

DimensionHeader

Mô tả một cột phương diện trong báo cáo. Các phương diện được yêu cầu trong báo cáo tạo ra các mục nhập cột trong các hàng và Phương diện tiêu đề. Tuy nhiên, các thứ nguyên được sử dụng riêng trong bộ lọc hoặc biểu thức không tạo ra các cột trong báo cáo; tương ứng, những thứ nguyên đó không tạo tiêu đề.

Biểu diễn dưới dạng JSON 
{
  "name": string
}
Trường
name

string

Tên của phương diện.

MetricHeader

Mô tả cột chỉ số trong báo cáo. Các chỉ số hiển thị được yêu cầu trong báo cáo tạo ra các mục nhập cột trong các hàng và MetricsHeader. Tuy nhiên, chỉ số được sử dụng riêng trong bộ lọc hoặc biểu thức không tạo ra cột trong báo cáo; tương ứng, những chỉ số đó không tạo tiêu đề.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "type": enum (MetricType)
}
Trường
name

string

Tên của chỉ số.
type

enum (MetricType)

Loại dữ liệu của chỉ số.

MetricType

Loại giá trị của chỉ số.

Enum
METRIC_TYPE_UNSPECIFIED Loại không xác định.
TYPE_INTEGER Loại số nguyên.
TYPE_FLOAT Loại dấu phẩy động.
TYPE_SECONDS Thời lượng giây; một loại dấu phẩy động đặc biệt.
TYPE_MILLISECONDS Thời lượng tính bằng mili giây; một kiểu dấu phẩy động đặc biệt.
TYPE_MINUTES Thời lượng tính bằng phút; một loại dấu phẩy động đặc biệt.
TYPE_HOURS Thời lượng tính bằng giờ; một loại dấu phẩy động đặc biệt.
TYPE_STANDARD Chỉ số tuỳ chỉnh thuộc loại chuẩn; một loại dấu phẩy động đặc biệt.
TYPE_CURRENCY Số tiền; một loại dấu phẩy động đặc biệt.
TYPE_FEET Chiều dài tính theo feet; một loại dấu phẩy động đặc biệt.
TYPE_MILES Chiều dài tính bằng dặm; một loại dấu phẩy động đặc biệt.
TYPE_METERS Chiều dài tính bằng mét; một loại dấu phẩy động đặc biệt.
TYPE_KILOMETERS Độ dài tính bằng kilômét; một loại dấu phẩy động đặc biệt.

Hàng

Báo cáo dữ liệu cho từng hàng. Ví dụ: nếu RunReportRequest chứa:

"dimensions": [
  {
    "name": "eventName"
  },
  {
    "name": "countryId"
  }
],
"metrics": [
  {
    "name": "eventCount"
  }
]

Một hàng có eventName là "in_app_purchase", "JP" là mã quốc gia và số eventCount trong 15 sẽ là:

"dimensionValues": [
  {
    "value": "in_app_purchase"
  },
  {
    "value": "JP"
  }
],
"metricValues": [
  {
    "value": "15"
  }
]
Biểu diễn dưới dạng JSON 
{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Trường
dimensionValues[]

object (DimensionValue)

Danh sách các giá trị phương diện được yêu cầu. Trong PivotReport, parameterValues chỉ được liệt kê cho các phương diện có trong bảng tổng hợp.
metricValues[]

object (MetricValue)

Danh sách các giá trị chỉ số hiển thị được yêu cầu.

DimensionValue

Giá trị của một phương diện.

Biểu diễn dưới dạng JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Trường
Trường hợp one_value. Một loại giá trị phương diện one_value chỉ có thể là một trong các giá trị sau:
value

string

Giá trị ở dạng chuỗi nếu loại phương diện là chuỗi.

MetricValue

Giá trị của một chỉ số.

Biểu diễn dưới dạng JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Trường
Trường hợp one_value. Một trong các giá trị chỉ số one_value chỉ được là một trong các giá trị sau:
value

string

Giá trị đo lường. Xem MetricsHeader để biết loại.

FunnelResponseMetadata

Siêu dữ liệu phản hồi của báo cáo phễu có thông tin bổ sung về báo cáo phễu.

Biểu diễn dưới dạng JSON 
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
Trường
samplingMetadatas[]

object (SamplingMetadata)

Nếu kết quả báo cáo phễu được lấy mẫu, thì giá trị này mô tả tỷ lệ phần trăm sự kiện được sử dụng trong báo cáo phễu này. Một samplingMetadatas được điền cho mỗi phạm vi ngày. Mỗi samplingMetadatas tương ứng với một phạm vi ngày theo thứ tự mà phạm vi ngày được chỉ định trong yêu cầu.

Tuy nhiên, nếu kết quả không được lấy mẫu, trường này sẽ không được xác định.

SamplingMetadata

Nếu kết quả báo cáo phễu được lấy mẫu, thì siêu dữ liệu này sẽ mô tả tỷ lệ phần trăm sự kiện được sử dụng trong báo cáo phễu này trong một phạm vi ngày. Lấy mẫu là phương pháp phân tích một tập hợp con của tất cả dữ liệu để khám phá thông tin có ý nghĩa trong tập dữ liệu lớn hơn.

Biểu diễn dưới dạng JSON 
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
Trường
samplesReadCount

string (int64 format)

Tổng số sự kiện được đọc trong báo cáo mẫu này trong một phạm vi ngày. Đây là quy mô của tập hợp con dữ liệu của tài sản này đã được phân tích trong báo cáo phễu này.
samplingSpaceSize

string (int64 format)

Tổng số sự kiện có trong dữ liệu của tài sản này mà có thể đã được phân tích trong báo cáo phễu này cho một phạm vi ngày. Việc lấy mẫu khám phá thông tin có ý nghĩa về tập dữ liệu lớn hơn và đây là kích thước của tập dữ liệu lớn hơn.

Để tính tỷ lệ phần trăm dữ liệu có sẵn được sử dụng trong báo cáo phễu này, hãy tính samplesReadCount/samplingSpaceSize.

PropertyQuota

Trạng thái hiện tại của tất cả các hạn mức cho Tài sản Analytics này. Nếu một tài sản hết hạn mức, thì tất cả các yêu cầu đối với tài sản đó sẽ trả về lỗi Tài nguyên đã hết.

Biểu diễn dưới dạng JSON 
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}
Trường
tokensPerDay

object (QuotaStatus)

Tài sản Analytics chuẩn có thể sử dụng tối đa 200.000 mã thông báo mỗi ngày; Tài sản Analytics 360 có thể sử dụng 2.000.000 mã thông báo mỗi ngày. Hầu hết các yêu cầu đều cần ít hơn 10 mã thông báo.
tokensPerHour

object (QuotaStatus)

Tài sản Analytics chuẩn có thể sử dụng tối đa 40.000 mã thông báo mỗi giờ; Tài sản Analytics 360 có thể sử dụng 400.000 mã thông báo mỗi giờ. Yêu cầu API sử dụng một số lượng mã thông báo và con số đó sẽ được khấu trừ từ tất cả hạn mức hằng giờ, hằng ngày và theo giờ của mỗi dự án.
concurrentRequests

object (QuotaStatus)

Tài sản Analytics chuẩn có thể gửi tối đa 10 yêu cầu đồng thời; Tài sản Analytics 360 có thể sử dụng tối đa 50 yêu cầu đồng thời.
serverErrorsPerProjectPerHour

object (QuotaStatus)

Các cặp tài sản Analytics chuẩn và dự án trên đám mây có thể có tối đa 10 lỗi máy chủ mỗi giờ; các cặp tài sản Analytics 360 và dự án trên đám mây có thể có tối đa 50 lỗi máy chủ mỗi giờ.
potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

Tài sản Analytics có thể gửi tối đa 120 yêu cầu với các phương diện có thể đạt ngưỡng mỗi giờ. Trong một yêu cầu hàng loạt, mỗi yêu cầu báo cáo sẽ được tính riêng cho hạn mức này nếu yêu cầu đó chứa phương diện có thể bị giới hạn.
tokensPerProjectPerHour

object (QuotaStatus)

Tài sản Analytics có thể sử dụng tối đa 35% mã thông báo cho mỗi dự án mỗi giờ. Số tiền này theo đó Tài sản Analytics chuẩn có thể sử dụng tối đa 14.000 mã thông báo cho mỗi dự án mỗi giờ và Tài sản Analytics 360 có thể sử dụng 140.000 mã thông báo cho mỗi dự án mỗi giờ. Yêu cầu API sử dụng một số lượng mã thông báo và con số đó sẽ được khấu trừ từ tất cả hạn mức hằng giờ, hằng ngày và theo giờ của mỗi dự án.

QuotaStatus

Trạng thái hiện tại của một nhóm hạn mức cụ thể.

Biểu diễn dưới dạng JSON 
{
  "consumed": integer,
  "remaining": integer
}
Trường
consumed

integer

Hạn mức mà yêu cầu này đã sử dụng.
remaining

integer

Hạn mức còn lại sau yêu cầu này.