סכימת טבלת המוצרים של 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