סכימת טבלת המוצרים ב-Google Merchant Center
סקירה כללית
כשנתוני הדיווח שלכם מ-Google Merchant Center מועברים אל BigQuery, הפורמט של נתוני המוצרים ובעיות המוצרים תואם בעיקר לפורמט של השדות הרלוונטיים במשאבי המוצרים וסטטוס המוצרים של Content API.
הנתונים נכתבים לטבלה בשם
Products_MERCHANT_ID אם אתם משתמשים במספר חשבון Merchant יחיד, או לטבלה בשם
Products_AGGREGATOR_ID אם אתם משתמשים בחשבון MCA.
סכימה
הסכימה של הטבלה Products_ היא:
| עמודה | סוג נתונים ב-BigQuery | תיאור | נתונים לדוגמה |
|---|---|---|---|
product_data_timestamp |
TIMESTAMP |
חותמת הזמן של נתוני המוצרים. | 2023-09-14 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 |
מצב הפריט [condition] שצוין על ידי המוכר. | חדש, משומש, מחודש |
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. | יוניסקס, גברים, נשים |
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 |
גרסה קריאה לבני אדם של הנתיב המלא. אם לא מספקים את הנתון, השדה נשאר ריק. | פריטי לבוש ואביזרים > ביגוד > שמלות |
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 שבהם המבצע מאושר. | US, CH |
destinations.pending_countries |
STRING, REPEATED |
רשימה של קודי טריטוריה של מאגר ה-CLDR שבהם המבצע נמצא בהמתנה. | US, CH |
destinations.disapproved_countries |
STRING, REPEATED |
רשימה של קודי טריטוריות של CLDR שבהן המבצע נדחה. | US, CH |
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