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
• เวลาในการตอบสนอง: เวลาในการตอบสนองของคำค้นหาจะขึ้นอยู่กับปริมาณข้อมูลที่ขอ คำค้นหาขนาดใหญ่อาจใช้เวลานานขึ้นและอาจทำให้เกิดการหมดเวลา