טמעת נתונים בכמות גדולה של פידים מאפשרת לכם להציג מסעדות, שירותים ותפריטים ב'הזמנה מקצה לקצה'.
Google מאחזרת את פידים של הנתונים שמאוחסנים בפלטפורמת האירוח ומעבדת אותם. אחרי הטמעה מוצלחת, הכלי Ordering End-to-End מספק מידע על סטטוס הטמעת הנתונים, קבצים חדשים שהועלו, מספר הקבצים הכולל, שגיאות ואזהרות, בין היתר.
במאמר הזה מוסבר בהרחבה על רוב השגיאות בפיד האצווה במרכז הפעולות, מה המשמעות שלהן ואיך לתקן אותן. הקישורים ההיפר-טקסטיים יעבירו אתכם אל הדף של הסכימה היחסית של מלאי שטחי הפרסום, שבו מפורט הקשר נוסף, כמו סוגי הנתונים המותרים ודוגמאות לשדות ולישויות ספציפיים.
איפה מופיעות שגיאות בפיד האצווה ב-Actions Center?
פידים של נתונים מאפשרים לכם להציג את המסעדה, השירותים והתפריט שלכם ב-Ordering End-to-End. מידע נוסף על אירוח פידים של נתונים זמין במאמר טמעת נתונים בכמות גדולה.
אחרי העלאת קובצי הפיד, Google מאחזרת אותם ומעבדת אותם. אם יש בעיות, הן יוצגו כשגיאות. כך רואים שגיאות בפידים בכמות גדולה במרכז הפעולות:
בחלונית הניווט הראשית במרכז הפעולות, עוברים לקטע פידים > היסטוריה.
בוחרים את הסביבה (Production או Sandbox) ולוחצים על הכרטיסייה Ingestion history.
מזינים חלון מבט לאחור כדי לראות את היסטוריית ההטמעה ב-X הימים האחרונים
כדי לקבל פרטים נוספים על שגיאות בהטמעת פיד מסוים, לוחצים על החץ (→)
לאחר מכן תוכלו לראות פרטים נוספים על השגיאות והאזהרות
זו רשימה של שגיאות בפיד באצווה:
| שגיאה | המשמעות | איך פותרים את הבעיה |
חסרים נתונים – MenuItem
תפריט חייב להכיל לפחות MenuItem אחד
|
הוגדר תפריט ללא MenuItem
|
מחפשים את המזהה של הישות השגויה מסוג תפריט בפיד ומוסיפים פריטים לתפריט. |
נתונים שגויים – maxPrice
נתונים שגויים בשדה maxPrice
|
הערך בשדה maxPrice שגוי
|
מוודאים שהערך בשדה maxPrice גדול מ-0 עבור מזהה הישות שצוין בתיאור השגיאה
|
נתונים שגויים – eligibleQuantityMax
נתונים שגויים בשדה eligibleQuantityMax
|
הערך בשדה eligibleQuantityMax שגוי
|
מוודאים שהערך בשדה eligibleQuantityMax גדול מ-0 עבור מזהה הישות שצוין.
|
נתונים שגויים – leadTimeMax
נתונים שגויים בשדה leadTimeMax
|
השדה leadTimeMax מצפה לערך שהוא מספר שלם. דוגמה: 12.
היא גורמת לשגיאה בכל סוג נתונים אחר, גם double (15.0)
|
עבור מזהה הישות שצוין בהודעת השגיאה, בודקים את הערך של המאפיין leadTimeMax ומוודאים שהוא מספר שלם.
|
נתונים שגויים – validFrom
נתונים שגויים בשדה validFrom
|
הערך בשדה validFrom צריך להיות בפורמט חותמת זמן של ISO מסוג מחרוזת.
|
עבור מזהה הישות בהודעת השגיאה בשדה validFrom, חשוב לוודא שהערך הוא מחרוזת של חותמת זמן.
דוגמה: ' 2022-01-02T00:00:00-07:00'
|
| נתונים חסרים – ServiceHours
OperationHour לא מכיל ServiceHours בתצוגת עץ |
הישות OperationHours מוגדרת, אבל אין לה ישות ServiceHours תקפה תואמת. | לגבי מזהה הישות שצוין בהודעת השגיאה, בודקים אם יש ישות ServiceHours מוגדרת כראוי שתואמת אליו.
דוגמה: אם הודעת השגיאה היא "מזהה הישות: store-1:DELIVERY OperationHour לא מכיל ServiceHours בתצוגת עץ", ומניחים שמזהה הישות של הישות OperationHours הוא 'store-1:DELIVERY:operation_hours' – צריך לבדוק אם יש ישות serviceHours שמקושרת ל-'store-1:DELIVERY' ServiceID ול-'store-1:DELIVERY:operation_hours' OperationHoursID
|
נתונים שגויים – advanceBookingRequirementMin
נתונים שגויים בשדה advanceBookingRequirementMin
|
השדה advanceBookingRequirementMin מצפה לערך שהוא מספר שלם. דוגמה: 12.
היא גורמת לשגיאה בכל סוג נתונים אחר, גם double (15.0) |
עבור מזהה הישות שצוין בהודעת השגיאה, בודקים את הערך של המאפיין advanceBookingRequirementMin ומוודאים שהוא מספר שלם.
|
נתונים שגויים – availabilityStarts
נתונים שגויים בשדה availabilityStarts
|
הערך בשדה availabilityStarts צריך להיות בפורמט חותמת זמן של ISO מסוג מחרוזת.
|
עבור מזהה הישות בהודעת השגיאה בשדה availabilityStarts, חשוב לוודא שהערך הוא מחרוזת של חותמת זמן.
דוגמה: ' 2022-01-02T00:00:00-07:00'
|
נתונים שגויים – closes
נתונים שגויים בשדה closes
|
הערך בשדה closes צריך להיות בפורמט חותמת זמן של ISO מסוג מחרוזת.
|
עבור מזהה הישות בהודעת השגיאה בשדה closes, חשוב לוודא שהערך הוא מחרוזת של חותמת זמן.
דוגמה: 2022-01-02T00:00:00-07:00
|
נתונים שגויים – dateModified
נתונים שגויים בשדה dateModified
|
הערך בשדה dateModified צריך להיות בפורמט חותמת זמן של ISO מסוג מחרוזת.
|
עבור מזהה הישות בהודעת השגיאה בשדה dateModified, חשוב לוודא שהערך הוא מחרוזת של חותמת זמן.
דוגמה: 2022-01-02T00:00:00-07:00
|
נתונים שגויים – discount
נתונים שגויים בשדה discount
|
השדה discount מצפה לערך מספרי
|
מזינים ערך מספרי עבור מזהה הישות בהודעת השגיאה בשדה discount.
דוגמה: 10
|
נתונים שגויים – discountPercentage
נתונים שגויים בשדה discountPercentage
|
השדה discountPercentage מצפה לערך מספרי
|
מזינים ערך מספרי עבור מזהה הישות בהודעת השגיאה בשדה discountPercentage.
דוגמה: 15
|
נתונים שגויים – geoRadius
נתונים שגויים בשדה geoRadius
|
השדה geoRadius מצפה לערך של מספר שלם חיובי.
|
עבור מזהה הישות שצוין בהודעת השגיאה, בודקים את הערך של המאפיין geoRadius ומוודאים שהוא מספר שלם.
דוגמה: 10000 |
נתונים שגויים – image
נתונים שגויים בשדה image
|
השדה image מצפה לכתובת URL תקינה, ומציג שגיאה אם הוא מזהה משהו אחר.
|
בודקים אם הערך בשדה image הוא מחרוזת כתובת URL חוקית
|
נתונים שגויים – latitude
נתונים שגויים בשדה latitude
|
השדה latitude מצפה שהערך יהיה מסוג double
|
במזהה הישות מסוג מסעדה שצוין בתיאור השגיאה, צריך לוודא שהערך של השדה latitude הוא כפול.
דוגמה: 35.4565 |
נתונים שגויים – leadTimeMin
נתונים שגויים בשדה leadTimeMin
|
השדה leadTimeMin מצפה לערך שהוא מספר שלם. דוגמה: 12.
היא גורמת לשגיאה בכל סוג נתונים אחר, גם double (15.0) |
עבור מזהה הישות שצוין בהודעת השגיאה, בודקים את הערך של המאפיין leadTimeMin ומוודאים שהוא מספר שלם.
|
נתונים שגויים – longitude
נתונים שגויים בשדה longitude
|
השדה longitude מצפה שהערך יהיה מסוג double
|
במזהה הישות מסוג מסעדה שצוין בתיאור השגיאה, צריך לוודא שהערך של השדה longitude הוא כפול.
דוגמה: 35.4565 |
נתונים שגויים – menuId
נתונים שגויים בשדה menuId
|
הערך בשדה menuId צריך להיות מחרוזת לא ריקה
|
לגבי מזהה הישות שצוין בתיאור השגיאה, צריך לוודא שהערך הוא מסוג String ולא ריק |
נתונים שגויים – name
נתונים שגויים בשדה name
|
הערך בשדה name צריך להיות מחרוזת לא ריקה
|
בודקים אם הערך של מזהה הישות שצוין בהודעת השגיאה הוא מחרוזת לא ריקה. |
נתונים שגויים – nutrition.calories
נתונים שגויים בשדה nutrition.calories
|
הערך בשדה calories צריך להיות מחרוזת בפורמט "NN Cal"
|
מוודאים שהערך של מזהה הישות בהודעת השגיאה הוא מספר חיובי בפורמט הנכון.
דוגמה: '123.32 קלוריות' |
נתונים שגויים – opens
נתונים שגויים בשדה opens
|
הערך בשדה opens צריך להיות בפורמט חותמת זמן של ISO מסוג מחרוזת.
|
עבור מזהה הישות בהודעת השגיאה בשדה opens, חשוב לוודא שהערך הוא מחרוזת של חותמת זמן.
דוגמה: 2022-01-02T00:00:00-07:00
|
נתונים שגויים – price
נתונים שגויים בשדה price
|
השדה price מצפה לערך מספרי
|
מזינים ערך מספרי עבור מזהה הישות בהודעת השגיאה בשדה price.
דוגמה: 15.4 |
נתונים שגויים – sku
נתונים שגויים בשדה sku
|
הערך בשדה sku צריך להיות מחרוזת לא ריקה
|
בודקים אם הערך של מזהה הישות שצוין בהודעת השגיאה הוא מחרוזת לא ריקה. |
נתונים שגויים – validFrom
נתונים שגויים בשדה validFrom
|
הערך בשדה validFrom צריך להיות בפורמט חותמת זמן של ISO מסוג מחרוזת.
בנוסף, הערך של validFrom צריך להיות קטן מ-validThrough או שווה לו.
|
עבור מזהה הישות שצוין בתיאור השגיאה, מוודאים שהערך בשדה validFrom הוא מחרוזת של חותמת זמן.
" 2022-01-02T00:00:00-07:00"
כמו כן, חשוב לוודא שהערך של validFrom קטן מ-validThrough או שווה לו
|
נתונים שגויים – validThrough
נתונים שגויים בשדה validThrough
|
הערך בשדה validThrough צריך להיות בפורמט חותמת זמן של ISO מסוג מחרוזת.
בנוסף, הערך של validThrough צריך להיות גדול מ-validFrom או שווה לו.
|
עבור מזהה הישות שצוין בתיאור השגיאה, מוודאים שהערך בשדה validThrough הוא מחרוזת של חותמת זמן.
" 2022-01-02T00:00:00-07:00"
כמו כן, חשוב לוודא שהערך של validThrough גדול מ-validFrom או שווה לו
|
נתונים שגויים – value
נתונים שגויים בשדה value
|
השדה value נדרש רק כשמגדירים את Optiontype. הפונקציה מצפה למחרוזת או ל-Enum value. הערה: ערכי Enum ספציפיים לסוג האפשרות PIZZA_SIDE.
|
עבור מזהה הישות שצוין בתיאור השגיאה, בודקים אם בשדה value יש מחרוזת לא ריקה.
|
| התפריט גדול מדי
הגודל של התפריט חורג מהמגבלה המקסימלית |
השגיאה הזו מתקבלת כאשר גודל קובץ התפריט גדול מהגודל שהמערכת יכולה לקבל. כל קובץ, שיכול להכיל כמה ישויות, לא יכול לחרוג מ-200MB. הגודל הכולל של הישות ברמה העליונה 'מסעדה', הישות ברמה העליונה 'שירות' והישות ברמה העליונה 'תפריט', יחד עם ישויות הצאצאים שלהן, לא יכול לחרוג מ-4MB. | מוודאים שגודל קובץ התפריט עומד במגבלה שצוינה במסמכי התיעוד. |
נתונים חסרים – addressCountry
חסר שדה החובה addressCountry בקלט.
|
addressCountry הוא שדה חובה וחסר בישות Restaurant
|
עבור מזהה הישות שצוין בתיאור השגיאה, בודקים אם השדה addressCountry הוא מחרוזת לא ריקה
|
נתונים חסרים – addressLocality
חסר שדה החובה addressLocality בקלט.
|
addressLocality הוא שדה חובה וחסר בישות Restaurant
|
עבור מזהה הישות שצוין בתיאור השגיאה, בודקים אם השדה addressLocality הוא מחרוזת לא ריקה
|
נתונים חסרים – addressRegion
חסר שדה החובה addressRegion בקלט.
|
addressRegion הוא שדה חובה וחסר בישות Restaurant
|
עבור מזהה הישות שצוין בתיאור השגיאה, בודקים אם השדה addressRegion הוא מחרוזת לא ריקה
|
| נתונים חסרים – עמלה
לשירותי משלוחים/טייק אווי אין דמי משלוח |
לישות מסוג Fee לא משויך price עבור שירות המסירה או הטייק אווי
|
לגבי מזהה הישות שצוין בתיאור השגיאה, מוודאים שהישות Fee מוגדרת כראוי לServiceType של 'הזמנה במשלוח' או 'טייק אווי', בהתאם להוראות שמפורטות כאן. |
נתונים חסרים – FeeValue
חובה להזין אחד מהשדות price, pricePerMeter, percentageOfCart.
|
צריך להגדיר בדיוק אחד מהמאפיינים price, pricePerMeter or percentageOfCart לערך של Fee.
|
במזהה הישות שצוין בתיאור השגיאה, צריך לוודא שרק אחד מהשדות price, pricePerMeter or percentageOfCart מוגדר.
|
נתונים חסרים – geoMidpointLatitude
חסר שדה החובה geoMidpointLatitude בקלט.
|
כשמגדירים את ServiceArea, צריך לציין את geoMidpointLatitude יחד עם geoMidpointLongitude כשמשתמשים ב-geoRadius.
|
עבור מזהה הישות שצוין בתיאור השגיאה, צריך לוודא שהערך של השדה geoMidpointLatitude מוגדר ומסווג כ-double.
דוגמה: 35.4565 |
נתונים חסרים – geoMidpointLongitude
geoMidpointLongitude בקלט.
|
כשמגדירים את ServiceArea, צריך לציין את geoMidpointLongitude יחד עם geoMidpointLatitude כשמשתמשים ב-geoRadius.
|
עבור מזהה הישות שצוין בתיאור השגיאה, צריך לוודא שהערך של השדה geoMidpointLatitude מוגדר ומסווג כ-double.
דוגמה: 122.4565 |
| נתונים חסרים – MenuItemOption
נדרש MenuItemOffer עבור MenuItemOption |
לכל MenuItemOption צריך להיות ישות MenuItemOffer תואמת | צריך לוודא שלכל מזהי הפריטים בתפריט שמופיעים בתיאור השגיאה, יש לישות MenuItemOption יש ישות MenuItemOffer שמוגדרת כראוי. |
| נתונים חסרים – OperationHours
חסרות שעות פעילות בשירות |
ישות של שירות משלוחים או טייק אווי חסרה ישות OperationHours תואמת. השדה OperationHours מתאר את חלון ההזמנות שבו המשתמשים יכולים לגשת לתהליך ולהזמין בהקדם האפשרי או להזמין מראש. | לגבי מזהה הישות שצוין בתיאור השגיאה, צריך לוודא שהישות OperationHours מוגדרת כראוי. |
נתונים חסרים – postalCode
חסר שדה החובה postalCode בקלט.
|
postalCode הוא שדה חובה וחסר בישות Restaurant
|
עבור מזהה הישות שצוין בתיאור השגיאה, בודקים אם השדה postalCode הוא מחרוזת לא ריקה
|
נתונים חסרים – priceCurrency
חסר שדה החובה priceCurrency בקלט.
|
השדה priceCurrency ריק או מכיל ערך לא מדויק. צריך להזין קוד מטבע לפי תקן ISO 4217 בן 3 אותיות.
|
במזהה הישות שמתואר בתיאור השגיאה, צריך לוודא שהשדה priceCurrency הוא מחרוזת לא ריקה עם קוד מטבע בן 3 אותיות לפי תקן ISO 4217.
דוגמה: USD, EUR |
| נתונים חסרים – ServiceArea
לשירות המשלוחים אין אזורי שירות |
יש להטמיע את הישות ServiceArea אם הערך של serviceType בישות Service המשויכת מוגדר כ-'DELIVERY'
|
מוודאים שלמזהה הישות של השירות שצוין בהודעת השגיאה יש ישות ServiceArea שהוגדרה בצורה נכונה |
נתונים חסרים – streetAddress
חסר שדה החובה streetAddress בקלט.
|
השדה streetAddress הוא שדה חובה וחסר בישות Restaurant
|
מחפשים את הישות Restaurant לפי המזהה שצוין בתיאור השגיאה, ובודקים אם השדה streetAddress הוא מחרוזת לא ריקה.
|
| ישות לא עדכנית | במהלך הטמעת פיד הנתונים, התכונה 'סידור מקצה לקצה' משווה את חותמת הזמן של תאריך השינוי של כל ישות נכנסת לחותמות הזמן של ישויות שהוכנסו בעבר. אלא אם הישות בפיד הנתונים עדכנית יותר, הישות הנכנסת מסומנת כלא עדכנית. | לגבי כל מזהי הישות שצוינו בתיאור השגיאה, Google צריכה לוודא שחותמת הזמן בפיד הנתונים חדשה יותר מחותמת הזמן שהוגדרה בעדכוני ישות קודמים שנשלחו ל-Google. אפשר לעיין במאמר ניהול גרסאות של ישויות כדי לקבל הבהרות נוספות. |