วิเคราะห์ประสิทธิภาพของแอฟฟิลิเอต YouTube (อัลฟ่า)

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

การใช้ API ของโปรแกรมแอฟฟิลิเอต YouTube และข้อมูลที่เกี่ยวข้องต้องเป็นไปตาม นโยบายสำหรับนักพัฒนาแอป YouTube Shopping

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

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

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

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

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

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

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

HTTP

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

{
  "query": "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"
}

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' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "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"
  }' \
  --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 อันดับแรกที่สั่งซื้อตามยอดขายรวมในช่วงวันที่ที่ระบุ

ดูประสิทธิภาพในแคมเปญทั้งหมด

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

ใช้คำสั่ง MCQL SELECT ต่อไปนี้เพื่อรับแคมเปญ 10 อันดับแรก ตามคำสั่งซื้อในวันที่ 23 เมษายน 2026

SELECT
  campaign_id,
  campaign_name,
  start_date,
  end_date,
  active_creators,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaigns_stats_view
WHERE date = '2026-04-23'
ORDER BY orders DESC LIMIT 10
    

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

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

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

ใช้คำสั่ง MCQL SELECT ต่อไปนี้เพื่อดูครีเอเตอร์ 10 อันดับแรก ตามยอดดูของแคมเปญที่เฉพาะเจาะจงในวันที่ 23 เมษายน 2026

SELECT
  channel_title,
  video_count,
  product_titles,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_individual_campaign_stats_view
WHERE date = '2026-04-23'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
ORDER BY views DESC LIMIT 10
    

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

ดูประสิทธิภาพของแคมเปญตามวิดีโอ

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

ใช้คำสั่ง MCQL SELECT ต่อไปนี้เพื่อดูวิดีโอ 10 อันดับแรก ตามยอดดูสำหรับครีเอเตอร์และแคมเปญที่เฉพาะเจาะจงในวันที่ 20 พฤษภาคม 2026

SELECT
  video_title,
  content_type,
  product_titles,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaign_videos_stats_view
WHERE date = '2026-05-20'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
  AND channel_id = 'YOUR_CHANNEL_ID'
ORDER BY views DESC LIMIT 10
    

คําค้นหานี้จะดึงชื่อวิดีโอ รูปแบบวิดีโอ (content_type) ชื่อสินค้าที่ติดแท็ก และเมตริกประสิทธิภาพที่สําคัญสําหรับวิดีโอ 10 อันดับแรก ซึ่งจัดอันดับตามจํานวนviewsทั้งหมดสําหรับครีเอเตอร์ แคมเปญ และวันที่ที่ระบุ

ดูประสิทธิภาพของแคมเปญตามผลิตภัณฑ์

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

ใช้คำสั่ง MCQL SELECT ต่อไปนี้เพื่อดูผลิตภัณฑ์ 10 อันดับแรก ตามยอดดูของแคมเปญที่เฉพาะเจาะจงในวันที่ 20 มิถุนายน 2026

SELECT
  channel_title,
  product_title,
  video_title,
  video_url,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaign_products_stats_view
WHERE date = '2026-06-20'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
ORDER BY views DESC LIMIT 10
    

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

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

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