אפשר להטמיע פילוח, שזמין בדוחות בהתאמה אישית ב-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_microsmetrics.ordered_item_sales_microsmetrics.returns_microsmetrics.shipped_item_sales_micros
מדדים של 'קונים ב-Google'
שפת השאילתות של Merchant Center תומכת בשתי קטגוריות של מדדים להזמנות מ'קונים ב-Google': מדדים ברמת הפריט ומדדים ברמת ההזמנה.
- מדדים ברמת הפריט
מדדים שמחושבים על סמך הפריטים בהזמנות, ומשויכים למאפייני המוצר של הפריטים בכל הזמנה.
metrics.item_days_to_shipmetrics.item_fill_ratemetrics.ordered_itemsmetrics.ordered_item_sales_microsmetrics.rejected_itemsmetrics.returned_itemsmetrics.return_ratemetrics.returns_microsmetrics.shipped_itemsmetrics.shipped_item_sales_microsmetrics.unshipped_items
- מדדים ברמת ההזמנה
המדדים מחושבים על בסיס כל הזמנה.
metrics.aosmetrics.aov_microsmetrics.days_to_shipmetrics.ordersmetrics.shipped_ordersmetrics.unshipped_orders
מדדים ברמת ההזמנה לא משויכים למאפייני המוצר של הפריטים בכל הזמנה.
אפשר לבחור מדדים ברמת הפריט בשילוב עם כל פלח זמין. עם זאת, בחירה של מדדים ברמת ההזמנה בשילוב עם אחד מהפלחים הבאים של מאפייני המוצר תיכשל:
segments.brandsegments.category_l1,segments.category_l2,segments.category_l3,segments.category_l4,segments.category_l5segments.custom_label1,segments.custom_label2,segments.custom_label3,segments.custom_label4,segments.custom_label5segments.offer_idsegments.product_type_l1,segments.product_type_l2,segments.product_type_l3,segments.product_type_l4,segments.product_type_l5segments.title
למידע נוסף
רשימה מלאה של פלחים זמינה במאמר הזה.