Method: properties.runFunnelReport

Trả về một 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ề là một 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 trong 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. Để gửi ý kiến phản hồi về API này, hãy hoàn tất biểu mẫu 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

Thông số
property

string

Không bắt buộc. Giá trị nhận dạng tài sản 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 bài viết nơi tìm mã tài sản. Trong một yêu cầu hàng loạt, bạn không nên chỉ định thuộc tính này hoặc phải chỉ định nhất quán với thuộc tính ở cấp lô.

Ví dụ: properties/1234

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với 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 dải ngày, mỗi hàng phản hồi sẽ chứa một chỉ mục dải ngày dựa trên số 0. Nếu hai phạm vi ngày trùng nhau, dữ liệu sự kiện cho những ngày trùng nhau 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 trong yêu cầu này. Bạn phải thiết lập cấu hình 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 phản hồi báo cáo phụ của bảng phễu. Phương diện phân tích này mở rộng từng bước trong phễu thành các giá trị riêng biệt của phương diện phân tích. Ví dụ: khi phân tích chi tiết theo phương diện deviceCategory, bạn sẽ tạo 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, thao tác tiếp theo sẽ thêm một phương diện vào phản hồi báo cáo phụ trực quan hoá phễu. Phương diện hành động tiếp theo sẽ 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ụ: hành động tiếp theo của phương diện eventName sẽ tạo các hàng cho một số sự kiện (ví dụ: session_start và click) và tổng số.

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 trực quan hoá kênh kiểm soát các phương diện có trong phản hồi báo cáo phụ trực quan hoá kênh. Nếu không chỉ định, hệ thống sẽ sử dụng STANDARD_FUNNEL.
segments[]

object (Segment)

Không bắt buộc. Cấu hình của các phân khúc. Phân đoạn là tập hợp con của 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 ra một hàng riêng biệt trong phản hồi; trong phản hồi, mỗi phân đoạn được xác định bằng tên của phân đoạn đó.

Bạn không bắt buộc phải sử dụng tham số phân khú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 sẽ trả về. Nếu bạn không chỉ định, 10.000 hàng sẽ được trả về. API này 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. 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 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 bài viết Tạo báo cáo: Bộ lọc phương diện để xem ví dụ. Bạn không thể sử dụng chỉ số trong bộ lọc này.
returnPropertyQuota

boolean

Không bắt buộc. Chuyển đổi để trả về trạng thái hiện tại của hạn mức Tài sản Analytics này hay không. 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à các tổ hợp phương diện và chỉ số khác nhau.

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 trong phễu, phân khúc, phương diện phân tích, số người dùng đang hoạt động, tỷ lệ hoàn thành, số lượt 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 bạn yêu cầu một phân đoạn. Phương diện chi tiết chỉ xuất hiện trong phản hồi này nếu bạn yêu cầu.
funnelVisualization

object (FunnelSubReport)

Hình ảnh hoá phễu là một báo cáo có bước trong phễu, phân khúc, ngày, phương diện hành động tiếp theo và số 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 bạn yêu cầu một phân đoạn. 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 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 này. 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:

  • 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 chuỗi 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 kín, 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, hệ thống sẽ sử dụng một phễu kín.
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 cần 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 bạn không chỉ định, các bước sẽ được đặt tên theo 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 thứ ba của phễu trong 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 diễn ra ngay sau bước trước đó. Nếu là false, có thể có các sự kiện giữa bước trước và bước này. Nếu bạn không 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, bước này phải hoàn tất trong khoảng thời gian này kể từ khi bước trước đó hoàn tất. withinDurationFromPriorStep bao gồm điểm cuối ở độ chi tiết đến từng phần triệu giây. Ví dụ: thời lượng 5 giây có thể hoàn thành ở 4,9 hoặc 5 giây, nhưng không thể hoàn thành ở 5 giây và 1 micro giây.

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

Thời lượng tính bằng giây, có 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 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 nhóm 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)

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

object (FunnelFilterExpressionList)

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

object (FunnelFilterExpression)

FunnelFilterExpression 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 một bộ lọc khớp với các sự kiện có một tên sự kiện duy nhất. Nếu bạn chỉ định một biểu thức bộ lọc thông số, thì chỉ những nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức bộ 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 bộ 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 bộ lọc phễu.

FunnelFieldFilter

Một biểu thức để lọc giá trị phương diệ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 nhóm 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 giá trị ngày.
betweenFilter

object (BetweenFilter)

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

FunnelEventFilter

Tạo một bộ lọc khớp với các sự kiện có một tên sự kiện duy nhất. Nếu bạn chỉ định một biểu thức bộ lọc thông số, thì chỉ những nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức bộ 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 so khớp các sự kiện có 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 bộ lọc thông số.

Trong biểu thức bộ lọc tham số, chỉ có bộ lọc tham số.

FunnelParameterFilterExpression

Thể hiện các tổ hợp bộ lọc phễu 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 (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Trường
Trường nhóm 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)

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

object (FunnelParameterFilterExpressionList)

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

object (FunnelParameterFilterExpression)

FunnelParameterFilterExpression KHÔNG thuộc notExpression.
funnelParameterFilter

object (FunnelParameterFilter)

Bộ lọc tham số phễu cơ bản.

FunnelParameterFilterExpressionList

Danh sách các biểu thức bộ lọc tham 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 bộ lọc tham số phễu.

FunnelParameterFilter

Một biểu thức để lọc các giá trị tham số trong một 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 nhóm 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 đã chỉ định. Thông số sự kiện được ghi lại dưới dạng thông số của sự kiện. Các thông số sự kiện bao gồm những trường như "firebase_screen" và "currency".

Bạn chỉ có thể sử dụng tham số sự kiện trong phân khúc và phễu, đồng thời chỉ có thể sử dụng tham số này trong bộ lọc con của EventFilter. Trong bộ lọc con của EventFilter, bạn nên sử dụng thông số sự kiện hoặc thông số mặt hàng.
itemParameterName

string

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

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

Thông số mặt hàng chỉ có trong các 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 nhóm 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 giá trị ngày.
betweenFilter

object (BetweenFilter)

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

FunnelBreakdown

Phân tích chi tiết sẽ thêm một phương diện vào phản hồi báo cáo phụ của 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 phản hồi báo cáo phụ của bảng phễu. Phương diện phân tích sẽ phân tích 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 cần trả về trong phản hồi. limit của 5 sẽ được dùng nếu bạn không chỉ định giới hạn. Giới hạn phải lớn hơn 0 và không được vượt quá 15.

FunnelNextAction

Thao tác tiếp theo cho biết giá trị của một phương diện sau khi người dùng hoàn thành 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 đủ điều kiện để người dùng chuyển sang bước trong phễu thứ i nhưng trước khi người dùng đạt được bước trong phễu thứ i+1.

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 hồi báo cáo phụ về hình ảnh phễu. Phương diện hành động tiếp theo 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 được bước phễu thứ i.

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 thể 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 phản hồi. limit của 5 sẽ được dùng nếu bạn không chỉ định giới hạn. Giới hạn phải lớn hơn 0 và không được vượt quá 5.

FunnelVisualizationType

Kiểm soát các phương diện có trong phản hồi của báo cáo phụ trực quan hoá kênh.

Enum
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Loại chưa chỉ định.
STANDARD_FUNNEL Phễu chuẩn (dạng bậc). Báo cáo phụ trực quan hoá kênh trong phản hồi sẽ không chứa ngày.
TRENDED_FUNNEL Phễu theo xu hướng (biểu đồ dạng đường). Báo cáo phụ trực quan hoá kênh trong 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 khúc 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 phần Trình tạo phân khúc.

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 khúc này. Nếu bạn không chỉ định, các phân khúc sẽ có 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ề. Phương diện segment đặt tên phân khúc bằng 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 nhóm one_segment_scope. Một 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à các 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 khúc phiên 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ỏ 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à các 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. Ví dụ: những người dùng đã từng mua hàng; những người dùng đã thêm các mặt hàng vào giỏ hàng nhưng không 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 khớp với một tiêu chí nếu các 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 đáp ứng từng andConditionGroups và từng andSequenceGroups. Bạn có thể để trống andConditionGroups nếu chỉ định andSequenceGroups.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

Người dùng đáp ứng tiêu chí này nếu người dùng đáp ứng từng andSequenceGroups và từng andConditionGroups. Bạn có thể để trống andSequenceGroups nếu 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 khúc.

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

enum (UserCriteriaScoping)

Dữ liệu được đưa vào hoặc loại trừ khỏi phân đoạn 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 sẽ đượ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 hay không khớp với người dùng này. Ví dụ: nếu conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, biểu thức sẽ đượ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à có khớp hay không đối với người dùng này.

Không bắt buộc. Nếu bạn không chỉ định, hệ thống sẽ sử dụng conditionScoping = ACROSS_ALL_SESSIONS.
segmentFilterExpression

object (SegmentFilterExpression)

Dữ liệu được đưa vào hoặc loại trừ khỏi phân đoạn 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ề phương diện, chỉ số và/hoặc thông số.

UserCriteriaScoping

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

Enum
USER_CRITERIA_SCOPING_UNSPECIFIED Phạm vi tiêu chí không xác đị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 sẽ đáp ứng tiêu chí đó.
USER_CRITERIA_WITHIN_SAME_SESSION Nếu đáp ứng tiêu chí trong một phiên, thì người dùng sẽ khớp với tiêu chí.
USER_CRITERIA_ACROSS_ALL_SESSIONS Nếu người dùng có bất kỳ sự kiện nào đáp ứng tiêu chí, thì người dùng đó sẽ khớp với tiêu chí.

SegmentFilterExpression

Thể hiện các tổ hợp 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 nhóm 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)

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

object (SegmentFilterExpressionList)

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

object (SegmentFilterExpression)

SegmentFilterExpression KHÔNG thuộc notExpression.
segmentFilter

object (SegmentFilter)

Bộ lọc phân đoạn cơ bản.
segmentEventFilter

object (SegmentEventFilter)

Tạo một bộ lọc khớp với các sự kiện có một tên sự kiện duy nhất. Nếu bạn chỉ định một biểu thức bộ lọc thông số, thì chỉ những nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức bộ 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 bộ 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 biểu thức bộ lọc phân khúc

SegmentFilter

Một biểu thức để lọc giá trị phương diệ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 nhóm 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 giá trị ngày.
betweenFilter

object (BetweenFilter)

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

SegmentFilterScoping

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

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ả các sự kiện nếu bộ lọc này đánh giá là true cho bất kỳ sự kiện nào trong phạm vi ngày của yêu cầu.

Tham 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 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 tiêu chí là ACROSS_ALL_SESSIONS và không thể chỉ định trong các chuỗi.

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

SegmentEventFilter

Tạo một bộ lọc khớp với các sự kiện có một tên sự kiện duy nhất. Nếu bạn chỉ định một biểu thức bộ lọc thông số, thì chỉ những nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức bộ 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 so khớp các sự kiện có 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 bộ lọc thông số.

Trong biểu thức bộ lọc tham số, chỉ có bộ lọc tham số.

SegmentParameterFilterExpression

Thể hiện các kiểu kết hợp bộ lọc phân đoạn trên các tham 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 nhóm 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)

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 thuộc notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

Bộ lọc tham số phân đoạn nguyên thuỷ.

SegmentParameterFilterExpressionList

Danh sách các biểu thức bộ 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 bộ lọc tham số phân đoạn.

SegmentParameterFilter

Một biểu thức để lọc các giá trị tham 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 nhóm 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 đã chỉ định. Thông số sự kiện được ghi lại dưới dạng thông số của sự kiện. Các thông số sự kiện bao gồm những trường như "firebase_screen" và "currency".

Bạn chỉ có thể sử dụng tham số sự kiện trong phân khúc và phễu, đồng thời chỉ có thể sử dụng tham số này trong bộ lọc con của EventFilter. Trong bộ lọc con của EventFilter, bạn nên sử dụng thông số sự kiện hoặc thông số mặt hàng.
itemParameterName

string

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

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

Thông số mặt hàng chỉ có trong các 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 nhóm 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 giá trị ngày.
betweenFilter

object (BetweenFilter)

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

SegmentParameterFilterScoping

Phạm vi chỉ định 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ỹ tham số trong khoảng thời gian đượ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", tham số sự kiện là "event_count" và tiêu chí của Bộ lọc là 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ẽ đáp ứng tiêu chí của Bộ lọc này để được đưa vào phân khúc 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 từ ngày 1/11/2021 đến ngày 3/11/2021, từ ngày 2/11/2021 đến ngày 4/11/2021, từ ngày 3/11/2021 đến ngày 5/11/2021, v.v. sẽ được xem xét.

Phạm vi ngày không được mở rộng để có khoảng thời gian N ngày đầy đủ gần với ngày bắt đầu của phạm vi ngày. Ví dụ: nếu một báo cáo có phạm vi từ 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ẽ bị rút ngắn vì không có dữ liệu sự kiện nào bên ngoài phạm vi ngày của báo cáo được đọc. Ví dụ: 4 khoảng thời gian đầu tiên sẽ là: 01/11/2021 đến 01/11/2021, 01/11/2021 đến 02/11/2021, 01/11/2021 đến 03/11/2021 và 02/11/2021 đến 04/11/2021.

inAnyNDayPeriod là không bắt buộc. Nếu bạn không 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 một 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)

Người dùng phải đáp ứng tất cả các bước trong chuỗi để khớp với chuỗi. Ví dụ: nếu là sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, người dùng phải hoàn tất tất cả các bước trong chuỗi trong một phiên để khớp với chuỗi. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT không được hỗ trợ.

Không bắt buộc. Nếu bạn không chỉ định, hệ thống sẽ sử dụng conditionScoping = ACROSS_ALL_SESSIONS.
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 đến từng 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ể hoàn thành ở 4,9 hoặc 5 giây, nhưng không thể hoàn thành ở 5 giây và 1 micro giây.

sequenceMaximumDuration là không bắt buộc và nếu không được chỉ định, các chuỗi có thể được hoàn thành trong khoảng thời gian bất kỳ.

Thời lượng tính bằng giây, có 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 chuỗi có thứ tự gồm các bước điều kiện. Người dùng phải hoàn tất từng bước trong sự kiện để có thể 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 đáp ứng bước này phải là sự kiện tiếp theo ngay sau sự kiện đáp ứng bước cuối cùng. Nếu là false, bước này 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)

Người dùng phải đáp ứng bước này trong phạm vi để khớp với chuỗi. Ví dụ: nếu là sequenceScoping = WITHIN_SAME_SESSION, thì người dùng phải hoàn tất các bước trong chuỗi này trong một phiên để khớp với chuỗi. Bạn chỉ được sử dụng stepScoping = ACROSS_ALL_SESSIONS nếu sequenceScoping = ACROSS_ALL_SESSIONS.

Không bắt buộc. Nếu bạn không chỉ định, stepScoping sẽ dùng cùng UserCriteriaScoping với sequenceScoping.
segmentFilterExpression

object (SegmentFilterExpression)

Người dùng sẽ khớp với bước này trong chuỗi 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ề phương diệ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 thời gian 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, hệ thống sẽ sử dụng userExclusionDuration của USER_EXCLUSION_TEMPORARY.
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 cho userExclusionDuration.

UserExclusionDuration

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

Enum
USER_EXCLUSION_DURATION_UNSPECIFIED Thời gian loại trừ không xác định. Không chỉ định.
USER_EXCLUSION_TEMPORARY Loại trừ tạm thời người dùng khỏi phân khúc trong các khoảng thời gian mà 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 khúc phiên 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 được đưa vào phân khúc 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 khúc này. Không bắt buộc.

SessionSegmentCriteria

Một phiên sẽ khớp với 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 hoạt động đáp ứng tiêu chí này nếu phiên hoạt động đó đáp ứng từng andConditionGroups trong số 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 khúc.

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

enum (SessionCriteriaScoping)

Dữ liệu được đưa vào hoặc loại trừ khỏi phân đoạn 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 sẽ đượ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 hay không cho phiên này. Ví dụ: nếu conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, biểu thức sẽ đượ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à khớp hay không khớp cho phiên này.

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

object (SegmentFilterExpression)

Dữ liệu được đưa vào hoặc loại trừ khỏi phân đoạn 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ề phương diện, chỉ số và/hoặc thông số.

SessionCriteriaScoping

Phạm vi chỉ định những sự kiện đượ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í không xác đị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 đó sẽ đáp ứng 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ẽ đáp ứng tiêu chí.

SessionSegmentExclusion

Chỉ đị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 thời gian loại trừ nếu một phiên trùng khớp với sessionExclusionCriteria.

Không bắt buộc. Nếu bạn không chỉ định, 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, 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ề thời gian loại trừ nếu một phiên trùng khớp với sessionExclusionCriteria.

Enum
SESSION_EXCLUSION_DURATION_UNSPECIFIED Thời gian loại trừ không xác đị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 mà 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 khúc 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 ở 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 sẽ khớp với 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 khớp với tiêu chí này nếu sự kiện đó khớp với từng andConditionGroups nà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 khúc.

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 không chỉ định, 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 loại trừ khỏi phân đoạn 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ề phương diện, chỉ số và/hoặc thông số.

EventCriteriaScoping

Phạm vi chỉ định những sự kiện đượ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í không xác định. Không chỉ định.
EVENT_CRITERIA_WITHIN_SAME_EVENT Nếu tiêu chí được đáp ứng trong một sự kiện, thì sự kiện đó sẽ đáp ứng 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 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, thì sự kiện đó sẽ không được tính vào thành viên của phân khúc cho 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 trùng khớp với eventExclusionCriteria.

Enum
EVENT_EXCLUSION_DURATION_UNSPECIFIED Thời gian loại trừ không xác đị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 đó từng đáp ứng điều kiện eventExclusionCriteria.

FunnelSubReport

Báo cáo phụ về phễu chứa các giá trị dữ liệu về phương diện và chỉ số. Ví dụ: 12 người dùng đã đạt đế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 trong phễu trong các phản hồi của báo cáo phụ. Các phương diện khác như thông tin chi tiết, ngày và thao tác 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 các phản hồi của báo cáo phụ. Bảng phễu có thêm các chỉ số như tỷ lệ hoàn thành, số lượt bỏ dở và tỷ lệ bỏ dở.
rows[]

object (Row)

Các hàng gồm tổ hợp giá trị thứ nguyê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 kênh mang thông tin bổ sung về báo cáo kênh.

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 kênh được lấy mẫu, thì chỉ số này mô tả tỷ lệ phần trăm sự kiện được dùng trong báo cáo kênh này. Một samplingMetadatas được điền sẵ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à các 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, thì trường này sẽ không được xác định.