Analyze Youtube Affiliate Performance (Alpha)

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 liên kết trên 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 liên kết dành riêng cho YouTube, chẳng hạn như doanh số, 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 và sản phẩm riêng lẻ.

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 liên kết trên YouTube. Các chế độ xem này hoạt động giố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 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 liên kết trên YouTube.

Truy vấn điểm cuối alpha

Xin lưu ý rằng vì đây là bản phát hành 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 trên YouTube, bạn cần gửi yêu cầu POST đến điểm cuối v1alpha. Sau đây là yêu cầu mẫu:

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

  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' \
  --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 cũng như mã kênh.

Sau đây là ví dụ về câu lệnh SELECT MCQL mà bạn có thể dùng để xem 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 được chỉ định.

Xem hiệu suất theo nội dung

Để xem những 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 và bao gồm tiêu đề cũng như mã video.

Để truy xuất 3 video hàng đầu theo lượt xem từ ngày 1 tháng 5 đến ngày 2 tháng 5 năm 2025, hãy chuyển câu lệnh MCQL sau đây đến accounts.reports.search phương thức:

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ó nhiều lượt tương tác nhất

Để biết những sản phẩm được gắn thẻ nào có nhiều lượt tương tác và doanh số 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 SELECT MCQL mà bạn có thể dùng để xem 10 sản phẩm hàng đầu theo lượt xem từ ngày 20 tháng 1 đế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ố 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 những sản phẩm bán chạy nhất

Để biết những 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 SELECT MCQL mà bạn có thể dùng để xem 10 sản phẩm hàng đầu được xếp hạng theo tổng doanh số từ ngày 20 tháng 1 đế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 doanh số, 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.

Điểm quan trọng cần lưu ý

• Ngày: Luôn lọc truy vấn theo date bằng cách sử dụng mệnh đề WHERE để chỉ định kỳ báo cáo. Ngày ở định dạng YYYY-MM-DD.
• Độ 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 tình trạng hết thời gian chờ.