Analyze Youtube Affiliate Performance (Alpha)

คุณสามารถดึงข้อมูลเมตริกประสิทธิภาพหลักของผลิตภัณฑ์ที่เข้าร่วม โปรแกรมแอฟฟิลิเอต YouTube ได้โดยใช้ Reporting sub-API คู่มือนี้จะอธิบายวิธีค้นหาข้อมูลแอฟฟิลิเอตที่เฉพาะเจาะจงของ YouTube เช่น ยอดขาย ค่าคอมมิชชัน คำสั่งซื้อ การดู และ การคลิก ซึ่งระบุแหล่งที่มาเป็นครีเอเตอร์ เนื้อหาวิดีโอ และผลิตภัณฑ์แต่ละรายการ

คุณสามารถใช้ ภาษาสำหรับการค้นหาของ Merchant Center (MCQL) เพื่อเลือกเมตริกและมิติข้อมูลจากมุมมองแอฟฟิลิเอต YouTube โดยเฉพาะ ซึ่งทำงานเหมือนตารางในการค้นหา

ข้อกำหนดเบื้องต้น

โปรดตรวจสอบสิ่งต่อไปนี้ก่อนใช้คู่มือนี้

• บัญชีที่ใช้ในการตรวจสอบสิทธิ์การเรียก API มีบทบาทเป็น ผู้มีสิทธิ์เข้าถึงประสิทธิภาพและข้อมูลเชิงลึก ซึ่งให้สิทธิ์เข้าถึงเมตริกประสิทธิภาพ
• บัญชี Google Merchant Center ของคุณเข้าร่วม โปรแกรมแอฟฟิลิเอต YouTube

ค้นหาปลายทางอัลฟ่า

โปรดทราบว่าปลายทางจะแตกต่างกันเนื่องจากเป็นเวอร์ชันอัลฟ่าสาธารณะ หากต้องการดึงข้อมูลประสิทธิภาพแอฟฟิลิเอต YouTube คุณต้องส่งคำขอ POST ไปยังปลายทาง v1alpha ตัวอย่างคำขอมีดังนี้

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

ดูประสิทธิภาพตามครีเอเตอร์

หากต้องการทราบว่าครีเอเตอร์ YouTube รายใดกระตุ้นการมีส่วนร่วมและยอดขายได้มากที่สุด คุณสามารถค้นหา youtube_creator_performance_view มุมมองนี้จะรวบรวมเมตริกตามครีเอเตอร์ YouTube แต่ละราย รวมถึงชื่อครีเอเตอร์และรหัสช่อง

ต่อไปนี้คือตัวอย่างคำสั่ง MCQL SELECT ที่คุณใช้เพื่อดูครีเอเตอร์ 3 อันดับแรก ที่มีประสิทธิภาพสูงสุดตามยอดขาย ระหว่างวันที่ 1 ถึง 2 พฤษภาคม 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

การค้นหานี้จะดึงข้อมูลชื่อครีเอเตอร์ รหัสช่อง และเมตริกประสิทธิภาพหลักของครีเอเตอร์ 3 อันดับแรกที่จัดอันดับตามเมตริกยอดขายรวมภายในช่วงวันที่ที่ระบุ

ดูประสิทธิภาพตามเนื้อหา

หากต้องการดูว่าวิดีโอ YouTube ใดมีประสิทธิภาพสูงสุด คุณสามารถค้นหา youtube_content_performance_view มุมมองนี้จะรวบรวมเมตริกตามวิดีโอ YouTube แต่ละรายการ รวมถึงชื่อและรหัสวิดีโอ

หากต้องการดึงข้อมูลวิดีโอ 3 อันดับแรกตามจำนวนการดูระหว่างวันที่ 1 ถึง 2 พฤษภาคม 2025, ให้ส่งคำสั่ง MCQL ต่อไปนี้ไปยัง 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

การค้นหานี้จะดึงข้อมูลชื่อวิดีโอ รหัสวิดีโอ และเมตริกหลักของวิดีโอ 3 อันดับแรกที่จัดอันดับตามจำนวน views ทั้งหมดในช่วงวันที่ที่ระบุ

ดูผลิตภัณฑ์ที่ติดแท็กซึ่งมีการมีส่วนร่วมมากที่สุด

หากต้องการทราบว่าผลิตภัณฑ์ที่ติดแท็กใดมีการมีส่วนร่วมและยอดขายมากที่สุด คุณสามารถค้นหา youtube_product_tagged_stats_view มุมมองนี้จะรวบรวมเมตริกตามผลิตภัณฑ์ที่ติดแท็กแต่ละรายการ รวมถึงชื่อและรหัสข้อเสนอ

ต่อไปนี้คือตัวอย่างคำสั่ง MCQL SELECT ที่คุณใช้เพื่อดูผลิตภัณฑ์ 10 อันดับแรก ตามจำนวนการดู ระหว่างวันที่ 20 ถึง 21 มกราคม 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

การค้นหานี้จะดึงข้อมูลชื่อ จำนวนวิดีโอที่ติดแท็ก และเมตริกหลักของผลิตภัณฑ์ 10 อันดับแรกที่จัดอันดับตามจำนวน views ทั้งหมดในช่วงวันที่ที่ระบุ

ดูผลิตภัณฑ์ที่ขายได้มากที่สุด

หากต้องการทราบว่าผลิตภัณฑ์ใดมียอดขายมากที่สุด คุณสามารถค้นหา youtube_product_sold_stats_view

ต่อไปนี้คือตัวอย่างคำสั่ง SELECT ของ MCQL ที่คุณใช้เพื่อดูผลิตภัณฑ์ 10 อันดับแรก ที่จัดอันดับตามยอดขายรวม ระหว่างวันที่ 20 ถึง 21 มกราคม 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

การค้นหานี้จะดึงข้อมูลยอดขาย ค่าคอมมิชชัน และเมตริกหลักของผลิตภัณฑ์ 10 อันดับแรกที่จัดเรียงตามยอดขายรวมในช่วงวันที่ที่ระบุ

สิ่งสำคัญที่ต้องคำนึงถึง

• วันที่: กรองการค้นหาตาม date เสมอโดยใช้คําสั่ง WHERE เพื่อ ระบุระยะเวลาการรายงาน วันที่อยู่ในรูปแบบ YYYY-MM-DD
• เวลาในการตอบสนอง: เวลาในการตอบสนองของการค้นหาจะขึ้นอยู่กับปริมาณข้อมูลที่ขอ การค้นหาที่ครอบคลุมชุดข้อมูลขนาดใหญ่จะใช้เวลานานกว่าและอาจทำให้เกิดการหมดเวลา