אפשר להטמיע פילוח, הזמין בדוחות בהתאמה אישית של 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'
לוחצים על הפעלה כדי לנסות את הדוגמה ב-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 תקצה את הקטגוריה למוצר באופן אוטומטי. לחלופין, יכול להיות ש-Google תצמצם את הקטגוריה שצוינה.
- רמות של סוג המוצר (
segments.product_type_l1
,segments.product_type_l2
וכו') - סוגי מוצרים שמקצים על סמך הסיווג שלכם. להבדיל מרמות הקטגוריה, אין קבוצה מוגדרת מראש של ערכים נתמכים.
מאפייני הקטגוריה וסוג המוצר מאורגנים בהיררכיה עם מספר רמות. מפרט המוצרים מפריד בין כל רמה באמצעות התו >
, אבל בדוחות יכולים לבחור כל רמה בהיררכיה בנפרד.
לדוגמה, נניח שיש לכם מוצר עם הרמות הבאות של סוגי מוצרים:
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
הדוחות יחזירו כל רמה בשדה נפרד, באופן הבא:
פילוח | Value |
---|---|
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.order_item_sales_micros
.
מכיוון שזה חשוב כדי לפרש נכון את המדדים האלה, הערך של ReportRow
שיוחזר יכלול באופן אוטומטי segments.currency_code
בכל פעם שתבחרו באחד ממדדי המחיר שבהמשך.
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
למידע נוסף
רשימה מלאה של הפלחים זמינה במסמכי התיעוד.