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