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

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

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

אתם יכולים להשתמש בשפת השאילתות של Merchant Center (MCQL) כדי לבחור מדדים ומאפיינים מתוך תצוגות ייעודיות של שותפים עצמאיים ב-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, והיא כוללת את הכותרות של היוצרים ואת מזהי הערוצים.

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

כדי לקבל את 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
הבא
Use Merchant Center Query Language