Performance reports

‫Merchant API מציע דוחות ביצועים, לדוגמה product_performance_view. בדף הזה מוסבר על המבנה של דוחות הביצועים.

מדדים

אפשר לשלוח שאילתות לגבי מדדים (לדוגמה, clicks ו-impressions) שרוצים לקבל. כדי לשלוח שאילתה לשירות הדוחות לגבי נתוני ביצועים, צריך להוסיף מסנן לטווח התאריכים.

זוהי דוגמה לשאילתה שמחזירה שורה אחת עם המספר הכולל של הקליקים בטווח התאריכים שצוין:

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

צריך לציין את הנתונים שרוצים לקבל. שימוש בתווים כלליים (לדוגמה, SELECT *) יחזיר שגיאה.

בדוגמה הבאה של תגובה אפשר לראות שהמוכר קיבל 4,440 קליקים בסך הכול על כל המוצרים, בכל שיטות השיווק, בין 1 בדצמבר 2023 ל-21 בדצמבר 2023.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4440"
      }
    }
  ]
}

פלחים

אפשר להשתמש בשדות של פלחים כדי ליצור פילוח בדוחות ביצועים. לדוגמה, שאילתה של marketing_method מחזירה דוח עם שורה לכל שיטת שיווק, והמדדים שציינתם לשיטת השיווק הזו בסעיף SELECT.

השדות של הפלחים יכולים להיות מאפייני מוצר (לדוגמה, offer_id, brand ו-category) או מאפייני אירוע (לדוגמה, date ו-marketing_method).

שדות של פלחים פועלים באופן דומה ל-GROUP BY ב-SQL. שדות הפלחים מפצלים את המדדים שנבחרו, ומקבצים לפי כל פלח בסעיף SELECT.

זוהי שאילתה לדוגמה שמחזירה את מספר הקליקים ליום, בסדר יורד לפי clicks, במסגרת התנאי הנוסף של טווח תאריכים. רק שורות שבהן לפחות מדד מבוקש אחד הוא לא אפס מוחזרות.

SELECT
  date,
  clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC

בדוגמה הבאה של תגובה אפשר לראות שהמוכר קיבל 1,546 קליקים על כל המוצרים, בכל שיטות השיווק, ב-1 בדצמבר 2023, ו-829 קליקים על כל המוצרים, בכל שיטות השיווק, ב-2 בדצמבר 2023. המוכר לא קיבל קליקים ב-3 בדצמבר 2023, ולכן לא מוחזרים נתונים לגבי התאריך הזה.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}

בדומה לדוחות בהתאמה אישית ב-Merchant Center, אפשר לציין כמה פלחים באותה שאילתה באמצעות Merchant Reports API.

דוגמה לשאילתה שמחזירה את הקליקים על כל המוצרים בחשבון במהלך תקופה של 30 יום, מפולחים לפי marketing_method וoffer_id:

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

התשובה מהשאילתה הזו כוללת שורה לכל שילוב של offer_id ושל marketing_method, עם מספר הקליקים לשילוב הזה:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

קטגוריה וסוג מוצר

שפת השאילתות של Merchant Center תומכת בפילוח מדדים לפי שתי קבוצות של מאפיינים שאפשר להגדיר כדי לארגן את מלאי המוצרים:

רמות הקטגוריות

קטגוריות מטקסונומיית המוצרים של Google. יכול להיות ש-Google תקצה אוטומטית קטגוריה למוצר אם לא צוינה קטגוריה, או שתשפר את הקטגוריה שצוינה.

רמות של סוג מוצר

סוגי מוצרים שאתם מקצים לפי הסיווג שלכם. בניגוד לרמות הקטגוריה, אין קבוצה מוגדרת מראש של ערכים נתמכים.

המאפיינים 'קטגוריה' ו'סוג המוצר' מאורגנים בהיררכיה עם כמה רמות. מפרט המוצר מפריד בין כל רמה באמצעות התו >, אבל בדוחות בוחרים כל רמה בהיררכיה בנפרד.

לדוגמה, נניח שיש מוצר עם רמות סוג המוצר הבאות:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

כל רמה מוחזרת בדוח בשדה משלה:

מדדים של מטבע ומחיר

מדדי מחיר, כמו conversion_value, מיוצגים באמצעות הסוג Price. אם המדד זמין בכמה מטבעות, הערך של כל מטבע מוחזר בשורה נפרדת. לדוגמה, השאילתה הבאה:

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

הפונקציה מחזירה את התוצאות הבאות:

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

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

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

מוחזרת התגובה הבאה:

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

כל השדות שתבחרו יוחזרו בתגובה, גם אם הערך שלהם הוא עדיין ערך ברירת המחדל או אפס.

מידע נוסף על השדות שזמינים לשאילתה מופיע במאמר בנושא שדות בטבלה productPerformanceView.