คุณสามารถดึงข้อมูลเมตริกประสิทธิภาพที่สำคัญสำหรับผลิตภัณฑ์ที่เข้าร่วมโปรแกรมแอฟฟิลิเอต YouTube โดยใช้ API ย่อยสำหรับการรายงาน คู่มือนี้จะอธิบายวิธีค้นหาข้อมูลแอฟฟิลิเอตเฉพาะของ YouTube เช่น ยอดขาย ค่าคอมมิชชัน คำสั่งซื้อ ยอดดู และการคลิกที่มาจากครีเอเตอร์ เนื้อหาวิดีโอ สินค้าแต่ละรายการ หมวดหมู่สินค้า และแคมเปญเป้าหมายต่างๆ
การใช้ API ของโปรแกรมแอฟฟิลิเอต YouTube และข้อมูลที่เกี่ยวข้องของคุณต้องเป็นไปตามนโยบายสำหรับนักพัฒนาแอป YouTube Shopping
คุณสามารถใช้ Merchant Center Query Language (MCQL) เพื่อเลือกเมตริกและมิติข้อมูลจากมุมมอง YouTube Affiliate โดยเฉพาะ ซึ่งทำหน้าที่เหมือนตารางในการค้นหา
ข้อกำหนดเบื้องต้น
โปรดตรวจสอบสิ่งต่อไปนี้ก่อนใช้คู่มือนี้
- บัญชีที่ใช้ตรวจสอบสิทธิ์การเรียก API มีบทบาทประสิทธิภาพและข้อมูลเชิงลึกซึ่งให้สิทธิ์เข้าถึงเมตริกประสิทธิภาพ
- บัญชี Google Merchant Center ของคุณเข้าร่วมโปรแกรมแอฟฟิลิเอต YouTube
ค้นหาปลายทางอัลฟ่า
เนื่องจากฟีเจอร์นี้อยู่ในเวอร์ชันอัลฟ่าแบบสาธารณะ ปลายทางจึงแตกต่างกัน หากต้องการดึงข้อมูลประสิทธิภาพของแอฟฟิลิเอต 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 แต่ละราย และรวมถึงชื่อครีเอเตอร์และรหัสช่อง
ต่อไปนี้คือตัวอย่างคำสั่ง SELECT ของ MCQL ที่คุณใช้เพื่อดูครีเอเตอร์ที่มีประสิทธิภาพสูงสุด 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 แต่ละรายการ รวมถึงชื่อและรหัสวิดีโอ สำหรับมาร์เก็ตเพลส ให้ใส่ account_id เพื่อแจกแจงประสิทธิภาพตามบัญชีผู้ขายย่อยแต่ละบัญชี หากต้องการดูจำนวนค่าคอมมิชชันที่ได้รับเงินสนับสนุนจากผู้ขายย่อยและแพลตฟอร์มมาร์เก็ตเพลส ให้ระบุ seller_commissions และ platform_commissions
หากต้องการดึงข้อมูลวิดีโอ 3 อันดับแรกตามยอดดูระหว่างวันที่ 1 พฤษภาคมถึง 2 พฤษภาคม 2025 ให้ส่งคำสั่ง MCQL ต่อไปนี้ไปยังเมธอด accounts.reports.search
SELECT title, video_id, account_id, gross_sales, net_sales, commissions, seller_commissions, platform_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
การค้นหานี้จะดึงข้อมูลชื่อวิดีโอ รหัสวิดีโอ รหัสบัญชีผู้ขายย่อย (account_id) ค่าคอมมิชชันทั้งหมด (commissions) ค่าคอมมิชชันที่ผู้ขายให้เงินสนับสนุน (seller_commissions) ค่าคอมมิชชันที่แพลตฟอร์มให้เงินสนับสนุน (platform_commissions) และเมตริกหลักอื่นๆ สำหรับวิดีโอ 3 อันดับแรกที่จัดอันดับตามจำนวนviewsทั้งหมดในช่วงวันที่ที่ระบุ หมายเหตุ: คุณไม่สามารถใช้ account_id ในส่วนคำสั่ง WHERE ของ MCQL เพื่อกรองผลลัพธ์ได้
ดูผลิตภัณฑ์ที่ติดแท็กซึ่งมีการมีส่วนร่วมมากที่สุด
หากต้องการทราบว่าผลิตภัณฑ์ที่ติดแท็กรายการใดมีการมีส่วนร่วมและยอดขายมากที่สุด คุณสามารถค้นหา 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_category_tagged_stats_view
มุมมองนี้จะรวมเมตริกตามหมวดหมู่สินค้า (product_type) ในการจัดหมวดหมู่สินค้าของคุณ ซึ่งรวมถึงจำนวนครีเอเตอร์และวิดีโอที่ไม่ซ้ำกันซึ่งติดแท็กสินค้าในแต่ละหมวดหมู่
ใช้คำสั่ง MCQL SELECT ต่อไปนี้เพื่อดูหมวดหมู่สินค้าที่ติดแท็กยอดนิยม 10 อันดับแรกซึ่งจัดอันดับตามยอดขายรวมในวันที่ 1 กันยายน 2026
SELECT product_type, tagged_creator_count, tagged_video_count, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_product_category_tagged_stats_view WHERE date = '2026-09-01' ORDER BY gross_sales DESC LIMIT 10
การค้นหานี้จะดึงข้อมูลหมวดหมู่สินค้า (product_type) จำนวนครีเอเตอร์ที่ติดแท็ก จำนวนวิดีโอที่ติดแท็ก และเมตริกประสิทธิภาพหลักสำหรับหมวดหมู่สินค้า 10 อันดับแรกที่จัดอันดับตาม gross_sales ในวันที่ที่ระบุ
ดูสินค้าที่ขายได้มากที่สุด
หากต้องการทราบว่าผลิตภัณฑ์ใดมียอดขายมากที่สุด คุณสามารถค้นหา 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และdateyoutube_campaign_videos_stats_view:campaign_id,channel_idและdateyoutube_campaign_products_stats_view:campaign_idและdate
- เวลาในการตอบสนอง: เวลาในการตอบสนองของคำค้นหาขึ้นอยู่กับปริมาณข้อมูลที่ขอ การค้นหาที่ครอบคลุมชุดข้อมูลขนาดใหญ่จะใช้เวลานานกว่าและอาจทำให้หมดเวลา