- Yêu cầu HTTP
- Thông số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Phễu
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- FunnelNextAction
- FunnelVisualizationType
- Phân đoạn
- UserSegment
- UserSegmentCriteria
- UserSegmentConditionGroup
- UserCriteriaScoping
- SegmentFilterExpression
- SegmentFilterExpressionList
- SegmentFilter
- SegmentFilterScoping
- SegmentEventFilter
- SegmentParameterFilterExpression
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion
- UserExclusionDuration
- SessionSegment
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentExclusion
- SessionExclusionDuration
- EventSegment
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration
- FunnelSubReport
- FunnelResponseMetadata
- Hãy làm thử!
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 |
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 ( |
Trường | |
---|---|
date |
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 |
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. |
funnel |
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 |
funnel |
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 Thao tác tiếp theo chỉ hỗ trợ |
funnel |
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 |
segments[] |
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 |
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. API cũng có thể trả về ít hàng hơn |
dimension |
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. |
return |
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 ( |
Trường | |
---|---|
funnel |
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. |
funnel |
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 |
property |
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 |
Xác định loại tài nguyên của thông báo này. |
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 ( |
Trường | |
---|---|
is |
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[] |
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 ( |
Trường | |
---|---|
name |
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 |
is |
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, |
filter |
Đ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. |
within |
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.
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 " |
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 |
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: |
|
and |
FunnelFilterExpression trong |
or |
FunnelFilterExpression trong |
not |
FunnelFilterExpression KHÔNG phải là |
funnel |
Bộ lọc phễu cho một phương diện hoặc chỉ số. |
funnel |
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 ( |
Trường | |
---|---|
expressions[] |
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 |
Trường | |
---|---|
field |
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: |
|
string |
Bộ lọc liên quan đến chuỗi. |
in |
Bộ lọc cho các giá trị trong danh sách. |
numeric |
Bộ lọc cho giá trị số hoặc ngày. |
between |
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 ( |
Trường | |
---|---|
event |
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. |
funnel |
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 |
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: |
|
and |
FunnelParameterFilterExpression trong |
or |
FunnelParameterFilterExpression trong |
not |
FunnelParameterFilterExpression KHÔNG phải là |
funnel |
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 ( |
Trường | |
---|---|
expressions[] |
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 |
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: |
|
event |
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. |
item |
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: |
|
string |
Bộ lọc liên quan đến chuỗi. |
in |
Bộ lọc cho các giá trị trong danh sách. |
numeric |
Bộ lọc cho giá trị số hoặc ngày. |
between |
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 ( |
Trường | |
---|---|
breakdown |
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ó |
limit |
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 |
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 nextActionDimension
là eventName
, 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 ( |
Trường | |
---|---|
next |
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ứ
|
limit |
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 |
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 |
Trường | |
---|---|
name |
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 |
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: |
|
user |
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. |
session |
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. |
event |
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 ( |
Trường | |
---|---|
user |
Xác định những người dùng thuộc phân khúc này. Không bắt buộc. |
exclusion |
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 ( |
Trường | |
---|---|
and |
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 |
and |
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 |
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 ( |
Trường | |
---|---|
condition |
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à Không bắt buộc. Nếu không chỉ định, hệ thống sẽ sử dụng |
segment |
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 |
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: |
|
and |
SegmentFilterExpression trong |
or |
SegmentFilterExpression trong |
not |
SegmentFilterExpression KHÔNG phải là |
segment |
Bộ lọc phân đoạn gốc. |
segment |
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 ( |
Trường | |
---|---|
expressions[] |
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 ( |
Trường | |
---|---|
field |
Tên phương diện hoặc tên chỉ số. |
filter |
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: |
|
string |
Bộ lọc liên quan đến chuỗi. |
in |
Bộ lọc cho các giá trị trong danh sách. |
numeric |
Bộ lọc cho giá trị số hoặc ngày. |
between |
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 | |
---|---|
at |
Nếu Thông số Bạn chỉ có thể chỉ định Nếu phạm vi tiêu chí là |
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 ( |
Trường | |
---|---|
event |
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. |
segment |
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 |
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: |
|
and |
SegmentParameterFilterExpression trong |
or |
SegmentParameterFilterExpression trong |
not |
SegmentParameterFilterExpression KHÔNG phải là |
segment |
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 ( |
Trường | |
---|---|
expressions[] |
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 ( |
Trường | |
---|---|
filter |
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: |
|
event |
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. |
item |
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: |
|
string |
Bộ lọc liên quan đến chuỗi. |
in |
Bộ lọc cho các giá trị trong danh sách. |
numeric |
Bộ lọc cho giá trị số hoặc ngày. |
between |
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 | |
---|---|
in |
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à Ví dụ: nếu 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à
|
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 ( |
Trường | |
---|---|
sequence |
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à Không bắt buộc. Nếu không chỉ định, hệ thống sẽ sử dụng |
sequence |
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.
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 " |
user |
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 |
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 ( |
Trường | |
---|---|
is |
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. |
step |
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à Không bắt buộc. Nếu không được chỉ định, |
segment |
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 ( |
Trường | |
---|---|
user |
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 Không bắt buộc. Nếu không chỉ định, hệ thống sẽ sử dụng |
user |
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
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 ( |
Trường | |
---|---|
session |
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 |
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 ( |
Trường | |
---|---|
and |
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 |
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 ( |
Trường | |
---|---|
condition |
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à Không bắt buộc. Nếu không chỉ định, hệ thống sẽ sử dụng |
segment |
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 ( |
Trường | |
---|---|
session |
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 Không bắt buộc. Nếu không chỉ định, hệ thống sẽ sử dụng |
session |
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
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 ( |
Trường | |
---|---|
event |
Xác định những sự kiện có trong phân khúc này. Không bắt buộc. |
exclusion |
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 ( |
Trường | |
---|---|
and |
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 |
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 ( |
Trường | |
---|---|
condition |
Không bắt buộc. Nếu không chỉ định, hệ thống sẽ sử dụng |
segment |
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 ( |
Trường | |
---|---|
event |
Không bắt buộc. Nếu không chỉ định, hệ thống sẽ sử dụng |
event |
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
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 ( |
Trường | |
---|---|
dimension |
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. |
metric |
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[] |
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 |
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 ( |
Trường | |
---|---|
sampling |
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 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. |