- Yêu cầu HTTP
- Tham 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 (Loại trừ người dùng)
- UserExclusionDuration
- SessionSegment cho (Phân đoạn phiên hoạt động)
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentExclusion
- SessionExclusionDuration
- EventSegment
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration
- FunnelSubReport
- FunnelResponseMetadata
- SamplingMetadata (Siêu dữ liệu lấy mẫu)
- PropertyQuota
- QuotaStatus
- 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 mà API trả về sẽ ở dạng bảng với các cột cho những phương diện và chỉ số được yêu cầu.
Kỹ thuật khám phá phễu cho phép bạn thể hiện các bước mà người dùng cần thực hiện để hoàn tất một hành động bằng hình ảnh, và xem nhanh mức độ mà họ hoàn tất hoặc không hoàn tất ở mỗi bước. Ví dụ: hành trình mà khách hàng tiềm năng trở thành người mua sắm và sau đó trở thành khách hàng diễn ra như thế nào? Hành trình mà khách hàng mua một lần trở thành khách hàng mua thường xuyên diễn ra như thế nào? Với thông tin này, bạn có thể cải thiện những hành trình không hiệu quả hoặc bị bỏ qua của khách hàng. Để tìm hiểu thêm, hãy xem bài viết Khám phá phễu GA4.
Phương thức này được ra mắt với độ ổn định alpha, nhằm mục đích thu thập thông tin phản hồi về cú pháp và chức năng trước khi chuyển sang giai đoạn thử nghiệm beta. Để cung cấp ý kiến phản hồi về API này, hãy hoàn tất Ý kiến phản hồi về Báo cáo phễu Google Analytics Data API.
Yêu cầu HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số | |
---|---|
property |
Không bắt buộc. Giá trị nhận dạng tài sản GA4 của Google Analytics có các sự kiện được theo dõi. Được chỉ định trong đường dẫn URL chứ không phải trong nội dung. Để tìm hiểu thêm, hãy xem cách tìm mã tài sản của bạn. Trong một yêu cầu theo lô, tài sản này cần phải được chỉ định hoặc nhất quán với tài sản cấp lô. Ví dụ: thuộc tính/1234 |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "dateRanges": [ { object ( |
Trường | |
---|---|
dateRanges[] |
Không bắt buộc. Phạm vi ngày của dữ liệu cần đọc. Nếu bạn yêu cầu nhiều phạm vi ngày, thì mỗi hàng phản hồi sẽ chứa một chỉ mục phạm vi ngày dựa trên 0. Nếu hai phạm vi ngày trùng lặp, thì dữ liệu sự kiện của những ngày bị trùng lặp sẽ được đưa vào các hàng phản hồi cho cả hai phạm vi ngày. |
funnel |
Không bắt buộc. Cấu hình phễu của yêu cầu này. Cấu hình phễu này là bắt buộc. |
funnelBreakdown |
Không bắt buộc. Nếu được chỉ định, bảng chi tiết này sẽ thêm một phương diện vào phản hồi trong báo cáo phụ bảng phễu. Phương diện phân tích này mở rộng từng bước phễu thành các giá trị riêng biệt của phương diện phân tích đó. Ví dụ: bảng chi tiết theo phương diện |
funnelNextAction |
Không bắt buộc. Nếu được chỉ định, hành động tiếp theo sẽ thêm một phương diện vào phản hồi báo cáo phụ của hình ảnh phễu. Phương diện hành động tiếp theo này mở rộng từng bước trong phễu thành các giá trị riêng biệt của hành động tiếp theo. Ví dụ: một hành động tiếp theo của phương diện Hành động tiếp theo chỉ hỗ trợ |
funnelVisualizationType |
Không bắt buộc. Loại hình ảnh phễu kiểm soát các phương diện có trong mục phản hồi báo cáo phụ về hình ảnh phễu. Nếu không chỉ định, |
segments[] |
Không bắt buộc. Cấu hình của phân đoạn. Phân đoạn là các nhóm nhỏ dữ liệu của một tài sản. Trong báo cáo phễu có phân đoạn, phễu sẽ được đánh giá trong từng phân đoạn. Mỗi phân khúc được chỉ định trong yêu cầu này tạo ra một hàng riêng biệt trong phản hồi. Trong phản hồi, mỗi phân khúc được xác định theo tên của phân khúc đó. Thông số phân đoạn là không bắt buộc. Yêu cầu chỉ được có tối đa 4 phân đoạn. |
limit |
Không bắt buộc. Số hàng cần trả về. Nếu không chỉ định, hàm sẽ trả về 10.000 hàng. API trả về tối đa 250.000 hàng cho mỗi yêu cầu, bất kể bạn yêu cầu bao nhiêu hàng. API cũng có thể trả về ít hàng hơn |
dimensionFilter |
Không bắt buộc. Bộ lọc phương diện chỉ cho phép bạn yêu cầu một số giá trị phương diện cụ thể trong báo cáo. Để tìm hiểu thêm, hãy xem bài viết Tạo báo cáo: Bộ lọc phương diện để xem ví dụ. Không thể sử dụng chỉ số trong bộ lọc này. |
returnPropertyQuota |
Không bắt buộc. Bật/tắt tính năng trả về trạng thái hiện tại của hạn mức của Tài sản Analytics này. Hạn mức được trả về trong PropertyQuota. |
Nội dung phản hồi
Nội dung phản hồi trong báo cáo phễu chứa 2 báo cáo phụ. Hai báo cáo phụ này là sự kết hợp khác nhau giữa phương diện và chỉ số.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "funnelTable": { object ( |
Trường | |
---|---|
funnelTable |
Bảng phễu là một báo cáo có bước phễu, phân đoạn, phương diện phân tích, người dùng đang hoạt động, tỷ lệ hoàn thành, số lượt bỏ ngang và tỷ lệ bỏ ngang. Thứ nguyên phân đoạn chỉ xuất hiện trong phản hồi này nếu phân đoạn được yêu cầu. Phương diện phân tích chỉ xuất hiện trong phản hồi này nếu được yêu cầu. |
funnelVisualization |
Hình ảnh phễu là một báo cáo có bước phễu, phân đoạn, ngày, phương diện hành động tiếp theo và người dùng đang hoạt động. Thứ nguyên phân đoạn chỉ xuất hiện trong phản hồi này nếu phân đoạn được yêu cầu. Phương diện ngày chỉ xuất hiện trong phản hồi này nếu được yêu cầu thông qua loại phễu |
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 |
Xác định loại tài nguyên này của thông báo. |
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau đây:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
Phễu
Thiết lập phễu trong yêu cầu báo cáo phễu. Phễu báo cáo về người dùng khi họ thực hiện một trình tự các bước.
Kỹ thuật khám phá phễu cho phép bạn thể hiện các bước mà người dùng cần thực hiện để hoàn tất một hành động bằng hình ảnh, và xem nhanh mức độ mà họ hoàn tất hoặc không hoàn tất ở mỗi bước. Ví dụ: hành trình mà khách hàng tiềm năng trở thành người mua sắm và sau đó trở thành khách hàng diễn ra như thế nào? Hành trình mà khách hàng mua một lần trở thành khách hàng mua thường xuyên diễn ra như thế nào? Với thông tin này, bạn có thể cải thiện những hành trình không hiệu quả hoặc bị bỏ qua của khách hàng.
Biểu diễn dưới dạng JSON |
---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
Trường | |
---|---|
isOpenFunnel |
Trong một phễu mở, người dùng có thể tham gia vào phễu ở bất kỳ bước nào và trong một phễu đóng, người dùng phải tham gia vào phễu ở bước đầu tiên. Không bắt buộc. Nếu không chỉ định, thì phễu kín sẽ được sử dụng. |
steps[] |
Các bước tuần tự của phễu này. |
FunnelStep
Các bước xác định hành trình của người dùng mà bạn muốn đo lường. Các bước chứa một hoặc nhiều điều kiện mà người dùng phải đáp ứng để được đưa vào bước đó trong hành trình phễu.
Biểu diễn dưới dạng JSON |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
Trường | |
---|---|
name |
Tên riêng biệt cho bước này. Nếu không chỉ định, các bước sẽ được đặt tên theo 1 tên được lập chỉ mục dựa trên (ví dụ: "0. ", "1. ", v.v.). Tên này xác định giá trị chuỗi do phương diện |
isDirectlyFollowedBy |
Nếu đúng, bước này phải ngay sau bước trước đó. Nếu giá trị sai, có thể có các sự kiện giữa bước trước đó và bước này. Nếu không chỉ định thì |
filterExpression |
Đ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 |
Nếu được chỉ định, bước này phải hoàn tất trong khoảng thời gian này khi hoàn tất bước trước đó.
Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng " |
FunnelFilterExpression
Thể hiện các kiểu kết hợp bộ lọc phễu.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp expr . Chỉ định một loại bộ lọc cho FunnelFilterExpression . expr chỉ có thể là một trong những trạng thái sau: |
|
andGroup |
KênhFilterExpression trong |
orGroup |
phễuFilterExpression trong |
notExpression |
phễuFilterExpression KHÔNG thuộc |
funnelFieldFilter |
Bộ lọc phễu cho một phương diện hoặc chỉ số. |
funnelEventFilter |
Tạo bộ lọc so khớp với các sự kiện của một tên sự kiện. Nếu bạn chỉ định một biểu thức lọc thông số, thì chỉ một nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức lọc thông số mới khớp với bộ lọc sự kiện này. |
FunnelFilterExpressionList
Danh sách các biểu thức lọc phễu.
Biểu diễn dưới dạng JSON |
---|
{
"expressions": [
{
object ( |
Trường | |
---|---|
expressions[] |
Danh sách các biểu thức lọc phễu. |
FunnelFieldFilter
Biểu thức để lọc các giá trị thứ nguyên hoặc chỉ số.
Biểu diễn dưới dạng JSON |
---|
{ "fieldName": string, // Union field |
Trường | |
---|---|
fieldName |
Tên phương diện hoặc tên chỉ số. |
Trường hợp one_filter . Chỉ định một loại bộ lọc. one_filter chỉ có thể là một trong những trạng thái sau: |
|
stringFilter |
Bộ lọc liên quan đến chuỗi. |
inListFilter |
Bộ lọc cho các giá trị trong danh sách. |
numericFilter |
Bộ lọc cho các giá trị số hoặc ngày. |
betweenFilter |
Bộ lọc giữa hai giá trị. |
FunnelEventFilter
Tạo bộ lọc so khớp với các sự kiện của một tên sự kiện. Nếu bạn chỉ định một biểu thức lọc thông số, thì chỉ một nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức lọc thông số mới khớp với bộ lọc sự kiện này.
Biểu diễn dưới dạng JSON |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
Trường | |
---|---|
eventName |
Bộ lọc này khớp với các sự kiện của tên sự kiện duy nhất này. Bạn phải nhập tên sự kiện. |
funnelParameterFilterExpression |
Nếu được chỉ định, bộ lọc này sẽ so khớp những sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức lọc thông số. Bên trong biểu thức lọc thông số, chỉ có bộ lọc tham số. |
FunnelParameterFilterExpression
Thể hiện các tổ hợp bộ lọc phễu trên thông số.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp expr . Chỉ định một loại bộ lọc cho FunnelParameterFilterExpression . expr chỉ có thể là một trong những trạng thái sau: |
|
andGroup |
KênhParameterFilterExpression trong |
orGroup |
KênhParameterFilterExpression trong |
notExpression |
KênhParameterFilterExpression KHÔNG phải là |
funnelParameterFilter |
Bộ lọc tham số phễu chính. |
FunnelParameterFilterExpressionList
Danh sách các biểu thức lọc thông số phễu.
Biểu diễn dưới dạng JSON |
---|
{
"expressions": [
{
object ( |
Trường | |
---|---|
expressions[] |
Danh sách các biểu thức lọc thông số phễu. |
FunnelParameterFilter
Biểu thức để lọc các giá trị thông số trong phễu.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp one_parameter . Trường đang được lọc. one_parameter chỉ có thể là một trong những trạng thái sau: |
|
eventParameterName |
Bộ lọc này sẽ được đánh giá dựa trên thông số sự kiện được chỉ định. Thông số sự kiện được ghi lại dưới dạng thông số của sự kiện. Thông số sự kiện bao gồm các trường như "firebase_screen" và "currency". Bạn chỉ có thể dùng thông số sự kiện trong các phân đoạn và phễu, đồng thời chỉ có thể dùng trong một bộ lọc cấp dưới từ một Bộ lọc sự kiện. Trong bộ lọc con từ EventFilter, bạn nên sử dụng thông số sự kiện hoặc mục. |
itemParameterName |
Bộ lọc này sẽ được đánh giá dựa trên thông số mục được chỉ định. Thông số mặt hàng được ghi lại dưới dạng thông số trong mảng mặt hàng. Thông số mặt hàng bao gồm các trường như "item_name" và "item_category". Bạn chỉ có thể dùng thông số mục trong các phân đoạn và phễu, đồng thời chỉ có thể dùng trong một bộ lọc cấp dưới từ một EventFilter. Trong bộ lọc con từ EventFilter, bạn nên sử dụng thông số sự kiện hoặc mục. Thông số mặt hàng chỉ có trong sự kiện thương mại điện tử. Để tìm hiểu thêm về các sự kiện thương mại điện tử, hãy xem hướng dẫn Đo lường sự kiện thương mại điện tử. |
Trường hợp one_filter . Chỉ định một loại bộ lọc. one_filter chỉ có thể là một trong những trạng thái sau: |
|
stringFilter |
Bộ lọc liên quan đến chuỗi. |
inListFilter |
Bộ lọc cho các giá trị trong danh sách. |
numericFilter |
Bộ lọc cho các giá trị số hoặc ngày. |
betweenFilter |
Bộ lọc giữa hai giá trị. |
FunnelBreakdown
Bảng chi tiết thêm một phương diện vào nội dung phản hồi cho báo cáo phụ bảng phễu.
Biểu diễn dưới dạng JSON |
---|
{
"breakdownDimension": {
object ( |
Trường | |
---|---|
breakdownDimension |
Đã thêm cột phương diện vào phản hồi cho báo cáo phụ của bảng phễu. Phương diện phân tích chi tiết từng bước trong phễu. Bạn phải có |
limit |
Số lượng giá trị riêng biệt tối đa của phương diện phân tích trả về trong câu trả lời. |
FunnelNextAction
Các hành động tiếp theo nêu rõ giá trị của một phương diện sau khi người dùng đã đạt được một bước nhưng trước khi người dùng đó hoàn thành bước tiếp theo. Ví dụ: nếu nextActionDimension
là eventName
, thì nextActionDimension
trong hàng bước trong phễu thứ i
sẽ trả về sự kiện đầu tiên sau sự kiện đã giúp người dùng đủ điều kiện tham gia bước trong phễu thứ i
, nhưng trước khi người dùng đạt được bước thứ i+1
trong phễu.
Biểu diễn dưới dạng JSON |
---|
{
"nextActionDimension": {
object ( |
Trường | |
---|---|
nextActionDimension |
Đã thêm cột phương diện vào nội dung phản hồi trong báo cáo phụ về hình ảnh phễu. Phương diện hành động tiếp theo sẽ trả về giá trị phương diện tiếp theo của phương diện này sau khi người dùng đạt đến bước thứ
|
limit |
Số lượng giá trị riêng biệt tối đa của phương diện phân tích trả về trong câu trả lời. |
FunnelVisualizationType
Kiểm soát các phương diện có trong nội dung phản hồi của báo cáo phụ về hình ảnh phễu.
Enum | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
Loại không xác định. |
STANDARD_FUNNEL |
Phễu chuẩn (dạng bậc). Báo cáo phụ về hình ảnh phễu trong phản hồi sẽ không chứa ngày. |
TRENDED_FUNNEL |
Một phễu theo xu hướng (biểu đồ dạng đường). Báo cáo phụ về hình ảnh phễu trong phản hồi sẽ chứa phương diện ngày. |
Phân khúc
Phân đoạn là một nhóm nhỏ chứa dữ liệu Analytics của bạn. Ví dụ: trong toàn bộ nhóm người dùng, thì phân đoạn có thể là một nhóm nhỏ gồm những người dùng đến từ một quốc gia hoặc thành phố cụ thể. Một phân khúc khác có thể bao gồm những người dùng mua một dòng sản phẩm cụ thể hoặc những người truy cập vào một phần cụ thể của trang web hay kích hoạt một số sự kiện nhất định trong ứng dụng của bạn.
Để tìm hiểu thêm, hãy xem bài viết Trình tạo phân đoạn GA4.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, // Union field |
Trường | |
---|---|
name |
Tên cho phân đoạn này. Nếu bạn chưa chỉ định, các phân đoạn sẽ có tên là "Phân đoạn". Tên này xác định giá trị chuỗi do phương diện |
Trường hợp one_segment_scope . Phân đoạn được chỉ định trong một phạm vi. one_segment_scope chỉ có thể là một trong những trạng thái sau: |
|
userSegment |
Phân khúc người dùng là nhóm nhỏ gồm những người dùng đã tương tác với trang web hoặc ứng dụng của bạn. |
sessionSegment |
Phân đoạn phiên hoạt động là nhóm nhỏ các phiên hoạt động xảy ra trên trang web hoặc ứng dụng của bạn. |
eventSegment |
Phân khúc sự kiện là nhóm nhỏ những sự kiện được kích hoạt trên trang web hoặc ứng dụng của bạn. |
UserSegment
Phân khúc người dùng là một nhóm nhỏ những người dùng đã tương tác với trang web hoặc ứng dụng của bạn. Ví dụ: người dùng đã từng mua hàng; người dùng đã thêm sản phẩm vào giỏ hàng nhưng chưa hoàn tất giao dịch mua.
Biểu diễn dưới dạng JSON |
---|
{ "userInclusionCriteria": { object ( |
Trường | |
---|---|
userInclusionCriteria |
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 |
Xác định những người dùng bị loại trừ trong phân khúc này. Không bắt buộc. |
UserSegmentCriteria
Người dùng sẽ khớp với một tiêu chí nếu sự kiện của người dùng đó đáp ứng các điều kiện trong tiêu chí đó.
Biểu diễn dưới dạng JSON |
---|
{ "andConditionGroups": [ { object ( |
Trường | |
---|---|
andConditionGroups[] |
Một người dùng sẽ khớp tiêu chí này nếu người dùng đó khớp với từng |
andSequenceGroups[] |
Một người dùng sẽ khớp tiêu chí này nếu người dùng đó khớp với từng |
UserSegmentConditionGroup
Các điều kiện cho Analytics biết những dữ liệu cần thêm vào hoặc loại trừ khỏi phân đoạn.
Biểu diễn dưới dạng JSON |
---|
{ "conditionScoping": enum ( |
Trường | |
---|---|
conditionScoping |
Dữ liệu được thêm vào hoặc bị loại trừ khỏi phân khúc dựa trên việc dữ liệu đó có khớp với nhóm điều kiện hay không. Phạm vi này xác định số lượng sự kiện mà Không bắt buộc. Nếu không chỉ định thì |
segmentFilterExpression |
Dữ liệu được đưa vào hoặc bị loại trừ khỏi phân khúc dựa trên việc dữ liệu đó có khớp với biểu thức này hay không. Biểu thức thể hiện tiêu chí về thứ nguyên, chỉ số và/hoặc thông số. |
UserCriteriaScoping
Phạm vi cho biết những sự kiện nào được xem xét khi đánh giá xem người dùng có đáp ứng tiêu chí hay không.
Enum | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
Phạm vi tiêu chí chưa được chỉ định. Không nêu rõ. |
USER_CRITERIA_WITHIN_SAME_EVENT |
Nếu đáp ứng các tiêu chí trong một sự kiện, thì người dùng sẽ khớp với các tiêu chí đó. |
USER_CRITERIA_WITHIN_SAME_SESSION |
Nếu đáp ứng tiêu chí trong một phiên, người dùng sẽ khớp với tiêu chí. |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
Nếu có sự kiện nào đó đáp ứng tiêu chí của người dùng, thì người dùng đó sẽ khớp với tiêu chí đó. |
SegmentFilterExpression
Thể hiện sự kết hợp của các bộ lọc phân khúc.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp expr . Chỉ định một loại bộ lọc cho SegmentFilterExpression . expr chỉ có thể là một trong những trạng thái sau: |
|
andGroup |
segmentationFilterExpression trong |
orGroup |
segmentationFilterExpression trong |
notExpression |
segmentationFilterExpression KHÔNG phải là |
segmentFilter |
Bộ lọc phân đoạn gốc. |
segmentEventFilter |
Tạo bộ lọc so khớp với các sự kiện của một tên sự kiện. Nếu bạn chỉ định một biểu thức lọc thông số, thì chỉ một nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức lọc thông số mới khớp với bộ lọc sự kiện này. |
SegmentFilterExpressionList
Danh sách các biểu thức lọc phân đoạn.
Biểu diễn dưới dạng JSON |
---|
{
"expressions": [
{
object ( |
Trường | |
---|---|
expressions[] |
Danh sách các biểu thức lọc phân đoạn |
SegmentFilter
Biểu thức để lọc các giá trị thứ nguyên hoặc chỉ số.
Biểu diễn dưới dạng JSON |
---|
{ "fieldName": string, "filterScoping": { object ( |
Trường | |
---|---|
fieldName |
Tên phương diện hoặc tên chỉ số. |
filterScoping |
Chỉ định phạm vi cho bộ lọc. |
Trường hợp one_filter . Chỉ định một loại bộ lọc cho Filter . one_filter chỉ có thể là một trong những trạng thái sau: |
|
stringFilter |
Bộ lọc liên quan đến chuỗi. |
inListFilter |
Bộ lọc cho các giá trị trong danh sách. |
numericFilter |
Bộ lọc cho các giá trị số hoặc ngày. |
betweenFilter |
Bộ lọc giữa hai giá trị. |
SegmentFilterScoping
Phạm vi chỉ định cách xem xét phương diện và chỉ số của nhiều sự kiện khi đánh giá một bộ lọc phân đoạn.
Biểu diễn dưới dạng JSON |
---|
{ "atAnyPointInTime": boolean } |
Trường | |
---|---|
atAnyPointInTime |
Nếu Thông số Bạn chỉ có thể chỉ định Nếu phạm vi tiêu chí là |
SegmentEventFilter
Tạo bộ lọc so khớp với các sự kiện của một tên sự kiện. Nếu bạn chỉ định một biểu thức lọc thông số, thì chỉ một nhóm nhỏ sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức lọc thông số mới khớp với bộ lọc sự kiện này.
Biểu diễn dưới dạng JSON |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
Trường | |
---|---|
eventName |
Bộ lọc này khớp với các sự kiện của tên sự kiện duy nhất này. Bạn phải nhập tên sự kiện. |
segmentParameterFilterExpression |
Nếu được chỉ định, bộ lọc này sẽ so khớp những sự kiện khớp với cả tên sự kiện đơn lẻ và biểu thức lọc thông số. Bên trong biểu thức lọc thông số, chỉ có bộ lọc tham số. |
SegmentParameterFilterExpression
Thể hiện các tổ hợp bộ lọc phân khúc dựa trên các thông số.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp expr . Chỉ định một loại bộ lọc cho SegmentParameterFilterExpression . expr chỉ có thể là một trong những trạng thái sau: |
|
andGroup |
segmentationParameterFilterExpression trong |
orGroup |
segmentationParameterFilterExpression trong |
notExpression |
segmentationParameterFilterExpression KHÔNG phải là |
segmentParameterFilter |
Bộ lọc tham số phân đoạn gốc. |
SegmentParameterFilterExpressionList
Danh sách các biểu thức lọc tham số phân đoạn.
Biểu diễn dưới dạng JSON |
---|
{
"expressions": [
{
object ( |
Trường | |
---|---|
expressions[] |
Danh sách các biểu thức lọc tham số phân đoạn. |
SegmentParameterFilter
Một biểu thức để lọc các giá trị thông số trong một phân đoạn.
Biểu diễn dưới dạng JSON |
---|
{ "filterScoping": { object ( |
Trường | |
---|---|
filterScoping |
Chỉ định phạm vi cho bộ lọc. |
Trường hợp one_parameter . Trường đang được lọc. one_parameter chỉ có thể là một trong những trạng thái sau: |
|
eventParameterName |
Bộ lọc này sẽ được đánh giá dựa trên thông số sự kiện được chỉ định. Thông số sự kiện được ghi lại dưới dạng thông số của sự kiện. Thông số sự kiện bao gồm các trường như "firebase_screen" và "currency". Bạn chỉ có thể dùng thông số sự kiện trong các phân đoạn và phễu, đồng thời chỉ có thể dùng trong một bộ lọc cấp dưới từ một Bộ lọc sự kiện. Trong bộ lọc con từ EventFilter, bạn nên sử dụng thông số sự kiện hoặc mục. |
itemParameterName |
Bộ lọc này sẽ được đánh giá dựa trên thông số mục được chỉ định. Thông số mặt hàng được ghi lại dưới dạng thông số trong mảng mặt hàng. Thông số mặt hàng bao gồm các trường như "item_name" và "item_category". Bạn chỉ có thể dùng thông số mục trong các phân đoạn và phễu, đồng thời chỉ có thể dùng trong một bộ lọc cấp dưới từ một EventFilter. Trong bộ lọc con từ EventFilter, bạn nên sử dụng thông số sự kiện hoặc mục. Thông số mặt hàng chỉ có trong sự kiện thương mại điện tử. Để tìm hiểu thêm về các sự kiện thương mại điện tử, hãy xem hướng dẫn Đo lường sự kiện thương mại điện tử. |
Trường hợp one_filter . Chỉ định một loại bộ lọc. one_filter chỉ có thể là một trong những trạng thái sau: |
|
stringFilter |
Bộ lọc liên quan đến chuỗi. |
inListFilter |
Bộ lọc cho các giá trị trong danh sách. |
numericFilter |
Bộ lọc cho các giá trị số hoặc ngày. |
betweenFilter |
Bộ lọc giữa hai giá trị. |
SegmentParameterFilterScoping
Phạm vi cho biết cách nhiều sự kiện sẽ được xem xét khi đánh giá một bộ lọc thông số phân đoạn.
Biểu diễn dưới dạng JSON |
---|
{ "inAnyNDayPeriod": string } |
Trường | |
---|---|
inAnyNDayPeriod |
Tích luỹ thông số trong khoảng thời gian ngày được chỉ định trước khi áp dụng bộ lọc. Chỉ được hỗ trợ nếu phạm vi tiêu chí là Ví dụ: nếu Phạm vi ngày không được mở rộng vì mục đích có toàn bộ khung thời gian N ngày gần bắt đầu phạm vi ngày. Ví dụ: nếu báo cáo dành cho ngày 1/11/2021 đến ngày 10/11/2021 và
|
UserSegmentSequenceGroup
Xác định các điều kiện phải xảy ra theo thứ tự cụ thể để người dùng trở thành thành viên của phân khúc.
Biểu diễn dưới dạng JSON |
---|
{ "sequenceScoping": enum ( |
Trường | |
---|---|
sequenceScoping |
Bạn phải đáp ứng tất cả các bước trong trình tự khi xác định phạm vi để người dùng khớp với trình tự. Ví dụ: nếu Không bắt buộc. Nếu không chỉ định thì |
sequenceMaximumDuration |
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 với tối đa 9 chữ số thập phân, kết thúc bằng " |
userSequenceSteps[] |
Một trình tự sắp xếp các bước điều kiện. Sự kiện của người dùng phải hoàn tất từng bước để người dùng đó khớp với |
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 | |
---|---|
isDirectlyFollowedBy |
Nếu đúng, sự kiện đáp ứng bước này phải là sự kiện tiếp theo sau khi sự kiện đáp ứng bước cuối cùng. Nếu giá trị sai, bước này sẽ gián tiếp đứng sau bước trước đó; ví dụ: có thể có các sự kiện giữa bước trước và bước này. |
stepScoping |
Bạn phải đáp ứng bước trình tự này trong việc xác định phạm vi để người dùng khớp với trình tự. Ví dụ: nếu Không bắt buộc. Nếu không chỉ định thì |
segmentFilterExpression |
Người dùng sẽ so khớp bước này trong trình tự nếu các sự kiện của họ khớp với biểu thức này. Biểu thức thể hiện tiêu chí về thứ nguyên, chỉ số và/hoặc thông số. |
UserSegmentExclusion
Chỉ định những người dùng bị loại trừ trong phân khúc này.
Biểu diễn dưới dạng JSON |
---|
{ "userExclusionDuration": enum ( |
Trường | |
---|---|
userExclusionDuration |
Chỉ định khoảng thời gian áp dụng một tiêu chí loại trừ nếu người dùng khớp với Không bắt buộc. Nếu không chỉ định thì |
userExclusionCriteria |
Nếu đáp ứng điều kiện này thì người dùng sẽ bị loại khỏi tư cách thành viên trong phân khúc đối với |
UserExclusionDuration
Liệt kê các tuỳ chọn về thời gian loại trừ nếu người dùng khớp với userExclusionCriteria
.
Enum | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
Khoảng thời gian loại trừ chưa chỉ định. Không nêu rõ. |
USER_EXCLUSION_TEMPORARY |
Tạm thời loại trừ người dùng khỏi phân khúc trong các khoảng thời gian khi người dùng đáp ứng điều kiện userExclusionCriteria . |
USER_EXCLUSION_PERMANENT |
Loại trừ vĩnh viễn người dùng khỏi phân khúc nếu người dùng đó đã từng đáp ứng điều kiện userExclusionCriteria . |
SessionSegment
Phân đoạn phiên hoạt động là nhóm nhỏ các phiên xảy ra trên trang web hoặc ứng dụng của bạn (ví dụ: tất cả các phiên bắt nguồn từ một chiến dịch quảng cáo cụ thể).
Biểu diễn dưới dạng JSON |
---|
{ "sessionInclusionCriteria": { object ( |
Trường | |
---|---|
sessionInclusionCriteria |
Xác định những phiên nào được đưa vào phân đoạn này. Không bắt buộc. |
exclusion |
Xác định những phiên bị loại trừ trong phân đoạn này. Không bắt buộc. |
SessionSegmentCriteria
Một phiên khớp với một tiêu chí nếu các sự kiện của phiên đó đáp ứng các điều kiện trong tiêu chí đó.
Biểu diễn dưới dạng JSON |
---|
{
"andConditionGroups": [
{
object ( |
Trường | |
---|---|
andConditionGroups[] |
Một phiên khớp với tiêu chí này nếu phiên đó 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 đoạn.
Biểu diễn dưới dạng JSON |
---|
{ "conditionScoping": enum ( |
Trường | |
---|---|
conditionScoping |
Dữ liệu được thêm vào hoặc bị loại trừ khỏi phân khúc dựa trên việc dữ liệu đó có khớp với nhóm điều kiện hay không. Phạm vi này xác định số lượng sự kiện mà Không bắt buộc. Nếu không chỉ định thì hệ thống sẽ sử dụng |
segmentFilterExpression |
Dữ liệu được đưa vào hoặc bị loại trừ khỏi phân khúc dựa trên việc dữ liệu đó có khớp với biểu thức này hay không. Biểu thức thể hiện tiêu chí về thứ nguyên, chỉ số và/hoặc thông số. |
SessionCriteriaScoping
Phạm vi cho biết những sự kiện nào được xem xét khi đánh giá xem một phiên có đáp ứng tiêu chí hay không.
Enum | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
Phạm vi tiêu chí chưa được chỉ định. Không nêu rõ. |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
Nếu bạn đáp ứng tiêu chí trong một sự kiện, thì phiên đó sẽ khớp với tiêu chí. |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
Nếu đáp ứng tiêu chí trong một phiên, thì phiên đó sẽ khớp với tiêu chí. |
SessionSegmentExclusion
Xác định những phiên bị loại trừ trong phân khúc này.
Biểu diễn dưới dạng JSON |
---|
{ "sessionExclusionDuration": enum ( |
Trường | |
---|---|
sessionExclusionDuration |
Chỉ định khoảng thời gian mà một tiêu chí loại trừ sẽ kéo dài nếu một phiên khớp với Không bắt buộc. Nếu không chỉ định thì hệ thống sẽ sử dụng |
sessionExclusionCriteria |
Nếu một phiên đáp ứng điều kiện này, phiên đó sẽ bị loại trừ khỏi tư cách thành viên trong phân khúc cho |
SessionExclusionDuration
Liệt kê các tuỳ chọn về thời lượng của một tiêu chí loại trừ nếu một phiên hoạt động khớp với sessionExclusionCriteria
.
Enum | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
Khoảng thời gian loại trừ chưa chỉ định. Không nêu rõ. |
SESSION_EXCLUSION_TEMPORARY |
Tạm thời loại trừ các phiên khỏi phân đoạn trong các khoảng thời gian khi phiên đó đáp ứng điều kiện sessionExclusionCriteria . |
SESSION_EXCLUSION_PERMANENT |
Loại trừ vĩnh viễn các phiên khỏi phân đoạn nếu phiên đó đã từng đáp ứng điều kiện sessionExclusionCriteria . |
EventSegment
Phân khúc sự kiện là nhóm nhỏ các sự kiện được kích hoạt trên trang web hoặc ứng dụng của bạn (ví dụ: tất cả các sự kiện mua hàng được thực hiện tại một vị trí cụ thể; các sự kiện app_exception xảy ra trên một hệ điều hành cụ thể).
Biểu diễn dưới dạng JSON |
---|
{ "eventInclusionCriteria": { object ( |
Trường | |
---|---|
eventInclusionCriteria |
Xác định những sự kiện được đưa vào phân đoạn này. Không bắt buộc. |
exclusion |
Xác định những sự kiện bị loại trừ trong phân khúc này. Không bắt buộc. |
EventSegmentCriteria
Một sự kiện sẽ khớp với một tiêu chí nếu sự kiện đó đáp ứng các điều kiện trong tiêu chí đó.
Biểu diễn dưới dạng JSON |
---|
{
"andConditionGroups": [
{
object ( |
Trường | |
---|---|
andConditionGroups[] |
Một sự kiện sẽ khớp với tiêu chí này nếu sự kiện đó khớp với từng tiêu chí trong số |
EventSegmentConditionGroup
Các điều kiện cho Analytics biết những dữ liệu cần thêm vào hoặc loại trừ khỏi phân đoạn.
Biểu diễn dưới dạng JSON |
---|
{ "conditionScoping": enum ( |
Trường | |
---|---|
conditionScoping |
Không bắt buộc. Nếu không chỉ định thì hệ thống sẽ sử dụng |
segmentFilterExpression |
Dữ liệu được đưa vào hoặc bị loại trừ khỏi phân khúc dựa trên việc dữ liệu đó có khớp với biểu thức này hay không. Biểu thức thể hiện tiêu chí về thứ nguyên, chỉ số và/hoặc thông số. |
EventCriteriaScoping
Phạm vi cho biết những sự kiện nào được xem xét khi đánh giá xem một sự kiện có đáp ứng tiêu chí hay không.
Enum | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
Phạm vi tiêu chí chưa được chỉ định. Không nêu rõ. |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
Nếu bạn đáp ứng tiêu chí trong một sự kiện, thì sự kiện đó sẽ khớp với tiêu chí. |
EventSegmentExclusion
Chỉ định những sự kiện bị loại trừ trong phân khúc này.
Biểu diễn dưới dạng JSON |
---|
{ "eventExclusionDuration": enum ( |
Trường | |
---|---|
eventExclusionDuration |
Không bắt buộc. Nếu không chỉ định, hệ thống sẽ sử dụng |
eventExclusionCriteria |
Nếu một sự kiện đáp ứng điều kiện này, sự kiện đó sẽ bị loại trừ khỏi danh sách thành viên trong phân khúc đối với |
EventExclusionDuration
Liệt kê các lựa chọn về thời gian loại trừ nếu một sự kiện khớp với eventExclusionCriteria
.
Enum | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
Khoảng thời gian loại trừ chưa chỉ định. Không nêu rõ. |
EVENT_EXCLUSION_PERMANENT |
Loại trừ vĩnh viễn các sự kiện khỏi phân khúc nếu sự kiện đó đã từng đáp ứng điều kiện eventExclusionCriteria . |
FunnelSubReport
Báo cáo phụ phễu chứa các giá trị dữ liệu phương diện và chỉ số. Ví dụ: 12 người dùng đã tiếp cận bước thứ hai của phễu.
Biểu diễn dưới dạng JSON |
---|
{ "dimensionHeaders": [ { object ( |
Trường | |
---|---|
dimensionHeaders[] |
Mô tả các cột phương diện. Báo cáo phễu luôn bao gồm phương diện bước phễu trong ý kiến phản hồi cho báo cáo phụ. Các phương diện bổ sung như bảng chi tiết, ngày và hành động tiếp theo có thể xuất hiện trong phản hồi nếu được yêu cầu. |
metricHeaders[] |
Mô tả các cột chỉ số. Báo cáo phễu luôn bao gồm người dùng đang hoạt động trong phản hồi báo cáo phụ. Bảng phễu bao gồm các chỉ số bổ sung như tỷ lệ hoàn thành, số lượt bỏ ngang và tỷ lệ bỏ ngang. |
rows[] |
Các hàng gồm các kiểu kết hợp giá trị phương diện và giá trị chỉ số trong báo cáo. |
metadata |
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 có 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 | |
---|---|
samplingMetadatas[] |
Nếu kết quả báo cáo phễu được lấy mẫu, thì giá trị này mô tả tỷ lệ phần trăm sự kiện được sử dụng trong báo cáo phễu này. Một Tuy nhiên, nếu kết quả không được lấy mẫu, trường này sẽ không được xác định. |
SamplingMetadata
Nếu kết quả báo cáo phễu được lấy mẫu, thì siêu dữ liệu này sẽ mô tả tỷ lệ phần trăm sự kiện được sử dụng trong báo cáo phễu này trong một phạm vi ngày. Lấy mẫu là phương pháp phân tích một tập hợp con của tất cả dữ liệu để khám phá thông tin có ý nghĩa trong tập dữ liệu lớn hơn.
Biểu diễn dưới dạng JSON |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
Trường | |
---|---|
samplesReadCount |
Tổng số sự kiện được đọc trong báo cáo mẫu này trong một phạm vi ngày. Đây là quy mô của tập hợp con dữ liệu của tài sản này đã được phân tích trong báo cáo phễu này. |
samplingSpaceSize |
Tổng số sự kiện có trong dữ liệu của tài sản này mà có thể đã được phân tích trong báo cáo phễu này cho một phạm vi ngày. Việc lấy mẫu khám phá thông tin có ý nghĩa về tập dữ liệu lớn hơn và đây là kích thước của tập dữ liệu lớn hơn. Để tính tỷ lệ phần trăm dữ liệu có sẵn được sử dụng trong báo cáo phễu này, hãy tính |
PropertyQuota
Trạng thái hiện tại của tất cả các hạn mức cho Tài sản Analytics này. Nếu một tài sản hết hạn mức, thì tất cả các yêu cầu đối với tài sản đó sẽ trả về lỗi Tài nguyên đã hết.
Biểu diễn dưới dạng JSON |
---|
{ "tokensPerDay": { object ( |
Trường | |
---|---|
tokensPerDay |
Tài sản Analytics chuẩn có thể sử dụng tối đa 200.000 mã thông báo mỗi ngày; Tài sản Analytics 360 có thể sử dụng 2.000.000 mã thông báo mỗi ngày. Hầu hết các yêu cầu đều cần ít hơn 10 mã thông báo. |
tokensPerHour |
Tài sản Analytics chuẩn có thể sử dụng tối đa 40.000 mã thông báo mỗi giờ; Tài sản Analytics 360 có thể sử dụng 400.000 mã thông báo mỗi giờ. Yêu cầu API sử dụng một số lượng mã thông báo và con số đó sẽ được khấu trừ từ tất cả hạn mức hằng giờ, hằng ngày và theo giờ của mỗi dự án. |
concurrentRequests |
Tài sản Analytics chuẩn có thể gửi tối đa 10 yêu cầu đồng thời; Tài sản Analytics 360 có thể sử dụng tối đa 50 yêu cầu đồng thời. |
serverErrorsPerProjectPerHour |
Các cặp tài sản Analytics chuẩn và dự án trên đám mây có thể có tối đa 10 lỗi máy chủ mỗi giờ; các cặp tài sản Analytics 360 và dự án trên đám mây có thể có tối đa 50 lỗi máy chủ mỗi giờ. |
potentiallyThresholdedRequestsPerHour |
Tài sản Analytics có thể gửi tối đa 120 yêu cầu với các phương diện có thể đạt ngưỡng mỗi giờ. Trong một yêu cầu hàng loạt, mỗi yêu cầu báo cáo sẽ được tính riêng cho hạn mức này nếu yêu cầu đó chứa phương diện có thể bị giới hạn. |
tokensPerProjectPerHour |
Tài sản Analytics có thể sử dụng tối đa 35% mã thông báo cho mỗi dự án mỗi giờ. Số tiền này theo đó Tài sản Analytics chuẩn có thể sử dụng tối đa 14.000 mã thông báo cho mỗi dự án mỗi giờ và Tài sản Analytics 360 có thể sử dụng 140.000 mã thông báo cho mỗi dự án mỗi giờ. Yêu cầu API sử dụng một số lượng mã thông báo và con số đó sẽ được khấu trừ từ tất cả hạn mức hằng giờ, hằng ngày và theo giờ của mỗi dự án. |
QuotaStatus
Trạng thái hiện tại của một nhóm hạn mức cụ thể.
Biểu diễn dưới dạng JSON |
---|
{ "consumed": integer, "remaining": integer } |
Trường | |
---|---|
consumed |
Hạn mức mà yêu cầu này đã sử dụng. |
remaining |
Hạn mức còn lại sau yêu cầu này. |