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": "4,440"
      }
    }
  ]
}

פלחים

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

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

Segment ערך
product_type_l1 Home & Garden
product_type_l2 Kitchen & Dining
product_type_l3 Kitchen Appliances
product_type_l4 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.