דוחות ביצועים

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

מדדים

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

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

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

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

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.

הקודם
Evaluate your products
הבא
Understand the market