סכימת טבלת המוצרים של Google Merchant Center
כשנתוני הדיווח של Google Merchant Center מועברים ל-BigQuery, הפורמט של נתוני המוצרים ותובנות על מוצרים תואם בעיקר לפורמט של השדות הרלוונטיים במשאבים products ו-productstatuses של Content API.
הנתונים נכתבים בטבלה בשם Products_MERCHANT_ID אם אתם משתמשים במספר חשבון Merchant ספציפי, או בטבלה בשם Products_AGGREGATOR_ID אם אתם משתמשים בחשבון MCA.
סכימה
הסכימה של הטבלה Products_ היא:
| עמודה | סוג הנתונים ב-BigQuery | תיאור | נתונים לדוגמה |
|---|---|---|---|
product_data_timestamp |
TIMESTAMP |
חותמת הזמן של נתוני המוצר. | 14 בספטמבר 2023, 11:49:50 UTC |
product_id |
STRING |
מזהה ה-REST של המוצר ב-Content API, בפורמט:
channel:content_language:feed_label:offer_id. זה המפתח הראשי. |
online:en:AU:666840730 |
merchant_id |
INTEGER |
מספר החשבון של המוכר. | 1234 |
aggregator_id |
INTEGER |
מזהה חשבון של אגרגטור לחשבונות מרובי-לקוחות. | 12345 |
offer_id |
STRING |
מזהה המוצר שסופק על ידי המוכר. | tddy123uk |
title |
STRING |
שם הפריט. | TN2351 שחור USB |
description |
STRING |
תיאור של הפריט. | ה-USB השחור TN2351 הגדיר מחדש את האופן שבו XJS יכול להשפיע על חוויות LLCD. |
link |
STRING |
כתובת ה-URL של דף הנחיתה של המוצר, כפי שסופקה על ידי המוכר. | https://www.example.com/tn2351-black-usb/6538811?skuId=1234 |
mobile_link |
STRING |
כתובת URL של גרסה מותאמת לניידים של דף הנחיתה, שהמוכר סיפק. | https://www.example.com/tn2351-black-usb/6538811?skuId=1234 |
image_link |
STRING |
כתובת ה-URL של התמונה הראשית של המוצר, כפי שסופקה על ידי המוכר. | https://www.example.com/tn2351-black-usb/6538811?skuId=1234 |
additional_image_links |
STRING, REPEATED |
כתובות URL נוספות של תמונות של הפריט, שהמוכר סיפק. | |
content_language |
STRING |
קוד השפה של הפריט, בן שתי אותיות לפי תקן ISO 639-1. | iw |
target_country |
STRING |
הוצא משימוש (תמיד מוגדר כ-NULL) כחלק משינוי שמאפשר למוצרים לטרגט כמה מדינות. במקום זאת, השתמשו בשדות הבאים כדי לקרוא את הסטטוס של כל מדינה מטורגטת: destinations.approved_countries, destinations.pending_countries, destinations.disapproved_countries. עכשיו בעיות יכולות לחול על מדינות יעד מסוימות ולא על אחרות, כפי שמצוין בשדה issues.applicable_countries. |
null |
feed_label |
STRING |
תווית הפיד שהמוכר סיפק לפריט, או - אם לא סופקה תווית. |
ארה"ב |
channel |
STRING |
ערוץ הפריט, online או local. |
מקומי, אונליין |
expiration_date |
TIMESTAMP |
התאריך והשעה שבהם תוקף הפריט אמור לפוג, כפי שצוין על ידי המוכר בזמן הוספת הפריט. אם לא צוין ערך, הוא מוגדר כ-null. | 2023-10-14 00:00:00 UTC |
google_expiration_date |
TIMESTAMP |
התאריך והשעה שבהם תוקף הפריט ב-Google שופינג יפוג. אף פעם לא מוגדר כ-null. | 2023-10-14 00:00:00 UTC |
adult |
BOOLEAN |
צריך להגדיר את הערך true אם הפריט מיועד למבוגרים. | true, false |
age_group |
STRING |
קבוצת הגיל שאליה מיועד הפריט, כפי שצוינה על ידי המוכר. אם לא צוין, הערך יהיה NULL. | תינוק שזה עתה נולד, תינוק, פעוט, ילדים, מבוגר |
availability |
STRING |
סטטוס הזמינות של הפריט שסופק על ידי המוכר. | במלאי, חסר במלאי |
availability_date |
TIMESTAMP |
התאריך והשעה שבהם מוצר בהזמנה מראש יהיה זמין למשלוח, כפי שצוינו על ידי המוכר. אם לא צוין, הערך יהיה NULL. | 2023-10-14 00:00:00 UTC |
brand |
STRING |
המותג של הפריט, כפי שצוין על ידי המוכר. אם לא צוין, הערך יהיה NULL. | שם המותג |
google_brand_id |
STRING |
מזהה המותג של הפריט ב-Google. | 12759524623914508053 |
color |
STRING |
הצבע של הפריט, כפי שצוין על ידי המוכר. אם לא צוין, הערך יהיה NULL. | כסף, אפור, צבעוני |
condition |
STRING |
מצב הפריט כפי שצוין על ידי המוכר. | חדש, משומש, מחודש |
custom_labels |
RECORD |
תוויות מותאמות אישית שהמוכר מספק כדי לקבץ פריטים במודעות שופינג. אם לא צוין, הערך יהיה NULL. | |
custom_labels.label_0 |
STRING |
תווית מותאמת אישית 0. | התווית המותאמת אישית שלי |
custom_labels.label_1 |
STRING |
תווית מותאמת אישית 1. | התווית המותאמת אישית שלי |
custom_labels.label_2 |
STRING |
תווית מותאמת אישית 2. | התווית המותאמת אישית שלי |
custom_labels.label_3 |
STRING |
תווית מותאמת אישית 3. | התווית המותאמת אישית שלי |
custom_labels.label_4 |
STRING |
תווית מותאמת אישית 4. | התווית המותאמת אישית שלי |
gender |
STRING |
המגדר שהמוצר מיועד לו, כפי שצוין על ידי המוכר. אם לא צוין, הערך יהיה NULL. | unisex, male, female |
gtin |
STRING |
מספר הפריט המסחרי הגלובלי (GTIN) של הפריט, כפי שסופק על ידי המוכר. אם לא צוין, הערך יהיה NULL. | 3234567890126 |
item_group_id |
STRING |
מזהה משותף שסופק על ידי המוכר לכל הווריאציות של אותו מוצר. אם לא צוין, הערך יהיה NULL. | AB12345 |
material |
STRING |
החומר שהמוכר ציין שהפריט עשוי ממנו. אם לא צוין, הערך יהיה NULL. | עור |
mpn |
STRING |
מספר החלק שהיצרן הקצה לפריט (קוד MPN), כפי שסופק על ידי המוכר. אם לא צוין ערך, הוא מוגדר כ-NULL. | GO12345OOGLE |
pattern |
STRING |
תבנית שסופקה על ידי המוֹכר. אם לא צוין, הערך יהיה NULL. | פסים |
price |
RECORD |
המחיר של הפריט שצוין על ידי המוֹכר. | |
price.value |
NUMERIC |
מחיר הפריט. | 19.99 |
price.currency |
STRING |
המטבע של המחיר. | USD |
sale_price |
RECORD |
מחיר המבצע של הפריט שסופק על ידי המוכר. | |
sale_price.value |
NUMERIC |
מחיר המבצע של הפריט. אם לא צוין, הערך יהיה NULL. | 19.99 |
sale_price.currency |
STRING |
המטבע של מחיר המבצע. אם לא צוין, הערך יהיה NULL. | USD |
sale_price_effective_start_date |
TIMESTAMP |
תאריך ושעת ההתחלה של המבצע על הפריט. | 2023-10-14 00:00:00 UTC |
sale_price_effective_end_date |
TIMESTAMP |
תאריך ושעת הסיום של המבצע על הפריט. | 2023-10-14 00:00:00 UTC |
google_product_category |
INTEGER |
מזהה קטגוריית המוצר ב-Google של הפריט. אם לא צוין, הערך יהיה NULL. | 2271 |
google_product_category_ids |
INTEGER, REPEATED |
הנתיב המלא של קטגוריות המוצרים ב-Google לפריט, שמאוחסן כקבוצה של מזהים. אם לא צוין, הערך יהיה NULL. | |
google_product_category_path |
STRING |
גרסה קריאה לאנשים של הנתיב המלא. אם לא צוין, השדה ריק. | Apparel & Accessories > Clothing > Dresses |
product_type |
STRING |
הקטגוריה של הפריט, כפי שצוינה על ידי המוכר. | דף הבית > נשים > שמלות > שמלות מקסי |
additional_product_types |
STRING, REPEATED |
קטגוריות נוספות של הפריט. | |
promotion_ids |
STRING, REPEATED |
רשימת מזהי המבצעים שמשויכים למוצר. | |
destinations |
RECORD, REPEATED |
היעדים שאליהם המוצר מיועד. | |
destinations.name |
STRING |
שם היעד. יש תמיכה רק ב-Shopping. הערך הזה תואם לשיטות השיווק "מודעות שופינג" ו "מודעות מלאי של חנויות מקומיות" ב-Merchant Center. |
שופינג |
destinations.status |
STRING |
הוצא משימוש (תמיד מוגדר כ-NULL) כחלק משינוי שמאפשר למוצרים לטרגט כמה מדינות. במקום זאת, השתמשו בשדות הבאים כדי לקרוא את הסטטוס של כל מדינה מטורגטת: destinations.approved_countries, destinations.pending_countries, destinations.disapproved_countries. עכשיו בעיות יכולות לחול על מדינות יעד מסוימות ולא על אחרות, כפי שמצוין בשדה issues.applicable_countries. |
NULL |
destinations.approved_countries |
STRING, REPEATED |
רשימה של קודי הטריטוריות של CLDR שבהם המוצר אושר. | ארה"ב, שווייץ |
destinations.pending_countries |
STRING, REPEATED |
רשימה של קודי הטריטוריות של CLDR שבהן המוצר נמצא בבדיקה. | ארה"ב, שווייץ |
destinations.disapproved_countries |
STRING, REPEATED |
רשימה של קודי טריטוריה של CLDR שבהם המוצר נפסל. | ארה"ב, שווייץ |
issues |
RECORD, REPEATED |
רשימת הבעיות ברמת הפריט שמשויכות למוצר. | |
issues.code |
STRING |
קוד השגיאה של הבעיה. | image_too_generic |
issues.servability |
STRING |
איך הבעיה הזו משפיעה על הצגת המוצר. | נדחתה, לא מושפעת |
issues.resolution |
STRING |
אם המוכר יכול לפתור את הבעיה. | merchant_action, pending_processing |
issues.attribute_name |
STRING |
שם המאפיין, אם הבעיה נגרמת על ידי מאפיין אחד. אחרת הערך יהיה NULL. | קישור לתמונה |
issues.destination |
STRING |
היעד שבו הבעיה קיימת. הערך תמיד מוגדר כ-Shopping. |
שופינג |
issues.short_description |
STRING |
תיאור קצר של הבעיה באנגלית. | תמונה גנרית |
issues.detailed_description |
STRING |
תיאור מפורט של הבעיה באנגלית. | צריך להשתמש בתמונה שהמוצר מוצג בה |
issues.documentation |
STRING |
כתובת URL של דף אינטרנט שיכולה לעזור בפתרון הבעיה. | https://support.google.com/merchants/answer/6098288 |
issues.applicable_countries |
STRING, REPEATED |
רשימה של קודי אזורים במאגר CLDR שבהם הבעיה רלוונטית. | CH |
שאילתות לדוגמה
סטטיסטיקות של מוצרים ותובנות על מוצרים
השאילתה הבאה לדוגמה ב-SQL מספקת את מספר המוצרים, המוצרים עם הבעיות והבעיות לפי יום.
SELECT _PARTITIONDATE AS date, COUNT(*) AS num_products, COUNTIF(ARRAY_LENGTH(issues) > 0) AS num_products_with_issues, SUM(ARRAY_LENGTH(issues)) AS num_issues FROM dataset.Products_merchant_id WHERE _PARTITIONDATE >= 'YYYY-MM-DD' GROUP BY date ORDER BY date DESC
מוצרים שנפסלו להצגה במודעות שופינג
שאילתת ה-SQL לדוגמה הבאה מספקת את מספר המוצרים שלא אושרו להצגה במודעות שופינג, בחלוקה לפי מדינה. המוצר יכול להיפסל אם היעד לא נכלל או בגלל בעיה במוצר.
SELECT _PARTITIONDATE AS date, disapproved_country, COUNT(*) AS num_products FROM dataset.Products_merchant_id, UNNEST(destinations) AS destination, UNNEST(disapproved_countries) AS disapproved_country WHERE _PARTITIONDATE >= 'YYYY-MM-DD' GROUP BY date, disapproved_country ORDER BY date DESC
מוצרים עם בעיות שגורמות לפסילה
השאילתה הבאה לדוגמה ב-SQL מאחזרת את מספר המוצרים עם בעיות פסילה, בחלוקה לפי מדינה.
SELECT _PARTITIONDATE AS date, applicable_country, COUNT(DISTINCT CONCAT(CAST(merchant_id AS STRING), ':', product_id)) AS num_distinct_products FROM dataset.Products_merchant_id, UNNEST(issues) AS issue, UNNEST(issue.applicable_countries) as applicable_country WHERE _PARTITIONDATE >= 'YYYY-MM-DD' AND issue.servability = 'disapproved' GROUP BY date, applicable_country ORDER BY date DESC