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 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, số lượt xem và số 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 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:

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

Xin lưu ý rằng vì đây là phiên bả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. Sau đây là một yêu cầu mẫu:

HTTP

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

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' \
  --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 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 đ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, bao gồm cả tiêu đề và mã 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 đến 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 độ tương tác 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 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 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 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ố bán hàng trong phạm vi 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 date bằng cách sử dụng các mệnh đề WHERE để chỉ định khoảng thời gian báo cáo. Ngày ở định dạng YYYY-MM-DD.
  • Độ 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ờ.
Trước
Explore your competitive landscape
Tiếp
Use Merchant Center Query Language