Bạn có thể truy xuất các chỉ số hiệu suất chính cho những sản phẩm tham gia Chương trình tiếp thị liên kết của YouTube bằng cách sử dụng API phụ Báo cáo. Hướng dẫn này giải thích cách truy vấn dữ liệu tiếp thị liên kết dành riêng cho YouTube, chẳng hạn như doanh số, hoa hồng, số đơn đặt hàng, lượt xem và lượt nhấp, được phân bổ cho nhiều nhà sáng tạo, nội dung video, từng sản phẩm, danh mục sản phẩm và chiến dịch mục tiêu.
Việc bạn sử dụng các API của Chương trình tiếp thị liên kết của YouTube và dữ liệu liên quan phải tuân thủ chính sách dành cho nhà phát triển của YouTube Shopping.
Bạn có thể sử dụng Ngôn ngữ truy vấn của Merchant Center (MCQL) để chọn các chỉ số và phương diện trong các chế độ xem chuyên biệt của Chương trình tiếp thị liên kết của YouTube. Các chế độ xem này hoạt động như bảng trong truy vấn của bạn.
Điều kiện tiên quyết
Trước khi sử dụng hướng dẫn này, hãy đảm bảo rằng:
- Tài khoản dùng để xác thực lệnh gọi API có vai trò Hiệu suất và thông tin chi tiết giúp cấp quyền truy cập vào các chỉ số hiệu suất.
- Tài khoản Google Merchant Center của bạn tham gia Chương trình tiếp thị liên kết của YouTube.
Truy vấn điểm cuối alpha
Vì tính năng này đang trong giai đoạn alpha công khai, nên điểm cuối sẽ khác. Để truy xuất dữ liệu hiệu suất của Chương trình liên kết của YouTube, bạn cần gửi yêu cầu POST đến điểm cuối v1alpha. Để biết thêm thông tin về cách truy xuất báo cáo, hãy xem accounts.reports.search.
Sau đây là một yêu cầu mẫu:
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
{
"query": "SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY gross_sales DESC LIMIT 3"
}
cURL
curl -X POST \
'https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search?key={YOUR_API_KEY}' \
--header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"query": "SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '\''2025-05-01'\'' AND date < '\''2025-05-02'\'' ORDER BY gross_sales DESC LIMIT 3"
}' \
--compressed
Xem hiệu suất theo nhà sáng tạo
Để biết nhà sáng tạo nào trên YouTube đang thúc đẩy nhiều lượt tương tác và doanh số nhất, bạn có thể truy vấn youtube_creator_performance_view.
Chế độ xem này tổng hợp các chỉ số theo từng nhà sáng tạo trên YouTube và bao gồm
tiêu đề của nhà sáng tạo và mã nhận dạng kênh.
Dưới đây là ví dụ về câu lệnh MCQL SELECT mà bạn có thể dùng để lấy thông tin về 3 nhà sáng tạo có hiệu suất cao nhất theo doanh số từ ngày 1 tháng 5 đến ngày 2 tháng 5 năm 2025:
SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY gross_sales DESC LIMIT 3
Truy vấn này tìm nạp tiêu đề của nhà sáng tạo, mã nhận dạng kênh và các chỉ số hiệu suất chính cho 3 nhà sáng tạo hàng đầu được xếp hạng theo chỉ số tổng doanh số trong phạm vi ngày đã chỉ định.
Xem hiệu suất theo nội dung
Để xem video cụ thể nào trên YouTube đang hoạt động hiệu quả nhất, bạn có thể truy vấn
youtube_content_performance_view.
Chế độ xem này tổng hợp các chỉ số theo từng video trên YouTube và bao gồm
tiêu đề và mã video. Đối với trang web thương mại, hãy thêm account_id để phân tích hiệu suất theo từng tài khoản người bán phụ. Để xem số tiền hoa hồng do người bán phụ và nền tảng trang web thương mại tài trợ, hãy thêm seller_commissions và platform_commissions.
Để truy xuất 3 video hàng đầu theo số lượt xem từ ngày 1 tháng 5 đến ngày 2 tháng 5 năm 2025, hãy truyền câu lệnh MCQL sau đến phương thức accounts.reports.search:
SELECT title, video_id, account_id, gross_sales, net_sales, commissions, seller_commissions, platform_commissions, orders, clicks, views FROM youtube_content_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY views DESC LIMIT 3
Truy vấn này truy xuất tiêu đề video, mã video, mã tài khoản người bán phụ
(account_id), tổng hoa hồng (commissions),
hoa hồng do người bán tài trợ (seller_commissions),
hoa hồng do nền tảng tài trợ (platform_commissions) và các
chỉ số chính khác cho 3 video hàng đầu được xếp hạng theo tổng số
views trong phạm vi ngày được chỉ định. Lưu ý: Bạn không thể sử dụng account_id trong mệnh đề WHERE của MCQL để lọc kết quả.
Xem những sản phẩm được gắn thẻ có mức độ tương tác cao nhất
Để biết sản phẩm được gắn thẻ nào có mức độ tương tác và doanh số cao nhất,
bạn có thể truy vấn
youtube_product_tagged_stats_view.
Chế độ xem này tổng hợp các chỉ số theo từng sản phẩm được gắn thẻ, bao gồm
tiêu đề và mã ưu đãi của sản phẩm.
Sau đây là ví dụ về câu lệnh MCQL SELECT mà bạn có thể dùng để lấy 10 sản phẩm hàng đầu theo số lượt xem trong khoảng thời gian từ ngày 20 đến ngày 21 tháng 1 năm 2026:
SELECT title, offer_id, tagged_creator_count, tagged_video_count, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_product_tagged_stats_view WHERE date >= '2026-01-20' AND date < '2026-01-21' ORDER BY views DESC LIMIT 10
Truy vấn này truy xuất tiêu đề, số lượng video được gắn thẻ và các chỉ số chính cho
10 sản phẩm hàng đầu được xếp hạng theo tổng số views trong
phạm vi ngày được chỉ định.
Xem hiệu suất theo danh mục sản phẩm được gắn thẻ
Để biết danh mục sản phẩm được gắn thẻ nào thúc đẩy nhiều lượt tương tác và doanh số nhất, hãy truy vấn youtube_product_category_tagged_stats_view.
Chế độ xem này tổng hợp các chỉ số theo danh mục sản phẩm
(product_type) trong hệ thống phân loại sản phẩm của bạn, bao gồm cả
số lượng nhà sáng tạo và video riêng biệt đã gắn thẻ sản phẩm trong mỗi
danh mục.
Sử dụng câu lệnh MCQL SELECT sau đây để lấy 10 danh mục sản phẩm được gắn thẻ hàng đầu, xếp hạng theo tổng doanh số vào ngày 1 tháng 9 năm 2026:
SELECT product_type, tagged_creator_count, tagged_video_count, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_product_category_tagged_stats_view WHERE date = '2026-09-01' ORDER BY gross_sales DESC LIMIT 10
Truy vấn này truy xuất danh mục sản phẩm (product_type),
số lượng nhà sáng tạo được gắn thẻ, số lượng video được gắn thẻ và các chỉ số hiệu suất chính
cho 10 danh mục sản phẩm hàng đầu được xếp hạng theo gross_sales vào
ngày đã chỉ định.
Xem các sản phẩm bán chạy nhất
Để biết sản phẩm nào có doanh số cao nhất, bạn có thể truy vấn
youtube_product_sold_stats_view.
Sau đây là ví dụ về câu lệnh MCQL SELECT mà bạn có thể dùng để lấy 10 sản phẩm hàng đầu được xếp hạng theo tổng doanh số từ ngày 20 đến ngày 21 tháng 1 năm 2026:
SELECT title, offer_id, gross_sales, net_sales, commissions, orders FROM youtube_product_sold_stats_view WHERE date >= '2026-01-20' AND date < '2026-01-21' ORDER BY gross_sales DESC LIMIT 10
Truy vấn này truy xuất dữ liệu bán hàng, hoa hồng và các chỉ số chính cho 10 sản phẩm hàng đầu được đặt hàng theo tổng doanh số, trong phạm vi ngày được chỉ định.
Xem hiệu suất trên tất cả chiến dịch
Để tìm hiểu hiệu suất tổng thể của các chiến dịch tiếp thị liên kết, hãy truy vấn
youtube_campaigns_stats_view.
Chế độ xem này tổng hợp các chỉ số trên tất cả chiến dịch, bao gồm cả tên chiến dịch, ngày bắt đầu và ngày kết thúc, số lượng nhà sáng tạo đang hoạt động, cũng như các chỉ số về doanh số và mức độ tương tác.
Sử dụng câu lệnh MCQL SELECT sau đây để lấy 10 chiến dịch hàng đầu theo số đơn đặt hàng vào ngày 23 tháng 4 năm 2026:
SELECT campaign_id, campaign_name, start_date, end_date, active_creators, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaigns_stats_view WHERE date = '2026-04-23' ORDER BY orders DESC LIMIT 10
Truy vấn này truy xuất mã chiến dịch, tên chiến dịch, phạm vi ngày, số lượng nhà sáng tạo đang hoạt động và các chỉ số hiệu suất chính cho 10 chiến dịch hàng đầu được xếp hạng theo tổng số orders vào ngày đã chỉ định.
Xem hiệu suất chiến dịch theo nhà sáng tạo
Để phân tích hiệu suất của từng nhà sáng tạo tham gia một chiến dịch cụ thể, hãy truy vấn báo cáo youtube_individual_campaign_stats_view.
Chế độ xem này tổng hợp các chỉ số cho mỗi nhà sáng tạo trong một chiến dịch, bao gồm
tiêu đề kênh, số lượng video và tiêu đề sản phẩm được gắn thẻ.
Sử dụng câu lệnh MCQL SELECT sau đây để lấy 10 nhà sáng tạo hàng đầu theo số lượt xem cho một chiến dịch cụ thể vào ngày 23 tháng 4 năm 2026:
SELECT channel_title, video_count, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_individual_campaign_stats_view WHERE date = '2026-04-23' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
Truy vấn này truy xuất tiêu đề kênh của nhà sáng tạo, số lượng video, tiêu đề sản phẩm và các chỉ số hiệu suất chính cho 10 nhà sáng tạo hàng đầu được xếp hạng theo tổng số lượt xem trong chiến dịch và ngày được chỉ định.
Xem hiệu suất chiến dịch theo video
Để xem hiệu suất của video cụ thể của nhà sáng tạo trong một chiến dịch, hãy truy vấn
youtube_campaign_videos_stats_view.
Chế độ xem này cung cấp các chỉ số hiệu suất ở cấp video cho một nhà sáng tạo trong một
chiến dịch, bao gồm tiêu đề video, định dạng video và sản phẩm được gắn thẻ.
Sử dụng câu lệnh MCQL SELECT sau đây để lấy 10 video hàng đầu theo số lượt xem cho một nhà sáng tạo và chiến dịch cụ thể vào ngày 20 tháng 5 năm 2026:
SELECT video_title, content_type, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_videos_stats_view WHERE date = '2026-05-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' AND channel_id = 'YOUR_CHANNEL_ID' ORDER BY views DESC LIMIT 10
Truy vấn này truy xuất tiêu đề video, định dạng video (content_type),
tiêu đề sản phẩm được gắn thẻ và các chỉ số hiệu suất chính cho 10 video hàng đầu
được xếp hạng theo tổng số views cho kênh, chiến dịch và ngày của nhà sáng tạo
được chỉ định.
Xem hiệu suất chiến dịch theo sản phẩm
Để tìm hiểu hiệu suất của từng sản phẩm trong một chiến dịch, hãy truy vấn youtube_campaign_products_stats_view.
Chế độ xem này cung cấp các chỉ số hiệu suất ở cấp sản phẩm trong một chiến dịch, bao gồm tiêu đề sản phẩm, thông tin chi tiết về video liên quan và chỉ số bán hàng.
Sử dụng câu lệnh MCQL SELECT sau đây để lấy 10 sản phẩm hàng đầu theo số lượt xem cho một chiến dịch cụ thể vào ngày 20 tháng 6 năm 2026:
SELECT channel_title, product_title, video_title, video_url, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_products_stats_view WHERE date = '2026-06-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
Truy vấn này truy xuất tiêu đề kênh của nhà sáng tạo, tiêu đề sản phẩm, tiêu đề video, URL video và các chỉ số hiệu suất chính cho 10 sản phẩm hàng đầu được xếp hạng theo tổng số views trong chiến dịch và ngày được chỉ định.
Điểm quan trọng cần lưu ý
- Ngày: Luôn lọc cụm từ tìm kiếm theo
datebằng cách sử dụng mệnh đềWHEREđể chỉ định kỳ báo cáo. Ngày theo định dạngYYYY-MM-DD. - Bộ lọc bắt buộc: Một số chế độ xem chiến dịch yêu cầu thêm bộ lọc trong mệnh đề
WHERE:youtube_individual_campaign_stats_view:campaign_idvàdate.youtube_campaign_videos_stats_view:campaign_id,channel_idvàdate.youtube_campaign_products_stats_view:campaign_idvàdate.
- Độ trễ: Độ trễ của truy vấn phụ thuộc vào khối lượng dữ liệu được yêu cầu. Các truy vấn bao gồm tập dữ liệu lớn sẽ mất nhiều thời gian hơn và có thể gây ra lỗi hết thời gian chờ.