ניתוח הביצועים של YouTube Affiliate (אלפא)

אתם יכולים לאחזר מדדי ביצועים מרכזיים של המוצרים שמשתתפים בתוכנית השותפים של YouTube באמצעות ה-API המשני Reporting. במדריך הזה מוסבר איך לשלוח שאילתות לגבי נתונים ספציפיים ל-YouTube של שותפים עצמאיים, כמו מכירות, עמלות, הזמנות, צפיות וקליקים, שמשויכים ליוצרים שונים, לקטע וידאו, למוצרים בודדים, לקטגוריות מוצרים ולקמפיינים יעד.

השימוש שלכם בממשקי ה-API של תוכנית השותפים של YouTube ובנתונים שמשויכים אליהם חייב לעמוד בדרישות של מדיניות המפתחים של YouTube שופינג.

אתם יכולים להשתמש בשפת השאילתות של Merchant Center (MCQL) כדי לבחור מדדים ומאפיינים מתצוגות ייעודיות של תוכנית השותפים של YouTube, שפועלות כמו טבלאות בשאילתות שלכם.

דרישות מוקדמות

לפני שמשתמשים במדריך הזה, חשוב לוודא:

שליחת שאילתה לנקודת הקצה של אלפא

מכיוון שהתכונה הזו נמצאת בגרסת אלפא ציבורית, נקודת הקצה שונה. כדי לאחזר נתוני ביצועים של תוכנית השותפים של YouTube, צריך לשלוח את בקשת ה-POST לנקודת הקצה (endpoint) 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) בטקסונומיית המוצרים, כולל מספר היוצרים והסרטונים הייחודיים שתייגו מוצרים בכל קטגוריה.

כדי לקבל את 10 קטגוריות המוצרים המתויגות המובילות לפי מכירות ברוטו ב-1 בספטמבר 2026, אפשר להשתמש בהצהרת MCQL SELECT הבאה: 

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. בתצוגה הזו מרוכזים מדדים מכל הקמפיינים, כולל שמות הקמפיינים, תאריכי ההתחלה והסיום, מספר היוצרים הפעילים ומדדי המכירות וההתעניינות.

כדי לקבל את 10 הקמפיינים המובילים לפי הזמנות ב-23 באפריל 2026, משתמשים בהצהרת MCQLSELECT הבאה: 

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. בתצוגה הזו מוצגים מדדים מצטברים לכל יוצר בקמפיין, כולל שמות הערוצים, מספר הסרטונים ושמות המוצרים שתויגו.

כדי לקבל את 10 היוצרים המובילים לפי צפיות בקמפיין ספציפי ב-23 באפריל 2026, משתמשים בהצהרת MCQL SELECT הבאה: 

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. בתצוגה הזו מוצגים מדדי ביצועים ברמת הסרטון של יוצר בקמפיין, כולל שמות הסרטונים, הפורמטים של הסרטונים והמוצרים המתויגים.

כדי לקבל את 10 הסרטונים המובילים לפי מספר הצפיות של יוצר וקמפיין ספציפיים ב-20 במאי 2026, משתמשים בהצהרת ה-MCQL הבאה (SELECT): 

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. בתצוגה הזו מוצגים מדדי ביצועים ברמת המוצר בקמפיין, כולל שמות המוצרים, פרטי הסרטונים המשויכים ומדדי המכירות.

כדי לקבל את 10 המוצרים המובילים לפי צפיות בקמפיין ספציפי ב-20 ביוני 2026, משתמשים בהצהרת ה-MCQL הבאה (SELECT): 

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.
  • זמן אחזור: זמן האחזור של השאילתות תלוי בנפח הנתונים המבוקשים. שאילתות שכוללות קבוצות נתונים גדולות אורכות יותר זמן ויכולות לגרום לזמני קצוב לתפוגה.
הקודם
Explore your competitive landscape
הבא
Analyze UCP agentic performance (Alpha)