הטמעת נתונים בכמות גדולה של פידים של נתונים מאפשרת לכם להציג מסעדות, שירותים ותפריטים במהלך ההזמנה מקצה לקצה.
Google מאחזרת את הפידים של הנתונים ששמורים בפלטפורמת האירוח ומעבדת אותם. אחרי שהטמעתם את הנתונים בהצלחה, בקטע 'סידור מקצה לקצה' תוכלו למצוא מידע לגבי הסטטוס של הטמעת הנתונים, הקבצים החדשים שהועלו, המספר הכולל של הקבצים, השגיאות והאזהרות.
במאמר הזה נפרט את רוב השגיאות בפידים של קבוצות במרכז הפעולות, מה המשמעות שלהן ואיך לתקן אותן. ההיפר-קישורים מובילים לדף הסכימה של מלאי שטחי הפרסום, שמספק הקשר נוסף, כמו סוגי נתונים קבילים ודוגמאות לשדות ולישויות ספציפיים.
איפה מופיעות שגיאות בפידים באצווה במרכז הפעולות?
בעזרת הפידים של הנתונים אפשר להציג את המסעדה, השירותים והתפריט שלכם בכל שלבי ההזמנה. מידע נוסף על אירוח פידים של נתונים זמין במאמר הטמעת נתונים באצווה.
אחרי שמעלים את קובצי הפיד, Google מאחזרת אותם ומעבדת אותם. אם יש בעיות, הן מוצגות כשגיאות. כדי להציג שגיאות באצווה של פידים במרכז הפעולות, בצעו את השלבים הבאים.
בחלונית הניווט הראשית במרכז הפעולות, עוברים לקטע Feeds > History (פידים).
בוחרים את הסביבה (סביבת ייצור או Sandbox) ולוחצים על הכרטיסייה היסטוריית הטמעת נתונים.
יש להזין חלון מבט לאחור כדי לראות את ההיסטוריה של הטמעת הנתונים מ-X הימים האחרונים
כדי לקבל פרטים נוספים על שגיאות בהטמעת נתונים מסוימת של הפיד, לחצו על החץ (←)
לאחר מכן יוצגו פרטים נוספים על שגיאות ואזהרות
הנה רשימת שגיאות בעדכון אצווה:
| שגיאה | מה זה אומר | איך פותרים את הבעיה |
נתונים חסרים – MenuItem
בתפריט צריך להיות לפחות MenuItem אחד
|
הוגדר תפריט ללא MenuItem
|
צריך לחפש בפיד את המזהה של ישות תפריט שגויה ולהוסיף פריטים לתפריט. |
נתונים שגויים - maxPrice
נתונים שגויים בשדה maxPrice
|
הערך בשדה maxPrice שגוי
|
צריך לוודא שהערך בשדה maxPrice גדול מ-0 עבור מזהה הישות שמוזכר בתיאור השגיאה
|
נתונים שגויים - eligibleQuantityMax
נתונים שגויים בשדה eligibleQuantityMax
|
הערך בשדה eligibleQuantityMax שגוי
|
צריך לוודא שהערך בשדה eligibleQuantityMax גדול מ-0 עבור מזהה הישות שצוין.
|
נתונים שגויים - leadTimeMax
נתונים שגויים בשדה leadTimeMax
|
השדה leadTimeMax מצפה לערך שהוא מספר שלם. דוגמה, 12.
מופיעה שגיאה לגבי כל סוג אחר של נתונים, אפילו כפול (15.0)
|
עבור מזהה הישות שמוזכר בהודעת השגיאה, צריך לבדוק את הערך של המאפיין leadTimeMax ולוודא שהוא מספר שלם.
|
נתונים שגויים - validFrom
נתונים שגויים בשדה validFrom
|
הערך בשדה validFrom מצפה לפורמט חותמת זמן של ISO עם סוג String.
|
לגבי מזהה הישות בהודעת השגיאה בשדה validFrom, צריך לוודא שהערך הוא מחרוזת של חותמת זמן.
דוגמה: " 2022-01-02T00:00:00-07:00"
|
| נתונים חסרים – ServiceHours
OperationHour לא מכיל ServiceHours מקוננות |
הישות OperationHours הוגדרה, אבל לא קיימת ישות ServiceHours חוקית שתואמת אליה. | לגבי מזהה הישות שמצוין בהודעת השגיאה, בודקים אם קיימת ישות ServiceHours שתואמת אליה.
דוגמה: אם הודעת השגיאה היא 'Entity_id: store-1:סט פעולהHour' מכיל אין שירות שעות מקונן ', ובהנחה שמזהה הישות של הישות OperationHours הוא'store-1:delivery:operation_hours' – צריך לבדוק אם יש ישות serviceHours שמקושרת ל-'store-1:delivery' ServiceID ול-'store-1:delivery:operation_hours' OperationHoursID
|
נתונים שגויים - advanceBookingRequirementMin
נתונים שגויים בשדה advanceBookingRequirementMin
|
השדה advanceBookingRequirementMin מצפה לערך שהוא מספר שלם. דוגמה, 12.
היא גורמת לשגיאה של כל סוג נתונים אחר, אפילו כפול (15.0) |
עבור מזהה הישות שמוזכר בהודעת השגיאה, צריך לבדוק את הערך של המאפיין advanceBookingRequirementMin ולוודא שהוא מספר שלם.
|
נתונים שגויים - availabilityStarts
נתונים שגויים בשדה availabilityStarts
|
הערך בשדה availabilityStarts מצפה לפורמט חותמת זמן של ISO עם סוג String.
|
לגבי מזהה הישות בהודעת השגיאה בשדה availabilityStarts, צריך לוודא שהערך הוא מחרוזת של חותמת זמן.
דוגמה: " 2022-01-02T00:00:00-07:00"
|
נתונים שגויים - closes
נתונים שגויים בשדה closes
|
הערך בשדה closes מצפה לפורמט חותמת זמן של ISO עם סוג String.
|
לגבי מזהה הישות בהודעת השגיאה בשדה closes, צריך לוודא שהערך הוא מחרוזת של חותמת זמן.
דוגמה: " 2022-01-02T00:00:00-07:00"
|
נתונים שגויים - dateModified
נתונים שגויים בשדה dateModified
|
הערך בשדה dateModified מצפה לפורמט חותמת זמן של ISO עם סוג String.
|
לגבי מזהה הישות בהודעת השגיאה בשדה 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 מצפה שסוג הערך יהיה כפול
|
במזהה הישות מסוג 'מסעדה' שמופיע בתיאור השגיאה, צריך לוודא שהערך בשדה latitude הוא כפול.
לדוגמה: 35.4565 |
נתונים שגויים - leadTimeMin
נתונים שגויים בשדה leadTimeMin
|
השדה leadTimeMin מצפה לערך שהוא מספר שלם. דוגמה, 12.
היא גורמת לשגיאה של כל סוג נתונים אחר, אפילו כפול (15.0) |
עבור מזהה הישות שמוזכר בהודעת השגיאה, צריך לבדוק את הערך של המאפיין leadTimeMin ולוודא שהוא מספר שלם.
|
נתונים שגויים - longitude
נתונים שגויים בשדה longitude
|
השדה longitude מצפה שסוג הערך יהיה כפול
|
במזהה הישות מסוג 'מסעדה' שמופיע בתיאור השגיאה, צריך לוודא שהערך בשדה longitude הוא כפול.
לדוגמה: 35.4565 |
נתונים שגויים - menuId
נתונים שגויים בשדה menuId
|
הערך בשדה menuId צריך להיות מחרוזת שאינה ריקה
|
במזהה הישות שמוזכר בתיאור השגיאה, צריך לוודא שהערך הוא מסוג String ולא ריק |
נתונים שגויים - name
נתונים שגויים בשדה name
|
הערך בשדה name צריך להיות מחרוזת שאינה ריקה
|
צריך לבדוק אם הערך של מזהה הישות שמוזכר בהודעת השגיאה הוא מחרוזת שאינה ריקה |
נתונים שגויים - nutrition.calories
נתונים שגויים בשדה nutrition.calories
|
הערך בשדה calories צריך להיות מחרוזת בפורמט "NN Cal"
|
יש לוודא שלמזהה הישות בהודעת השגיאה, הערך הוא מספר חיובי בפורמט הנכון.
דוגמה: "123.32 קלוריות" |
נתונים שגויים - opens
נתונים שגויים בשדה opens
|
הערך בשדה opens מצפה לפורמט חותמת זמן של ISO עם סוג String.
|
לגבי מזהה הישות בהודעת השגיאה בשדה opens, צריך לוודא שהערך הוא מחרוזת של חותמת זמן.
דוגמה: " 2022-01-02T00:00:00-07:00"
|
נתונים שגויים - price
נתונים שגויים בשדה price
|
השדה price מצפה לערך מספרי
|
במזהה הישות בהודעת השגיאה בשדה price, צריך לוודא שהערך הוא מספרי.
לדוגמה: 15.4 |
נתונים שגויים - sku
נתונים שגויים בשדה sku
|
הערך בשדה sku צריך להיות מחרוזת שאינה ריקה
|
צריך לבדוק אם הערך של מזהה הישות שמוזכר בהודעת השגיאה הוא מחרוזת שאינה ריקה |
נתונים שגויים - validFrom
נתונים שגויים בשדה validFrom
|
הערך בשדה validFrom מצפה לפורמט חותמת זמן של ISO עם סוג String.
כמו כן, הערך של validFrom צריך להיות קטן מ-validThrough או שווה לו
|
במזהה הישות שמוזכר בתיאור השגיאה, צריך לוודא שהערך בשדה validFrom הוא מחרוזת של חותמת זמן.
" 2022-01-02T00:00:00-07:00"
בנוסף, צריך לוודא שהערך של validFrom קטן מ-validThrough או שווה לו
|
נתונים שגויים - validThrough
נתונים שגויים בשדה validThrough
|
הערך בשדה validThrough מצפה לפורמט חותמת זמן של ISO עם סוג String.
כמו כן, הערך של validThrough צריך להיות גדול מ-validFrom או שווה לו
|
במזהה הישות שמוזכר בתיאור השגיאה, צריך לוודא שהערך בשדה validThrough הוא מחרוזת של חותמת זמן.
" 2022-01-02T00:00:00-07:00"
בנוסף, צריך לוודא שהערך של validThrough גדול מ-validFrom או שווה לו
|
נתונים שגויים - value
נתונים שגויים בשדה value
|
נדרש רק כאשר מוגדר Optiontype. הפונקציה מצפה למחרוזת או ל-Enum value. חשוב לשים לב שערכי Enum הם ספציפיים לסוג האפשרות PIZZA_SIDE.
|
עבור ה-entityID שמוזכר בתיאור השגיאה, צריך לבדוק אם השדה value מכיל מחרוזת שאינה ריקה.
|
| התפריט גדול מדי
גודל התפריט חורג מהמגבלה המקסימלית |
הודעת השגיאה הזאת מוצגת כאשר קובץ תפריט גדול מהגודל שהמערכת יכולה לקבל. כל קובץ, שיכול להכיל מספר ישויות, לא יעלה על 200MB. הישויות 'מסעדה', 'שירות' ו'תפריט' ברמה העליונה, יחד עם ישויות הצאצא שלהן, לא יכולות לחרוג מ-4MB יחד. | חשוב לוודא שהגודל של קובץ התפריט לא חורג מהמגבלה שמצוינת במסמכי התיעוד. |
נתונים חסרים – addressCountry
חסר שדה חובה addressCountry בקלט.
|
השדה addressCountry הוא שדה חובה, והוא חסר בישות 'מסעדה'
|
במזהה הישות שמוזכר בתיאור השגיאה, צריך לבדוק אם השדה addressCountry הוא מחרוזת שאינה ריקה
|
נתונים חסרים – addressLocality
חסר שדה חובה addressLocality בקלט.
|
השדה addressLocality הוא שדה חובה, והוא חסר בישות 'מסעדה'
|
במזהה הישות שמוזכר בתיאור השגיאה, צריך לבדוק אם השדה addressLocality הוא מחרוזת שאינה ריקה
|
נתונים חסרים – addressRegion
חסר שדה חובה addressRegion בקלט.
|
השדה addressRegion הוא שדה חובה, והוא חסר בישות 'מסעדה'
|
במזהה הישות שמוזכר בתיאור השגיאה, צריך לבדוק אם השדה addressRegion הוא מחרוזת שאינה ריקה
|
| נתונים חסרים – עמלה
בשירות משלוחים/איסוף עצמי אין עמלות משלוח |
לישות מסוג עמלה לא משויך price כלשהו עבור שירות המשלוחים/איסוף עצמי
|
במזהה הישות שמוזכר בתיאור השגיאה, צריך לוודא שהישות עמלה מוגדרת בצורה נכונה עבור ServiceType של משלוח/איסוף עצמי, לפי ההוראות שמפורטות כאן. |
נתונים חסרים – FeeValue
הקלט הוא אחד מהערכים הבאים: price, pricePerMeter, percentageOfCart.
|
בערך 'עמלה', צריך להגדיר רק אחד מתוך price, pricePerMeter or percentageOfCart המאפיינים.
|
במזהה הישות שמוזכר בתיאור השגיאה, צריך לוודא שמוגדר בדיוק אחד מהערכים 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, צריך להיות ישות MenuItemOption תואמת | חשוב לוודא שבכל מזהי הפריטים בתפריט שצוינו בתיאור השגיאה, בכל הישויות של MenuItemOption יש ישות MenuItemOption שמוגדרת כראוי. |
| נתונים חסרים – OperationHours
חסרות שעות פעילות בשירות |
בישות של שירות משלוחים/איסוף עצמי חסרה ישות OperationHours תואמת. בשדה OperationHours מוצג חלון ההזמנות שמאפשר למשתמשים לגשת לתהליך התהליך ולבצע הזמנות בהקדם האפשרי או בעתיד. | במזהה הישות שמוזכר בתיאור השגיאה, צריך לוודא שישות OperationHours מוגדרת נכון. |
נתונים חסרים – postalCode
חסר שדה חובה postalCode בקלט.
|
השדה postalCode הוא שדה חובה, והוא חסר בישות 'מסעדה'
|
במזהה הישות שמוזכר בתיאור השגיאה, צריך לבדוק אם השדה postalCode הוא מחרוזת שאינה ריקה
|
נתונים חסרים – priceCurrency
חסר שדה חובה priceCurrency בקלט.
|
השדה priceCurrency ריק או מכיל ערך לא מדויק. הוא צריך לקבל קוד מטבע בן 3 אותיות לפי תקן ISO 4217.
|
במזהה הישות שמתואר בתיאור השגיאה, צריך לוודא שהשדה priceCurrency הוא מחרוזת לא ריקה עם קוד מטבע לפי תקן ISO 4217 בן 3 אותיות.
לדוגמה: USD, EUR |
| חסרים נתונים – ServiceArea
לשירות המשלוחים אין אזורי שירות משלוחים |
צריך להטמיע את הישות ServiceArea אם ישות ה-Service המשויכת ל-serviceType מוגדרת כ-'Deliver'
|
יש לוודא שלמזהה ישות השירות שמצוין בהודעת השגיאה יש ישות ServiceArea שמוגדרת כראוי. |
נתונים חסרים – streetAddress
חסר שדה חובה streetAddress בקלט.
|
השדה streetAddress הוא שדה חובה, והוא חסר בישות מסעדה
|
צריך למצוא את הישות מסעדה לפי המזהה שמצוין בתיאור השגיאה, ולבדוק אם השדה streetAddress אינו מחרוזת ריקה
|
| ישות לא עדכנית | במהלך הטמעת הנתונים של פיד הנתונים, התכונה 'סידור מקצה לקצה' של הנתונים משווה בין חותמת הזמן של התאריך המתוקן של כל ישות נכנסת לבין חותמות הזמן של ישויות שעברו הטמעת נתונים קודם לכן. הישות הנכנסת תסומן כלא פעילה, אלא אם הישות בפידים של הנתונים חדשה יותר. | עבור כל מזהי הישויות שמוזכרים בתיאור השגיאה, Google צריכה לוודא שחותמת הזמן בפיד הנתונים חדשה יותר מחותמת הזמן שהוגדרה בעדכונים הקודמים של הישויות שנשלחו אל Google. להבהרות נוספות, אפשר לעיין במאמר בנושא ניהול גרסאות של ישויות. |