Analyze YouTube Affiliate Performance (Alpha)

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

אתם יכולים להשתמש ב-MCQL כדי לבחור מדדים ומימדים מתוך 'צפיות' ייעודיות של שותפים עצמאיים ב-YouTube, שפועלות כמו טבלאות בשאילתות שלכם.

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

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

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

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

HTTP

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

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' \
  --compressed

הצגת נתוני הביצועים לפי יוצר

כדי להבין אילו יוצרים ב-YouTube מניבים את רמת המעורבות והמכירות הגבוהה ביותר, אפשר להריץ שאילתה ב-youtube_creator_performance_view. בתצוגה הזו מוצגים מדדים מצטברים של יוצרים ספציפיים ב-YouTube, כולל שמות היוצרים ומזהי הערוצים שלהם.

הנה דוגמה להצהרת SELECT ב-MCQL שאפשר להשתמש בה כדי לקבל את 3 היוצרים שמניבים את הביצועים הכי טובים לפי מכירות בין 1 במאי ל-2 במאי 2025.

SELECT
  title,
  channel_id,
  sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3

השאילתה הזו מאחזרת את שם היוצר, מזהה הערוץ ומדדי הביצועים העיקריים של 3 היוצרים המובילים, לפי דירוג מדד המכירות בטווח התאריכים שצוין.

צפייה בנתוני הביצועים לפי תוכן

כדי לראות אילו סרטונים ספציפיים ב-YouTube מניבים את הביצועים הכי טובים, אפשר להריץ שאילתה על youtube_content_performance_view. בתצוגה הזו המדדים מצטברים לפי סרטונים ספציפיים ב-YouTube, והיא כוללת את שמות הסרטונים ומזהי הסרטונים.

הנה דוגמה להצהרת SELECT של MCQL שאפשר להשתמש בה כדי לקבל את 3 הסרטונים המובילים לפי מספר הצפיות בין 1 במאי ל-2 במאי 2025.

SELECT
  title,
  video_id,
  views,
  clicks,
  sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY views DESC LIMIT 3

השאילתה הזו מאחזרת את שם הסרטון, מזהה הסרטון ומדדי המפתח של 3 הסרטונים המובילים שדורגו לפי המספר הכולל של views בטווח התאריכים שצוין.

הצגת נתוני הביצועים לפי מוצר

כדי לנתח את הביצועים של מוצרים ספציפיים בתוכנית השותפים של YouTube, אפשר להריץ שאילתה על youtube_product_performance_view. בתצוגה הזו מוצגים מדדים מצטברים לפי מוצר, כולל שמות המוצרים ומזהי המבצעים.

דוגמה להצהרת SELECT ב-MCQL שבה אפשר להשתמש כדי למצוא את 3 המוצרים המובילים לפי סכום המכירות בין 1 במאי ל-2 במאי 2025:

SELECT
  title,
  offer_id,
  sales,
  commissions,
  orders,
  clicks
FROM youtube_product_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3

השאילתה הזו מחזירה את שם המוצר, מזהה המבצע ומדדי הביצועים של 3 המוצרים המובילים, לפי סדר יורד של המדד sales, במהלך התקופה שצוינה.

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

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