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 Reports 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 MCQL để chọn các chỉ số và phương diện trong "lượt xem" dành riêng cho chương trình tiếp thị liên kết của YouTube. Các chỉ số và phương diện 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 cao nhất theo doanh số bán hàng từ ngày 1 tháng 5 đến ngày 2 tháng 5 năm 2025.

SELECT
  title,
  channel_id,
  sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY 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ố 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 riêng lẻ trên YouTube, bao gồm cả tiêu đề và mã nhận dạng video.

Sau đây là ví dụ về câu lệnh MCQL SELECT mà bạn có thể dùng để lấy 3 video hàng đầu theo số lượt xem trong khoảng thời gian từ ngày 1 tháng 5 đến ngày 2 tháng 5 năm 2025.

SELECT
  title,
  video_id,
  views,
  clicks,
  sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '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 của 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 hiệu suất theo sản phẩm

Để phân tích hiệu suất của từng sản phẩm trong Chương trình tiếp thị liên kết của YouTube, bạn có thể truy vấn youtube_product_performance_view. Chế độ xem này tổng hợp các chỉ số theo sản phẩm, bao gồm cả tiêu đề sản phẩm và mã nhận dạng sản phẩm.

Sau đây là ví dụ về câu lệnh MCQL SELECT mà bạn có thể dùng để tìm 3 sản phẩm hàng đầu theo số tiền bán hàng từ ngày 1 tháng 5 đến ngày 2 tháng 5 năm 2025:

SELECT
  title,
  offer_id,
  sales,
  commissions,
  orders,
  clicks
FROM youtube_product_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3

Truy vấn này trả về tiêu đề sản phẩm, mã sản phẩm và các chỉ số hiệu suất của 3 sản phẩm hàng đầu, được sắp xếp theo chỉ số sales trong khoảng thời gian đượ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 sẽ phụ thuộc vào khối lượng dữ liệu được yêu cầu. Các truy vấn 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ờ.