คุณสามารถดึงข้อมูลเมตริกประสิทธิภาพที่สำคัญสำหรับผลิตภัณฑ์ที่เข้าร่วม โปรแกรมแอฟฟิลิเอต YouTube ได้โดยใช้ Reporting sub-API คู่มือนี้จะอธิบายวิธีค้นหาข้อมูลแอฟฟิลิเอตที่เฉพาะเจาะจงของ YouTube เช่น ยอดขาย ค่าคอมมิชชัน คำสั่งซื้อ ยอดดู และยอดคลิก ซึ่งระบุแหล่งที่มาเป็นครีเอเตอร์ เนื้อหาวิดีโอ ผลิตภัณฑ์แต่ละรายการ หมวดหมู่สินค้า และแคมเปญเป้าหมายต่างๆ
การใช้ API ของโปรแกรมแอฟฟิลิเอต YouTube และข้อมูลที่เกี่ยวข้องต้องเป็นไปตาม นโยบายสำหรับนักพัฒนาแอป YouTube Shopping
คุณสามารถใช้ Merchant Center Query Language (MCQL) เพื่อเลือกเมตริกและมิติข้อมูลจากมุมมองแอฟฟิลิเอต YouTube โดยเฉพาะ ซึ่งทำงานเหมือนตารางในคำค้นหา
ข้อกำหนดเบื้องต้น
ก่อนใช้คู่มือนี้ โปรดตรวจสอบว่า
- บัญชีที่ใช้ในการตรวจสอบสิทธิ์การเรียก 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) ในการจัดหมวดหมู่สินค้า ซึ่งรวมถึง
จำนวนครีเอเตอร์และวิดีโอที่ไม่ซ้ำกันที่ติดแท็กผลิตภัณฑ์ในแต่ละ
หมวดหมู่
ใช้คำสั่ง SELECT ของ MCQL ต่อไปนี้เพื่อดูหมวดหมู่สินค้าที่ติดแท็ก 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
ต่อไปนี้เป็นตัวอย่างคำสั่ง SELECT ของ MCQL ที่คุณใช้เพื่อดู
ผลิตภัณฑ์ 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
มุมมองนี้จะรวบรวมเมตริกในทุกแคมเปญ ซึ่งรวมถึงชื่อแคมเปญ
วันที่เริ่มต้นและวันที่สิ้นสุด จำนวนครีเอเตอร์ที่ใช้งานอยู่ รวมถึงเมตริกยอดขายและการมีส่วนร่วม
ใช้คำสั่ง SELECT ของ MCQL ต่อไปนี้เพื่อดูแคมเปญ 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
มุมมองนี้จะรวบรวมเมตริกต่อครีเอเตอร์ภายในแคมเปญ ซึ่งรวมถึง
ชื่อช่อง จำนวนวิดีโอ และชื่อผลิตภัณฑ์ที่ติดแท็ก
ใช้คำสั่ง SELECT ของ MCQL ต่อไปนี้เพื่อดูครีเอเตอร์ 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
มุมมองนี้จะแสดงเมตริกประสิทธิภาพระดับวิดีโอสำหรับครีเอเตอร์ในแคมเปญ ซึ่งรวมถึงชื่อวิดีโอ รูปแบบวิดีโอ และผลิตภัณฑ์ที่ติดแท็ก
ใช้คำสั่ง SELECT ของ MCQL ต่อไปนี้เพื่อดูวิดีโอ 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
มุมมองนี้จะแสดงเมตริกประสิทธิภาพระดับสินค้าภายในแคมเปญ ซึ่งรวมถึงชื่อผลิตภัณฑ์ รายละเอียดวิดีโอที่เกี่ยวข้อง และเมตริกยอดขาย
ใช้คำสั่ง SELECT ของ MCQL ต่อไปนี้เพื่อดูผลิตภัณฑ์ 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
- เวลาในการตอบสนอง: เวลาในการตอบสนองของคำค้นหาขึ้นอยู่กับปริมาณข้อมูลที่ขอ คำค้นหาที่ครอบคลุมชุดข้อมูลขนาดใหญ่จะใช้เวลานานกว่าและอาจทำให้เกิดการหมดเวลา