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