Analyze Youtube Affiliate Performance (Alpha)

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

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

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

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

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

หมายเหตุ: ยอดดูประสิทธิภาพของแอฟฟิลิเอต YouTube ใน Merchant Reports API อยู่ในรุ่นอัลฟ่า ฟีเจอร์และฟังก์ชันการทำงานอาจมีการเปลี่ยนแปลง และอาจได้รับการอัปเดตหรือหยุดให้บริการ

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

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

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

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