פילוח

אפשר להטמיע את הפילוח בדוחות בהתאמה אישית ב-Merchant Center ב-Reporting API על ידי הוספת השדה המתאים לשאילתה. לדוגמה, אם תשלחו שאילתה על segments.program, יופיע דוח עם שורה לכל תוכנית (מודעות שופינג, כרטיסי מוצר חינמיים וכו') שכוללת את המדדים (חשיפות, קליקים וכו') של אותה התוכנית, כפי שצוין בסעיף SELECT.

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

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

SELECT
  segments.program,
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

הפעלה

לוחצים על Run כדי לנסות את הדוגמה ב-API Explorer. אחרי שלוחצים על Run, מעדכנים את ה-placeholder של מספר המוכר למספר המזהה שלכם בכתובת ה-URL של הבקשה. אפשר לשנות את השאילתה. כדי שהשאילתה המלאה תפעל עם API Explorer, היא צריכה להישאר בשורה אחת.

התוצאות משליחת השאילתה הזו ל-reports.search הן שורה שמציינת את הקליקים לכל שילוב של offer_id ו-program, כמו במחרוזת JSON לדוגמה:

{
  "results": [
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "38"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "125"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "23"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "8"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "3"
      }
    }
  ]
}

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

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

רמות של קטגוריות (segments.category_l1, segments.category_l2 וכו')
קטגוריות מטקסונומיית המוצרים של Google. אם לא צוינה קטגוריה, יכול להיות ש-Google תקצה באופן אוטומטי את הקטגוריה למוצר, או תצמצם את הקטגוריה שצוינה.
רמות של סוגי מוצרים (segments.product_type_l1, segments.product_type_l2 וכו')
סוגי מוצרים שמקצים על סמך הסיווגים שלכם. בשונה מרמות הקטגוריה, אין קבוצה מוגדרת מראש של ערכים נתמכים.

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

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

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

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

פילוח ערך של Gpa education
segments.product_type_l1 Home & Garden
segments.product_type_l2 Kitchen & Dining
segments.product_type_l3 Kitchen Appliances
segments.product_type_l4 Refrigerators

מדדי מטבע ומחיר

השדה segments.currency_code ב-ReportRow מציין את המטבע שבו מוחזרים מדדי מחיר כמו metrics.conversion_value_micros. מכיוון שהנתון הזה חשוב כדי לפרש נכון את המדדים האלה, הערך של ReportRow שיוחזר יכלול באופן אוטומטי את הערך segments.currency_code בכל פעם שבוחרים באחד ממדדי המחיר הבאים.

  • metrics.conversion_value_micros
  • metrics.aov_micros
  • metrics.ordered_item_sales_micros
  • metrics.returns_micros
  • metrics.shipped_item_sales_micros

מדדים של 'קונים ב-Google'

שפת השאילתות ב-Merchant Center תומכת בשתי קטגוריות של מדדים להזמנות ב'קונים ב-Google': מדדים ברמת הפריט ומדדים ברמת ההזמנה.

מדדים ברמת הפריט

המדדים מחושבים על סמך הפריטים בהזמנות ומשויכים למידות של המוצרים בכל הזמנה.

  • metrics.item_days_to_ship
  • metrics.item_fill_rate
  • metrics.ordered_items
  • metrics.ordered_item_sales_micros
  • metrics.rejected_items
  • metrics.returned_items
  • metrics.return_rate
  • metrics.returns_micros
  • metrics.shipped_items
  • metrics.shipped_item_sales_micros
  • metrics.unshipped_items
מדדים ברמת ההזמנה

המדדים מחושבים לפי הזמנה.

  • metrics.aos
  • metrics.aov_micros
  • metrics.days_to_ship
  • metrics.orders
  • metrics.shipped_orders
  • metrics.unshipped_orders

מדדים ברמת ההזמנה לא משויכים למאפייני המוצר של הפריטים בכל הזמנה.

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

  • segments.brand
  • segments.category_l1, segments.category_l2, segments.category_l3, segments.category_l4, segments.category_l5
  • segments.custom_label1, segments.custom_label2, segments.custom_label3, segments.custom_label4, segments.custom_label5
  • segments.offer_id
  • segments.product_type_l1, segments.product_type_l2, segments.product_type_l3, segments.product_type_l4, segments.product_type_l5
  • segments.title

פרטים נוספים

לרשימה המלאה של הפלחים, עיינו במסמכי העזרה.