Tài liệu này giải thích những điểm tương đồng và khác biệt trong cách YouTube Analytics API và YouTube Reporting API cung cấp quyền truy cập vào dữ liệu của YouTube Analytics, để bạn chọn API phù hợp cho ứng dụng của mình.
Cả hai API này đều cho phép bạn truy xuất dữ liệu trong YouTube Analytics. Ngoài ra, cả hai API này đều hỗ trợ chủ sở hữu kênh YouTube và chủ sở hữu nội dung trên YouTube. Mỗi đối tượng có thể truy cập vào một nhóm báo cáo cụ thể:
-
Báo cáo kênh chứa các chỉ số về hoạt động của người dùng đối với một kênh cụ thể.
-
Báo cáo của chủ sở hữu nội dung tổng hợp các chỉ số của tất cả các kênh liên kết với một chủ sở hữu nội dung cụ thể trên YouTube. Ví dụ: một hãng thu âm có thể truy xuất báo cáo chứa số liệu thống kê tổng hợp từ các kênh YouTube của tất cả nghệ sĩ thuộc hãng. Một số báo cáo của chủ sở hữu nội dung có chứa các chỉ số về hoạt động của người dùng, trong khi những báo cáo khác có chứa các chỉ số liên quan đến doanh thu và hiệu suất quảng cáo.
Reporting API cũng cho phép một số chủ sở hữu nội dung truy cập vào báo cáo doanh thu từ quảng cáo do hệ thống quản lý. Bạn chỉ có thể truy xuất dữ liệu trong báo cáo do hệ thống quản lý bằng Reporting API.
Tất cả yêu cầu gửi đến API YouTube Analytics và API Báo cáo của YouTube đều phải được kênh hoặc chủ sở hữu nội dung sở hữu dữ liệu được yêu cầu cho phép.
Nội dung của báo cáo
Các báo cáo mà API truy xuất chứa 2 loại dữ liệu:
-
Phương diện là các tiêu chí chung được dùng để tổng hợp dữ liệu, chẳng hạn như ngày xảy ra hoạt động của người dùng hoặc quốc gia nơi người dùng sinh sống.
Trong một báo cáo, mỗi hàng dữ liệu có một tổ hợp giá trị phương diện duy nhất. Do đó, tổ hợp giá trị phương diện của mỗi hàng đóng vai trò là khoá chính cho hàng đó.
-
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 yếu tố 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ọn API phù hợp cho ứng dụng của bạn
- API YouTube Analytics
- YouTube Analytics API hỗ trợ các truy vấn có mục tiêu theo thời gian thực để tạo báo cáo tuỳ chỉnh từ YouTube Analytics. API này cung cấp các tham số lọc và sắp xếp, nên ứng dụng gọi không cần hỗ trợ các chức năng này một cách tự nhiên.
Mỗi yêu cầu API đều chỉ định phạm vi ngày mà dữ liệu sẽ được trả về. API này cũng cho phép bạn truy xuất các tập dữ liệu hằng tuần và hằng tháng. Do đó, ứng dụng gọi không cần lưu trữ các tập dữ liệu đã truy xuất hoặc số liệu thống kê tổng hợp trên các phạm vi ngày. - API Báo cáo của YouTube
- API Báo cáo của YouTube truy xuất hàng loạt báo cáo chứa dữ liệu trong YouTube Analytics của một kênh hoặc chủ sở hữu nội dung. API này được thiết kế cho những ứng dụng có thể nhập các tập dữ liệu lớn và cung cấp công cụ để lọc, sắp xếp và khai thác dữ liệu đó.
Mỗi báo cáo chứa một nhóm các trường được xác định trước. Bạn sử dụng API này để lên lịch cho các tác vụ báo cáo. Mỗi tác vụ sẽ xác định một báo cáo mà YouTube cần tạo. Sau đó, YouTube sẽ tạo một báo cáo hằng ngày mà bạn có thể tải xuống không đồng bộ. Mỗi báo cáo chứa dữ liệu cho một khoảng thời gian 24 giờ riêng biệt.
Ngoài ra, YouTube tự động tạo một bộ báo cáo do hệ thống quản lý cho những chủ sở hữu nội dung có quyền truy cập vào các báo cáo tương ứng trong YouTube Creator Studio. Các báo cáo này cung cấp quyền truy cập có lập trình vào dữ liệu doanh thu từ quảng cáo.
Các báo cáo được hỗ trợ
Bảng sau đây xác định các loại báo cáo mà bạn có thể truy xuất bằng cách sử dụng API. Bạn có thể sử dụng các truy vấn có mục tiêu thông qua YouTube Analytics API và các báo cáo hàng loạt thông qua API Báo cáo của YouTube.
Dữ liệu có trong một API có thể không có trong API còn lại. Ví dụ: YouTube Analytics API cho phép bạn truy xuất các chỉ số về hoạt động của người dùng theo tuần hoặc theo tháng, nhưng YouTube Reporting API yêu cầu bạn tự tổng hợp dữ liệu đó. Mặt khác, YouTube Reporting API hỗ trợ báo cáo về tài sản cho chủ sở hữu nội dung, nhưng dữ liệu đó không có trong YouTube Analytics API.
| Loại báo cáo | |
|---|---|
| Báo cáo video | Được hỗ trợ cho các kênh (query hoặc bulk) và chủ sở hữu nội dung (query hoặc bulk). Báo cáo video cung cấp số liệu thống kê về tất cả hoạt động của người dùng liên quan đến video của một kênh hoặc video của một chủ sở hữu nội dung. Ví dụ: các báo cáo này chứa số lượt xem mà video của bạn nhận được. Trong API YouTube Analytics, một số báo cáo về video của chủ sở hữu nội dung cũng bao gồm các chỉ số về doanh thu ước tính và hiệu suất quảng cáo. |
| Báo cáo danh sách phát | Được hỗ trợ cho các kênh (query hoặc bulk) và chủ sở hữu nội dung (query hoặc bulk). Báo cáo danh sách phát cung cấp số liệu thống kê liên quan cụ thể đến số lượt xem video trong bối cảnh của một danh sách phát. YouTube Reporting API hỗ trợ báo cáo về tỷ lệ giữ chân người xem đối với danh sách phát, nhưng YouTube Analytics API không hỗ trợ báo cáo tương tự. |
| Báo cáo hiệu quả hoạt động của quảng cáo | Được hỗ trợ cho chủ sở hữu nội dung (query hoặc bulk). Báo cáo hiệu suất quảng cáo cung cấp các chỉ số dựa trên lượt hiển thị cho những quảng cáo chạy trong thời gian phát video. Những chỉ số này tính đến từng lượt hiển thị quảng cáo và mỗi lượt phát video có thể tạo ra nhiều lượt hiển thị. |
| Báo cáo doanh thu ước tính | Được hỗ trợ cho chủ sở hữu nội dung (hàng loạt). Báo cáo doanh thu ước tính cung cấp tổng doanh thu ước tính cho các video từ những nguồn quảng cáo do Google bán và từ những nguồn không phải quảng cáo. Các báo cáo này cũng chứa một số chỉ số về hiệu suất quảng cáo. Xin lưu ý rằng báo cáo do hệ thống quản lý chứa doanh thu thực tế. |
| Báo cáo thành phần | Được hỗ trợ cho chủ sở hữu nội dung (hàng loạt). Báo cáo tài sản cung cấp các chỉ số về hoạt động của người dùng liên quan đến những video được liên kết với tài sản của một chủ sở hữu nội dung. Một video sẽ xuất hiện trong báo cáo của chủ sở hữu nội dung nếu chủ sở hữu nội dung đó đã xác nhận quyền sở hữu video đó là nội dung trùng khớp với một trong các tài sản của chủ sở hữu nội dung. Video đó có thể do chủ sở hữu nội dung hoặc một người dùng YouTube khác tải lên. |
| Báo cáo do hệ thống quản lý | Dành cho những chủ sở hữu nội dung có quyền truy cập vào các báo cáo tương ứng trong trình đơn Báo cáo của YouTube Studio. Báo cáo do hệ thống quản lý cung cấp dữ liệu doanh thu thực tế kiếm được từ tài sản và video. Một báo cáo khác liệt kê các video đã được xác nhận quyền sở hữu và tài sản mà những video đó trùng khớp. Không phải báo cáo nào trong Creator Studio cũng có trong API. Lưu ý: YouTube tự động tạo báo cáo do hệ thống quản lý cho những chủ sở hữu nội dung có quyền truy cập vào các báo cáo tương ứng trong Creator Studio. Do đó, quy trình truy xuất các báo cáo này khác với quy trình truy xuất các loại báo cáo khác trong danh sách này. Hãy xem tài liệu về báo cáo do hệ thống quản lý để biết thêm thông tin. |
Những điểm khác biệt chính
Bảng sau đây nêu bật những điểm khác biệt quan trọng giữa API Báo cáo và API Analytics của YouTube.
| Tính năng | API YouTube Analytics | API Báo cáo của YouTube |
|---|---|---|
| Quy trình truy xuất dữ liệu | Mỗi yêu cầu API đều chỉ định các phương diện và chỉ số sẽ được trả về, cũng như khoảng thời gian mà dữ liệu sẽ được trả về. | Các ứng dụng lên lịch cho công việc báo cáo. Đối với mỗi công việc, YouTube sẽ tạo báo cáo hằng ngày mà bạn có thể tải xuống không đồng bộ. |
| Phạm vi ngày | Một số báo cáo API chỉ định ngày xảy ra hoạt động của người dùng. Một số báo cáo trong số đó hỗ trợ các phương diện để tổng hợp chỉ số hoạt động của người dùng theo tháng. | Tất cả báo cáo API đều chỉ định ngày xảy ra hoạt động của người dùng. Các ứng dụng sử dụng API này có thể triển khai các tính năng để tổng hợp dữ liệu theo các khoảng thời gian định kỳ. |
| Lọc dữ liệu | Bạn có thể lọc báo cáo để chỉ bao gồm những hàng mà một phương diện có giá trị cụ thể. API này cũng hỗ trợ một số phương diện, chẳng hạn như lục địa và subContinent, chỉ được dùng làm bộ lọc. | API này hỗ trợ tải hàng loạt toàn bộ tập dữ liệu xuống. API này không hỗ trợ lọc hoặc trả về dữ liệu cho các phương diện chỉ lọc. Ứng dụng khách lưu trữ dữ liệu đã tải xuống và triển khai các tính năng riêng để lọc dữ liệu. |
| Sắp xếp | Bạn có thể sắp xếp báo cáo dựa trên các giá trị chỉ số được trả về. Một số báo cáo chỉ hỗ trợ một số lượng kết quả có hạn. Ví dụ: báo cáo liệt kê những video được xem nhiều nhất của một kênh sẽ trả về tối đa 200 hàng. | API này hỗ trợ tải hàng loạt toàn bộ tập dữ liệu xuống. Các ứng dụng có thể triển khai các tính năng riêng để sắp xếp dữ liệu đã tải xuống. |
| Bảng liệt kê | Báo cáo API chứa các giá trị văn bản, chẳng hạn như "ANDROID" hoặc "CHANNEL", để xác định các giá trị phương diện được liệt kê. | Báo cáo API chứa các số nguyên có thể được liên kết với các giá trị văn bản. |
| Hạn mức | Máy chủ API đánh giá từng truy vấn để xác định chi phí hạn mức. Phần mức sử dụng hạn mức giải thích chi tiết hơn về phương pháp này. | Việc sử dụng hạn mức không phải là vấn đề vì dữ liệu được truy xuất một lần rồi được lọc, sắp xếp và truy vấn trong ứng dụng. |
| Báo cáo riêng biệt |
|
|
| Phương diện duy nhất | group (chỉ số lọc) continent (chỉ số lọc) subContinent (chỉ số lọc) month viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
| Chỉ số duy nhất | uniques relativeRetentionPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_impressions card_teaser_click_rate card_teaser_clicks card_teaser_impressions estimated_partner_adsense_revenue estimated_partner_doubleclick_revenue playlist_saves_added playlist_saves_removed |
Sự khác biệt về tên giữa các API
Hai API này sử dụng các quy ước đặt tên khác nhau để xác định phương diện và chỉ số. Tên YouTube Analytics API sử dụng kiểu chữ camelCase, chẳng hạn như adType. Tên của YouTube Reporting API là chữ thường và sử dụng dấu gạch dưới, chẳng hạn như ad_type.
Các bảng sau đây xác định những tên khác nhau mà hai API này sử dụng để xác định cùng một chỉ số và phương diện. Trong một số trường hợp, sự khác biệt giữa hai tên này lớn hơn sự khác biệt mà bạn nhận được sau khi chuyển đổi tên từ camelCase sang dấu gạch dưới. Ví dụ: phương diện video trong YouTube Analytics API có tên là video_id trong API Báo cáo của YouTube.