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 Reporting sub-API. 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ố bán hàng, hoa hồng, đơ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, sản phẩm riêng lẻ và chiến dịch được nhắm 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 Mua sắm.
Bạn có thể sử dụng Ngôn ngữ truy vấn Merchant Center (MCQL) để chọn các chỉ số và phương diện trong các chế độ xem dành riêng cho chương trình tiếp thị liên kết của YouTube. Các chế độ xem này hoạt động như các 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 các lệnh gọi API có vai trò Hiệu suất và thông tin chi tiết, cho phép 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 ở 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 tiếp thị liên kết trên 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ững 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, bao gồm cả tiêu đề của nhà sáng tạo và mã nhận dạng kênh.
Sau đây là ví dụ về câu lệnh MCQL SELECT mà bạn có thể dùng để lấy 3 nhà sáng tạo có hiệu suất hàng đầu 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 của 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 được chỉ định.
Xem hiệu suất theo nội dung
Để xem video cụ thể nào trên YouTube có hiệu suất cao 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, bao gồm cả tiêu đề và mã nhận dạng video.
Để 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 đây vào phương thức accounts.reports.search:
SELECT title, video_id, gross_sales, net_sales, 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 và các chỉ số chính 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.
Xem những sản phẩm được gắn thẻ có mức độ gắn bó cao nhất
Để biết những 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 cả 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 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 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 để nhận 10 sản phẩm hàng đầu được xếp hạng theo tổng doanh số bán hàng 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 về doanh số, phí hoa hồng và các chỉ số chính cho 10 sản phẩm hàng đầu được sắp xếp 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
Để biết hiệu suất tổng thể của 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 để nhận 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ố 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 được 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 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 cả 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 của 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 một số 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 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 của 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ố chính về hiệu suất 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 liên quan về video và các chỉ số về doanh số bán hàng.
Sử dụng câu lệnh MCQL SELECT sau đây để nhận 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ác truy vấn theo
datebằng cách sử dụng mệnh đềWHEREđể chỉ định kỳ báo cáo. Ngày ở đị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 bộ lọc bổ sung 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 các truy vấn phụ thuộc vào khối lượng dữ liệu được yêu cầu. Những truy vấn bao gồm các 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ờ.