Analyze YouTube Affiliate Performance (Alpha)

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

คุณใช้ MCQL เพื่อเลือกเมตริกและมิติข้อมูลจาก "มุมมอง" ของ YouTube Affiliate โดยเฉพาะได้ ซึ่งจะทำงานเหมือนตารางในคำค้นหา

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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