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

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

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

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

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

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

שליחת שאילתה לנקודת הקצה (endpoint) של גרסת האלפא

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

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)