Tài liệu này xác định những 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 tuỳ chỉnh từ YouTube Analytics.
Chỉ số là các phép đo 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. Các chỉ số về hoạt động của người dùng bao gồm những thông tin như số lượt xem và điểm xếp hạng video (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 ngừng sử dụng được nêu trong Điều khoản dịch vụ, nhưng các chỉ số không phải chính (và phương diện không phải chính) thì không phải tuân thủ chính sách này. Trong phần định nghĩa trên trang này, mọi chỉ số là chỉ số cốt lõi đều được xác định rõ ràng là chỉ số cốt lõi.
Danh sách bên dưới xác định các chỉ số cốt lõi của API.
annotationClickThroughRate
annotationCloseRate
averageViewDuration
comments
dislikes
estimatedMinutesWatched
estimatedRevenue
likes
shares
subscribersGained
subscribersLost
viewerPercentage
views
Hãy xem danh sách các API YouTube tuân theo Chính sách 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:
- Trong báo cáo video, chỉ số này cho biết 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 bối cảnh của 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 các 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 đó trong bối cảnh 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 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ố về danh sách phát.
- redViews
- Số lần thành viên YouTube Premium (trước đây gọi là YouTube Red) xem một video.
- viewerPercentage (chỉ số chính)
- 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ố chính)
- Số phút người dùng xem video của kênh, chủ sở hữu nội dung, video hoặc danh sách phát được chỉ định. This is a core metric and is subject to the Deprecation Policy.
- estimatedRedMinutesWatched
- Số phút mà 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 các lượt phát video. Kể từ ngày 13 tháng 12 năm 2021, chỉ số này sẽ loại trừ lưu lượng truy cập của đoạn video phát 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 các lượt phát video đã xảy 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 được xem trong khi phát video. Kể từ ngày 13 tháng 12 năm 2021, chỉ số này sẽ loại trừ lưu lượng truy cập của đoạn video phát lặp lại.
Chỉ số tương tác
- bình luận (chỉ số chính)
- Số lần người dùng bình luận 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ố chính)
- Số lần người dùng cho biết rằng 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.
- số lượt không thích (chỉ số cốt lõi)
- Số lần người dùng cho biết rằng 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ẻ 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.
Kênh có thể tăng hoặc giảm số người đăng ký ở một số nơi, bao gồm trang xem video, trang kênh và phần 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 cả những người đăng ký có được từ bất kỳ vị trí nào trong số này. Tuy nhiên, trong những báo cáo sử dụng phương diệnvideo
hoặc tham sốfilter
để hạn chế phản hồ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 huỷ đăng ký 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ả những người đăng ký bị mất thông qua bất kỳ cơ chế nào mà 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ế phản hồ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ý trang xem của video được chỉ định. - videosAddedToPlaylists
- Số lần video được thêm vào danh sách phát trên YouTube. Video có thể đã được thêm vào danh sách phát của chủ sở hữu video hoặc vào danh sách phát của các kênh khác.
Giá trị của chỉ số này bao gồm cả số lần video được thêm vào các 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ì giá trị của chỉ số này sẽ phản ánh việc 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 đối với những ngày trước ngày 1 tháng 10 năm 2014. - videosRemovedFromPlaylists
- Số lần video bị xoá khỏi danh sách phát trên YouTube. Các 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 các kênh khác.
Giá trị của chỉ số này bao gồm số lần video bị xoá khỏi các 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 video đó rồi xoá lại video đó, thì giá trị của chỉ số này sẽ cho biết video đó đã bị xoá khỏi danh sách phát hai lần. Không có dữ liệu cho chỉ số này đối với những ngày trước ngày 1 tháng 10 năm 2014.
Chỉ số của danh sách phát
Báo cáo danh sách phát chứa 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 cung cấp các chỉ số về hoạt động của người dùng và lượt hiển thị được tổng hợp cho tất cả video trong danh sách phát mà kênh sở hữu danh sách phát đó cũng sở hữu. Các chỉ số của video thuộc quyền sở hữu của các kênh khác sẽ 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 thuộc quyền sở hữu của các kênh khác, thì báo cáo cho những danh sách phát đó sẽ không cung cấp giá trị cho các chỉ số này.
Hãy tham khảo phần chỉ số lượt xem và chỉ số thời gian xem trong tài liệu này để biết định nghĩa về các chỉ số video tổng hợp được hỗ trợ.
-
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 trong 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 nào sở hữu các video đó, nhưng chỉ tính số lượt xem xảy ra trong bối cảnh danh sách phát.
Hầu hết các chỉ số được liệt kê dưới đây 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ề lượt 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 các video trong danh sách phát. Do đó, những chỉ số đó sẽ không được phân loại là chỉ số video tổng hợp hoặc 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à người xem xem video trong một danh sách phát sau khi bắt đầu phát danh sách phát đó. Xin lưu ý rằng chỉ số này chỉ bao gồm các lượt xem danh sách phát xảy ra trên web.
- playlistAverageViewDuration
- Thời lượng trung bình ước tính (tính bằng giây) mà người dùng xem trong 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 lượt xem 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ề các video trong danh sách phát thuộc quyền sở hữu của các kênh khác. - playlistEstimatedMinutesWatched
- Số phút người dùng xem nội dung trong danh sách phát. Thời gian xem xảy ra trong các ngữ cảnh khác (ví dụ: thời gian xem từ các lượt xem xảy ra khi người xem đ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 thuộc quyền sở hữu của các kênh khác.
- playlistSaves
- Số lần người dùng đã lưu một danh sách phát. Hãy xem 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ề số 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 danh sách phát đó, thì giá trị chỉ số sẽ phản ánh việc thêm một lượt lưu danh sách phát.
- 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 các lượt xem danh sách phát xảy ra trên web.
- playlistViews
- Số lần video trong danh sách phát được xem trong bối cảnh 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 thuộc quyền sở hữu của các kênh khác.
- viewsPerPlaylistStart
- Số lượt xem video trung bình xảy ra mỗi khi người dùng bắt đầu xem một danh sách phát. Xin lưu ý rằng chỉ số này chỉ bao gồm các lượt xem danh sách phát xảy ra trên web.
Chỉ số chú thích
Lưu ý: Kể từ ngày 10 tháng 6 năm 2012, các báo cáo của YouTube Analytics API chỉ trả về dữ liệu cho chỉ số annotationClickThroughRate
và annotationCloseRate
. Ngoài ra, các báo cáo của API YouTube Analytics chỉ trả về dữ liệu cho các 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ố chú thích được nhấp vào.
- annotationClickThroughRate (chỉ số chính)
- 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. 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 đường liên kết.
- annotationClosableImpressions
- Số lượng chú thích đã xuất hiện và có thể đóng.
- annotationCloses
- Số lượng chú thích đã đóng.
- annotationCloseRate (chỉ số chính)
- Tỷ lệ phần trăm 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ố 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 thẻ trong YouTube Analytics.
- cardImpressions
- Số lần thẻ hiển thị. Khi bảng điều khiển thẻ mở ra, hệ thống sẽ ghi lại một lượt hiển thị thẻ cho mỗi thẻ trong video.
- cardClicks
- Số lần người dùng nhấp vào thẻ đó.
- cardClickRate
- Tỷ lệ nhấp của thẻ, được tính bằng tỷ lệ giữa số lượt nhấp vào thẻ so với số lượt hiển thị thẻ.
- Số lần quảng cáo thẻ đó hiển thị. Một lượt xem video có thể tạo ra nhiều lượt hiển thị đoạn giới thiệu.
- Số lượt nhấp vào quảng cáo thẻ. Số lượt nhấp vào biểu tượng thẻ được tính cho dòng giới thiệu gần đây nhất mà người dùng nhìn thấy.
- 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ẻ so với tổng số lượt hiển thị dòng giới thiệu thẻ.
Chỉ số của sự kiện phát trực tiếp (số người xem đồng thời)
- averageConcurrentViewers
- Số người xem đồng thời trung bình của một video cụ thể. Nếu bạn chỉ định phương diện livestreamPosition cho báo cáo, thì giá trị
averageConcurrentViewers
sẽ chỉ định số người xem đồng thời trung bình trong một phân khúc cụ thể - peakConcurrentViewers
- Số người xem đồng thời cao nhất của một video cụ thể. Nếu bạn chỉ định phương diện livestreamPosition cho báo cáo, thì giá trị
peakConcurrentViewers
sẽ chỉ định số người xem đồng thời cao nhất trong một phân đoạn cụ thể của video.
Chỉ số về tỷ lệ giữ chân người xem
- audienceWatchRatio
- Tỷ lệ tuyệt đối của những người xem đang xem video tại một thời điểm nhất định trong video. Tỷ lệ này được tính bằng cách so sánh số lần một phần của video được xem 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ố.
Xin lưu ý rằng một phần video có thể được xem nhiều lần (hoặc không được xem) 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 của video nhiều lần, thì tỷ lệ tuyệt đối của phần video đó có thể lớn hơn1
.
Các ví dụ sau đây minh hoạ cách tính giá trị:- Một video dài 1 phút được xem 100 lần. Một nửa số người xem ngừng xem sau 15 giây và số còn lại xem toàn bộ video. Không có người xem nào xem lại bất kỳ phần nào của video. Trong trường hợp này, giá trị của chỉ số này sẽ là
1
đối với các khoảng thời gian trong phần tư đầu tiên của video và giá trị của chỉ số này sẽ là0.50
đối với phần còn lại của video. - Một video dài 1 phút được xem 100 lần. Tất cả người xem đều xem toàn bộ video, nhưng 20 người xem xem đến điểm 45 giây của video, sau đó bỏ qua trở lại điểm 30 giây của video rồi xem phần còn lại. Trong trường hợp này, giá trị của chỉ số sẽ là
1
cho các khoảng thời gian trong nửa đầu hoặc quý cuối của video. Tuy nhiên, giá trị này sẽ là1.2
đối với các khoảng thời gian trong quý thứ ba của video vì 100% người xem đã xem đoạn video đó nhưng 20% người xem đã xem đoạn video đó hai lần.
- Một video dài 1 phút được xem 100 lần. Một nửa số người xem ngừng xem sau 15 giây và số còn lại xem toàn bộ video. Không có người xem nào xem lại bất kỳ phần nào của video. Trong trường hợp này, giá trị của chỉ số này sẽ là
- relativeRetentionPerformance
- Chỉ số đo lường mức độ giữ chân người xem của một video trong khi phát so với tất cả các video khác trên YouTube có thời lượng tương tự. Chỉ số này có giá trị từ
0
đến1
, cho biết hiệu suất giữ chân 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 còn lại giữ chân người xem kém hiệu quả 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% số 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ỉ 80% người xem vẫn xem sau 3 phút, nhưng tất cả những người xem đó vẫn xem sau 8 phút.- Tại giá trị
elapsedVideoTimeRatio
tương ứng với thời điểm 3 phút trong video, 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 8 phút trong video, 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ị
- startedWatching
- Số lần một đoạn video cụ thể là đoạn đầu tiên được xem trong quá trình phát video.
Ví dụ: Giả sử Video X có thời lượng 5 phút. Để phục vụ cho báo cáo này, YouTube chia video thành 100 phân đoạn dài 3 giây. Các phân đoạn này được xác định bằng phương diện elapsedVideoTimeRatio. Một người xem truy cập vào YouTube và xem 1 phút 10 giây đầu tiên của video, bao gồm tất cả hoặc một phần trong số 24 phân đoạn đầu tiên của video. Trong một lần truy cập tiếp theo trên YouTube, người xem xem phần còn lại của video, tiếp tục phát từ phân đoạn 24 và xem đến phân đoạn 100.
Ví dụ này sẽ tạo ra các giá trị chỉ số về đồng hồ sau:- Giá trị của chỉ số
startedWatching
sẽ là1
đối với phân khúc 1 và 24, còn giá trị của chỉ số sẽ là0
đối với tất cả các phân khúc khác. - Giá trị của chỉ số
stoppedWatching
sẽ là1
đối với các phân khúc 24 và 100, còn giá trị của chỉ số sẽ là0
đối với tất cả các phân khúc khác. - Giá trị của chỉ số
totalSegmentImpressions
sẽ là2
đối với phân khúc 24 và giá trị của chỉ số sẽ là1
đối với tất cả các phân khúc khác.
- Giá trị của chỉ số
- stoppedWatching
- Số lần một đoạn video cụ thể là đoạn video cuối cùng được xem trong quá trình phát video. Hãy tham khảo định nghĩa của chỉ số
startedWatching
để biết ví dụ về cách tính giá trị chỉ số này. - totalSegmentImpressions
- Số lần một đoạn cụ thể trong video được xem. Hãy tham khảo định nghĩa của chỉ số
startedWatching
để biết ví dụ về cách tính giá trị chỉ số này. Xin lưu ý rằng người xem có thể xem cùng một đoạn video nhiều lần trong cùng một lượt phát.
Chỉ số về lượt huỷ gói thành viên
- membershipsCancellationSurveyResponses
- Số người dùng YouTube đã hoàn tất bản khảo sát và đã huỷ gói hội viên của kênh trong khoảng thời gian báo cáo.
Chỉ số doanh thu ước tính
Lưu ý: Các chỉ số doanh thu ước tính sẽ có sự điều chỉnh vào cuối tháng và không bao gồm doanh thu từ quảng cáo do đối tác bán và 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ố về doanh thu ước tính và hiệu suất quảng cáo, 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ố chính) (trước đây có tên là
earnings
) - Tổng doanh thu ròng ước tính từ tất cả các nguồn quảng cáo do 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ố doanh thu ước tính sẽ có sự điều chỉnh vào cuối tháng và không bao gồm doanh thu từ quảng cáo do đối tác bán và phân phát.
- estimatedAdRevenue (trước đây có tên là
adEarnings
) - Tổng doanh thu ròng ước tính từ tất cả các nguồn quảng cáo do Google bán trong phạm vi ngày và khu vực đã chọn.
Các chỉ số doanh thu ước tính sẽ có sự điều chỉnh vào cuối tháng và không bao gồm doanh thu từ quảng cáo do đối tác bán và phân phát. - estimatedRedPartnerRevenue (trước đây có tên 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) theo 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 và 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
- Doanh thu gộp ước tính (tính bằng đô la Mỹ) từ tất cả quảng cáo do Google bán hoặc do đối tác DoubleClick bán trong phạm vi ngày và khu vực đã chọn. Tổng doanh thu phải tuân theo đ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. Bạn không nên nhầm lẫn tổng doanh thu với doanh thu ước tính hoặc doanh thu thuần. Những chỉ số này tính đến tỷ lệ sở hữu và các thoả thuận chia sẻ doanh thu của bạn.
- cpm (trước đây có tên là
impressionBasedCpm
) - Tổng doanh thu ước tính trên một nghìn lượt hiển thị quảng cáo.
- adImpressions (trước đây có tên là
impressions
) - Số lượt hiển thị quảng cáo đã được xác minh được phân phát.
- monetizedPlaybacks
- Số lần 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. Lượt phát có thể kiếm tiền được tính nếu người xem nhìn thấy quảng cáo trước video nhưng ngừng xem quảng cáo đó trước khi video của bạn bắt đầu. 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ột nghìn lượt phát.