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 trả về từ API ở dạng bảng có các cột cho các 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 Dữ liệu 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

Tham số
property

string

Không bắt buộc. Mã 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 trong phần 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, thuộc tính này phải không được chỉ định hoặc 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 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 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 phải có 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 chi tiết này mở rộng mỗi bước phễu thành các giá trị riêng biệt của phương diện chi tiết. Ví dụ: bảng chi tiết theo phương diện deviceCategory sẽ tạo các hàng cho mobile, tablet, desktop và tổ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 báo cáo phụ về hình ảnh phễu. Phương diện hành động tiếp theo này mở rộng mỗi 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_startclick) và tổng số.

Thao tác tiếp theo chỉ hỗ trợ eventName và hầu hết các phương diện Trang / Màn hình như pageTitlepagePath.

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 phản hồi báo cáo phụ về hình ảnh phễu. 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 đoạn. Phân đoạn là một nhóm nhỏ dữ liệu của một tài sản. Trong báo cáo phễu có các phân đoạn, phễu sẽ đượ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 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ố segments. Yêu cầu chỉ được giới hạn ở 4 phân khúc.

limit

string (int64 format)

Không bắt buộc. Số lượng hàng sẽ trả về. Nếu không chỉ định, 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 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 để biết ví dụ. Không thể sử dụng chỉ số trong bộ lọc này.

returnPropertyQuota

boolean

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

Nội dung phản hồi

Phản hồi báo cáo phễu chứa hai báo cáo phụ. Hai báo cáo phụ là các tổ hợp khác nhau củ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 khúc, phương diện chi tiết, người dùng đang hoạt động, tỷ lệ hoàn tất, 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 phễu, phân khúc, 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 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 bạn 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 bạn 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 phễu mở, người dùng có thể tham gia phễu ở bất kỳ bước nào, còn trong phễu kín, người dùng phải tham gia phễu ở bước đầu tiên. Không bắt buộc. Nếu bạn không chỉ định, hệ thống sẽ sử dụng 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 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 theo sau bước trước đó. Nếu giá trị là false, thì có thể có cá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à sai.

filterExpression

object (FunnelFilterExpression)

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

withinDurationFromPriorStep

string (Duration format)

Nếu được chỉ định, bước này phải hoàn tất trong khoảng thời gian hoàn tất bước trước. withinDurationFromPriorStep bao gồm cả điểm cuối ở mức độ chi tiết micro giây. Ví dụ: thời lượng 5 giây có thể kết thúc ở 4,9 hoặc 5 giây, nhưng không phải 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 theo bất kỳ khoảng thời gian nào.

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

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

FunnelFieldFilter

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 hợp hợp nhất one_filter. Chỉ định một loại bộ lọc. one_filter chỉ có thể là một trong những giá trị 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 giá trị số hoặc 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ủa một tên sự kiện. Nếu bạn chỉ định một biểu thức bộ lọc thông số, thì chỉ một nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức 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 khớp với 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 các sự kiện khớp với cả tên sự kiện đơn và biểu thức bộ lọc thông số.

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

FunnelParameterFilterExpression

Biểu thị các tổ hợp bộ lọc phễu 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 (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Trường
Trường hợp hợp nhất expr. Chỉ định một loại bộ lọc cho FunnelParameterFilterExpression. expr chỉ có thể là một trong những giá trị 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 phải là notExpression.

funnelParameterFilter

object (FunnelParameterFilter)

Bộ lọc tham số phễu gốc.

FunnelParameterFilterExpressionList

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

FunnelParameterFilter

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

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

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

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Trường
Trường hợp hợp nhất one_parameter. Trường đang được lọc. one_parameter chỉ có thể là một trong những giá trị 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. 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 khúc và phễu, đồng thời chỉ có thể sử dụng trong bộ lọc con từ một EventFilter. Trong bộ lọc con từ EventFilter, bạn nên sử dụng thông số sự kiện hoặc 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 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. Tham 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 tham số mặt hàng trong các phân khúc và phễu, đồng thời chỉ có thể sử dụng trong bộ lọc con từ một EventFilter. Trong bộ lọc con từ EventFilter, bạn nên sử dụng thông số sự kiện hoặc thông số mặt hàng.

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ề sự kiện thương mại điện tử, hãy xem hướng dẫn Đo lường sự kiện thương mại điện tử.

Trường hợp hợp nhất one_filter. Chỉ định một loại bộ lọc. one_filter chỉ có thể là một trong những giá trị 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 giá trị số hoặc ngày.

betweenFilter

object (BetweenFilter)

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

FunnelBreakdown

Bảng chi tiết sẽ thêm một phương diện vào phản hồi báo cáo phụ dạng 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 chi tiết 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 chi tiết cần trả về trong phản hồi. Hệ thống sẽ sử dụng limit của 5 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

Hành động 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 nextActionDimensioneventName, thì nextActionDimension trong hàng bước phễu thứ i sẽ trả về sự kiện đầu tiên sau sự kiện giúp người dùng đủ điều kiện bước vào bước phễu thứ i nhưng trước khi người dùng đạt được bước 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ụ trực quan hoá 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 đến bước thứ i trong phễu.

nextActionDimension hiện chỉ hỗ trợ eventName và hầu hết các phương diện Trang / Màn hình như pageTitlepagePath. nextActionDimension không được là 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 chi tiết cần trả về trong phản hồi. Hệ thống sẽ sử dụng limit của 5 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 báo cáo phụ trực quan hoá 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ụ trực quan hoá phễu 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á phễu 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 đoạn.

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 không chỉ định, các phân đoạn sẽ được đặt tên là "Phân đoạn". Tên này xác định giá trị chuỗi do phương diện segment trả về. Phương diện segment thêm tiền tố vào 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 hợp hợp nhất 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 giá trị 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 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 thuộc 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 khớp với tiêu chí này nếu người dùng khớp với từng andConditionGroups và từng andSequenceGroups. andConditionGroups có thể trống nếu bạn chỉ định andSequenceGroups.

andSequenceGroups[]

object (UserSegmentSequenceGroup)

Người dùng khớp với tiêu chí này nếu người dùng khớp với từng andSequenceGroups 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 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 bị loại trừ khỏi phân khúc dựa trên việc dữ liệu đó có khớp với nhóm điều kiện hay không. Phạm vi này xác định số lượng sự kiện mà segmentFilterExpression được đánh giá trước khi xác định nhóm điều kiện có 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 sẽ được xác định là khớp hay không khớp với người dùng này. Ví dụ: nếu là 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 sẽ được xác định là khớp hay không khớp với người dùng này.

Không bắt buộc. Nếu 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 bị loại trừ khỏi phân khúc dựa trên việc dữ liệu đó có khớp với biểu thức này hay không. Biểu thức thể hiện tiêu chí về 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 đáp ứng tiêu chí trong một sự kiện, thì người dùng sẽ khớp với 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 bất kỳ sự kiện nào của người dùng đều đáp ứng tiêu chí, thì người dùng đó 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 hợp hợp nhất expr. Chỉ định một loại bộ lọc cho SegmentFilterExpression. expr chỉ có thể là một trong những giá trị 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 phải là notExpression.

segmentFilter

object (SegmentFilter)

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

segmentEventFilter

object (SegmentEventFilter)

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

SegmentFilterExpressionList

Danh sách 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

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 hợp hợp nhất one_filter. Chỉ định một loại bộ lọc cho Filter. one_filter chỉ có thể là một trong những giá trị 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 giá trị số hoặc 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á 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ả 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.

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 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 trình tự.

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

SegmentEventFilter

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

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

SegmentParameterFilterExpression

Biểu thị các tổ hợp bộ lọc phân khúc 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 hợp hợp nhất expr. Chỉ định một loại bộ lọc cho SegmentParameterFilterExpression. expr chỉ có thể là một trong những giá trị 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 phải là notExpression.

segmentParameterFilter

object (SegmentParameterFilter)

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

SegmentParameterFilterExpressionList

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

SegmentParameterFilter

Biểu thức để lọc giá trị tham số trong một phân khúc.

Biểu diễn dưới dạng JSON
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

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

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

object (SegmentParameterFilterScoping)

Chỉ định phạm vi cho bộ lọc.

Trường hợp hợp nhất one_parameter. Trường đang được lọc. one_parameter chỉ có thể là một trong những giá trị 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. 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 khúc và phễu, đồng thời chỉ có thể sử dụng trong bộ lọc con từ một EventFilter. Trong bộ lọc con từ EventFilter, bạn nên sử dụng thông số sự kiện hoặc 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 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. Tham 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 tham số mặt hàng trong các phân khúc và phễu, đồng thời chỉ có thể sử dụng trong bộ lọc con từ một EventFilter. Trong bộ lọc con từ EventFilter, bạn nên sử dụng thông số sự kiện hoặc thông số mặt hàng.

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ề sự kiện thương mại điện tử, hãy xem hướng dẫn Đo lường sự kiện thương mại điện tử.

Trường hợp hợp nhất one_filter. Chỉ định một loại bộ lọc. one_filter chỉ có thể là một trong những giá trị 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 giá trị số hoặc 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 khúc.

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 đã chỉ định trước khi áp dụng bộ lọc. Chỉ được hỗ trợ nếu phạm vi tiêu chí là ACROSS_ALL_SESSIONS hoặc WITHIN_SAME_SESSION. Chỉ được hỗ trợ nếu tham số là event_count.

Ví dụ: nếu inAnyNDayPeriod là 3, eventName là "purchase", thông số sự kiện là "event_count" và tiêu chí của Bộ lọc lớn hơn 5, thì bộ lọc này sẽ tích luỹ số 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 khúc này nếu số sự kiện mua hàng của họ vượt quá 5 trong bất kỳ khoảng thời gian 3 ngày liên tiếp nào. Ví dụ: các khoảng thời gian từ ngày 1 tháng 11 năm 2021 đến ngày 3 tháng 11 năm 2021, từ ngày 2 tháng 11 năm 2021 đến ngày 4 tháng 11 năm 2021, từ ngày 3 tháng 11 năm 2021 đến ngày 5 tháng 11 năm 2021, v.v. sẽ được xem xét.

Phạm vi ngày không được mở rộng để có đượ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 báo cáo là từ ngày 1 tháng 11 năm 2021 đến ngày 10 tháng 11 năm 2021 và inAnyNDayPeriod = 3, thì khoảng thời gian hai ngày đầu tiên sẽ được rút ngắn hiệu quả vì không có dữ liệu sự kiện nào nằm ngoài phạm vi ngày của báo cáo sẽ được đọc. Ví dụ: 4 khoảng thời gian đầu tiên sẽ có hiệu lực là: 1/11/2021 đến 1/11/2021, 1/11/2021 đến 2/11/2021, 1/11/2021 đến 3/11/2021 và 2/11/2021 đến 4/11/2021.

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 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)

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

Không bắt buộc. Nếu không chỉ định, 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 cả điểm cuối ở mức độ chi tiết micro giây. Ví dụ: một trình tự có thời lượng tối đa là 5 giây có thể hoàn tất ở 4,9 hoặc 5 giây, nhưng không thể hoàn tất ở 5 giây và 1 micro giây.

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

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

Trình tự có thứ tự của các bước điều kiện. Sự kiện của người dùng phải hoàn tất từng bước để người dùng khớp với UserSegmentSequenceGroup.

UserSequenceStep

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

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

boolean

Nếu đúng, sự kiện đáp ứng bước này phải là sự kiện tiếp theo sau sự kiện đáp ứng bước cuối cùng. Nếu giá trị là false, thì 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)

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 trong trình tự này phải hoàn tất 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 sequenceScoping = ACROSS_ALL_SESSIONS.

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

segmentFilterExpression

object (SegmentFilterExpression)

Người dùng sẽ khớp với bước trình tự này nếu 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 lượng của một tiêu chí loại trừ nếu người dùng khớp với userExclusionCriteria.

Không bắt buộc. Nếu không chỉ định, 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 danh sách thành viên trong phân khúc cho userExclusionDuration.

UserExclusionDuration

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

Enum
USER_EXCLUSION_DURATION_UNSPECIFIED Thời lượng loại trừ không đượ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 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 hoạt động có trong phân khúc này. Không bắt buộc.

exclusion

object (SessionSegmentExclusion)

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

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

segmentFilterExpression

object (SegmentFilterExpression)

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

SessionCriteriaScoping

Phạm vi xác đị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ẽ khớp với tiêu chí.
SESSION_CRITERIA_WITHIN_SAME_SESSION Nếu đáp ứng tiêu chí trong một phiên, thì phiên đó sẽ khớp với tiêu chí.

SessionSegmentExclusion

Chỉ định những phiên hoạt động 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 lượng của một tiêu chí loại trừ nếu một phiên khớp với sessionExclusionCriteria.

Không bắt buộc. Nếu không chỉ định, hệ thống sẽ sử dụng sessionExclusionDuration của 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 thành viên trong phân khúc của sessionExclusionDuration.

SessionExclusionDuration

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

Enum
SESSION_EXCLUSION_DURATION_UNSPECIFIED Thời lượng loại trừ không đượ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 khúc trong những 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ó trong 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 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 không chỉ định, hệ thống sẽ sử dụng conditionScoping của EVENT_CRITERIA_WITHIN_SAME_EVENT.

segmentFilterExpression

object (SegmentFilterExpression)

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

EventCriteriaScoping

Việc xác định 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 một sự kiện đáp ứng tiêu chí, thì sự kiện đó khớp với tiêu chí.

EventSegmentExclusion

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

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

enum (EventExclusionDuration)

eventExclusionDuration phải luôn là PERMANENTLY_EXCLUDE.

Không bắt buộc. Nếu không chỉ định, hệ thống sẽ sử dụng eventExclusionDuration của 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 đưa vào gói hội viên trong phân khúc của eventExclusionDuration.

EventExclusionDuration

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

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

FunnelSubReport

Báo cáo phụ của phễu chứa các giá trị dữ liệu phương diện và chỉ số. Ví dụ: 12 người dùng đã đạ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 bổ sung như thông tin chi tiết, ngày và hành động tiếp theo có thể xuất hiện trong phản hồi nếu được yêu cầu.

metricHeaders[]

object (MetricHeader)

Mô tả các cột chỉ số. Báo cáo phễu luôn bao gồm người dùng đang hoạt động trong 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, số lượt bỏ ngang và tỷ lệ bỏ ngang.

rows[]

object (Row)

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

metadata

object (FunnelResponseMetadata)

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

FunnelResponseMetadata

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

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

object (SamplingMetadata)

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