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