API nhật ký CrUX cung cấp quyền truy cập có độ trễ thấp vào dữ liệu trải nghiệm người dùng thực tế trong 6 tháng trước theo mức độ chi tiết về trang và nguồn gốc.
Trường hợp sử dụng phổ biến
API Nhật ký CrUX cho phép truy vấn các chỉ số trải nghiệm người dùng trước đây cho một URI cụ thể, chẳng hạn như "Nhận xu hướng trải nghiệm người dùng trước đây cho nguồn gốc https://example.com".
API Nhật ký tuân theo cấu trúc giống như API CrUX hằng ngày, ngoại trừ việc các giá trị được cung cấp trong một mảng và khoá được gắn nhãn bằng tên số nhiều (ví dụ: histogramTimeseries thay vì histogram hoặc p75s thay vì p75).
Khoá API CrUX
Giống như API hằng ngày, việc sử dụng API nhật ký CrUX yêu cầu một khoá API Google Cloud được cấp để sử dụng Chrome UX Report API. Bạn có thể sử dụng cùng một khoá cho API hằng ngày và API nhật ký.
Lấy và sử dụng khoá API
Hoặc tạo một mã trong trang Thông tin xác thực.
Sau khi bạn có khoá API, ứng dụng của bạn có thể thêm tham số truy vấn key=yourAPIKey vào tất cả URL yêu cầu.
Khoá API an toàn để nhúng vào URL; không cần mã hoá.
Xem Truy vấn mẫu.
Mô hình dữ liệu
Phần này trình bày chi tiết cấu trúc dữ liệu trong các yêu cầu và phản hồi.
Ghi âm
Một phần thông tin riêng biệt về một trang hoặc trang web. Một bản ghi có thể có dữ liệu dành riêng cho một giá trị nhận dạng và cho một tổ hợp phương diện cụ thể. Một bản ghi có thể chứa dữ liệu cho một hoặc nhiều chỉ số.
Giá trị nhận dạng
Giá trị nhận dạng chỉ định những bản ghi cần tra cứu. Trong CrUX, các giá trị nhận dạng này là trang web và trang web.
Điểm gốc
Khi giá trị nhận dạng là một nguồn gốc, tất cả dữ liệu hiện có cho tất cả các trang trong nguồn gốc đó sẽ được tổng hợp với nhau. Ví dụ: giả sử nguồn gốc http://www.example.com có các trang như được nêu trong sơ đồ trang web này:
http://www.example.com/
http://www.example.com/foo.html
http://www.example.com/bar.html
Điều này có nghĩa là khi truy vấn Báo cáo trải nghiệm người dùng trên Chrome với nguồn gốc được đặt thành http://www.example.com, dữ liệu cho http://www.example.com/, http://www.example.com/foo.html và http://www.example.com/bar.html sẽ được trả về, tổng hợp với nhau, vì đó đều là các trang thuộc nguồn gốc đó.
URL
Khi giá trị nhận dạng là một URL, hệ thống sẽ chỉ trả về dữ liệu cho URL cụ thể đó. Xem lại sơ đồ trang web gốc http://www.example.com:
http://www.example.com/
http://www.example.com/foo.html
http://www.example.com/bar.html
Nếu giá trị nhận dạng được đặt thành URL có giá trị là http://www.example.com/foo.html, thì hệ thống sẽ chỉ trả về dữ liệu cho trang đó.
Kích thước
Phương diện xác định một nhóm dữ liệu cụ thể mà bản ghi đang được tổng hợp. Ví dụ: hệ số hình dạng PHONE cho biết bản ghi chứa thông tin về các lượt tải đã diễn ra trên thiết bị di động.
Kiểu dáng
API Nhật ký CrUX chỉ có sẵn ở dạng tổng hợp theo phương diện hệ số hình dạng. Đây là một lớp thiết bị chung được chia thành PHONE, TABLET và DESKTOP.
Chỉ số
Chúng tôi báo cáo các chỉ số theo chuỗi thời gian của dữ liệu tổng hợp thống kê, bao gồm biểu đồ, phân vị và phân số.
Các biểu đồ
Khi các chỉ số được biểu thị trong một mảng biểu đồ, thì mỗi mục trong chuỗi thời gian đại diện cho tỷ lệ phần trăm số lượt tải trang mà chỉ số đó rơi vào một khoảng thời gian, tương ứng với tất cả. Các điểm dữ liệu được trình bày theo thứ tự ngày khoảng thời gian thu thập cũng do API trả về, trong đó điểm đầu tiên là khoảng thời gian sớm nhất và điểm cuối cùng là khoảng thời gian thu thập gần đây nhất.
Biểu đồ thanh ba ngăn cho một chỉ số mẫu có dạng như sau:
{
"histogramTimeseries": [
{
"start": 0,
"end": 2500,
"densities": [0.9190, 0.9203, 0.9194, 0.9195, 0.9183, 0.9187]
},
{
"start": 2500,
"end": 4000,
"densities": [0.0521, 0.0513, 0.0518, 0.0518, 0.0526, 0.0527]
},
{
"start": 4000,
"densities": [0.0288, 0.0282, 0.0286, 0.0285, 0.0290, 0.0285]
}
],
}
Dữ liệu này cho biết 91,90% số lượt tải trang có giá trị chỉ số mẫu từ 0 mili giây đến 2.500 mili giây trong khoảng thời gian thu thập dữ liệu đầu tiên trong nhật ký, tiếp theo là 92,03%, 91,94%... Các đơn vị của chỉ số không có trong biểu đồ này, trong trường hợp này, chúng ta sẽ giả định là mili giây.
Ngoài ra, 5,21% số lượt tải trang có giá trị chỉ số mẫu trong khoảng từ 2.500 mili giây đến 4.000 mili giây trong khoảng thời gian thu thập dữ liệu đầu tiên trong quá khứ và 2,88% số lượt tải trang có giá trị lớn hơn 4.000 mili giây trong khoảng thời gian thu thập dữ liệu đầu tiên trong quá khứ.
Phân vị
Chỉ số cũng có thể chứa chuỗi thời gian của các phân vị có thể hữu ích cho việc phân tích thêm.
Các điểm dữ liệu được trình bày theo thứ tự ngày khoảng thời gian thu thập cũng do API trả về, trong đó điểm đầu tiên là khoảng thời gian sớm nhất và điểm cuối cùng là khoảng thời gian thu thập gần đây nhất.
{
"percentilesTimeseries": {
"p75s": [1362, 1352, 1344, 1356, 1366, 1377]
},
}
Những phân vị này có thể cho biết các giá trị chỉ số cụ thể tại phân vị nhất định cho chỉ số đó. Các giá trị này dựa trên tập hợp đầy đủ dữ liệu có sẵn chứ không phải dữ liệu được phân thành nhóm cuối cùng. Do đó, các giá trị này không nhất thiết phải khớp với một giá trị phần trăm nội suy dựa trên biểu đồ thanh được phân thành nhóm cuối cùng.
Phân số
Các chỉ số có thể được biểu thị dưới dạng chuỗi thời gian của các phân số được gắn nhãn; mỗi nhãn mô tả một lượt tải trang theo một cách cụ thể. Các điểm dữ liệu được trình bày theo thứ tự ngày khoảng thời gian thu thập cũng do API trả về, trong đó điểm đầu tiên là khoảng thời gian sớm nhất và điểm cuối cùng là khoảng thời gian thu thập gần đây nhất.
Ví dụ:
{
"fractionTimeseries": {
"desktop": {"fractions": [0.3195, 0.2115, 0.1421]},
"phone": {"fractions": [0.6295, 0.7544, 0.8288]},
"tablet": {"fractions": [0.051, 0.0341, 0.029]}
}
}
Trong ví dụ này, điểm dữ liệu gần đây nhất cho biết 14,21% số lượt tải trang đến từ máy tính và 82,88% đến từ điện thoại.
Loại giá trị chỉ số
Vì API Nhật ký CrUX sử dụng cùng loại giá trị chỉ số, nên bạn có thể tham khảo tài liệu về các loại giá trị chỉ số API CrUX hằng ngày để biết thêm thông tin chi tiết.
Điều kiện sử dụng chỉ số
Dựa trên các tiêu chí về điều kiện, một nguồn gốc hoặc URL có thể chỉ đủ điều kiện cho một số khoảng thời gian thu thập dữ liệu mà API Nhật ký CrUX bao gồm. Trong những trường hợp này, CrUX History API sẽ trả về "NaN" cho mật độ histogramTimeseries và null cho percentilesTimeseries cho các khoảng thời gian thu thập không có dữ liệu đủ điều kiện. Lý do cho sự khác biệt này là mật độ biểu đồ luôn là số, trong khi tỷ lệ phần trăm có thể là số hoặc chuỗi (CLS sử dụng chuỗi, ngay cả khi chúng trông giống như số).
Ví dụ: nếu khoảng thời gian thứ hai không có dữ liệu đủ điều kiện, thì khoảng thời gian này sẽ hiển thị như sau:
{
"histogramTimeseries": [
{
"start": 0,
"end": 2500,
"densities": [0.9190, "NaN", 0.9194, 0.9195, 0.9183, 0.9187]
},
{
"start": 2500,
"end": 4000,
"densities": [0.0521, "NaN", 0.0518, 0.0518, 0.0526, 0.0527]
},
{
"start": 4000,
"densities": [0.0288, "NaN", 0.0286, 0.0285, 0.0290, 0.0285]
}
],
"percentilesTimeseries": {
"p75s": [1362, null, 1344, 1356, 1366, 1377]
},
}
Đối với những URL hoặc nguồn gốc không đủ điều kiện và đủ điều kiện theo thời gian, bạn có thể nhận thấy nhiều mục bị thiếu.
Khoảng thời gian thu thập
API Nhật ký CrUX chứa một đối tượng collectionPeriods với một mảng các trường firstDate và endDate đại diện cho ngày bắt đầu và ngày kết thúc của mỗi khoảng thời gian tổng hợp. Ví dụ:
"collectionPeriods": [{
"firstDate": { "year": 2022, "month": 7, "day": 10 },
"lastDate": { "year": 2022, "month": 8, "day": 6 }
}, {
"firstDate": { "year": 2022, "month": 7, "day": 17 },
"lastDate": { "year": 2022, "month": 8, "day": 13 }
}, {
"firstDate": { "year": 2022, "month": 7, "day": 24 },
"lastDate": { "year": 2022, "month": 8, "day": 20 }
}, {
"firstDate": { "year": 2022, "month": 7, "day": 31 },
"lastDate": { "year": 2022, "month": 8, "day": 27 }
}, {
"firstDate": { "year": 2022, "month": 8, "day": 7 },
"lastDate": { "year": 2022, "month": 9, "day": 3 }
}, {
"firstDate": { "year": 2022, "month": 8, "day": 14 },
"lastDate": { "year": 2022, "month": 9, "day": 10 }
}
]
Các khoảng thời gian thu thập này được sắp xếp theo thứ tự tăng dần và thể hiện khoảng thời gian của từng điểm dữ liệu trong các phần khác của phản hồi.
API Nhật ký được cập nhật vào mỗi thứ Hai và chứa dữ liệu cho đến thứ Bảy trước đó (theo độ trễ tiêu chuẩn là 2 ngày). Báo cáo này chứa dữ liệu trong 40 tuần trước đó, tức là một khoảng thời gian thu thập dữ liệu mỗi tuần. Theo mặc định, hệ thống sẽ trả về 25 khoảng thời gian thu thập. Bạn có thể thay đổi giá trị này bằng cách đặt "collectionPeriodCount" trong yêu cầu thành một số từ 1 đến 40.
Vì mỗi khoảng thời gian thu thập dữ liệu chứa dữ liệu tổng hợp trong 28 ngày trước đó và khoảng thời gian thu thập dữ liệu là hằng tuần, nên các khoảng thời gian thu thập dữ liệu sẽ trùng lặp. Các chỉ số này tương tự như giá trị trung bình động của dữ liệu, trong đó mỗi khoảng thời gian tiếp theo bao gồm dữ liệu trong 3 tuần và một tuần khác.
Cụm từ tìm kiếm mẫu
Các truy vấn được gửi dưới dạng đối tượng JSON bằng cách sử dụng yêu cầu POST đến https://chromeuxreport.googleapis.com/v1/records:queryHistoryRecord?key=[YOUR_API_KEY]" với dữ liệu truy vấn dưới dạng đối tượng JSON trong phần nội dung POST.
Lưu ý việc sử dụng queryHistoryRecord thay thế cho queryRecord của API CrUX hằng ngày.
Ví dụ về nội dung:
{
"origin": "https://example.com",
"formFactor": "PHONE",
"metrics": [
"largest_contentful_paint",
"experimental_time_to_first_byte"
]
}
Ví dụ: bạn có thể gọi hàm này từ curl bằng dòng lệnh sau (thay thế API_KEY bằng khoá của bạn):
curl -s --request POST 'https://chromeuxreport.googleapis.com/v1/records:queryHistoryRecord?key=API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"formFactor":"PHONE","origin":"https://www.example.com","metrics":["largest_contentful_paint", "experimental_time_to_first_byte"]}'
Bạn có thể xem dữ liệu cấp trang thông qua API bằng cách truyền thuộc tính url trong truy vấn thay vì origin:
{
"url": "https://example.com/page",
"formFactor": "PHONE",
"metrics": [
"largest_contentful_paint",
"experimental_time_to_first_byte"
]
}
Nếu bạn không đặt thuộc tính metrics, thì tất cả chỉ số hiện có sẽ được trả về:
cumulative_layout_shiftfirst_contentful_paintinteraction_to_next_paintlargest_contentful_paintexperimental_time_to_first_bytelargest_contentful_paint_resource_typelargest_contentful_paint_image_time_to_first_bytelargest_contentful_paint_image_resource_load_delaylargest_contentful_paint_image_resource_load_durationlargest_contentful_paint_image_element_render_delaynavigation_typesround_trip_timeform_factors(chỉ được báo cáo nếu không cóformFactornào được chỉ định trong yêu cầu)
Nếu bạn không cung cấp giá trị formFactor, thì các giá trị sẽ được tổng hợp trên tất cả các hệ số hình dạng.
Hãy xem hướng dẫn Sử dụng API nhật ký CrUX để biết thêm các truy vấn mẫu.
Quy trình dữ liệu
Tập dữ liệu CrUX được xử lý thông qua một quy trình để hợp nhất, tổng hợp và lọc dữ liệu trước khi cung cấp thông qua API.
Trung bình luân phiên
Dữ liệu trong Báo cáo trải nghiệm người dùng trên Chrome là giá trị trung bình luân phiên trong 28 ngày của các chỉ số tổng hợp. Điều này có nghĩa là dữ liệu được trình bày trong Báo cáo trải nghiệm người dùng trên Chrome tại bất kỳ thời điểm nào thực sự là dữ liệu của 28 ngày qua được tổng hợp lại với nhau.
API Nhật ký chứa một số khoảng thời gian thu thập, mỗi khoảng thời gian kéo dài 28 ngày. Vì mỗi khoảng thời gian thu thập dữ liệu chứa dữ liệu tổng hợp trong 28 ngày trước đó và khoảng thời gian thu thập dữ liệu là hằng tuần, nên các khoảng thời gian thu thập dữ liệu sẽ trùng lặp. Các chỉ số này tương tự như giá trị trung bình động của dữ liệu, trong đó mỗi khoảng thời gian tiếp theo bao gồm dữ liệu trong 3 tuần và một tuần khác.
Thông tin cập nhật hằng tuần
API Nhật ký được cập nhật vào mỗi thứ Hai lúc khoảng 04:00 (giờ UTC) và chứa dữ liệu cho đến thứ Bảy trước đó (theo độ trễ tiêu chuẩn là 2 ngày). Báo cáo này chứa dữ liệu của 40 tuần trước (khoảng 10 tháng), mỗi tuần có một khoảng thời gian thu thập dữ liệu. Xin lưu ý rằng theo mặc định, chúng tôi trả về 25 mục nhập cho mỗi chuỗi thời gian; nhưng bạn có thể ghi đè số lượng này bằng cách chỉ định tham số yêu cầu collectionPeriodCount.
Không có thoả thuận mức độ cung cấp dịch vụ nào về thời gian cập nhật; quá trình này được chạy dựa trên nỗ lực tốt nhất mỗi ngày.
Lược đồ
Có một điểm cuối duy nhất cho API Nhật ký CrUX chấp nhận các yêu cầu HTTP POST. API trả về một record chứa một hoặc nhiều metrics tương ứng với dữ liệu hiệu suất về nguồn gốc hoặc trang được yêu cầu.
Yêu cầu HTTP
POST https://chromeuxreport.googleapis.com/v1/records:queryHistoryRecord
URL sử dụng cú pháp Chuyển mã gRPC.
Nội dung yêu cầu
API Nhật ký CrUX sử dụng nội dung yêu cầu tương tự như API CrUX hằng ngày, với một trường "collectionPeriodCount" bổ sung, không bắt buộc:
{
"formFactor": enum (FormFactor),
"metrics": [
string
],
// Union field url_pattern can be only one of the following:
"origin": string,
"url": string,
// End of list of possible types for union field url_pattern.
"collectionPeriodCount": int32 // Optional: Number of periods to collect
}
| Trường | |
|---|---|
formFactor |
Hệ số hình dạng là một phương diện truy vấn chỉ định lớp thiết bị mà dữ liệu của bản ghi thuộc về. Trường này sử dụng các giá trị Lưu ý: Nếu bạn không chỉ định hệ số hình dạng nào, thì hệ thống sẽ trả về một bản ghi đặc biệt có dữ liệu tổng hợp trên tất cả các hệ số hình dạng. |
metrics[] |
Các chỉ số cần đưa vào phản hồi. Nếu bạn không chỉ định chỉ số nào, thì hệ thống sẽ trả về mọi chỉ số tìm thấy. Giá trị được phép: |
Trường hợp hợp nhất url_. url_pattern là giá trị nhận dạng chính cho một lượt tra cứu bản ghi. Chỉ có thể là một trong những loại sau: |
|
origin |
"Nguồn gốc" Ví dụ: |
url |
Ví dụ: |
Kết thúc trường Union url_. |
|
collectionPeriodCount |
Số chu kỳ thu thập dữ liệu cần trả về từ 1 đến 40. Giá trị mặc định là 25. Lưu ý nếu bạn không chỉ định |
Ví dụ: để yêu cầu các giá trị Thời gian hiển thị nội dung lớn nhất trên máy tính cho trang chủ web.dev:
{
"url": "https://web.dev/",
"formFactor": "DESKTOP",
"metrics": [
"largest_contentful_paint"
]
}
Yêu cầu tương tự này bao gồm trường collectionPeriodCount không bắt buộc và sẽ trả về 40 mục theo chuỗi thời gian cung cấp khoảng 10 tháng nhật ký hiệu suất web cho nguồn https://web.dev:
{
"url": "https://web.dev/",
"formFactor": "DESKTOP",
"metrics": [
"largest_contentful_paint"
],
"collectionPeriodCount": 40
}
Nội dung phản hồi
Các yêu cầu thành công sẽ trả về phản hồi có đối tượng record và urlNormalizationDetails theo cấu trúc sau:
{
"record": {
"key": {
object (Key)
},
"metrics": [
string: {
object (Metric)
}
]
},
"urlNormalizationDetails": {
object (UrlNormalization)
}
}
Ví dụ: nội dung phản hồi cho phần nội dung yêu cầu trong yêu cầu trước đó có thể là:
{
"record": {
"key": {
"origin": "https://web.dev"
},
"metrics": {
"largest_contentful_paint": {
"histogramTimeseries": [{
"start": 0, "end": 2500, "densities": [
0.9190, 0.9203, 0.9194, 0.9195, 0.9183, 0.9187, ...
]
}, {
"start": 2500, "end": 4000, "densities": [
0.0521, 0.0513, 0.0518, 0.0518, 0.0526, 0.0527, ...
]
}, {
"start": 4000, "densities": [
0.0288, 0.0282, 0.0286, 0.0285, 0.0290, 0.0285, ...
]
}
],
"percentilesTimeseries": {
"p75s": [
1362, 1352, 1344, 1356, 1366, 1377, ...
]
}
}
},
"collectionPeriods": [{
"firstDate": { "year": 2022, "month": 7, "day": 10 },
"lastDate": { "year": 2022, "month": 8, "day": 6 }
}, {
"firstDate": { "year": 2022, "month": 7, "day": 17 },
"lastDate": { "year": 2022, "month": 8, "day": 13 }
}, {
"firstDate": { "year": 2022, "month": 7, "day": 24 },
"lastDate": { "year": 2022, "month": 8, "day": 20 }
}, {
"firstDate": { "year": 2022, "month": 7, "day": 31 },
"lastDate": { "year": 2022, "month": 8, "day": 27 }
}, {
"firstDate": { "year": 2022, "month": 8, "day": 7 },
"lastDate": { "year": 2022, "month": 9, "day": 3 }
}, {
"firstDate": { "year": 2022, "month": 8, "day": 14 },
"lastDate": { "year": 2022, "month": 9, "day": 10 }
}, {
...
}
]
}
}
Khoá
Key xác định tất cả các phương diện xác định bản ghi này là duy nhất.
{
"formFactor": enum (FormFactor),
// Union field url_pattern can be only one of the following:
"origin": string,
"url": string
// End of list of possible types for union field url_pattern.
}
| Trường | |
|---|---|
formFactor |
Kiểu dáng là lớp thiết bị mà tất cả người dùng đã dùng để truy cập vào trang web cho bản ghi này. Nếu bạn không chỉ định kiểu dáng thiết bị, thì hệ thống sẽ trả về dữ liệu tổng hợp trên tất cả kiểu dáng thiết bị. |
Trường hợp hợp nhất url_. Mẫu URL là URL mà bản ghi áp dụng. url_ chỉ có thể là một trong những giá trị sau: |
|
origin |
Origin chỉ định nguồn gốc của bản ghi này. Lưu ý: Khi bạn chỉ định một nguồn gốc, dữ liệu cho các lượt tải trong nguồn gốc này trên tất cả các trang sẽ được tổng hợp thành dữ liệu trải nghiệm người dùng ở cấp nguồn gốc. |
url |
Lưu ý: Khi chỉ định |
Chỉ số
metric là một tập hợp dữ liệu trải nghiệm người dùng cho một chỉ số hiệu suất web, chẳng hạn như lượt vẽ nội dung đầu tiên. Tệp này chứa biểu đồ tóm tắt về mức sử dụng Chrome trong thực tế dưới dạng một loạt bins.
{
"histogramTimeseries": [
{
object (Bin)
}
],
"percentilesTimeseries": {
object (Percentiles)
}
}
hoặc
"fractionTimeseries": {
object (Fractions)
}
| Trường | |
|---|---|
histogramTimeseries[] |
Biểu đồ dạng đường thời gian về trải nghiệm người dùng cho một chỉ số. Biểu đồ dạng hình thang theo chuỗi thời gian sẽ có ít nhất một nhóm và mật độ của tất cả các nhóm sẽ cộng lại bằng khoảng 1. Các giá trị bị thiếu cho Khoảng thời gian thu thập dữ liệu cụ thể đó sẽ được đánh dấu là |
percentilesTimeseries |
Các phân vị hữu ích phổ biến của Chỉ số. Loại giá trị cho các phân vị sẽ giống với loại giá trị được cung cấp cho các vùng chứa Biểu đồ thanh. Các giá trị bị thiếu cho Khoảng thời gian thu thập dữ liệu cụ thể đó sẽ được đánh dấu là |
fractionTimeseries |
Đối tượng này chứa chuỗi thời gian của các phân số được gắn nhãn, tổng cộng khoảng 1 cho mỗi mục nhập. Phân số được làm tròn đến 4 chữ số thập phân. Các mục bị thiếu được biểu thị là"NaN" trên tất cả các phân số. |
Thùng
bin là một phần dữ liệu riêng biệt trải dài từ đầu đến cuối hoặc nếu không có điểm cuối được cung cấp từ đầu đến vô cực dương.
Giá trị bắt đầu và kết thúc của một nhóm được cung cấp theo loại giá trị của chỉ số mà nhóm đó đại diện. Ví dụ: lượt vẽ nội dung đầu tiên được đo bằng mili giây và hiển thị dưới dạng int, do đó, các bộ chứa chỉ số sẽ sử dụng int32 cho các loại bắt đầu và kết thúc. Tuy nhiên, độ lệch bố cục tích luỹ được đo bằng số thập phân không có đơn vị và được hiển thị dưới dạng số thập phân được mã hoá dưới dạng chuỗi, do đó, các nhóm chỉ số của độ lệch bố cục tích luỹ sẽ sử dụng chuỗi cho loại giá trị.
{
"start": value,
"end": value,
"densities": [number, number, number...etc.]
}
| Trường | |
|---|---|
start |
Start (Bắt đầu) là phần đầu của vùng chứa dữ liệu. |
end |
End (Kết thúc) là phần cuối của vùng chứa dữ liệu. Nếu không điền giá trị cho end, thì vùng chứa sẽ không có điểm cuối và hợp lệ từ start đến +inf. |
densities |
Một chuỗi thời gian về tỷ lệ phần trăm người dùng đã trải nghiệm giá trị của bộ chứa này cho chỉ số nhất định. Mật độ được làm tròn đến 4 chữ số thập phân. |
Phân vị
Percentiles chứa các giá trị tổng hợp của một chỉ số tại một phân vị thống kê nhất định. Các chỉ số này được dùng để ước tính giá trị của một chỉ số theo tỷ lệ phần trăm người dùng trong tổng số người dùng.
{
"P75": value
}
| Trường | |
|---|---|
p75s |
Dữ liệu theo chuỗi thời gian của các giá trị mà 75% số lượt tải trang đã trải nghiệm chỉ số nhất định ở mức hoặc thấp hơn giá trị này. |
Phân số
Fractions chứa chuỗi thời gian của các phân số được gắn nhãn có tổng cộng ~1 cho mỗi mục nhập.
Mỗi nhãn mô tả một lượt tải trang theo một cách nào đó, vì vậy, các chỉ số được biểu thị theo cách này có thể được coi là tạo ra các giá trị riêng biệt thay vì giá trị số và các phân số thể hiện tần suất đo lường một giá trị riêng biệt cụ thể.
{
"label_1": { "fractions": array[fraction]},
"label_1": { "fractions": array[fraction]},
...
"label_n": { "fractions": array[fraction]}
}
Tương tự như các giá trị mật độ trong các bộ chứa biểu đồ, mỗi fraction là một số 0.0 <= value <= 1.0 và chúng cộng lại bằng ~1.0. Khi không có chỉ số này cho một khoảng thời gian thu thập dữ liệu cụ thể, thì mục tương ứng sẽ là "NaN" trong tất cả các mảng phân số.
| Trường | |
|---|---|
p75s |
Dữ liệu theo chuỗi thời gian của các giá trị mà 75% số lượt tải trang có chỉ số nhất định ở mức hoặc thấp hơn giá trị này. |
UrlNormalization
Đối tượng đại diện cho các hành động chuẩn hoá được thực hiện để chuẩn hoá URL nhằm tăng cơ hội tra cứu thành công. Đây là những thay đổi cơ bản, tự động được thực hiện khi tìm nạp url_pattern được cung cấp sẽ không thành công. Các hành động phức tạp như theo lệnh chuyển hướng sẽ không được xử lý.
{
"originalUrl": string,
"normalizedUrl": string
}
| Trường | |
|---|---|
originalUrl |
URL ban đầu được yêu cầu trước khi thực hiện bất kỳ hành động chuẩn hoá nào. |
normalizedUrl |
URL sau khi thực hiện bất kỳ hành động chuẩn hoá nào. Đây là một URL trải nghiệm người dùng hợp lệ và có thể được tra cứu một cách hợp lý. |
Giới hạn số lượng yêu cầu
API Nhật ký CrUX có cùng giới hạn với API CrUX là 150 truy vấn mỗi phút cho mỗi dự án Google Cloud đối với cả hai API này. Cả hai API đều được cung cấp miễn phí. Bạn có thể xem hạn mức này và mức sử dụng hiện tại trong Google Cloud Console. Hạn mức hào phóng này sẽ đủ cho hầu hết các trường hợp sử dụng và bạn không thể trả tiền để tăng hạn mức.