Analyze Youtube Affiliate Performance (Alpha)

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

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

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

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

• לחשבון שמשמש לאימות קריאות ל-API יש את התפקיד ביצועים ותובנות שמעניק גישה למדדי הביצועים.
• החשבון שלכם ב-Google Merchant Center משתתף בתוכנית השותפים העצמאיים של YouTube.

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

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

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

  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' \
  --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 המוצרים המובילים לפי מכירות ברוטו, בטווח התאריכים שצוין.

שיקולים חשובים

• תאריכים: תמיד מסננים את השאילתות לפי date באמצעות סעיפי WHERE כדי לציין את תקופת הדיווח. התאריכים הם בפורמט YYYY-MM-DD.
• זמן אחזור: זמן האחזור של שאילתות תלוי בנפח הנתונים שמתבקש. שאילתות שכוללות מערכי נתונים גדולים אורכות יותר זמן, ויכול להיות שייגרם להן פסק זמן.