אתם יכולים לשתף עם Merchant Center קובץ שמכיל את כל נתוני המוצרים בחנויות המקומיות שלכם. בהתאם להגדרה שתבחרו, המערכת תוכל לסנכרן אוטומטית את נתוני המוצרים ב-Merchant Center עם קובץ נתוני המוצרים. אם אתם כבר מספקים קובץ עם כל נתוני המוצרים, אתם יכולים להשתמש באותו קובץ בשביל ליצור מודעות מלאי של חנויות מקומיות וכרטיסים חינמיים למוצרים מקומיים.
הנושאים במאמר
- מקור נתוני המוצרים
- שליחת מקור נתוני מוצרים
- סיכום הדרישות שנוגעות למאפיינים
- מאפייני זיהוי שחובה להוסיף
- מאפייני חובה של סיווג יעילות אנרגטית (באיחוד האירופי בלבד)
- מאפייני החרגה מומלצים
- פורמט
- התאמת מאפיינים במקרה ששולחים את נתוני המוצרים בחנויות המקומיות באמצעות מקור נתונים מדור קודם (אופציונלי)
- פריטי לבוש
- מאפייני תמחור (אופציונלי)
- מאפיינים של איסוף מהחנות (אופציונלי)
- מאפיינים של דפי מוצר עם נתוני מחיר וזמינות במלאי בחנות ספציפית (אופציונלי)
- מאפיינים נוספים (אופציונלי)
מקור נתוני המוצרים
כדי להשתמש במקור קיים של נתוני מוצרים שעדיין לא מוגדר כמקור ליצירת מודעות מלאי של חנויות מקומיות או כרטיסים חינמיים למוצרים מקומיים, אתם צריכים להפעיל את התוסף הרלוונטי ולהגדיר שמקור נתוני המוצרים ישמש להצגת מוצרים לקונים מקומיים. כדי לעשות את זה:
- נכנסים לחשבון Merchant Center.
- לוחצים על סמל ההגדרות והכלים
ואז לוחצים על מקורות נתונים.
- בוחרים את מקור הנתונים שרוצים לשנות.
- לוחצים על ההגדרה הרצויה ומשנים אותה מ'שימוש בנתוני מוצרים ממקור הנתונים הזה' ל'שימוש בנתוני המוצרים לחנויות מקומיות ולחנויות וירטואליות'.
ההמלצה של Google היא לשלוח את כל המוצרים בקובץ נתונים יחיד לשני היעדים: מודעות מלאי של חנויות מקומיות וכרטיסים חינמיים למוצרים מקומיים. אם אתם יוצרים מקור נתונים חדש, אתם יכולים לבחור את כל היעדים הרלוונטיים של מקור הנתונים במהלך היצירה של מקור הנתונים. אם אתם רוצים להוסיף מודעות מלאי של חנויות מקומיות ו/או כרטיסים חינמיים למוצרים מקומיים כיעדים במקור נתונים קיים, אתם יכולים לעשות את זה דרך ההגדרות של מקור הנתונים הראשי. כדי להחריג מוצרים ממודעות שופינג או ממודעות מלאי של חנויות מקומיות וכרטיסים חינמיים למוצרים מקומיים, אתם יכולים להשתמש במאפיין היעד המוחרג [excluded_destination]. מידע נוסף על מאפיין היעד המוחרג
שליחת מקור נתוני מוצרים
סוג קובץ: אתם יכולים להשתמש בקובץ טקסט עם תווי הפרדה (מומלץ), ב-XML או ב-API.
רישום מקור נתונים חדש: כדי לרשום מקור נתונים חדש פועלים לפי השלבים הרגילים.
המוצרים יופיעו תוך יומיים לכל היותר מרגע השליחה.
חשוב: לחלק מהמאפיינים במפרט נתוני המוצרים הזה יש רווחים וקווים תחתונים. כדי לוודא שאתם מזינים את המאפיינים עם התווים ועם הרווחים הנכונים, מומלץ לפעול לפי ההוראות הבאות בהתאם לסוג הקובץ שבו אתם משתמשים:
- במקורות נתונים מסוג קובץ מופרד בטאבים: חובה להשתמש ברווחים. אם במאפיין יש קווים תחתונים, צריך להזין רווח במקום קו תחתון ('_').
- במקורות נתונים מסוג קובץ XML או ב-API בפורמט XML: חובה להשתמש בקווים תחתונים, והמערכת תמיר אותם לרווחים.
- API בפורמט JSON: חובה להשתמש בקווים תחתונים, והמערכת תמיר אותם לרווחים.
סיכום הדרישות שנוגעות למאפיינים
| מאפיין | דרישות בנוגע לשליחה |
שם הפריט [title] |
חובה לשלוח את המאפיינים האלה לגבי כל המוצרים הנמכרים בחנויות. |
מספר GTIN [gtin] |
חובה לגבי כל המוצרים החדשים שיש להם GTIN שהוקצה על ידי היצרן. אופציונלי (מומלץ מאוד) לגבי כל המוצרים האחרים. |
מותג [brand] |
חובה לכל המוצרים החדשים (למעט מותגים של סרטים, ספרים והקלטות מוזיקה). אופציונלי לגבי כל שאר המוצרים. |
מצב [condition] |
חובה אם המוצר משומש או מחודש. אופציונלי למוצרים חדשים. |
|
סיווג יעילות אנרגטית סיווג יעילות אנרגטית מינימלי [max_energy_efficiency_class] |
חובה אם המוצרים שלכם מטורגטים למדינות באיחוד האירופי, בריטניה או שווייץ. אופציונלי אם המוצרים שלכם לא מטורגטים לאף אחת מהמדינות באיחוד האירופי, בריטניה או שווייץ. |
יעד מוחרג [excluded_destination] |
מומלץ אם אתם משתמשים במקור יחיד של נתוני מוצרים כדי לשלוח נתונים גם למוצרים באינטרנט וגם למוצרים בחנויות מקומיות. מומלץ להשתמש במאפיין הזה כדי להחריג מוצרים שלא נמכרים בחנויות, כך שלא יופיעו במודעות מלאי של חנויות מקומיות ובכרטיסים חינמיים למוצרים מקומיים. |
|
קוד MPN [MPN] |
אופציונלי אם אתם שולחים נתוני מוצרים בחנויות מקומיות באמצעות מקור נתונים מדור קודם, אתם יכולים להשתמש במאפיינים האלה כדי שהמוצרים שאתם מוכרים באינטרנט ובחנויות יהיו זהים במקור נתוני המוצרים הראשי ובמקור נתוני המוצרים בחנויות המקומיות. יש 2 דרכים לעשות את זה:
[condition]. |
|
תאריכי התוקף של מחיר המבצע מידת תמחור יחידה [unit_pricing_base_measure] |
מומלץ לשלוח במקור הנתונים הראשי את המחיר חובה לשלוח במקור הנתונים הראשי את המחיר [unit_pricing_measure] ומידת בסיס לתמחור יחידה [unit_pricing_base_measure] אם התקנות או החוקים המקומיים מחייבים זאת. |
|
אם אתם רוצים לאפשר ללקוחות לרכוש מוצרים באינטרנט ולאסוף אותם בחנות, אתם צריכים לשלוח את 2 המאפיינים האלה.
חשוב: החל מ-1 בספטמבר 2024, כבר לא חובה להשתמש במאפיין שיטת האיסוף
[pickup_method] כדי לציין שמוצרים זמינים לאיסוף מהחנות.בקישורים הבאים תוכלו לקרוא מידע נוסף על התכונות איסוף היום, 'איסוף במועד מאוחר יותר' לנתוני מלאי בחנות ו'איסוף במועד מאוחר יותר' עם נתוני מוצר. |
|
|
תבנית קישור לנייד [ads_redirect] |
אופציונלי אם רוצים להציג מוצרים בדף החנות באתר של המוכר. חובה לציין את מאפיין הקישור חובה לציין את מאפיין הקישור לדף של חנות מקומית באתר של המוכר מאפיין קישור המובייל לדף של חנות מקומית באתר של המוכר |
הערה חשובה (XML בלבד): אם מקור הנתונים שלכם ב-Merchant Center הוא בפורמט XML ואתם מעדכנים בו אחד מהמאפיינים שמפורטים למטה, אתם צריכים להוסיף את הצהרת מרחב השמות של Google Merchant Center. אחרת, יכול להיות שיהיו בעיות בעיבוד של מקור הנתונים.
מאפייני זיהוי שחובה להוסיף
המאפיינים האלה מספקים לנו מידע בסיסי על המוצרים שלכם והם נדרשים לכל הפריטים.
מזהה [id] – המזהה של הפריט
המזהה של כל פריט הוא ייחודי לו בכל החנויות ואי אפשר לעשות בו שימוש חוזר בין מקורות נתונים מאותו סוג שמיועדים לאותה מדינה וכתובים באותה שפה.
מתי משתמשים במאפיין הזה: חובה לכל הפריטים במקורות הנתונים.
| סוג | מחרוזת |
| דוגמה בפורמט טקסט/מופרד בטאבים | 421486 |
| דוגמה בפורמט XML | <g:id>421486</g:id> |
שימו לב:
- רווחים בהתחלה ובסוף ותווי חזרה לתחילת השורה (0x0D) יוסרו.
- כל רצף של תווי חזרה לתחילת השורה (0x0D) ורווחים (תווי Unicode עם מאפיין הרווח) מוחלף ברווח בודד (0x20).
- ניתן להזין רק תווי Unicode חוקיים, למעט התווים הבאים:
- תווי בקרה (למעט תו חזרה לתחילת השורה 0x0D)
- תווי פונקציות
- תווי Private Area
- זוגות ממלאי מקום (Surrogate pairs)
- מיקומי תווים (code point) שלא הוקצו (בפרט כל מיקום תו שגדול מ-0x10FFFF)
- אחרי ששולחים פריט כלשהו, אסור לשנות את מאפיין המזהה כשמעדכנים את מקור הנתונים, ואסור להשתמש בו למוצר אחר בעתיד.
- אם אתם משתמשים במאפיין המזהה בקמפיינים של שופינג, מומלץ להשתמש באותיות קטנות או בתווים שהם לא תלויי רישיות.
שם הפריט [title] – השם של הפריט
שם הפריט. Google ממליצה לכלול בשם הפריט מאפיינים כגון צבע או מותג שמבדילים את הפריט ממוצרים אחרים. במקרים שבהם המערכת תזהה התאמה, Google עשויה להציג את הפריט כפי שהוא מופיע בחנות באינטרנט או את הנתונים מהקטלוג של Google.
מתי משתמשים במאפיין הזה: חובה לכל הפריטים במקורות הנתונים.
| סוג | טקסט (מחרוזת), פחות מ-70 תווים |
| דוגמה בפורמט טקסט/מופרד בטאבים | Netgear ReadyNAS Duo |
| דוגמה בפורמט XML | <g:title>Netgear ReadyNAS Duo</g:title> |
שימו לב:
- עליכם להקפיד מאוד על הנחיות העריכה. לדוגמה, אסור לכלול טקסט של קידום מכירות, כמו "משלוח חינם", ואסור לאיית מילים שלמות באותיות רישיות (BLOCK CAPITALS).
- במשפחות מוצרים, צריך לכלול את שם הפריט המשותף לכל הווריאציות במשפחה. לדוגמה, אם המוצר "חולצת פולו לגברים" זמין באדום ובכחול, אפשר לציין אחד משמות הפריטים הבאים:
- חולצת פולו לגברים (בשביל שתי הווריאציות)
- חולצת פולו מבד פיקה לגברים – אדום (בשביל החולצה האדומה)
- חולצת פולו מבד פיקה לגברים – כחול (בשביל החולצה הכחולה)
תיאור [description] – תיאור של הפריט
התיאור צריך לכלול רק מידע שרלוונטי למוצר. עליו לתאר את המאפיינים הרלוונטיים ביותר של הפריט, כמו מידה, חומר, טווח גילאי יעד, תכונות מיוחדות או מפרטים טכניים אחרים. מומלץ לכלול מידע גם על המאפיינים החזותיים של המוצר (כמו צורה, הדפס, מרקם ועיצוב), כי הטקסט הזה עשוי לשמש אותנו כדי למצוא את הפריט.
אנחנו ממליצים שהתיאור יהיה באורך 500 עד 1,000 תווים, אבל לא יותר מ-5,000 תווים. צריך לכתוב את התיאורים לפי כללי הדקדוק הרגילים ולהציב בסופם סימן פיסוק מתאים.
מתי משתמשים במאפיין הזה: חובה לכל הפריטים במקורות הנתונים.
Content API v2 (JSON): "description": "מצעים בצבע אדום חלק למיטה זוגית גדולה (קווין סייז), מבד בעל צפיפות חוטים בדרגה 300 שעשוי מ-100% פוליאסטר ארוג. הסט כולל סדין גומי, סדין רגיל ושתי ציפיות בגודל סטנדרטי. אפשר לכבס במכונה. תוספת בד למזרנים גבוהים."
Content API v2 (XML): <description>מצעים בצבע אדום חלק למיטה זוגית גדולה (קווין סייז), מבד בעל צפיפות חוטים בדרגה 300 שעשוי מ-100% פוליאסטר ארוג. הסט כולל סדין גומי, סדין רגיל ושתי ציפיות בגודל סטנדרטי. אפשר לכבס במכונה. תוספת בד למזרנים גבוהים.</description>
| סוג | טקסט |
| מגבלת תווים | 5,000 |
| טקסט (TSV) | מצעים בצבע אדום חלק למיטה זוגית גדולה (קווין סייז), מבד בעל צפיפות חוטים בדרגה 300 העשוי מ-100% פוליאסטר ארוג. הסט כולל סדין גומי, סדין רגיל ושתי ציפיות בגודל סטנדרטי. אפשר לכבס במכונה. תוספת בד למזרנים גבוהים. |
| מקורות נתונים בפורמט XML | <description>מצעים בצבע אדום חלק למיטה זוגית גדולה (קווין סייז), מבד בעל צפיפות חוטים בדרגה 300 שעשוי מ-100% פוליאסטר ארוג. הסט כולל סדין גומי, סדין רגיל ושתי ציפיות בגודל סטנדרטי. אפשר לכבס במכונה. תוספת בד למזרנים גבוהים.</description> |
שימו לב:
- חשוב להקפיד על הנחיות העריכה של Google. לדוגמה: אסור לכלול טקסט של קידום מכירות, כגון "משלוח חינם", אסור לאיית מילים שלמות באותיות רישיות (למשל באנגלית), ואסור לכלול תיאור של המותג או של החברה.
- כמו כן, בתיאורים אסור לכלול מידע מהסוגים הבאים:
- קישורים לחנות שלכם או לאתרים אחרים
- פרטי חיוב, תשלום או מכירות
- הפניות לסיווגים פנימיים, למשל: "צעצועים ומשחקים > צעצועים > בובות תינוק".
- השוואות למוצרים אחרים, למשל: "טוב/מהיר/גדול יותר מ-X"
- פרטים על מוצרים, אביזרים או פריטים דומים אחרים שאתם מציעים.
קישור לתמונה [image_link] – כתובת ה-URL של תמונת הפריט
זוהי כתובת ה-URL של התמונה הראשית של המוצר. זו התמונה הראשונה שהלקוחות רואים בדפים של פרטי המוצר.
אם יש לכם כמה תמונות שונות של המוצר, עליכם לשלוח את התמונה הראשית באמצעות מאפיין הקישור לתמונה, ואת יתר התמונות באמצעות מאפיין הקישור לתמונה נוספת [additional_image_link].
גודל תמונה:
- כדאי לבחור את התמונה הגדולה ביותר ובעלת הרזולוציה הגבוהה ביותר שיש לכם עבור המוצר. התמונה צריכה להציג את המוצר בגודל מלא, וגודל הקובץ של התמונה לא יעלה על 16MB.
- גודל התמונה המומלץ הוא לפחות 800 x 800 פיקסלים.
- תמונות של פריטי לבוש צריכות להיות בגודל של 250 x 250 פיקסלים לפחות, ולא יותר מ-64 מגה-פיקסל. תמונות של יתר המוצרים צריכות להיות בגודל של 100 x 100 פיקסלים לפחות, ולא יותר מ-64 מגה-פיקסל.
- אל תשלחו תמונות מוגדלות או ממוזערות. מומלץ שהמוצר ימלא 75-90% מהתמונה כולה.
מתי משתמשים במאפיין הזה: חובה לכל הפריטים במקורות הנתונים.
Content API v2 (JSON): "imageLink": "http://www.example.com/image1.jpg"
Content API v2 (XML): <image_link>http://www.example.com/image1.jpg</image_link>
| סוג | כתובת URL (חייבת להתחיל ב-'http://' או ב-'https://') |
| מגבלת תווים | 2,000 |
| טקסט (TSV) | http://www.example.com/image1.jpg |
| מקורות נתונים בפורמט XML |
|
עמידה בדרישות ויישום ההמלצות הבאות יעזרו לכם לשפר את חוויית השופינג של הלקוחות.
דרישות:
- אסור לשלוח פריט ללא תמונה.
- כמו כן, אסור להשתמש בסוגי התמונות הבאים:
- תמונות שנועדו למלא את המקום או תמונות שלא מוצג בהן המוצר הנכון
- תמונות, גרפיקה או איורים גנריים שאינם תמונות של המוצר עצמו, למעט מוצרים בקטגוריות 'Hardware [חומרי בניין]' (632) או 'Vehicles and parts [כלי רכב וחלקי חילוף]' (888), המציגים גרפיקה ו/או איורים של המוצר עצמו
- תמונות בצבע אחד שהן למעשה ריבוע צבע, למעט מוצרים בקטגוריות 'Vehicle Paint [צבע לרכב]' (3812), Craft Paint, Ink & Glaze ['צבע, דיו וזיגוג אומנותיים]' (505378) ו-'Painting Consumables' [חומרי צביעה מתכלים]' (503740)
- תמונות המכילות אלמנטים של קידום מכירות (למשל, קריאות לפעולה, כמו 'קנו'); פרטים הקשורים לשירות (למשל 'אחריות מורחבת', 'משלוח חינם', מידע על מחירים); תיאורים שנועדו לקידום מכירות (למשל, 'הטוב ביותר', 'זול'); פרטים על מצב או על יכולת התאמה (למשל 'חדש', '2 חלקים', 'ניתן להתאמה'); או שמות ו/או סמלי לוגו של מוכרים, גם אם הם מוצגים כשכבה מעל המוצר. ההנחיות האלה חלות גם על סימני מים עם אלמנטים של קידום מכירות וכן שמות ו/או סמלי לוגו של מוכרים
- תמונות המכילות תוכן שמסתיר חלק מהתמונה (למשל סימני מים, שמות של מותגים ו/או של סמלי לוגו) שמוצגים כשכבה מעל המוצר הנמכר.
- תמונות עם מסגרות
- תמונות של חבילה שאינן מציגות את כל החבילה
- תמונות של מארזים שאינן מציגות יחידה בודדת של המוצר
- דפי נחיתה ללא תמונות של המוצר, או עם תמונות שנועדו רק למלא את המקום ולא רואים בהן את המוצר עצמו
-
חשוב לוודא שהתמונה של כל פריט מתאימה לערכים שציינתם במאפייני הצבע
[color], דוגמת העיצוב[pattern]והחומר[material]. אחרת ייתכן שנפסול את הפריט.
המלצות:
- אם אין לכם אפשרות לצרף את התמונות המתאימות כדי לשלוח את הפריטים כווריאציות, תוכלו לציין את משפחת המוצרים כפריט בודד בעל ערכים מרובים במאפייני הווריאציה ולצרף את התמונה שיש לכם.
- התמונה צריכה להציג את המוצר באופן מדויק. אסור לשלוח תמונה שמציגה את המוצר באופן מינימלי, או לא מציגה אותו כלל.
- בווריאציות המבוססות על צבע, לכל פריט וריאציה ששולחים צריך לצרף תמונה שמציגה את המוצר בצבע אחד.
- התמונה הראשית צריכה להיות בעלת רקע בצבע לבן, אפור או בצבעים בהירים.
-
בתמונה הראשית צריכים לראות את המוצר בצורה ברורה או בזווית המרכזית. אפשר לשלוח תמונות נוספות של המוצר מזוויות אחרות (חוץ מהזווית המרכזית) באמצעות מאפיין הקישור לתמונה נוספת
[additional_image_link].
פורמט:
- הפורמטים המותרים לתמונות הם: GIF ללא אנימציה (.gif), JPEG (.jpg/.jpeg), PNG (.png), BMP (.bmp) ו-TIFF (.tif/.tiff), וסיומת הקובץ של כל תמונה צריכה להתאים לפורמט התמונה.
- הפרוטוקולים המותרים לכתובות URL הם "http" ו-"https". אם כתובת ה-URL של התמונה מכילה סמלים, צריך להחליף אותם בישויות מקודדות שמתאימות לכתובות URL (לדוגמה, פסיק = %2C).
- Google ממליצה לשלוח תמונות עם כתובות URL יציבות ולעדכן את כתובת ה-URL רק אם תמונת המוצר השתנתה. זו המלצה חשובה מאוד למי שמשתמש ברשת להעברת תוכן כדי לארח תמונות, כי היא מאפשרת ל-Google לסרוק את התמונות בצורה תקינה.
חיתוך:
יכול להיות שנחתוך את התמונה באופן אוטומטי כדי להתמקד יותר במוצר.
מצב [condition] – מצב הפריט
Google מתירה לקדם מוצרים איכותיים מיד שנייה. מותר לקדם ב-Google גם מוצרים מחודשים, בתנאי שהם עומדים בדרישות של התקנות והחוקים המקומיים ובדרישות המדיניות שלנו.
יש רק 3 ערכים שאפשר להשתמש בהם:
- חדש
[new]: המוצר חדש ומעולם לא נעשה בו שימוש. המוצר ארוז באריזתו המקורית שלא נפתחה. - מחודש
[refurbished]: המוצר שוחזר באופן מקצועי והוא במצב תקין. זהו מוצר 'כמו חדש' והלקוח מקבל עליו אחריות. הוא ארוז באריזה מקורית או אחרת. הערך הזה נקרא לפעמים "remanufactured" (מיוצר מחדש). - משומש
[used]: משתמשים בערך הזה במקרים שבהם אי אפשר לתאר את המוצר כ'חדש' או כ'מחודש'. לדוגמה: אם השתמשו פעם במוצר, אם המוצר הוא מחסנית דיו של מדפסת שמילאו מחדש או אם האריזה המקורית נפתחה או לא קיימת.
מתי משתמשים במאפיין הזה: חובה אם המוצר משומש או מחודש. אופציונלי במוצרים חדשים.
Content API v2 (JSON): "condition": "used"
Content API v2 (XML): <condition>used</condition>
| סוג |
יש רק 3 ערכים קבילים:
|
| טקסט (TSV) | used |
| XML | <g:condition>used</g:condition> |
חשוב: אם אתם שולחים שמות של מאפיינים באנגלית, אתם צריכים לציין גם את ערכי המאפיינים באנגלית.
מספר GTIN [gtin] – מספר פריט מסחרי גלובלי (GTIN) של הפריט
משתמשים במאפיין של מספר פריט מסחרי גלובלי (GTIN) כדי לשלוח מספרי GTIN באחד מהפורמטים הבאים:
- קוד מוצר אוניברסלי, UPC (בצפון אמריקה / GTIN-12): מספר באורך 12 ספרות. צריך להמיר קודי UPC-E באורך 8 ספרות לקודים באורך 12 ספרות.
- EAN (באירופה / GTIN-13): מספר באורך 13 ספרות.
- JAN (ביפן / GTIN-13): מספר באורך 8 או 13 ספרות.
- ISBN (לספרים): מספר באורך 10 או 13 ספרות. אם יש לכם את שניהם, ציינו רק את המספר שבאורך 13 ספרות. מספרים בפורמט ISBN-10 כבר הוצאו משימוש, וצריך להמיר אותם לפורמט ISBN-13.
- ITF-14 (למארזים / GTIN-14): מספר באורך 14 ספרות.
| מתי לכלול את המאפיין | חובה לגבי כל המוצרים החדשים שיש להם מספר פריט מסחרי גלובלי (GTIN) שהוקצה על ידי היצרן |
| סוג | מספר באורך 8, 12, 13 או 14 ספרות (UPC, EAN, JAN או ISBN) |
| מגבלת תווים | 50 |
| קובץ טקסט / קובץ מופרד בטאבים | 3234567890126 |
| מקורות נתונים בפורמט XML | <g:gtin>3234567890126</g:gtin> |
חשוב:
- אנחנו מקבלים רק מספרי GTIN חוקיים, לפי המוגדר במדריך האימות הרשמי של GS1, הכולל את הדרישות האלה:
- יש ספרת ביקורת והיא נכונה.
- ה-GTIN לא מוגבל (בטווחי הקידומות הבאים של GS1: 02, 04, 2).
- ה-GTIN הוא לא קוד שובר (בטווחי הקידומות הבאים של GS1: 98 עד 99).
מותג [brand] – המותג של הפריט
מתי משתמשים במאפיין הזה: חובה לכל מוצר חדש (למעט סרטים, ספרים ומותגים של הקלטות מוזיקה). אופציונלי לגבי כל שאר המוצרים.
Content API v2 (JSON): "brand": "Acme"
Content API v2 (XML): <brand>Acme</brand>
| סוג | טקסט |
| מגבלת תווים | 70 |
| טקסט (TSV) | Acme |
| מקורות נתונים בפורמט XML | <g:brand>Acme</g:brand> |
חשוב: אסור לציין את שם החנות בתור המותג, אלא אם אתם מייצרים את המוצר בעצמכם.
המאפיינים סיווג יעילות אנרגטית [energy_efficiency_class], סיווג יעילות אנרגטית מינימלי [min_energy_efficiency_class] וסיווג יעילות אנרגטית מקסימלי [max_energy_efficiency_class] הם אופציונליים, אבל יכול להיות שתידרשו לספק את המידע הזה בשל תקנות או חוקים מקומיים. לדוגמה, אם אתם מטרגטים את המוצרים שלכם למדינות באיחוד האירופי, לבריטניה או לשווייץ, קחו בחשבון את הדרישות המשפטיות בנושא, שמוגדרות בחוקי היישום הלאומיים בדירקטיבה 2017/1369 של האיחוד האירופי ובחוקים מקומיים רלוונטיים אחרים.
סיווג יעילות אנרגטית [energy_efficiency_class], סיווג יעילות אנרגטית מינימלי [min_energy_efficiency_class], סיווג יעילות אנרגטית מקסימלי [max_energy_efficiency_class]
במאפיין הזה אפשר לציין את הערכים הנדרשים של סיווג היעילות האנרגטית של המוצר.
מתי משתמשים במאפיין הזה: במוצרים שבהם זה רלוונטי, מומלץ מאוד לשלוח את המאפיינים של סיווג יעילות אנרגטית, סיווג יעילות אנרגטית מינימלי וסיווג יעילות אנרגטית מקסימלי. יכול להיות שתצטרכו לספק את הסיווג הזה לגבי סוגי המוצרים הבאים:
| מקררים | תנורים |
| מקפיאים | מחממי מים |
| מכונות כביסה | מכלים לאחסון מים חמים |
| מייבשי כביסה | מזגנים |
| מכונת כביסה משולבת מייבש | מנורות חשמל |
| מקררי יין | גופי תאורה |
| מדיחי כלים | טלוויזיות |
| סוג |
ערכים מותרים:
|
| טקסט (TSV) | A+ |
| דוגמה בפורמט XML | <g:energy_efficiency_class>+A</g:energy_efficiency_class> |
שימו לב:
- הערך של סיווג היעילות האנרגטית המינימלי
[min_energy_efficiency_class]חייב להיות קטן מהערך של סיווג היעילות האנרגטית המקסימלי[max_energy_efficiency_class]. לדוגמה, סולם הערכים צריך להיות מסודר מ-A עד D, ולא מ-D עד A. - הערך של סיווג היעילות האנרגטית
[energy_efficiency_class]צריך להיות בטווח הערכים שבין סיווג היעילות האנרגטית המינימלי לבין סיווג היעילות האנרגטית המקסימלי. לדוגמה, אם הטווח הוא מ-A עד D, הערך של סיווג היעילות האנרגטית לא יכול להיות G.
מאפייני החרגה מומלצים
אפשר להשתמש במאפיין היעד המוחרג [excluded_destination] כדי להחריג מוצרים שלא מתאימים ליעד מסוים. בעזרת המאפיין הזה תוכלו לשלוט במיקומים השונים שבהם התוכן שלכם יוכל להופיע. לדוגמה, אפשר להשתמש במאפיין הזה אם רוצים שמוצר מסוים יופיע בקמפיין שופינג אך לא במוצרים בחנויות מקומיות.
מתי משתמשים במאפיין הזה: מומלץ להשתמש במאפיין הזה אם אתם רוצים שמוצר מסוים לא יוצג בסוגים מסוימים של מודעות וכרטיסי מוצר.
ערכים נתמכים:
- מודעות שופינג
[Shopping_ads]. המוצר לא יוצג במודעות שופינג. למידע על מודעות שופינג - מודעות לרשת המדיה
[Display_ads]. המוצר לא יוצג במודעות דינמיות לרימרקטינג. למידע על רימרקטינג דינמי לקמעונאות - מודעות מלאי של חנויות מקומיות
[Local_inventory_ads]. המוצר לא יוצג במודעות מלאי של חנויות מקומיות. למידע נוסף על מודעות מלאי של חנויות מקומיות - כרטיסי מוצר חינמיים
[Free_listings]. המוצר לא יוצג בכרטיסי מוצר חינמיים. למידע נוסף על הצגת מוצרים בחינם ב-Google - כרטיסים חינמיים למוצרים מקומיים
[Free_local_listings]. מוצרים בחנויות מקומיות לא יוצגו בחינם ב-Google. למידע נוסף על פרסום מוצרים בחנויות מקומיות בחינם ב-Google
Shopping Actions, Surfaces across Google, Local surfaces across Google. הערכים האלה עדיין יתקבלו, אבל מומלץ לעדכן את המוצרים כך שיכללו את הערכים החדשים של היעדים הבאים: Free_listings, Free_local_listings.פורמט
חשוב לפעול בהתאם להנחיות הפורמט הבאות כדי להבטיח שנבין את הנתונים שאתם שולחים.
| ערכים נתמכים | Shopping_ads, Display_ads, Local_inventory_ads, Free_listings, Free_local_listings |
| שדה חוזר | כן |
| פורמט קובץ | ערך לדוגמה |
| מקורות נתונים בפורמט טקסט | Display_ads |
| מקורות נתונים בפורמט XML | <g:excluded_destination>Display_ads</g:excluded_destination> |
שדות חוזרים
טקסט
כדי להגדיר מספר יעדים שאתם רוצים להחריג, מומלץ לשלוח את המאפיין מספר פעמים, פעם אחת לגבי כל יעד. למשל:
| נתוני מוצר למיטה אורתופדית לכלבים | |
| מאפיין | ערך |
שם הפריט [title] |
מיטה אורתופדית XXL לכלבים |
יעד מוחרג [excluded_destination] |
Display_ads |
יעד מוחרג [excluded_destination] |
Shopping_ads |
אפשר גם להפריד בין היעדים בעזרת פסיק ( , ):
Display_ads, Display_ads
XML
כדי להגדיר כמה יעדים להחרגה במקור נתונים מסוג XML, צריך להוסיף מאפיין נפרד לכל יעד מוחרג:
<g:excluded_destination>Display_ads</g:excluded_destination>
<g:excluded_destination>Shopping_ads</g:excluded_destination>
מידע נוסף על הפורמט של נתונים ב-API זמין ב-Content API for Shopping
התאמת מאפיינים במקרה ששולחים את נתוני המוצרים בחנויות המקומיות באמצעות מקור נתונים מדור קודם (אופציונלי)
מזהה תואם [webitemid] – התאמה בין מזהה בחנות באינטרנט לבין מזהה בחנות מקומית
אם אין אפשרות להתאים בין מאפיין המזהה [id] במקור הנתונים של המוצרים בחנויות המקומיות לבין מאפיין המזהה במקור נתוני המוצרים הראשי, אתם יכולים לבצע את ההתאמה באמצעות מאפיין המזהה התואם. במצב כזה, שולחים ערכים שונים במאפיין המזהה, אבל את אותו ערך במזהה התואם ובמזהה הרגיל. הערך הזה צריך תמיד להיות תואם למזהה של הווריאציה המקבילה במקור נתוני המוצרים, אם יש כזו.
מכיוון שהמזהה התואם משמש להתאמה בלבד, יכול להיות שלכמה פריטים יהיה אותו מזהה תואם אם הם ממופים לאותו פריט במקור נתוני המוצרים.
מתי משתמשים במאפיין הזה: מומלץ לכל הפריטים שיש להם מזהים/מק"טים שונים למוצרים בחנות באינטרנט לעומת המוצרים בחנות המקומית.
| סוג | טקסט (מחרוזת) |
| טקסט (TSV) | WB1011 |
| דוגמה בפורמט XML | <g:webitemid>WB1011</g:webitemid> |
שימו לב:
- רווחים בהתחלה ובסוף ותווי חזרה לתחילת השורה (0x0D) יוסרו.
- כל רצף של תווי חזרה לתחילת השורה (0x0D) ורווחים (תווי Unicode עם מאפיין הרווח) מוחלף ברווח בודד (0x20).
- ניתן להזין רק תווי Unicode חוקיים, למעט התווים הבאים:
- תווי בקרה (למעט תו חזרה לתחילת השורה 0x0D)
- תווי פונקציות
- תווי Private Area
- זוגות ממלאי מקום (Surrogate pairs)
- מיקומי תווים (code point) שלא הוקצו (בפרט כל מיקום תו שגדול מ-0x10FFFF)
- אחרי ששלחתם פריט כלשהו, אסור לשנות את מאפיין המזהה התואם [webitemid] כשאתם מעדכנים את מקור הנתונים, או להשתמש בו בשביל מוצר אחר בעתיד.
מספר GTIN [gtin] – מספר פריט מסחרי גלובלי (GTIN) של הפריט
במאפיין הזה מציינים את מספרי ה-GTIN של המוצרים.
מתי משתמשים במאפיין הזה: אם אתם מוכרים מוצרים גם בחנות הפיזית וגם בחנות באינטרנט, ואין לכם אפשרות להשתמש במאפיין המזהה [id] לצורך התאמה, תצטרכו להשתמש במאפיין המזהה התואם [webitemid] או במזהי מוצר ייחודיים (UPI) כמאפייני התאמה.
אם אתם משתמשים במזהי מוצר ייחודיים כלשהם לצורך התאמה, תצטרכו לכלול מאפיין מצב במקור הנתונים הזה.
| סוג | טקסט (מחרוזת) |
| טקסט (TSV) | 0606449056822 |
| דוגמה בפורמט XML | <g:gtin>0606449056822</g:gtin> |
קוד MPN [mpn] – מספר חלק של היצרן (MPN)
הקוד הזה מזהה באופן ייחודי את המוצר עם היצרן שלו. השילוב הספציפי של מותג וקוד MPN מאפשר זיהוי ברור של מוצר אחד.
מתי משתמשים במאפיין הזה: אם אתם מוכרים מוצרים גם בחנות הפיזית וגם בחנות באינטרנט, ואין לכם אפשרות להשתמש במאפיין המזהה [id] לצורך התאמה, תצטרכו להשתמש במאפיין המזהה התואם [webitemid] או במזהי מוצר ייחודיים (UPI) כמאפייני התאמה.
אם אתם משתמשים במזהי מוצר ייחודיים כלשהם לצורך התאמה, תצטרכו לכלול מאפיין מצב במקור הנתונים הזה.
| סוג | טקסט (מחרוזת) |
| טקסט (TSV) | RND2150 |
| דוגמה בפורמט XML | <g:mpn>RND2150</g:mpn> |
מותג [brand] – המותג של הפריט
מתי משתמשים במאפיין הזה: אם אתם מוכרים מוצרים גם בחנות הפיזית וגם בחנות באינטרנט, ואין לכם אפשרות להשתמש במאפיין המזהה [id] לצורך התאמה, תצטרכו להשתמש במאפיין המזהה התואם [webitemid] או במזהי מוצר ייחודיים (UPI) כמאפייני התאמה.
אם אתם משתמשים במזהי מוצר ייחודיים כלשהם לצורך התאמה, תצטרכו לכלול מאפיין מצב במקור הנתונים הזה.
| סוג | טקסט (מחרוזת) |
| טקסט (TSV) | Netgear |
| דוגמה בפורמט XML | <g:brand>Netgear</g:brand> |
פריטי לבוש
כשמזינים פריטי לבוש במקור הנתונים הראשי, נדרשים כמה מאפיינים נוספים:
מזהה קבוצת פריטים [item_group_id] – מזהה משותף לכל הווריאציות של אותו מוצר
לכל הפריטים המשמשים כווריאציות של אותו מוצר צריך להיות ערך זהה במאפיין של מזהה קבוצת הפריטים. אם יש 'מק"ט הורה' אחד משותף לכל הווריאציות של המוצר, ניתן לציין אותו כערך המאפיין של מזהה קבוצת הפריטים.
מתי משתמשים במאפיין הזה: חובה במדינות ברזיל, צרפת, גרמניה, יפן, בריטניה וארה"ב, לכל הפריטים שיש להם וריאציות עם המאפיינים הבאים: צבע [color], מידה [size], דוגמת עיצוב [pattern], חומר [material], קבוצת גיל [age group], מגדר [gender], סוג המידה [size type] ושיטת המדידה [size_system]. מומלץ להשתמש במאפיין הזה גם לכל שאר המדינות.
Content API v2 (JSON): "itemGroupId": "AB12345"
Content API v2 (XML): <item_group_id>AB12345</item_group_id>
| סוג | קוד אלפאנומרי |
| מגבלת תווים | 50 |
| טקסט (TSV) | AB12345 |
| מקורות נתונים בפורמט XML | <g:item_group_id>AB12345</g:item_group_id> |
שימו לב:
- מאפיין מזהה קבוצת הפריטים
[item_group_id]הוא מאפיין שונה ממאפיין המזהה[id]. מאפיין מזהה קבוצת הפריטים מכיל ערכים משותפים לקבוצת וריאציות, ואילו מאפיין המזהה אמור להכיל ערך ייחודי לכל פריט שהוא וריאציה בקבוצת וריאציות, כמו גם לכל פריט אחר. - לכל מוצר צריך להיות ערך ייחודי במאפיין מזהה קבוצת הפריטים, והערך הזה צריך להיות משותף רק לפריטים שהם וריאציות של אותו מוצר.
- אם תשלחו לנו מאפיין של מזהה קבוצת פריטים, נחפש באופן אוטומטי מאפייני וריאציות. אם לפריט יש מזהה קבוצת פריטים, חשוב לוודא שלפריט יש מאפיין מוצר מפורט אחד לפחות.
צבע [color] – צבע הפריט
המאפיין הזה מגדיר את הצבעים הדומיננטיים של הפריט. אם לפריט יש כמה צבעים, אפשר להוסיף עד שני ערכים נוספים בתור צבעים משניים:
- מסדרים את הצבעים לפי מידת הדומיננטיות שלהם, כשהם מופרדים בקו נטוי (/). מזינים קודם את הצבע הדומיננטי ואחריו עד 2 צבעים משניים. למשל: בשביל נעל שחורה עם עיטורים ירוקים, ערך הצבע צריך להיות 'שחור/ירוק'. לגבי מוצרים ששייכים לקטגוריה של פריטי לבוש אך מיוצרים מחומרים קשיחים, למשל אביזרים מעץ או תכשיטים, צריך לציין את החומר או את הגימור במקום את הצבע. ניתן לשלוח את השם של הגימור או החומר במאפיין הצבע
[color](למשל: 'מהגוני', 'פלדה' או 'זהב ורוד'). - אם אתם משתמשים ב-XML, אתם צריכים להזין את הקו הנטוי (/) באמצעות התג "#47;"
מתי משתמשים במאפיין הזה: חובה בכל המוצרים בקבוצת פריטים שנבדלים זה מזה בצבע, ובכל פריטי הלבוש במקורות נתונים שמטרגטים את ברזיל, צרפת, גרמניה, יפן, בריטניה וארה"ב. מומלץ בכל המוצרים שבהם הצבע הוא מאפיין חשוב שמבדיל אותם מאחרים.
Content API v2 (JSON): "color": "שחור"
Content API v2 (XML): <color>שחור</color>
| סוג | טקסט |
| מגבלת תווים | 100 |
| טקסט (TSV) | שחור |
| מקורות נתונים בפורמט XML | <g:color>שחור</g:color> |
מה לא לכלול:
- ערכי צבעים שמכילים מספרים (למשל '0 2 4 6 8').
- ערכי צבעים שמכילים תווים שאינם אלפאנומריים (לדוגמה: '
#fff000'). - ערכי צבעים המסומנים באות אחת (למשל, 'G') בשפות עם אותיות לטיניות. מותר לציין ערכי צבעים המסומנים באות אחת בשפות סינית, יפנית וקוריאנית (למשל: '红').
- ערכי צבעים שמפנים את המשתמשים למוצר או לתמונת המוצר (למשל: 'הצגת התמונה').
- ערכים תיאוריים שאינם שמות מוגדרים של צבעים (למשל: צבעוני, מגוון, ססגוני, הצגת התמונה, לא זמין).
- ערכי צבעים ארוכים יותר מ-40 תווים.
- ערכי צבעים ארוכים שמקבצים יחד כמה צבעים (למשל:
אדוםורודכחול). במקום זאת:- אם אתם רוצים לציין כמה צבעים לפריט אחד (ולא לווריאציות של מוצר), אתם צריכים לציין צבע ראשי ולהוסיף אחריו עד 2 צבעים משניים אופציונליים, מופרדים בקו נטוי (/). לדוגמה, במקום
אדוםורודכחולהזינואדום/ורוד/כחול. - אם אתם רוצים לציין כמה צבעים לכמה פריטים דומים (וריאציות של מוצר), עליכם לשלוח אותם כמוצרים נפרדים ולהגדיר לכולם את אותו מזהה קבוצת פריטים, אך לתת לכל אחד מהם ערך צבע שונה.
- אם אתם רוצים לציין כמה צבעים לפריט אחד (ולא לווריאציות של מוצר), אתם צריכים לציין צבע ראשי ולהוסיף אחריו עד 2 צבעים משניים אופציונליים, מופרדים בקו נטוי (/). לדוגמה, במקום
הערה חשובה לגבי הזנת ערכים לא תקינים:
- אם תזינו ערך צבע באופן שנוגד את כללי התחביר שלמעלה, יכול להיות ש-Google תדחה את הפריט כולו בשלב השליחה של מקור הנתונים.
- Google עורכת בדיקות קבועות כדי לוודא את שאתם שולחים מאפיינים נכונים, כולל צבעים. אם נגיע למסקנה שהערכים שסיפקתם שגויים, יכול להיות שנסיר את כל הפריטים שלכם מכרטיסיית שופינג.
שימו לב:
- במקרה של וריאציות, צריך לשלוח כל צבע או שילוב צבעים כפריט בפני עצמו, ביחד עם מאפיין מזהה קבוצת הפריטים.
- חשוב לתת שמות עקביים לצבעים בכל הווריאציות השונות של המוצר ולהקפיד על אותה עקביות גם כשיש כמה מוצרים מאותה קטגוריה.
- הערכים שאתם מזינים עשויים להופיע בפני לקוחות, ולכן חשוב להזין ערכים שהם יוכלו להבין בקלות.
מידה [size] – מידת הפריט
המאפיין הזה מציין את המידה של המוצר. בפריטים בקטגוריית 'לבוש ואביזרים', ניתן גם לציין את מאפייני סוג המידה [size_type] ושיטת המדידה [size_system] כדי לתת מידע מפורט יותר על המידות השונות.
- אפשר לשלוח מאפיין אחד בלבד לכל פריט. אם מציינים כמה מאפיינים של מידה עבור אותו פריט, ייעשה שימוש רק במאפיין הראשון. המערכת תתעלם ממאפייני המידה הנוספים ותציג אזהרה.
מתי משתמשים במאפיין הזה: חובה בכל המוצרים בקבוצת פריטים שנבדלים זה מזה במידה. חובה לכל פריטי הלבוש בקטגוריות המוצרים 'לבוש ואביזרים > הלבשה' ו'לבוש ואביזרים > נעליים' בנתוני מוצרים שמטרגטים לברזיל, צרפת, גרמניה, יפן, בריטניה וארה"ב. מומלץ בכל המוצרים שבהם המידה היא מאפיין חשוב שמבדיל אותם מאחרים.
Content API v2 (JSON): "size": ["XL"]
Content API v2 (XML): <size>XL</size>
| סוג |
אם אתם מטרגטים את ארה"ב, כדאי לעיין ברשימת הערכים המזוהים (ארה"ב בלבד) לגבי שאר המדינות, אפשר לעיין במידות לדוגמה. |
| מגבלת תווים | 100 |
| טקסט (TSV) | XL |
| מקורות נתונים בפורמט XML | <g:size>XL</g:size> |
שימו לב:
- בווריאציות, צריך לשלוח כל מידה או שילוב מידות כפריט נפרד, לצד המאפיין של מזהה קבוצת הפריטים. למידע נוסף על שליחת מוצרי לבוש
- אם המידות מורכבות מכמה מימדים, צריך לרכז אותם לערך אחד (למשל: "40/86 גבוה" להיקף צוואר של 40 ס"מ, אורך שרוול 86 ס"מ ומבנה "גבוה").
- חשוב להשתמש בערכי מידה עקביים בכל הווריאציות של המוצר, וגם כשיש כמה מוצרים שונים מאותה קטגוריה. למשל: בקבוצה של חולצות טישרט, צריך להשתמש במידות "S", "M" ו-"L", ולא במידות "S", "מדיום" ו-"Large".
- אם אין תמונות ספציפיות לכל מידה, אפשר להשתמש באותה תמונה לווריאציות במידות שונות, אבל מומלץ שמאפיין הקישור [link] יוביל לדף שבו מפורט כל המידע שקשור לאותה וריאציה.
- ייתכן שהערכים שתזינו יוצגו ללקוחות, ולכן חשוב להזין ערכים שהם יוכלו להבין בקלות.
- במחרוזת הטקסט ניתן להוסיף פרטים נוספים על המידות השונות. למשל, אפשר לציין "3.5 ילדים" או "3.5 פעוטות".
- אם הפריט הוא בגודל אחיד לכולם, אפשר להזין במאפיין הזה את הערכים: "one size", "OS", "one size fits all", "OSFA", "one size fits most" או "OSFM".
ערכי מידות לדוגמה
לפעמים קשה לבחור ערכי מידות שיתאימו למוצרי לבוש מסוגים שונים. לא חייבים להשתמש באותם ערכים בדיוק לכל המוצרים, אבל כדאי להגדיר קנה מידה אחיד שלפיו תקבעו את כל ערכי המידות של מוצרי הלבוש. אפשר גם להשתמש במאפיינים של סוג המידה [size_type] ושיטת המדידה [size_system] כדי לספק מידע נוסף על מידות המוצרים.
חולצות, לבוש עליון ושמלות
XXS, XS, S, M, L, XL, 1XL, 2XL, 3XL, 4XL, 5XL, 6XL
00, 0, 02, 04, 06, 08, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34
מכנסיים וחצאיות
XXS, XS, S, M, L, XL, 1XL, 2XL, 3XL, 4XL, 5XL, 6XL
00, 0, 02, 04, 06, 08, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34
23, 24, 26, 27, 28, 29, 30, 32, 34, 36, 38, 40, 42, 44
למכנסיים: 24x30, 24x32, 24x34
מידות גדולות, מידות קטנות, גדול, גבוה, אורך פנימי (inseams) וכו'
- כשפריט משתייך לקבוצת מידות מיוחדת, כמו 'מידות גדולות', 'מידות קטנות', 'היריון' או 'גדול וגבוה', כדאי להשתמש במאפיין סוג המידה
[size_type]. - כשלפריט יש גימור עם תפרים פנימיים, כדאי להשתמש בפורמט הבא לתיאור המידה: 30 קצר, 30 רגיל, 30 ארוך
נעליים
- ארה"ב: 5, 5.5, 6, 6.5, 7, 7.5, 8, 8.5, 9, 9.5, 10, 10.5, 11, 11.5, 12, 12.5, 13, 13.5, 14, 14.5, 15, 15.5, 16.
- אירופה: 37, 38, 39, 40, 41, 42, 43, 44, 45.
מגדר [gender] – המגדר שאליו מיועד הפריט
"gender": "male" Content API v2 (XML) <gender>male</gender>| פורמט |
יש רק 3 ערכים קבילים:
|
| טקסט (TSV) | male |
| מקורות נתונים בפורמט XML | <g:gender>male</g:gender> |
שימו לב:
- אם שולחים שמות של מאפיינים באנגלית, צריך לציין גם את ערכי המאפיינים באנגלית.
- המאפיין הזה מומלץ, אבל לא חובה, בקטגוריות המשנה הבאות של הקטגוריה 'לבוש ואביזרים': סיכות דש (pinback buttons), סיכות עניבה (tie clips), צמידים (wristbands), כיסויים לנעליים (shoe covers), שרוכים לנעליים (shoe laces), דורבנות (spurs) ורצועות לשעונים (watch bands).
קבוצת גיל [age_group] – קבוצת הגיל שאליה מיועד הפריט
"ageGroup": "adult"Content API v2 (XML): <age_group>adult</age_group>
| פורמט |
יש רק 5 ערכים קבילים:
|
| טקסט (TSV) | adult |
| מקורות נתונים בפורמט XML | <g:age_group>adult</g:age_group> |
חשוב:
- לכל ערך מוגדר שוק יעד משלו:
- ניו-בורן
[newborn]: עד גיל 3 חודשים. מידות ניו-בורן מקוטלגות לרוב לפי טווח הגילאים בחודשים (0-3) ו/או לפי הערך 'ניו-בורן' [newborn]. - תינוקות
[infant]: גיל 3-12 חודשים. מידות לתינוקות מקוטלגות לרוב לפי טווח הגילאים בחודשים (3-12). - פעוטות [toddler]: גיל שנה עד 5 שנים. מידות לפעוטות מקוטלגות לרוב לפי טווח הגילאים בחודשים (12-24) או בשנים (1-5).
- ילדים
[kids]: גיל 5-13 שנים. כל המידות בקבוצת הגיל הזו מיוצרות כך שיתאימו לילדים בטווח הגילאים הזה. - מבוגרים
[adult]: לרוב, מגיל נוער ומעלה. כל המידות בקבוצת הגיל הזו מיוצרות כך שיתאימו למבוגרים או לבני נוער. - אם שולחים את שמות המאפיינים באנגלית, צריך לציין גם את ערכי המאפיינים באנגלית.
- ניו-בורן
- המאפיין הזה מומלץ, אבל לא חובה, בקטגוריות המשנה הבאות של הקטגוריה 'לבוש ואביזרים': סיכות דש (pinback buttons), סיכות עניבה (tie clips), צמידים (wristbands), כיסויים לנעליים (shoe covers), שרוכים לנעליים (shoe laces), דורבנות (spurs) ורצועות לשעונים (watch bands).
- אם הפריט לא מיועד במפורש לילדים בלבד, צריך להגדיר אותו כפריט למבוגרים
[adult], כי לכל פריט מותר לשלוח ערך אחד בלבד.
מאפייני תמחור (אופציונלי)
יש גם מאפיינים אופציונליים שאפשר לשלוח אם הם רלוונטיים לכם.
מחיר [price] – מחיר ברירת המחדל של הפריט במדינת היעד
אם המוצר נמכר במחיר אחיד בכל החנויות, אפשר להשתמש במאפיין הזה כדי לשלוח את מחיר ברירת המחדל של המוצר. אתם יכולים לציין את המחיר במאפיין הזה אם המוצר נמכר במחיר אחיד בכל החנויות, או אם אתם מטמיעים את התכונה דף מוצר עם נתוני זמינות במלאי.
אחרת, כל המחירים הספציפיים לחנות שתכללו במקורות הנתונים של מלאי המוצרים בחנויות מקומיות יחליפו את ערך המאפיין הזה.
אם אתם מטמיעים את התכונה דף מוצר עם נתוני זמינות במלאי, תצטרכו לציין את מאפייני התמחור ולוודא שהם זהים למחיר שציינתם בדף הנחיתה.
הערה: ההנחה של Google היא שהמחיר נקוב במטבע המקובל במדינה שבה ממוקמת החנות. אם המטבע מוגדר ברמת הפריט, צריך לוודא שהוא תואם לתקן ISO 4217.
מתי לכלול אותו: מומלץ לכל הפריטים.
| סוג | מחיר (מספר ממשי (float)) |
| טקסט (TSV) | 1196.00 ILS |
| דוגמה בפורמט XML | <g:price>1196.00</g:price> |
מחיר מבצע [sale_price] – מחיר המבצע שמפרסמים בשביל הפריט
Google ממליצה לשלוח את מאפיין תאריכי התוקף של מחיר המבצע [sale_price_effective_date] לגבי כל פריט עם מחיר מבצע, כי הוא יקבע מתי מחיר המבצע יהיה פעיל. אם לא תשלחו את מאפיין תאריכי התוקף של מחיר המבצע, מחיר המבצע של הפריט יהיה בתוקף כל עוד הוא יישלח במקור הנתונים.
מתי משתמשים במאפיין הזה: מומלץ לכל הפריטים שנמכרים במחיר מבצע.
| סוג | מספר |
| טקסט (TSV) | 999.90 |
| דוגמה בפורמט XML | <g:sale_price>999.90</g:sale_price> |
תאריכי התוקף של מחיר המבצע [sale_price_effective_date] – טווח התאריכים שבו פריט נמכר במחיר מבצע
משתמשים במאפיין הזה יחד עם מאפיין מחיר המבצע [sale_price] כדי לציין את התאריכים שבהם מחיר המבצע בתוקף. מידע נוסף על ההגדרות של מחיר מבצע
| סוג | תאריכי ההתחלה והסיום מופרדים בקו נטוי (/). תאריך ההתחלה יופיע בפורמט (YYYY-MM-DD), ואחריו האות "T", השעה שבה מתחיל המבצע, ולאחר מכן ביטוי של אזור הזמן שבו מתקיים המבצע, כמוגדר בתקן ISO 8601. תאריך הסיום צריך להיות באותו פורמט. אם לא צוין אזור זמן, המערכת משתמשת בשעון UTC. |
| טקסט (TSV) |
דוגמה בזמן UTC: 2021-07-19T17:00:00/2021-07-27T05:00:00 דוגמה בזמן PST: 2021-07-19T09:00:00-08:00/2021-07-26T21:00:00-08:00 |
| XML | <g:sale_price_effective_date>2021-07-19T17:00:00/2021-07-27T05:00:00</g:sale_price_effective_date> |
מידת תמחור יחידה [unit_pricing_measure] – הגדרת המידות והמימדים של המוצר
משתמשים במאפיין של מידת תמחור יחידה [unit_pricing_measure] כדי להגדיר את המידות והמימדים של המוצר. הערך הזה מאפשר ללקוחות להבין את העלות המדויקת ליחידה של המוצר.
מתי משתמשים במאפיין הזה: חובה בכל מוצר, אלא אם יש תקנות או חוקים מקומיים אחרים בנושא.
| סוג | מספר חיובי ויחידה |
| טקסט (TSV) | 1.5kg |
| דוגמה בפורמט XML | <g:unit_pricing_measure>1.5kg</g:unit_pricing_measure> |
מידת בסיס לתמחור יחידה [unit_pricing_base_measure] – ציון המכנה של המחיר ליחידה
בעזרת המאפיין הזה מציינים את מידת הבסיס לתמחור המוצר (לדוגמה: כדי לציין שהמחיר של המוצר מחושב לפי יחידות של 100 מ"ל, מזינים את הערך '100ml'). אם אתם משתמשים במאפיין של מידת תמחור יחידה [unit_pricing_measure], אתם צריכים להשתמש במאפיין מידת הבסיס לתמחור יחידה כדי לציין את המכנה של המחיר ליחידה. כדי לאפשר למשתמשים להשוות בין המחירים ליחידות בכל המודעות והכרטיסים החינמיים למוצרים מקומיים המופיעים באותו דף, יכול להיות שתוצג אצלכם מידת בסיס אחרת מזו שציינתם כאן.
מתי משתמשים במאפיין הזה: אופציונלי, אלא אם יש תקנות או חוקים מקומיים אחרים בנושא.
| סוג | מספר שלם ויחידה |
| טקסט (TSV) | 100g |
| דוגמה בפורמט XML | <g:unit_pricing_base_measure>100g</g:unit_pricing_base_measure> |
מאפייני איסוף מהחנות (אופציונלי)
כדי להדגיש את אפשרות האיסוף בחנות, אפשר לכלול במקור הנתונים את 2 המאפיינים הבאים. מוסיפים אותם אל מקור הנתונים הראשי לגבי פריטים שבהם ערכי המאפיינים האלה חיוביים בכל החנויות (לדוגמה, לקוח יכול לאסוף את הטלוויזיה XYZ בכל אחת מהחנויות שלכם במדינת היעד).
שיטת איסוף [pickup_method] – אפשרות האיסוף של הפריט מהחנות
מציינים אם אפשר לאסוף את המוצר מהחנות ואיזו אפשרות להציג במודעה לגבי אפשרות האיסוף: קנייה, הזמנה, משלוח לחנות או לא אפשרי.
- קנייה
[buy]: העסקה כולה מתבצעת באינטרנט - הזמנה
[reserve]: מזמינים את הפריט באינטרנט והעסקה מתבצעת בחנות - משלוח לחנות
[ship_to_store]: הפריט נרכש באינטרנט ונשלח לחנות מקומית כדי שהלקוח יוכל לאסוף אותו - לא אפשרי
[not_supported]: אי אפשר לאסוף את הפריט מהחנות
| סוג | טקסט (מחרוזת). חייב להיות אחד מהערכים שצוינו למעלה. |
| טקסט (TSV) | buy |
| דוגמה בפורמט XML | <g:pickup_method>buy</g:pickup_method> |
מועד זמינות לאיסוף [pickup_sla] – התאריך שבו הפריט יהיה מוכן לאיסוף מהחנות
צריך לציין את התאריך שבו ההזמנה צפויה להיות מוכנה לאיסוף, ביחס למועד ביצוע ההזמנה.
- באותו יום
[same_day]: הפריט מוכן לאיסוף ביום ביצוע ההזמנה, בכפוף להגבלה של מועד אחרון לביצוע ההזמנה. - ביום המחרת
[next_day]: הפריט מוכן לאיסוף יום לאחר ביצוע ההזמנה. - יומיים
[2-day]: הפריט יישלח לחנות והלקוח יוכל לאסוף אותו בתוך יומיים. - 3 ימים
[3-day]: הפריט יישלח לחנות והלקוח יוכל לאסוף אותו בתוך 3 ימים. - 4 ימים
[4-day]: הפריט יישלח לחנות והלקוח יוכל לאסוף אותו בתוך 4 ימים - 5 ימים
[5-day]: הפריט יישלח לחנות והלקוח יוכל לאסוף אותו בתוך 5 ימים. - 6 ימים
[6-day]: הפריט יישלח לחנות והלקוח יוכל לאסוף אותו בתוך 6 ימים. - 7 ימים
[7-day]: הפריט יישלח לחנות והלקוח יוכל לאסוף אותו בתוך 7 ימים. - כמה שבועות
[multi-week]: הפריט יישלח לחנות והלקוח יוכל לאסוף אותו בעוד יותר משבוע.
| סוג | טקסט (מחרוזת). חייב להיות אחד מהערכים שצוינו למעלה. |
| טקסט (TSV) | same_day |
| דוגמה בפורמט XML | <g:pickup_sla>same day</g:pickup_sla> |
מאפיינים של דפי מוצר עם נתוני מחיר וזמינות במלאי בחנות ספציפית (אופציונלי)
כדי להשתמש במאפיין דף המוצר עם נתוני מחיר וזמינות במלאי בחנות ספציפית, אתם צריכים להוסיף למקור הנתונים הראשי את מאפייני ההפניה ל-URL [ads_redirect] והקישור לדף של חנות מקומית באתר של המוכר [link_template]. כדי לספק דף חנות באתר של המוכר בגרסה שמותאמת לניידים וכדי לעקוב אחר הקליקים מניידים, אתם יכולים להוסיף גם את המאפיין האופציונלי של קישור מובייל לדף חנות מקומית באתר של המוכר [mobile_link_template].
קישור [link]
אם הפעלתם בחשבון שלכם את התכונה דף מוצר עם נתוני זמינות במלאי, כשלקוחות ילחצו על מודעה או על כרטיס מוצר ייעודי שמופיע בחינם, הם יועברו לדף נחיתה באתר שלכם שבו יופיע המוצר. מגדירים את כתובת ה-URL של דף הנחיתה הזה באמצעות מאפיין הקישור [link].
שימו לב:
- השתמשו בשם הדומיין המאומת.
- כתובת ה-URL צריכה להתחיל ב-
httpאו ב-https. - השתמשו בכתובת URL מקודדת שתואמת לתקן RFC 2396 או RFC 1738. לדוגמה: פסיק מיוצג באמצעות "%2C".
- אין לקשר לדף ביניים אלא אם יש דרישה משפטית לכך.
| סוג | כתובת URL. (חייבת להתחיל ב-'http://' או ב-'https://'.) |
| טקסט (TSV) | http://mikemart.com/123 |
| XML | <g:link>http://mikemart.com/123</g:link> |
קישור לדף של חנות מקומית באתר של המוכר [link_template]
אם הפעלתם בחשבון שלכם את התכונה דף מוצר עם נתוני מחיר וזמינות במלאי בחנות ספציפית, כשלקוחות ילחצו על המודעה או על כרטיס המוצר שמופיע בחינם, הם יועברו לדף נחיתה באתר שלכם שבו יופיע המוצר. מגדירים את כתובת ה-URL של דף הנחיתה הזה באמצעות מאפיין הקישור לדף החנות באתר של המוכר [link_template].
שימו לב:
- אתם צריכים לכלול את פרמטר ValueTrack של קוד החנות {
store_code}. המבנה של כתובת ה-URL משתנה מאתר לאתר. קוד החנות יכול להיות פרמטר של כתובת URL או חלק מנתיב כתובת ה-URL. - אתם צריכים לאמת את כתובת האתר ולהצהיר בעלות עליה, וכן לוודא שבכתובת האתר שרשומה ב-Merchant Center מופיע אותו דומיין שצוין במאפיין הקישור. אם הדומיין בכתובת האתר שונה מהדומיין הרשום, אפשר לקרוא כאן איך לפתור את הבעיה.
- אתם צריכים לכלול את הפרמטרים למעקב אחר כתובת URL במאפיין ההפניה ל-URL
[ads_redirect]בלבד.
| סוג | כתובת URL. (חייבת להתחיל ב-'http://' או ב-'https://'.) |
| טקסט (TSV) | http://mikemart.com/123?store={store_code} |
| XML | <g:link_template>http://mikemart.com/123?store={store_code}</g:link_template> |
קישור מובייל לדף של חנות מקומית באתר של המוכר [mobile_link_template]
אם הפעלתם בחשבון שלכם את התכונה דף מוצר עם נתוני מחיר וזמינות במלאי בחנות ספציפית, כשלקוחות ילחצו על המודעה או על כרטיס המוצר שמופיע בחינם, הם יועברו לדף נחיתה באתר שלכם שבו יופיע המוצר.
מאפיין קישור המובייל לדף החנות באתר של המוכר [mobile_link_template] מאפשר לציין את כתובת ה-URL של דף הנחיתה בגרסה שמותאמת לניידים. הגרסה הזו לנייד תוצג ללקוחות במכשירים ניידים, כמו טלפונים או טאבלטים.
שימו לב:
- אתם צריכים לכלול את פרמטר ValueTrack של קוד החנות {
store_code}. המבנה של כתובת ה-URL משתנה מאתר לאתר. קוד החנות יכול להיות פרמטר של כתובת URL או חלק מנתיב כתובת ה-URL. - אתם צריכים לאמת את כתובת האתר ולהצהיר בעלות עליה, וגם לוודא שבכתובת האתר שרשומה ב-Merchant Center מופיע אותו דומיין שצוין במאפיין הקישור לדף החנות באתר של המוכר
[link_template]. אם הדומיין בכתובת האתר שונה מהדומיין הרשום, אפשר לקרוא כאן איך לפתור את הבעיה. - אתם צריכים לכלול את הפרמטרים למעקב אחר כתובת URL במאפיין ההפניה ל-URL
[ads_redirect]בלבד.
| סוג | כתובת URL. (חייבת להתחיל ב-'http://' או ב-'https://'.) |
| טקסט (TSV) | http://mikemart.com/123?store={store_code} |
| XML | <g:mobile_link_template>http://mikemart.com/123?store={store_code}</g:mobile_link_template> |
הפניה ל-URL [ads_redirect]
אם הפעלתם בחשבון שלכם את התכונה דף מוצר עם נתוני מחיר וזמינות במלאי בחנות ספציפית, כשלקוחות ילחצו על המודעה, הם יועברו לדף נחיתה באתר שלכם שבו יופיע המוצר.
מאפיין ההפניה ל-URL מאפשר להגדיר כתובת URL עם פרמטרים למעקב, שיעזרו לכם להבין טוב יותר את מקורות התנועה לדף הנחיתה.
שימו לב:
- אתם צריכים לכלול את פרמטר ValueTrack של קוד החנות {
store_code}. המבנה של כתובת ה-URL משתנה מאתר לאתר. קוד החנות יכול להיות פרמטר של כתובת URL או חלק מנתיב כתובת ה-URL. - אתם צריכים לאמת את כתובת האתר ולהצהיר בעלות עליה, וכן לוודא שבכתובת האתר שרשומה ב-Merchant Center מופיע אותו דומיין שצוין במאפיין הקישור. אם הדומיין בכתובת האתר שונה מהדומיין הרשום, אפשר לקרוא כאן איך לפתור את הבעיה.
- כשאתם מגדירים את המאפיין הזה, לקוח שילחץ על המודעה שלכם יועבר אל המיקום שצוין במאפיין הפניה ל-URL
[ads_redirect], ולא אל המיקום שצוין במאפיינים 'קישור לדף של חנות מקומית באתר של המוכר'[link_template]או 'קישור המובייל לדף של חנות מקומית באתר של המוכר'[mobile_link_template].
| סוג | כתובת URL. (חייבת להתחיל ב-'http://' או ב-'https://'.) |
| טקסט (TSV) | http://mikemart.com/123?store={store_code} |
| XML | <g:ads_redirect>http://mikemart.com/123?store={store_code}</g:ads_redirect> |
מאפיינים נוספים (אופציונלי)
כדי להציג מידע מפורט יותר במודעות או בכרטיסי מוצר, מומלץ לשלוח מידע נוסף על המוצרים במקור הנתונים הראשי. פירוט מלא של המאפיינים האפשריים מופיע במפרט נתוני המוצרים.