Analyze Youtube Affiliate Performance (Alpha)

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

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

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

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

• บัญชีที่ใช้เพื่อตรวจสอบสิทธิ์การเรียก 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ได้

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