Tài liệu này xác định các chỉ số mà bạn có thể truy xuất bằng YouTube Analytics API. 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 trong 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 video và điểm xếp hạng (lượt thích và không thích).
Chỉ số cốt lõi
Mặc dù YouTube Analytics API tuân theo Chính sách về việc ngừng cung cấp được nêu trong Điều khoản dịch vụ, nhưng các chỉ số không cốt lõi (và phương diện không cốt lõi) không tuân theo chính sách này. Trong các định nghĩa trên trang này, mọi chỉ số cốt lõi đều được xác định rõ ràng.
Danh sách dưới đây xác định các chỉ số cốt lõi của API.
annotationClickThroughRateannotationCloseRateaverageViewDurationcommentsdislikesengagedViewsestimatedMinutesWatchedestimatedRevenuelikessharessubscribersGainedsubscribersLostviewerPercentageviews
Hãy xem danh sách các API của YouTube tuân theo Chính sách về việc ngừng cung cấp để biết thêm thông tin.
Xem các chỉ số
- engagedViews (chỉ số cốt lõi)
- Số lần các video của kênh được xem qua khung hình đầu tiên hoặc số lần người dùng nhấp/nhấn để phát.
- lượt xem (chỉ số cốt lõi)
- 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. Chỉ số này bao gồm cả số lượt cùng xem khi nhiều người cùng xem trên màn hình TV.
This is a core metric and is subject to the Deprecation Policy.
- playlistViews
- Chỉ số này được định nghĩa 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. Chỉ số này bao gồm cả số lượt cùng xem khi nhiều người cùng xem trên màn hình TV. 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 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 không bao gồm lưu lượng truy cập từ đ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 các lượt phát video trong một 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 một lần phát video. Kể từ ngày 13 tháng 12 năm 2021, chỉ số này không bao gồm lưu lượng truy cập từ đoạn video 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ố cốt lõi)
- 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.
- lượt không thích (chỉ số chính)
- 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ý 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 cả 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 số người đăng ký có được từ bất kỳ nơi nào trong số này. Tuy nhiên, trong những báo cáo sử dụng phương diệnvideohoặc tham sốfilterđể giới hạn phản hồi chỉ bao gồm dữ liệu cho một video cụ thể, chỉ sốsubscribersGainedsẽ 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 số người đăng ký đã huỷ đăng ký kênh thông qua bất kỳ cơ chế nào. Tuy nhiên, trong những báo cáo sử dụng phương diệnvideohoặc tham sốfilterđể giới hạn 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ý trên 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. Các 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 các kênh khác.
Giá trị của chỉ số này có bao gồm 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 nhật ký xem của người dùng.
Chỉ số này trả về một 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 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 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 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 danh sách phát mặc định như danh sách phát "Xem sau".
Chỉ số này trả về một 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ì giá trị của chỉ số này sẽ phản ánh việc video bị xoá khỏi danh sách phát hai lần. Không có dữ liệu cho chỉ số nà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 kênh khác không được tính vào 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.
Tham khảo phần chỉ số về lượt xem và chỉ số về thời gian xem trong 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.
-
Các chỉ số trong danh sách phát phản ánh hoạt động của người dùng và mức độ tương tác trong bối cảnh 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 video, nhưng chỉ tính những lượt xem diễn ra trong danh sách phát.
Hầu hết các chỉ số sau đâ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ề 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 các video trong danh sách phát. Do đó, những chỉ số này sẽ không được coi là chỉ số tổng hợp của video hoặc chỉ số trong danh sách phát.
- averageTimeInPlaylist
- Thời gian xem trung bình ước tính (tính bằng phút) mà người xem đã xem video trong danh sách phát
sau khi danh sách phát được phát. Xin lưu ý rằng chỉ số này chỉ bao gồm những 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) 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 xem trung bình của từng video trong một danh sách phát; ngược lại, chỉ số
averageTimeInPlaylistthể 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 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 trong các bối cảnh khác (ví dụ: thời gian xem từ những lượt xem khi người xem 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 cả 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 ròng mà 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, tức là nếu một người dùng lưu một danh sách phát, xoá danh sách phát đó khỏi danh sách các danh sách phát đã lưu rồi lưu lại, thì giá trị của chỉ số này sẽ phản ánh một lượt lưu danh sách phát được thêm vào.
- playlistStarts
- Số lần người xem phát lại một danh sách phát. Xin lưu ý rằng chỉ số này chỉ bao gồm những lượt xem danh sách phát diễn ra trên web.
- playlistViews
- Số lượt xem của các video trong danh sách phát khi được xem từ 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 mỗi khi danh sách phát được phát. Xin lưu ý rằng
chỉ số này chỉ bao gồm những lượt xem danh sách phát diễn ra trên web.
Chỉ số về chú thích
Lưu ý: Báo cáo của API YouTube Analytics chỉ trả về dữ liệu cho các chỉ số annotationClickThroughRate và annotationCloseRate kể từ ngày 10 tháng 6 năm 2012. Ngoài ra, các báo cáo của YouTube Analytics API 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ố lượng 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ề việc tạo chú thích và sử dụng chú thích 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ệ 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 thẻ trong YouTube Analytics.
- cardImpressions
- Số lần thẻ được 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ẻ của video.
- cardClicks
- Số lần người xem 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ẻ xuất hiện. Một lượt xem video có thể tạo ra nhiều lượt hiển thị dòng giới thiệu.
- 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 xuất hiện gần đây nhất 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ẻ so với tổng số lượt hiển thị dòng giới thiệu thẻ.
Các chỉ số về 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ể. Chỉ số này bao gồm cả
người xem chung khi nhiều người cùng xem trên một màn hình TV. Nếu phương diện livestreamPosition được chỉ định cho báo cáo, thì giá trị
averageConcurrentViewerssẽ chỉ định số người xem đồng thời trung bình trong một phân đoạn cụ thể - peakConcurrentViewers
- Số người xem đồng thời cao nhất của một video cụ thể. Chỉ số này bao gồm cả
người xem chung khi nhiều người cùng xem trên một màn hình TV. Nếu phương diện livestreamPosition được chỉ định cho báo cáo, thì giá trị
peakConcurrentViewerssẽ chỉ định số lượng 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 số người xem video tại 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 đoạn video được xem với tổng số lượt xem của video đó. Phương diện
elapsedVideoTimeRatioxác định phần video tương ứng với chỉ số.
Xin lưu ý rằng một phần của 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 cho phần đó của 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à nửa còn lại xem toàn bộ video. Không có người xem 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à
1cho các nhóm 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.50cho 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 đến mốc 45 giây của video, sau đó tua lại mốc 30 giây của video rồi 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à
1cho các khoảng thời gian trong nửa đầu hoặc phần tư cuối của video. Tuy nhiên, giá trị sẽ là1.2cho các khoảng thời gian trong một phần tư thứ ba của video vì 100% người xem đã xem phân đoạn đó của video nhưng 20% trong số những người xem đó đã xem phân đoạn 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à nửa còn lại xem toàn bộ video. Không có người xem 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
- Chỉ số đo lường cho biết mức độ hiệu quả của video trong việc giữ chân người xem trong các lượt phát, 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, cho biết 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. Thời điểm trong video được cung cấp theo phương diệnelapsedVideoTimeRatio.
Giá trị0cho biết video giữ chân người xem kém hơn so với mọi video khác có thời lượng tương tự, trong khi giá trị1cho biết video giữ chân người xem tốt hơn so với mọi video khác có thời lượng tương tự. Giá trị trung vị là0.5cho biết một nửa số video có thời lượng tương tự giữ chân người xem tốt hơn, trong khi một nửa còn lại 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 tiếp tục xem sau 3 phút và 70% vẫn tiếp tục xem sau 8 phút. Tuy nhiên, đối với một video cụ thể dài 10 phút, chỉ có 80% người xem vẫn đang xem sau 3 phút, nhưng tất cả những người xem đó vẫn đang xem sau 8 phút.- Tại giá trị
elapsedVideoTimeRatiotương ứng với thời điểm 3 phút trong video, chỉ sốrelativeRetentionPerformancesẽ có giá trị dưới0.5vì tại thời điểm đó, video hoạt động kém hơn video trung bình. - Tại giá trị
elapsedVideoTimeRatiotương ứng với thời điểm phút thứ 8 trong video, chỉ sốrelativeRetentionPerformancesẽ có giá trị cao hơn0.5vì 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 phân đoạn cụ thể của video là phân đoạn đầu tiên được xem trong một lần phát video.
Ví dụ: Giả sử Video X dài 5 phút. Để phục vụ cho báo cáo này, YouTube chia video thành 100 phân đoạn, mỗi phân đoạn dài 3 giây và được xác định bằng phương diện elapsedVideoTimeRatio. 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 toàn bộ hoặc một phần của 24 phân đoạn đầu tiên của video. Trong lần truy cập tiếp theo vào YouTube, người xem xem phần còn lại của video, tiếp tục phát ở phân đoạn 24 và tiếp tục đến phân đoạn 100.
Ví dụ này sẽ tạo ra các giá trị chỉ số xem sau đây:- Giá trị của chỉ số
startedWatchingsẽ là1cho phân đoạn 1 và 24, còn giá trị chỉ số sẽ là0cho tất cả các phân đoạn khác. - Giá trị của chỉ số
stoppedWatchingsẽ là1cho các phân khúc 24 và 100, còn giá trị của chỉ số sẽ là0cho tất cả các phân khúc khác. - Giá trị của chỉ số
totalSegmentImpressionssẽ là2cho phân khúc 24 và giá trị chỉ số sẽ là1cho tất cả các phân khúc khác.
- Giá trị của chỉ số
- stoppedWatching
- Số lần một phân đoạn cụ thể của video là phân đoạn cuối cùng được xem trong một lần phát video. Hãy tham khảo định nghĩa về chỉ số
startedWatchingđể biết ví dụ về cách tính giá trị của chỉ số này. - totalSegmentImpressions
- Số lần người dùng xem một đoạn cụ thể trong video. Hãy tham khảo định nghĩa về chỉ số
startedWatchingđể xem ví dụ về cách tính giá trị của chỉ số này. Xin lưu ý rằng một người xem có thể xem cùng một đoạn video nhiều lần trong cùng một lần phát.
Chỉ số về việc huỷ gói thành viên
- membershipsCancellationSurveyResponses
- Số lượng bản khảo sát do những người dùng YouTube đã huỷ gói hội viên của kênh được chỉ định trong kỳ báo cáo hoàn thành.
Các chỉ số về doanh thu ước tính
Lưu ý: Các chỉ số 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à phân phát. Hãy xem Trung tâm trợ giúp của YouTube để biết thêm thông tin và lưu ý 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, giú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 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à 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 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 đượ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à phân phát. - estimatedRedPartnerRevenue (trước đây là
redPartnerRevenue) - Tổng doanh thu ước tính từ các gói thuê bao YouTube Premium (trước đây gọi là YouTube Red) cho 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
- Tổng doanh thu ước tính (tính bằng USD) 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. Đừng nhầm lẫn tổng doanh thu với doanh thu ước tính hoặc doanh thu ròng, vì doanh thu ròng có tính đến phần sở hữu và thoả thuận chia sẻ doanh thu của bạn.
- cpm (trước đây 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 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. Số 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%.
- playbackBasedCpm
- Tổng doanh thu ước tính trên mỗi nghìn lượt phát.