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 được API trả về ở dạng bảng có các cột cho 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. Để đưa ra ý kiến phản hồi về API này, hãy hoàn thành bài viết 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 nội dung. Để tìm hiểu thêm, hãy xem nơi xem Mã tài sản. Trong yêu cầu theo lô, tài sản này phải không đượ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 cho 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 của phễu của yêu cầu này. Bạn bắt buộc phải thiết lập phễu này.
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 nội dung phản hồi của báo cáo phụ ở bảng phễu. Phương diện bảng chi tiết này mở rộng từng bước phễu đến các giá trị riêng biệt của phương diện bảng chi tiết. Ví dụ: việc phân tích theo phương diện deviceCategory sẽ tạo các hàng cho mobile, tablet, desktop và tổng cộng.
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 cho 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 phễu đến các giá trị riêng biệt của hành động tiếp theo. Ví dụ: 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.

Thao tác 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 nội dung phản hồi cho báo cáo phụ của 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 khúc. 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 được đánh giá trong từng phân đoạn.

Mỗi phân đoạn được chỉ định trong yêu cầu này sẽ tạo một hàng riêng trong phản hồi; trong câu trả lời, từng phân đoạn được xác định theo tên.

Thông số phân đoạn là không bắt buộc. Chỉ có 4 phân đoạn yêu cầu.
limit

string (int64 format)

Không bắt buộc. Số hàng cần trả về. Nếu bạn không chỉ định thì hệ thống sẽ trả về 10.000 hàng. API sẽ 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 so với 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 cho phép bạn chỉ yêu cầu các giá trị phương diện cụ thể trong báo cáo. Để tìm hiểu thêm, hãy xem ví dụ trong bài viết Tạo báo cáo: Bộ lọc phương diện. 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 cho Tài sản Analytics này. Hạn mức được trả về trong PropertyQuota.

Nội dung phản hồi

Phản hồi 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, số người dùng đang hoạt động, tỷ lệ hoàn thành, tỷ lệ bỏ ngang và tỷ lệ bỏ ngang.

Phương diện phân đoạn chỉ xuất hiện trong phản hồi này nếu có yêu cầu phân đoạn. 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.

Phương diện phân đoạn chỉ xuất hiện trong phản hồi này nếu có yêu cầu phân đoạn. Phương diện ngày chỉ xuất hiện trong nội dung phản hồi này nếu nó đượ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 nếu đượ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 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 giữa 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:

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

Phễu

Định cấu hình 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ọ trải qua 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, còn 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 bạn chưa chỉ định, thì mô hình 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 để phân biệt cho bước này. Nếu chưa chỉ định, các bước sẽ được đặt tên bằng một tên được lập chỉ mục dựa trên 1 (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 trực tiếp thực hiện bước trước đó. Nếu giá trị là false thì có thể sẽ có sự kiện giữa bước trước đó và bước này. Nếu không được chỉ định, isDirectlyFollowedBy sẽ được coi là false.
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, thì bước này phải được hoàn tất trong khoảng thời gian này kể từ thời điểm hoàn tất bước trước đó. withinDurationFromPriorStep bao gồm điểm cuối ở độ chi tiết một micrô giây. Ví dụ: có thể hoàn thành thời lượng 5 giây ở 4,9 hoặc 5,0 giây, nhưng không thể hoàn thành 5 giây và 1 micrô giây.

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

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

FunnelFilterExpression

Thể hiện sự kết hợp của các 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 kết 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 đây:
andGroup

object (FunnelFilterExpressionList)

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

object (FunnelFilterExpressionList)

KênhFilterExpression trong orGroup có quan hệ OR.
notExpression

object (FunnelFilterExpression)

KênhFilterExpression KHÔNG phải là 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 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ỏ các sự kiện khớp với cả tên sự kiện 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 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 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 kết 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 đây:
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 tháng.
betweenFilter

object (BetweenFilter)

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

FunnelEventFilter

Tạo bộ lọc 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ỏ các sự kiện khớp với cả tên sự kiện 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 một tên sự kiện 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ẽ khớp với các sự kiện khớp với cả tên sự kiện và biểu thức lọc thông số.

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

FunnelParameterFilterExpression

Thể hiện sự kết hợp của 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 kết 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 đây:
andGroup

object (FunnelParameterFilterExpressionList)

KênhThông sốFilterExpression trong andGroup có quan hệ AND.
orGroup

object (FunnelParameterFilterExpressionList)

Kênh tham số FilterExpression trong orGroup có quan hệ OR.
notExpression

object (FunnelParameterFilterExpression)

Kênh tham số FilterExpression KHÔNG phải là notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

Bộ lọc thông số phễu ban đầu.

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 kết 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 đây:
eventParameterName

string

Bộ lọc này sẽ được đánh giá dựa trên thông số sự kiện đã chỉ định. Các 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ể sử dụng thông số sự kiện trong các phân đoạn và kênh và chỉ có thể được sử dụng trong bộ lọc con cháu từ EventFilter. Trong bộ lọc giảm dần 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 đã 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ể sử dụng thông số mặt hàng trong phân đoạn và kênh và chỉ có thể được sử dụng trong bộ lọc con cháu từ EventFilter. Trong bộ lọc giảm dần 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 kết 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 đây:
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 tháng.
betweenFilter

object (BetweenFilter)

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

FunnelBreakdown

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

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

object (Dimension)

Cột phương diện được thêm vào nội dung phản hồi của báo cáo phụ ở 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 cung cấp 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 cần trả về trong nội dung phản hồi. limit là 5 sẽ được sử dụng nếu bạn 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.

FunnelNextAction

Hành động tiếp theo sẽ nêu giá trị cho 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 đó đạt được bước tiếp theo. Ví dụ: nếu nextActionDimension là eventName, thì nextActionDimension trong hàng i bước phễu sẽ trả về sự kiện đầu tiên sau sự kiện khiến người dùng đủ điều kiện bước vào bước 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)

Cột phương diện được thêm vào phần phản hồi cho báo cáo phụ của 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 đã đế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 cần trả về trong nội dung phản hồi. limit là 5 sẽ được sử dụng nếu bạn 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ụ của hình ảnh phễu trong nội dung phản hồi sẽ không chứa ngày.
TRENDED_FUNNEL Phễu (biểu đồ dạng đường) theo xu hướng. Báo cáo phụ của hình ảnh phễu trong nội dung phản hồi sẽ chứa phương diện ngày.

Phân đoạn

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 đoạn khác có thể 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 hoặc 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 của phân đoạn này. Nếu bạn chưa chỉ định, các phân khúc sẽ được đặt tên là "Phân khúc". Tên này xác định giá trị chuỗi do phương diện segment trả về. Tiền tố phương diện segment đặt tên phân khúc 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 kết hợp one_segment_scope. Mỗi phân khúc đượ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 đây:
userSegment

object (UserSegment)

Phân khúc người dùng là một nhóm nhỏ 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à một 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à một 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.

UserSegment

Phân khúc người dùng là một nhóm nhỏ 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; những người dùng đã thêm sản phẩm vào giỏ hàng, nhưng không hoàn tất giao dịch mua hàng.

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ừ khỏi phân khúc này. Không bắt buộc.

UserSegmentCriteria

Người dùng 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)

Người dùng đáp ứng 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)

Người dùng đáp ứng 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 bao gồm hoặc 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à phù hợ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ả sự kiện trong một phiên, sau đó, nhóm điều kiện được xác định là phù hợp hoặc không phù hợ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á trên một sự kiện duy nhất, sau đó nhóm điều kiện được xác định là phù hợp hay không phù hợp cho người dùng này.

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

object (SegmentFilterExpression)

Dữ liệu được bao gồm hoặc 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 sẽ đượ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 chỉ định.
USER_CRITERIA_WITHIN_SAME_EVENT Nếu tiêu chí được đáp ứng trong một sự kiện, thì người dùng khớp với tiêu chí đó.
USER_CRITERIA_WITHIN_SAME_SESSION Nếu tiêu chí được đáp ứng trong một phiên, thì người dùng khớp với tiêu chí.
USER_CRITERIA_ACROSS_ALL_SESSIONS Nếu bất kỳ sự kiện nào cho người dùng đáp ứng tiêu chí, thì người dùng đó 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 đoạn.

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 kết 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 đây:
andGroup

object (SegmentFilterExpressionList)

SegmentFilterExpression trong andGroup có quan hệ AND.
orGroup

object (SegmentFilterExpressionList)

SegmentFilterExpression trong orGroup có quan hệ OR.
notExpression

object (SegmentFilterExpression)

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

object (SegmentFilter)

Bộ lọc phân khúc gốc.
segmentEventFilter

object (SegmentEventFilter)

Tạo bộ lọc 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ỏ các sự kiện khớp với cả tên sự kiện 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 khúc

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 kết 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 đây:
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 tháng.
betweenFilter

object (BetweenFilter)

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

SegmentFilterScoping

Phạm vi cho biết cách phương diện & Bạn nên xem xét chỉ số của nhiều sự kiện khi đánh giá 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 đúng, bộ lọc này sẽ đánh giá là đúng cho tất cả sự kiện nếu bộ lọc này đánh giá là đúng cho bất kỳ sự kiện nào 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 các sự kiện trong báo cáo. Nếu giá trị atAnyPointInTime là true, 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 của tiêu chí là ACROSS_ALL_SESSIONS và không thể 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 bạn không chỉ định.

SegmentEventFilter

Tạo bộ lọc 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ỏ các sự kiện khớp với cả tên sự kiện 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 một tên sự kiện 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ẽ khớp với các sự kiện khớp với cả tên sự kiện và biểu thức lọc thông số.

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

SegmentParameterFilterExpression

Thể hiện các tổ hợp bộ lọc phân đoạn 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 kết 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 đây:
andGroup

object (SegmentParameterFilterExpressionList)

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

object (SegmentParameterFilterExpressionList)

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

object (SegmentParameterFilterExpression)

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

object (SegmentParameterFilter)

Bộ lọc tham số phân khúc gốc.

SegmentParameterFilterExpressionList

Danh sách các biểu thức lọc thông số của phân khúc.

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 thông số của phân khúc.

SegmentParameterFilter

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 kết 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 đây:
eventParameterName

string

Bộ lọc này sẽ được đánh giá dựa trên thông số sự kiện đã chỉ định. Các 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ể sử dụng thông số sự kiện trong các phân đoạn và kênh và chỉ có thể được sử dụng trong bộ lọc con cháu từ EventFilter. Trong bộ lọc giảm dần 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 đã 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ể sử dụng thông số mặt hàng trong phân đoạn và kênh và chỉ có thể được sử dụng trong bộ lọc con cháu từ EventFilter. Trong bộ lọc giảm dần 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 kết 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 đây:
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 tháng.
betweenFilter

object (BetweenFilter)

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

SegmentParameterFilterScoping

Phạm vi cho biết cách xem xét nhiều sự kiện khi đánh giá 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 tính theo ngày 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ố sự kiện của sự kiện mua hàng trong mỗi 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ố sự kiện mua hàng của họ vượt quá 5 sự kiện trong khoảng thời gian 3 ngày liên tiếp bất kỳ. Ví dụ: các khoảng thời gian từ 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 nhằm mục đích có đủ N ngày gần thời điểm bắt đầu phạm vi ngày đó. Ví dụ: nếu báo cáo cho khoảng thời gian từ 01/11/2021 đến 10/11/2021 và inAnyNDayPeriod = 3, thì khoảng thời gian 2 ngày đầu tiên sẽ được rút ngắn hiệu quả vì hệ thống sẽ không đọc dữ liệu sự kiện nằm ngoài phạm vi ngày của báo cáo. Ví dụ: bốn khoảng thời gian đầu tiên sẽ có hiệu quả 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-02 đến 2021-11-02 đến 2021-11-02

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

UserSegmentSequenceGroup

Xác định các điều kiện phải xảy ra theo thứ tự cụ thể để người dùng là 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)

Tất cả các bước trình tự phải được đáp ứng trong phạm vi để người dùng khớp với trình tự. Ví dụ: nếu là sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, tất cả các bước 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 bạn chưa chỉ định, 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 micrô 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 thành 5 giây và 1 micrô giây.

Bạn không bắt buộc phải sử dụng sequenceMaximumDuration. Nếu bạn không chỉ định, người dùng có thể hoàn thành trình tự bất cứ lúc nào.

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

object (UserSequenceStep)

Một trình tự theo thứ tự 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 đượ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 thoả mãn bước này phải là sự kiện tiếp theo sau sự kiện làm thoả mãn bước cuối cùng. Nếu sai, bước này gián tiếp đứng sau bước trước đó; ví dụ: có thể có sự kiện giữa bước trước đó và bước này. isDirectlyFollowedBy phải có giá trị là false đối với bước đầu tiên.
stepScoping

enum (UserCriteriaScoping)

Bước trình tự này phải được đáp ứng trong phạm vi để người dùng khớp với trình tự. Ví dụ: nếu là sequenceScoping = WITHIN_SAME_SESSION, 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 bạn không chỉ định, stepScoping sẽ sử dụng cùng một UserCriteriaScoping với sequenceScoping.
segmentFilterExpression

object (SegmentFilterExpression)

Một người dùng khớp với bước trình tự này 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ừ khỏi 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 quy tắc loại trừ nếu người dùng khớp với userExclusionCriteria.

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

object (UserSegmentCriteria)

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

UserExclusionDuration

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

Enum
USER_EXCLUSION_DURATION_UNSPECIFIED Thời lượng loại trừ chưa được chỉ định. Không chỉ định.
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 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 đá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 các phiên đượ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 phù hợp với tiêu chí này nếu phiên đó khớp với từng andConditionGroups này.

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 bao gồm hoặc 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à phù hợ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ả sự kiện trong một phiên, sau đó, nhóm điều kiện được xác định là có khớp hay không cho phiên này. Ví dụ: nếu conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, biểu thức được đánh giá trên một sự kiện, sau đó nhóm điều kiện được xác định là có khớp hay không cho phiên này.

Không bắt buộc. Nếu bạn chưa chỉ định, conditionScoping của WITHIN_SAME_SESSION sẽ được sử dụng.
segmentFilterExpression

object (SegmentFilterExpression)

Dữ liệu được bao gồm hoặc 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 sẽ được xem xét khi đánh giá xem một phiên hoạt động 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 chỉ định.
SESSION_CRITERIA_WITHIN_SAME_EVENT Nếu tiêu chí được đáp ứng trong một sự kiện, thì phiên hoạt động đó khớp với tiêu chí.
SESSION_CRITERIA_WITHIN_SAME_SESSION Nếu tiêu chí được đáp ứng trong một phiên, thì phiên đó sẽ khớp với tiêu chí.

SessionSegmentExclusion

Chỉ định những phiên bị loại trừ trong phân đoạn 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 áp dụng quy tắc loại trừ nếu một phiên khớp với sessionExclusionCriteria.

Không bắt buộc. Nếu bạn chưa chỉ định, sessionExclusionDuration của SESSION_EXCLUSION_TEMPORARY sẽ được sử dụng.
sessionExclusionCriteria

object (SessionSegmentCriteria)

Nếu một phiên đáp ứng điều kiện này, thì 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 lựa chọn về khoảng thời gian loại trừ sẽ kéo dài nếu một phiên khớp với sessionExclusionCriteria.

Enum
SESSION_EXCLUSION_DURATION_UNSPECIFIED Thời lượng loại trừ chưa được chỉ định. Không chỉ định.
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 đó đáp ứng điều kiện sessionExclusionCriteria.

EventSegment

Phân khúc sự kiện là một 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ả sự kiện mua hàng được thực hiện tại một địa điểm 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 khúc 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 khớp với một tiêu chí nếu đá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 khớp với tiêu chí này nếu khớp với từng andConditionGroups dưới đây.

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 bạn chưa chỉ định, conditionScoping của EVENT_CRITERIA_WITHIN_SAME_EVENT sẽ được sử dụng.
segmentFilterExpression

object (SegmentFilterExpression)

Dữ liệu được bao gồm hoặc 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

Tính năng xác định phạm vi cho biết những sự kiện nào sẽ đượ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 chỉ định.
EVENT_CRITERIA_WITHIN_SAME_EVENT Nếu một sự kiện đáp ứng các tiêu chí, thì sự kiện đó khớp với các 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 bạn chưa chỉ định, eventExclusionDuration của EVENT_EXCLUSION_PERMANENT sẽ được sử dụng.
eventExclusionCriteria

object (EventSegmentCriteria)

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

EventExclusionDuration

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

Enum
EVENT_EXCLUSION_DURATION_UNSPECIFIED Thời lượng loại trừ chưa được chỉ định. Không chỉ định.
EVENT_EXCLUSION_PERMANENT Loại trừ vĩnh viễn các sự kiện khỏi phân đoạn nếu sự kiện đó đáp ứng điều kiện eventExclusionCriteria.

FunnelSubReport

Báo cáo phụ phễu chứa 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 các phản hồi của 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 câu trả lờ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 các phản hồi của báo cáo phụ. Bảng phễu bao gồm các chỉ số khác như tỷ lệ hoàn thành, tỷ lệ bỏ ngang và tỷ lệ bỏ ngang.
rows[]

object (Row)

Các hàng gồm các 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.

FunnelResponseMetadata

Siêu dữ liệu phản hồi của báo cáo phễu chứa thêm thông tin 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ì chỉ số 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 để bạn chỉ định các phạm vi ngày trong yêu cầu.

Tuy nhiên, nếu kết quả không được lấy mẫu thì 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 mô tả tỷ lệ phần trăm sự kiện được dùng trong báo cáo phễu này cho 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 trong báo cáo được lấy mẫu này trong một phạm vi ngày. Đây là kích thước 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 trong một phạm vi ngày. Việc lấy mẫu phát hiện 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 dùng trong báo cáo phễu này, hãy tính toán samplesReadCount/samplingSpaceSize.

PropertyQuota

Trạng thái hiện tại của tất 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ả yêu cầu đối với tài sản đó sẽ trả về lỗi Đã hết tài nguyên.

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ờ. Một yêu cầu API sẽ sử dụng một số lượng mã thông báo duy nhất 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 dự án.
concurrentRequests

object (QuotaStatus)

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

object (QuotaStatus)

Các tài sản Analytics chuẩn và cặp 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à cặp 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 những 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 các phương diện có thể đạt đến ngưỡng.
tokensPerProjectPerHour

object (QuotaStatus)

Mỗi giờ, tài sản Analytics có thể sử dụng tối đa 35% mã thông báo cho mỗi dự án. Số lượng này đối với 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ờ. Một yêu cầu API sẽ sử dụng một số lượng mã thông báo duy nhất 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 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.