Tài liệu này xác định các chỉ số mà bạn có thể truy xuất bằng API YouTube Analytics. API này hỗ trợ các truy vấn theo thời gian thực để tạo báo cáo YouTube Analytics tuỳ chỉnh.
Chỉ số là các chỉ số đo lường riêng lẻ về hoạt động của người dùng, hiệu suất quảng cáo hoặc doanh thu ước tính. Chỉ số hoạt động của người dùng bao gồm những thông tin như số lượt xem video và điểm xếp hạng (lượt thích và lượt không thích).
Chỉ số chính
Mặc dù API YouTube Analytics phải tuân thủ Chính sách về việc ngừng sử dụng được quy định trong Điều khoản dịch vụ, nhưng các chỉ số không phải phương diện chính (và phương diện không phải phương diện chính) sẽ không phải tuân thủ chính sách này. Trong các định nghĩa trên trang này, bất kỳ chỉ số nào là chỉ số chính đều được xác định rõ ràng theo cách đó.
Danh sách dưới đây xác định các chỉ số chính của API.
annotationClickThroughRate
annotationCloseRate
averageViewDuration
comments
dislikes
estimatedMinutesWatched
estimatedRevenue
likes
shares
subscribersGained
subscribersLost
viewerPercentage
views
- Chỉ số cốt lõi
earnings
đã ngừng hoạt động vào ngày 4 tháng 8 năm 2016 và đổi tên thànhestimatedRevenue
. Để tuân thủ Chính sách về việc ngừng sử dụng nêu trong Điều khoản dịch vụ, các chỉ sốearnings
vàestimatedRevenue
được hỗ trợ đồng thời cho đến hết ngày 10 tháng 8 năm 2017. - Các chỉ số chính
favoritesAdded
vàfavoritesRemoved
đã ngừng hoạt động từ ngày 31 tháng 3 năm 2015. Bạn chỉ có thể truy xuất các chỉ số này thông qua API YouTube Analytics.
Hãy xem danh sách các API YouTube tuân thủ Chính sách về việc ngừng sử dụng để biết thêm thông tin.
Xem các chỉ số
- lượt xem (chỉ số chính)
- Chỉ số này thể hiện các con số khác nhau trong các loại báo cáo khác nhau:
- Trong báo cáo video, chỉ số này chỉ định số lần một video được xem.
- Trong các báo cáo danh sách phát không sử dụng phương diện
isCurated
, chỉ số này chỉ định tổng số lượt xem của các video trong danh sách phát, bất kể những lượt xem đó có xảy ra trong danh sách phát hay không. Xin lưu ý rằng giá trị chỉ số này chỉ bao gồm số lượt xem video của chủ sở hữu kênh.
Trong những báo cáo này, chỉ sốplaylistViews
cho biết số lần người dùng xem các video trong danh sách phát liên quan đến một danh sách phát cụ thể. - Trong các báo cáo danh sách phát sử dụng phương diện
isCurated
, chỉ số này cho biết số lần các video được xem trong một danh sách phát cụ thể. Xin lưu ý rằng chỉ sốplaylistViews
không được hỗ trợ cho các báo cáo này.
- playlistViews
- Chỉ số này được xác định trong phần chỉ số danh sách phát.
- redViews
- Số lần các thành viên YouTube Premium (trước đây gọi là YouTube Red) xem một video.
- duy nhất (không dùng nữa từ ngày 27 tháng 9 năm 2016)
- Số lượng người xem riêng biệt đã xem video. Cách tính toán này dựa trên số lượng cookie duy nhất nên sẽ tính thừa số người dùng đang sử dụng nhiều thiết bị hoặc trình duyệt.
Từ ngày 27 tháng 9 năm 2016, chúng tôi đã ngừng sử dụng chỉ sốuniques
. Đây không phải là chỉ số cốt lõi và sẽ được hỗ trợ cho đến hết ngày 31 tháng 10 năm 2016. - viewerPercentage (chỉ số cốt lõi)
- Tỷ lệ phần trăm người xem đã đăng nhập khi xem video hoặc danh sách phát. This is a core metric and is subject to the Deprecation Policy.
Chỉ số thời gian xem
- estimatedMinutesWatched (chỉ số cốt lõi)
- Số phút mà người dùng đã xem video cho một kênh, chủ sở hữu nội dung, video hoặc danh sách phát cụ thể. This is a core metric and is subject to the Deprecation Policy.
- estimatedRedMinutesWatched
- Số phút mà các thành viên YouTube Premium (trước đây gọi là YouTube Red) đã xem một video.
- averageViewDuration (chỉ số chính)
- Thời lượng trung bình (tính bằng giây) của lượt phát video. Kể từ ngày 13 tháng 12 năm 2021, chỉ số này không tính đến lưu lượng truy cập các đoạn video lặp lại. Trong báo cáo danh sách phát, chỉ số này cho biết thời lượng trung bình (tính bằng giây) của lượt phát lại video diễn ra trong danh sách phát. This is a core metric and is subject to the Deprecation Policy.
- averageViewPercentage
- Tỷ lệ phần trăm trung bình của một video đã xem trong lúc phát video. Kể từ ngày 13 tháng 12 năm 2021, chỉ số này không tính đến lưu lượng truy cập các đoạn video lặp lại.
Chỉ số tương tác
- bình luận (chỉ số cốt lõi)
- Số lần người dùng nhận xét về một video. Hãy truy cập vào Trung tâm trợ giúp của YouTube để biết thêm thông tin. This is a core metric and is subject to the Deprecation Policy.
- lượt thích (chỉ số cốt lõi)
- Số lần người dùng cho biết họ thích một video bằng cách đánh giá tích cực cho video đó. This is a core metric and is subject to the Deprecation Policy.
- lượt không thích (chỉ số chính)
- Số lần người dùng cho biết họ không thích một video bằng cách đánh giá tiêu cực cho video đó. This is a core metric and is subject to the Deprecation Policy.
- Số lần người dùng đã chia sẻ một video thông qua nút
Share
. Hãy truy cập vào Trung tâm trợ giúp của YouTube để biết thêm thông tin. This is a core metric and is subject to the Deprecation Policy. - subscribersGained (chỉ số chính)
- Số lần người dùng đăng ký theo dõi một kênh. This is a core metric and is subject to the Deprecation Policy.
Các kênh có thể có thêm hoặc để mất người đăng ký ở nhiều nơi, bao gồm cả trên trang xem video, trang kênh và hướng dẫn xuất hiện trên trang chủ YouTube. Trong báo cáo kênh, chỉ số này bao gồm số người đăng ký có được từ bất kỳ nơi nào trong số này. Tuy nhiên, trong các báo cáo sử dụng phương diệnvideo
hoặc tham sốfilter
để hạn chế câu trả lời chỉ bao gồm dữ liệu cho một video cụ thể, chỉ sốsubscribersGained
sẽ chỉ bao gồm số liệu thống kê từ trang xem của video được chỉ định. - subscribersLost (chỉ số chính)
- Số lần người dùng hủy đăng ký khỏi một kênh. This is a core metric and is subject to the Deprecation Policy.
Dữ liệu cho chỉ số này được báo cáo tương tự như chỉ sốsubscribersGained
. Trong báo cáo kênh, chỉ số này bao gồm cả số người đăng ký bị mất thông qua bất kỳ cơ chế nào mà thông qua đó người dùng có thể huỷ đăng ký kênh. Tuy nhiên, trong các báo cáo sử dụng phương diệnvideo
hoặc thông sốfilter
để hạn chế câu trả lời chỉ bao gồm dữ liệu cho một video cụ thể, chỉ số này chỉ bao gồm những người dùng đã huỷ đăng ký khỏi trang xem của video được chỉ định. - videosAddedToPlaylists
- Số lần video được thêm vào danh sách phát bất kỳ trên YouTube. Những video này có thể đã được thêm vào danh sách phát của chủ sở hữu video hoặc danh sách phát của kênh khác.
Giá trị chỉ số này bao gồm cả số lần các video được thêm vào danh sách phát mặc định như danh sách phát "Xem sau". Tuy nhiên, chỉ số này không tính những danh sách phát mà video được tự động thêm vào, chẳng hạn như danh sách phát video tải lên của kênh hoặc danh sách video đã xem của người dùng.
Chỉ số này trả về một con số tuyệt đối, nghĩa là nếu người dùng thêm một video vào danh sách phát, xoá video rồi thêm lại thì đây là giá trị chỉ số cho biết video được thêm vào danh sách phát hai lần. Không có dữ liệu cho chỉ số này cho những ngày trước ngày 1 tháng 10 năm 2014. - videosRemovedFromPlaylists
- Số lần video bị xóa khỏi danh sách phát bất kỳ trên YouTube. Video có thể đã bị xoá khỏi danh sách phát của chủ sở hữu video hoặc khỏi danh sách phát của kênh khác.
Giá trị chỉ số này bao gồm số lần video bị xoá khỏi danh sách phát mặc định như danh sách phát "Xem sau".
Chỉ số này trả về một con số tuyệt đối, nghĩa là nếu người dùng thêm một video vào danh sách phát, xoá video, thêm lại rồi lại xoá, thì đây là giá trị chỉ số phản ánh video bị xoá khỏi danh sách phát hai lần. Không có dữ liệu cho chỉ số này cho những ngày trước ngày 1 tháng 10 năm 2014.
Chỉ số tương tác không dùng nữa
Các chỉ số sau đây đều là chỉ số chính sẽ ngừng hoạt động từ ngày 31 tháng 3 năm 2015.
- favoritesAdded (chỉ số cốt lõi) (ngừng sử dụng từ ngày 31 tháng 3 năm 2015)
- Số lần người dùng đã đánh dấu một video là video yêu thích. Hãy truy cập vào Trung tâm trợ giúp của YouTube để biết thêm thông tin. This is a core metric and is subject to the Deprecation Policy.
- favoritesRemoved (chỉ số cốt lõi) (ngừng sử dụng từ ngày 31 tháng 3 năm 2015)
- Số lần người dùng xóa một video khỏi danh sách video yêu thích. Hãy truy cập vào Trung tâm trợ giúp của YouTube để biết thêm thông tin. This is a core metric and is subject to the Deprecation Policy.
Các chỉ số của danh sách phát
Báo cáo danh sách phát có hai loại chỉ số giải thích cách người xem tương tác với các video trong danh sách phát:
-
Chỉ số tổng hợp về video cho biết chỉ số về lượt hiển thị và hoạt động của người dùng được tổng hợp cho tất cả video trong danh sách phát cũng thuộc quyền sở hữu của kênh sở hữu danh sách phát đó. Chỉ số cho những video thuộc sở hữu của các kênh khác không được tính trong dữ liệu tổng hợp. Do đó, nếu một kênh tạo danh sách phát chỉ chứa video của các kênh khác, thì báo cáo về những danh sách phát đó sẽ không cung cấp giá trị cho những chỉ số này.
Hãy tham khảo các phần chỉ số lượt xem và chỉ số thời gian xem của tài liệu này để biết định nghĩa về các chỉ số tổng hợp được hỗ trợ cho video.
-
Chỉ số trong danh sách phát phản ánh hoạt động và mức độ tương tác của người dùng theo bối cảnh của trang danh sách phát. Các chỉ số này bao gồm số lượt xem của tất cả video trong danh sách phát (bất kể kênh sở hữu các video đó) nhưng chỉ tính số lượt xem xảy ra trong danh sách phát.
Hầu hết các chỉ số được liệt kê bên dưới đều là chỉ số trong danh sách phát. Các chỉ số còn lại trong danh sách, chẳng hạn như chỉ số playlistSaves
, là về hoạt động tương tác của người dùng với chính danh sách phát đó chứ không phải với video trong danh sách phát. Do đó, những chỉ số đó sẽ không được mô tả là
chỉ số tổng hợp về video hay chỉ số trong danh sách phát.
- averageTimeInPlaylist
- Thời lượng trung bình ước tính (tính bằng phút) mà một khán giả đã xem video trong một danh sách phát
sau khi phát danh sách phát. Xin lưu ý rằng chỉ số này chỉ bao gồm lượt xem danh sách phát
diễn ra trên web.
- playlistAverageViewDuration
- Thời lượng trung bình ước tính (tính bằng giây) của mỗi lượt xem danh sách phát. Xin lưu ý rằng chỉ số này
thể hiện thời lượng trung bình của các video riêng lẻ trong một danh sách phát. Ngược lại, chỉ số
averageTimeInPlaylist
thể hiện thời gian trung bình mà mỗi người xem dành để xem toàn bộ danh sách phát. Chỉ số này bao gồm dữ liệu về những video trong danh sách phát do các kênh khác sở hữu. - playlistEstimatedMinutesWatched
- Số phút mà người dùng đã xem nội dung trong danh sách phát của họ. Thời gian xem
trong các bối cảnh khác (ví dụ: thời gian xem của các lượt xem xảy ra khi
khán giả đang xem cùng một video trong các danh sách phát khác) sẽ không được tính. Chỉ số này
bao gồm dữ liệu về những video trong danh sách phát do các kênh khác sở hữu.
- playlistSaves
- Số lần thực mà người dùng đã lưu một danh sách phát. Truy cập vào
Trung tâm trợ giúp của YouTube
để biết thêm
thông tin về danh sách phát đã lưu. Chỉ số này trả về giá trị thay đổi ròng, nghĩa là nếu
người dùng lưu một danh sách phát, xoá danh sách phát đó khỏi danh sách danh sách phát đã lưu rồi lưu lại,
thì giá trị chỉ số cho biết một danh sách phát lưu đang được thêm vào.
- playlistStarts
- Số lần người xem phát một danh sách phát. Xin lưu ý rằng chỉ số này
chỉ bao gồm lượt xem danh sách phát xảy ra trên web.
- playlistViews
- Số lần các video trong danh sách phát được xem theo ngữ cảnh của danh sách phát đó.
Chỉ số này bao gồm dữ liệu về những video trong danh sách phát do các kênh khác sở hữu.
- viewsPerPlaylistStart
- Số lượt xem video trung bình mỗi khi danh sách phát được phát. Xin lưu ý rằng
chỉ số này chỉ bao gồm lượt xem danh sách phát xảy ra trên web.
Chỉ số chú thích
Lưu ý: Báo cáo API YouTube Analytics chỉ trả về dữ liệu cho chỉ số annotationClickThroughRate
và annotationCloseRate
kể từ ngày 10 tháng 6 năm 2012. Ngoài ra, báo cáo API YouTube Analytics chỉ trả về dữ liệu cho những chỉ số chú thích còn lại kể từ ngày 16 tháng 7 năm 2013.
- annotationImpressions
- Tổng số lượt hiển thị chú thích.
- annotationClickableImpressions
- Số lượng chú thích đã xuất hiện và có thể nhấp vào.
- annotationClicks
- Số lượng chú thích được nhấp vào.
- annotationClickThroughRate (chỉ số cốt lõi)
- Tỷ lệ giữa số chú thích mà người xem nhấp vào so với tổng số lượt hiển thị chú thích có thể nhấp vào. This is a core metric and is subject to the Deprecation Policy. Trung tâm trợ giúp của YouTube có thêm thông tin về cách tạo chú thích và sử dụng chú thích cho đường liên kết.
- annotationClosableImpressions
- Số lượng chú thích đã xuất hiện và có thể bị đóng.
- annotationCloses
- Số lượng chú thích đã đóng.
- annotationCloseRate (chỉ số cốt lõi)
- Tỷ lệ giữa số chú thích mà người xem đã đóng so với tổng số lượt hiển thị chú thích. This is a core metric and is subject to the Deprecation Policy.
Chỉ số về thẻ
Trung tâm trợ giúp của YouTube có hướng dẫn chi tiết hơn về cách thêm thẻ vào video và Báo cáo về thẻ trong YouTube Analytics.
- cardImpressions
- Số lần thẻ được hiển thị. Khi bảng điều khiển thẻ được mở, một lần hiển thị thẻ được ghi lại cho từng thẻ của video.
- cardClicks
- Số lần người dùng nhấp vào thẻ.
- cardClickRate
- Tỷ lệ nhấp vào thẻ, được tính bằng tỷ lệ giữa số lượt nhấp vào thẻ và số lượt hiển thị thẻ.
- Số lần dòng giới thiệu thẻ hiển thị. Một lượt xem video có thể tạo ra nhiều lượt hiển thị quảng cáo xem trước video.
- Số lượt nhấp vào dòng giới thiệu thẻ. Số lượt nhấp vào biểu tượng thẻ được tính cho dòng giới thiệu cuối cùng hiển thị cho người dùng.
- Tỷ lệ nhấp vào dòng giới thiệu thẻ, được tính bằng tỷ lệ giữa số lượt nhấp vào dòng giới thiệu thẻ trên tổng số lượt hiển thị dòng giới thiệu thẻ.
Chỉ số về tỷ lệ giữ chân người xem
- audienceWatchRatio
- Tỷ lệ tuyệt đối về số người xem video tại một thời điểm cụ thể trong video. Tỷ lệ này được tính bằng cách so sánh số lượt xem của một phần video với tổng số lượt xem của video đó. Phương diện
elapsedVideoTimeRatio
xác định phần video tương ứng với chỉ số này.
Xin lưu ý rằng trong một lượt xem video, người xem có thể xem một phần của một video nhiều lần (hoặc hoàn toàn không xem được) trong một lượt xem video nhất định. Ví dụ: nếu người dùng tua lại và xem cùng một phần trong một video nhiều lần, thì tỷ lệ tuyệt đối của phần đó của video có thể lớn hơn1
.
Sau đây là các ví dụ minh hoạ cách tính giá trị:- Một video dài 1 phút có 100 lượt xem. Một nửa số khán giả ngừng xem sau 15 giây và số còn lại xem toàn bộ video. Không có khán giả nào xem bất kỳ phần nào của video nhiều hơn một lần. Trong trường hợp này, giá trị của chỉ số này sẽ là
1
đối với nhóm thời gian trong quý đầu tiên của video và giá trị của chỉ số này sẽ là0.50
cho phần còn lại của video. - Một video dài 1 phút có 100 lượt xem. Tất cả khán giả đều xem toàn bộ video nhưng 20 người trong số đó xem đến mốc 45 giây của video, sau đó quay lại mốc 30 giây của video và sau đó xem phần còn lại của video. Trong trường hợp này, giá trị của chỉ số sẽ là
1
cho nhóm thời gian trong nửa đầu hoặc nửa cuối của video. Tuy nhiên, giá trị sẽ là1.2
đối với nhóm thời gian trong quý thứ ba của video vì 100% khán giả đã xem đoạn đó của video nhưng 20% khán giả đã xem phân đoạn đó hai lần.
- Một video dài 1 phút có 100 lượt xem. Một nửa số khán giả ngừng xem sau 15 giây và số còn lại xem toàn bộ video. Không có khán giả nào xem bất kỳ phần nào của video nhiều hơn một lần. Trong trường hợp này, giá trị của chỉ số này sẽ là
- relativeRetentionPerformance
- Một số liệu đo lường cho biết khả năng giữ chân người xem của một video trong khi phát lại so với tất cả các video trên YouTube có thời lượng tương tự. Chỉ số này có giá trị từ
0
đến1
giúp xác định hiệu suất giữ chân người xem tương đối của video tại một thời điểm nhất định trong video. Điểm trong video do phương diệnelapsedVideoTimeRatio
cung cấp.
Giá trị0
cho biết video giữ chân người xem kém hơn bất kỳ video nào khác có thời lượng tương tự, còn giá trị1
cho biết video giữ chân người xem tốt hơn bất kỳ video nào khác có thời lượng tương tự. Giá trị trung bình là0.5
cho biết một nửa số video có thời lượng tương tự giữ chân người xem hiệu quả hơn, còn một nửa giữ chân người xem kém hơn.
Ví dụ giả định sau đây minh hoạ cách các giá trị có thể xuất hiện trong báo cáo. Trung bình, 90% người xem video dài 10 phút vẫn xem tiếp sau 3 phút và 70% vẫn xem tiếp sau 8 phút. Tuy nhiên, đối với một video cụ thể dài 10 phút, chỉ có 80% khán giả vẫn xem tiếp sau 3 phút, nhưng tất cả khán giả đó vẫn xem tiếp sau 8 phút.- Tại giá trị
elapsedVideoTimeRatio
tương ứng với thời điểm video được 3 phút, chỉ sốrelativeRetentionPerformance
sẽ có giá trị thấp hơn0.5
vì tại thời điểm đó, video hoạt động kém hơn video trung bình. - Tại giá trị
elapsedVideoTimeRatio
tương ứng với thời điểm video được xem 8 phút, chỉ sốrelativeRetentionPerformance
sẽ có giá trị cao hơn0.5
vì tại thời điểm đó, video đang hoạt động hiệu quả hơn các video khác có thời lượng tương tự.
- Tại giá trị
Chỉ số doanh thu ước tính
Lưu ý: Các chỉ số về doanh thu ước tính có thể được điều chỉnh vào cuối tháng và không bao gồm quảng cáo do đối tác bán và quảng cáo do đối tác phân phát. Vui lòng xem Trung tâm trợ giúp của YouTube để biết thêm thông tin và ghi chú về số liệu doanh thu ước tính.
currency
cho một số chỉ số hiệu suất quảng cáo và doanh thu ước tính, cho phép bạn truy xuất dữ liệu doanh thu ước tính bằng các đơn vị tiền tệ khác.- estimatedRevenue (chỉ số cốt lõi) (trước đây gọi là
earnings
) - Tổng doanh thu ròng ước tính từ tất cả các nguồn quảng cáo mà Google đã bán cũng như từ các nguồn không phải quảng cáo trong phạm vi ngày và khu vực đã chọn.
This is a core metric and is subject to the Deprecation Policy.
Các chỉ số về doanh thu ước tính có thể được điều chỉnh vào cuối tháng và không bao gồm quảng cáo do đối tác bán và quảng cáo do đối tác phân phát.
- estimatedAdRevenue (trước đây là
adEarnings
) - Tổng doanh thu ròng ước tính từ tất cả các nguồn quảng cáo mà Google đã bán trong phạm vi ngày và khu vực đã chọn.
Các chỉ số về doanh thu ước tính có thể được điều chỉnh vào cuối tháng và không bao gồm quảng cáo do đối tác bán và quảng cáo do đối tác phân phát. - estimatedRedPartnerRevenue (trước đây gọi là
redPartnerRevenue
) - Tổng doanh thu ước tính kiếm được từ gói thuê bao YouTube Premium (trước đây gọi là YouTube Red) đối với các phương diện báo cáo đã chọn. Giá trị của chỉ số này phản ánh doanh thu từ cả nội dung âm nhạc lẫn nội dung không phải âm nhạc, đồng thời có thể được điều chỉnh vào cuối tháng.
Chỉ số hiệu suất quảng cáo
- grossRevenue
- Tổng doanh thu ước tính, tính bằng USD, từ tất cả các quảng cáo do Google bán hoặc đối tác của DoubleClick đã bán trong phạm vi ngày và khu vực đã chọn. Tổng doanh thu có thể được điều chỉnh cuối tháng và không bao gồm quảng cáo do đối tác phân phối. Không nên nhầm lẫn tổng doanh thu với doanh thu ước tính hoặc doanh thu ròng, một yếu tố trong thoả thuận chia sẻ doanh thu và phần sở hữu của bạn.
- cpm (trước đây gọi là
impressionBasedCpm
) - Tổng doanh thu ước tính trên mỗi nghìn lượt hiển thị quảng cáo.
- adImpressions (trước đây là
impressions
) - Số lượt hiển thị quảng cáo đã xác minh được phân phát.
- monetizedPlaybacks
- Số lần một người xem phát video của bạn và nhìn thấy ít nhất một lượt hiển thị quảng cáo. Một lượt phát có thể kiếm tiền sẽ được tính nếu người xem nhìn thấy một quảng cáo trước video nhưng bỏ xem quảng cáo đó trước khi video bắt đầu phát. Sai số ước tính dự kiến cho con số này là ±2,0%.
- playbackBasedCpm
- Tổng doanh thu ước tính trên mỗi nghìn lượt phát.