Analyze YouTube Affiliate Performance (Alpha)

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

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

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

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

ส่งคำค้นหาไปยังปลายทางเวอร์ชันอัลฟ่า

โปรดทราบว่าเนื่องจากตอนนี้เป็นเวอร์ชันอัลฟ่าแบบสาธารณะแล้ว Endpoint จึงแตกต่างกัน หากต้องการดึงข้อมูลประสิทธิภาพของแอฟฟิลิเอต 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 แต่ละรายการ รวมถึงชื่อและรหัสวิดีโอ

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

ดูประสิทธิภาพตามผลิตภัณฑ์

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

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

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

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

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