Metrics

Tài liệu này xác định các chỉ số mà API Báo cáo của YouTube truy xuất. API này truy xuất các báo cáo dữ liệu hàng loạt chứa dữ liệu trong YouTube Analytics của một kênh hoặc chủ sở hữu nội dung.

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 Báo cáo của YouTube phải tuân thủ Chính sách ngừng sử dụng được xác định trong Điều khoản dịch vụ, nhưng các chỉ số không chính (và phương diện không 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. Bất kỳ chỉ số nào trong số này cũng được sử dụng trong API YouTube Analytics và cũng là chỉ số cốt lõi trong API đó.

Hãy xem danh sách các API của 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ố cốt lõi)
Số lượt xem video. Trong báo cáo danh sách phát, chỉ số này cho biết số lần một video được xem trong danh sách phát. Trung tâm trợ giúp của YouTube cung cấp thêm thông tin về cách báo cáo lượt xem. This is a core metric and is subject to the Deprecation Policy.
red_views
Số lần thành viên YouTube Premium (trước đây gọi là YouTube Red) xem một video.
views_percentage (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

watch_time_minutes (chỉ số cốt lõi)
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.
red_watch_time_minutes
Số phút mà thành viên YouTube Premium (trước đây gọi là YouTube Red) đã xem một video.
average_view_duration_seconds (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.
average_view_duration_percentage
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.
lượt chia sẻ (chỉ số chính)
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.
subscribers_gained (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. Để xác định số lượng người đăng ký kênh mới không đăng ký thông qua trang xem video, báo cáo hoạt động cơ bản của người dùng sẽ chứa một hàng không chỉ định giá trị phương diện video_id. Hàng đó cũng chỉ định giá trị cho chỉ số subscribersLost, nhưng không chỉ định giá trị cho các chỉ số khác.
subscribers_lost (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ố subscribers_gained. Để xác định số người dùng đã huỷ đăng ký nhưng không huỷ đăng ký trên trang xem video, báo cáo hoạt động cơ bản của người dùng sẽ chứa một hàng không chỉ định giá trị phương diện video_id. Hàng đó cũng chỉ định giá trị cho chỉ số subscribers_gained, nhưng không chỉ định giá trị cho các chỉ số khác.
videos_added_to_playlists
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.
videos_removed_from_playlists
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.

playlist_starts
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.
playlist_saves_added (chỉ được hỗ trợ trong API Báo cáo của YouTube)
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ề một con số tuyệt đối, 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 2 lượt lưu danh sách phát.
playlist_saves_removed (chỉ được hỗ trợ trong API Báo cáo của YouTube)
Số lần người dùng xoá danh sách phát khỏi danh sách danh sách phát đã lưu. Chỉ số này trả về một con số tuyệt đối, 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, lưu lại danh sách phát đó rồi xoá lại danh sách phát đó, thì giá trị chỉ số sẽ phản ánh 2 lần lưu danh sách phát bị xoá.

Chỉ số chú thích

annotation_impressions
Tổng số lượt hiển thị chú thích.
annotation_clickable_impressions
Số lượng chú thích đã xuất hiện và có thể nhấp vào.
annotation_clicks
Số chú thích được nhấp vào.
annotation_click_through_rate (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.
annotation_closable_impressions
Số lượng chú thích đã xuất hiện và có thể đóng.
annotation_closes
Số lượng chú thích đã đóng.
annotation_close_rate (chỉ số cốt lõi)
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.

card_impressions
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.
card_clicks
Số lần người dùng nhấp vào thẻ đó.
card_click_rate
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ẻ.
card_teaser_impressions
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.
card_teaser_clicks
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.
card_teaser_click_rate
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ố về màn hình kết thúc

Màn hình kết thúc là các thành phần xuất hiện trong khoảng 5 đến 20 giây cuối của video để quảng bá nội dung, kênh và trang web của bạn. Trung tâm trợ giúp của YouTube có hướng dẫn chi tiết hơn về cách thêm màn hình kết thúc vào video và Báo cáo màn hình kết thúc trong YouTube Analytics.

Lưu ý: Dữ liệu cho các chỉ số về màn hình kết thúc có sẵn kể từ ngày 1 tháng 5 năm 2016.

end_screen_element_impressions
Số thành phần màn hình kết thúc đã hiển thị. Hệ thống sẽ ghi lại một lượt hiển thị cho mỗi thành phần màn hình kết thúc xuất hiện.
end_screen_element_clicks
Số lượt nhấp vào các thành phần trên màn hình kết thúc.
end_screen_element_click_rate
Tỷ lệ nhấp vào thành phần màn hình kết thúc, được tính bằng tỷ lệ số lượt nhấp vào thành phần màn hình kết thúc trên số lượt hiển thị thành phần màn hình kết thúc.

Chỉ số về tỷ lệ giữ chân người xem

audience_retention_percentage
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 elapsed_video_time_percentage 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ơn 1.

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.

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.

API Báo cáo của YouTube báo cáo tất cả doanh thu và thu nhập ước tính bằng USD.
estimated_partner_revenue (chỉ số chính)
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.
estimated_partner_ad_revenue
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.
estimated_partner_ad_auction_revenue (chỉ được hỗ trợ trong API Báo cáo của YouTube)
Tổng thu nhập ước tính (doanh thu ròng) từ quảng cáo được bán thông qua phiên đấu giá qua AdSense trong phạm vi ngày và khu vực đã chọn. Trước đây, chỉ số này có tên là estimated_partner_ad_sense_revenue.
estimated_partner_ad_sense_revenue (chỉ được hỗ trợ trong API Báo cáo của YouTube)
Tổng thu nhập ước tính (doanh thu ròng) từ quảng cáo AdSense được bán thông qua phiên đấu giá trong phạm vi ngày và khu vực đã chọn.
estimated_partner_ad_reserved_revenue (chỉ được hỗ trợ trong API Báo cáo của YouTube)
Tổng thu nhập ước tính (doanh thu ròng) từ quảng cáo được bán theo hình thức đặt trước thông qua DoubleClick (DCLK) và các nguồn khác do YouTube bán. Trước đây, chỉ số này có tên là estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (chỉ được hỗ trợ trong API Báo cáo của YouTube)
Tổng thu nhập ước tính (doanh thu ròng) từ quảng cáo được bán theo hình thức đặt trước thông qua DoubleClick (DCLK) và các nguồn khác được bán trên YouTube.
estimated_partner_red_revenue (chỉ được hỗ trợ trong API Báo cáo của YouTube)
Tổng thu nhập ước tính (doanh thu ròng) từ các gói thuê bao YouTube Premium (trước đây gọi là YouTube Red).
estimated_partner_transaction_revenue (chỉ được hỗ trợ trong API Báo cáo của YouTube)
Tổng doanh thu ước tính từ các giao dịch, chẳng hạn như nội dung có tính phí và tính năng Tài trợ của người hâm mộ, trừ đi mọi khoản tiền hoàn lại do đối tác tính phí.

Chỉ số hiệu suất quảng cáo

estimated_youtube_ad_revenue
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.
estimated_cpm
Tổng doanh thu ước tính trên một nghìn lượt hiển thị quảng cáo.
ad_impressions
Số lượt hiển thị quảng cáo đã được xác minh được phân phát.
estimated_monetized_playbacks
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%.
estimated_playback_based_cpm
Tổng doanh thu ước tính trên một nghìn lượt phát.