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"
        }
      }
    }
  ]
}

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