סקירה כללית
הכלי לצפייה במלאי ב-Actions Center מאפשר לכם לראות את תקינות הטמעת הנתונים, את סטטוס ההתאמה למקום ואת הזכאות להצגת המלאי בחנויות המקומיות של נקודות העניין (POI).
בכלי הזה מוצגות בעיות שלא קשורות להטמעות ספציפיות – בעיות שקשורות למצב הפעיל של הצגת המודעות של כל ספק שירות, כולל כל מצבי הכשל האפשריים (מדיניות, אזהרות, שגיאות וכו') שעלולים להתרחש.
היעזר בכלי זה כדי:
- לחפש ולבדוק את כל ספקי השירות שנטמעו ואת סטטוס ההצגה שלהם בזמן אמת.
- לאבחן שגיאות באימות נתונים והפרות של מדיניות התוכן.
- לשלוח ערעורים על הפרות מדיניות ולעקוב אחריהם.
- לבדוק את נתוני האבחון של ההתאמה לספק השירות ולשלוח הצעות להתאמה ידנית.
- בודקים את מטעני ה-JSON הייעודיים הגולמיים מהטמעות הנתונים האחרונות של הפיד.
עמודות בטבלת המלאי
בתצוגת הרשימה מוצגים כל ספקי השירות שהועלו מהפיד של נקודות העניין (POI), והם מאורגנים בהיררכיה לפי ישות. אפשר לסנן לפי מזהה נקודת עניין מקומית, סטטוס התאמה, שילוב ופלטפורמה.
| עמודות בטבלת הסיכום | תיאור |
|---|---|
| מזהה נקודת עניין מקומית | המזהה הייחודי של הנכס המקומי שצוין בפיד (poi_id). |
| שם נקודת העניין בשפת המקום | השם המותאם לשוק המקומי של המאפיין המקומי שחולץ מהפיד. |
| סטטוס התאמה | מציין אם נקודת העניין הותאמה לדף עסקי במפות Google: • כן (תג ירוק): הותאמה בהצלחה למקום במפות Google. • לא (תג אדום): אין התאמה. נדרשת בדיקה או הצעה להתאמה. |
| שילוב | זהו שילוב של ריכוז קישורים לאתרי אגרגטור מקומיים. |
| משטח | פלטפורמת היעד להצגת המודעות (למשל, חיפוש). |
| סטטוס הצגה | סטטוס הכשירות להצגה בזמן אמת: • מופעל (אינדיקטור ירוק): כשיר ומוצג בפועל בפלטפורמות של Google. • מושבת (אינדיקטור אדום): המודעה חסומה להצגה בגלל שגיאות אימות, הפרות מדיניות או סטטוס לא תואם. |
| שגיאות | מספר הבעיות הפעילות ברמת חומרה "שגיאה". אם יש שגיאה כלשהי בנכס, הוא לא יוכל להופיע באף פלטפורמה. |
| אזהרות | מספר הבעיות הפעילות ברמת חומרה "אזהרה". נכסים עם אזהרות עדיין כשירים להצגה. |
| פרטי ההתאמה | מכיל את הלחצן "עריכת ההתאמה", שפותח את חלונית התיקון האינטראקטיבי של ההתאמה. |
תצוגת פרטים של נקודת עניין
לחיצה על מזהה נקודת עניין בתצוגת הרשימה תעביר אתכם לדף הפרטים הייעודי של הישות.
תצוגת הפרטים כוללת ארבעה קטעים שאפשר להרחיב:
1. מידע בסיסי
מסכם את המטא-נתונים של הישות ברמה העליונה:
- POI Name: שם העסק כפי שנותח מ-
data[].name.localizations. - POI ID: מזהה ייחודי של ישות השותף (
poi_id). - מקור נתונים: שם הקובץ המדויק של הפיד שממנו הוטמעה הישות הזו.
2. מצב הגשה
פירוט של הכשירות להצגה לפי שילוב ופלטפורמת יעד:
- שילוב ופלטפורמה: הענף ופלטפורמת היעד (למשל,
Local Aggregator Unitב-Search). - סטטוס הצגת המודעות: הסטטוס הנוכחי של
EnabledאוDisabled. - בעיות: תגים של כל השגיאות או האזהרות הפעילות (למשל,
Unmatched entity,Policy Violation). לחיצה על תג של בעיה פותחת את חלונית פרטי הבעיה. - ערעורים: הצגת מצבי ביטול או ערעור (
Under review,ApprovedאוRejected).
3. מידע על ההתאמה
הצגת אבחון של התאמת מקומות:
- קלט תואם: הכתובת הפיזית המעוצבת שנותחה מהפיד (
street_address, locality, region, postal_code, country). - סוג ההתאמה: מנגנון ההתאמה (למשל,
Location). - מרחב השמות של ההתאמה: הענף שבו השינויים בהתאמה יחולו (למשל,
Local Aggregator Unit). - סטטוס התאמה:
Yes(ירוק) אוNo(אדום). - פלט ההתאמה: שם המקום, הכתובת ומזהה המקום במפות Google.
- עריכת ההתאמה: כפתור לפתיחת תיבת הדו-שיח של הצעת ההתאמה.
4. JSON גולמי
מציג קוד אינטראקטיבי עם מספרי שורות והדגשת תחביר, שמציג את המטען הייעודי (payload) המלא של ה-JSON המנותח (item_proto) כדי לאפשר ניפוי באגים ואימות מהירים של הסכימה. ערכי הנתונים שמוצגים כאן ישקפו את הערכים שהתקבלו מהפיד של נקודות העניין.
תהליך העבודה לטיפול בבעיות וקביעת סדר עדיפויות
ישויות שסומנו עם בעיות הן מושבתות (אם סומנו עם ERROR) או מופחתות (אם סומנו עם WARNING). אי אפשר לערער על בעיות בישויות שמוצגות עם אזהרה. כדי לפתור את האזהרות, צריך לתקן את הבעיה הבסיסית.
סוגי בעיות: בעיות שאפשר לערער עליהן לעומת בעיות שאי אפשר לערער עליהן
- בעיות שלא ניתן לערער עליהן (בעיות טכניות, בעיות שקשורות לאיכות הנתונים ואימות אזהרות):
- השגיאות האלה נגרמות בגלל שגיאות בסכימה, שדות חובה חסרים, קואורדינטות לא תקינות, כתובות URL לא תקינות, מזהים כפולים או אזהרות תוכן שלא חוסמות את ההעלאה (כמו שמות של עסקים בשפות שאינן ברירת המחדל, או שפות כלשהן לתיאורים, כתובות לתצוגה וקטגוריות של מוסדות).
- פתרון: השותפים צריכים לתקן את הנתונים הבסיסיים בפיד המקור ולהעלות קובץ פיד מעודכן.
- בעיות שאפשר לערער עליהן (חסימת תוכן והפרות מדיניות):
- האירוע מופעל כשנכסי תמונות או טקסט נדרשים של נכס נכשלים בבדיקה של מסנני בטיחות תוכן אוטומטיים, עם חומרה מסוג ERROR.
- פתרון: אם התוכן עומד בדרישות המדיניות של הפלטפורמה, השותפים יכולים ללחוץ על הכפתור ערעור לצד הבעיה במרכז הפעולות כדי לשלוח ערעור. השותפים צריכים לספק סיבה והצדקה, וצוות הערעורים שלנו יבדוק ויאשר או ידחה את הבקשות. תקבלו הודעה באימייל ובכלי לגבי ההחלטות שהתקבלו.
קטלוג הבעיות ביחידת ריכוז קישורים לאתרי אגרגטור מקומי
בטבלה הבאה מפורטים כל קודי השגיאות באימות וקודי הבעיות שקשורות למדיניות בשילובים של יחידות ריכוז קישורים לאתרי אגרגטור מקומי:
| תיאור הבעיה | מידת החומרה | קוד הבעיה | השדה או הארגומנטים המושפעים | האם אפשר לערער? | פעולה / מדיניות רלוונטית |
|---|---|---|---|---|---|
| חסר מזהה נקודת עניין | ERROR | MISSING_REQUIRED_FIELD
|
poi_id
|
לא | צריך לספק poi_id ייחודי. אפשר למצוא פרטים נוספים במפרט הפיד של נקודות העניין. |
| חסרה הגדרת ברירת מחדל של לוקאל בשדה "name" | ERROR | MISSING_REQUIRED_FIELD
|
name.default_locale
|
לא | צריך לציין קוד שפה תקין בתקן BCP 47 בשביל הלוקאל שמוגדר כברירת מחדל. תמיכה בשפות שונות |
| לא נמצאה לוקליזציה שמוגדרת כברירת מחדל לשדה "name" | ERROR | MISSING_REQUIRED_FIELD
|
name.localizations
|
לא | צריך לציין ערך לשם המותאם לשוק המקומי של נקודת העניין שתואם לשפה default_locale שהוצהרה.
|
| חסרה הגדרת ברירת מחדל של השפה בשדה description | ERROR | MISSING_REQUIRED_FIELD
|
description.default_locale
|
לא | צריך לציין לוקאל תקין שמוגדר כברירת מחדל לפי תקן BCP 47 לתיאור הנכס. |
| לא נמצאה לוקליזציה לברירת המחדל בשדה "description" | ERROR | MISSING_REQUIRED_FIELD
|
description.localizations
|
לא | צריך לספק טקסט תיאור שתואם לשפה המוצהרת של default_locale.
|
| חסרה הגדרת ברירת מחדל של מיקום גיאוגרפי בשדה display_address | ERROR | MISSING_REQUIRED_FIELD
|
display_address.default_locale
|
לא | צריך לציין לוקאל ברירת מחדל תקין לפי תקן BCP 47 לכתובת לתצוגה. |
| לא נמצאה לוקליזציה שמוגדרת כברירת מחדל לשדה display_address | ERROR | MISSING_REQUIRED_FIELD
|
display_address.localizations
|
לא | צריך להזין טקסט של כתובת בפורמט שתואם לשפה default_locale שהוצהרה.
|
| חריגה ממספר התמונות המקסימלי | אזהרה | EXCEEDED_MAX_COUNT
|
images
|
לא | אפשר להוסיף עד 5 תמונות לכל נקודת עניין. תמונות עודפות יוסרו. |
| קואורדינטת קו רוחב לא תקינה | ERROR | INVALID_LATLNG
|
location.latitude
|
לא | צריך להזין קו רוחב תקין בין -90.0 ל-+90.0. הגדרה של קואורדינטות
|
| קואורדינטת קו אורך לא תקינה | ERROR | INVALID_LATLNG
|
location.longitude
|
לא | צריך להזין קו אורך תקין בין -180.0 ל-+180.0. הגדרה של קואורדינטות
|
| חסר קו רוחב | ERROR | MISSING_REQUIRED_FIELD
|
location.latitude
|
לא | כדי להשלים את צמד הקואורדינטות, צריך לציין את ערך קו הרוחב. הגדרה של קואורדינטות |
| חסר קו אורך בקואורדינטה | ERROR | MISSING_REQUIRED_FIELD
|
location.longitude
|
לא | כדי להשלים את זוג הקואורדינטות, צריך לספק את הערך של קו האורך. הגדרה של קואורדינטות |
| כתובת חסרה או לא מובנית | ERROR | MISSING_REQUIRED_FIELD
|
location.address
|
לא | צריך לציין כתובת דואר מובנית, כולל רחוב, יישוב, מיקוד ומדינה. |
| פורמט שגוי או כתובת URL לא תקינה | ERROR | INVALID_ATTRIBUTE_VALUE
|
url
|
לא | מוודאים שכתובת דף הנחיתה משתמשת בפרוטוקול HTTP/HTTPS נתמך ובתחביר תקין. |
| תמונה לא תקינה או שאי אפשר לגשת אליה | אזהרה | INVALID_IMAGE
|
image.url
|
לא | מוודאים שכתובות ה-URL של התמונות נגישות לכולם, לא דורשות אימות ולא מחזירות שגיאות 4xx או 5xx. |
| מזהה כפול של נקודת עניין | ERROR | DUPLICATE_ENTITY
|
poi_id
|
לא | צריך לוודא שכל poi_id הוא ייחודי בכל המטען הייעודי (payload) של הפיד. צריך להסיר את הכפילויות.
|
| ישות תואמת כפולה | ERROR | DUPLICATE_MATCHED_ENTITY
|
POI
|
לא | מסירים רשומות כפולות מהפיד, או משתמשים בכלי התאמת ישויות של נקודות עניין כדי להתאים עסקים נפרדים לדפים העצמאיים שלהם במפות Google. |
| ישות ללא התאמה | ERROR | UNMATCHED_ENTITY
|
POI
|
לא | מתאימים את נקודת העניין לדף עסקי במפות Google באמצעות הכלי POI Entity Matching. |
| הפרת המדיניות בנושא תמונות | ERROR | SAFE_SEARCH_POLICY_VIOLATION_IMAGE
|
image
|
כן | מסירים או מחליפים את התמונה שסומנה, או לוחצים על ערעור כדי לשלוח הסבר. לעיון במדיניות התוכן של חיפוש Google בנושא תמונות |
| הפרת מדיניות בנושא טקסט – שם ברירת המחדל | ERROR | SAFE_SEARCH_POLICY_VIOLATION_TEXT
|
name.localizations.*.text
|
כן | מסירים או מחליפים את הטקסט של השם שסומן, או לוחצים על ערעור. מדיניות התוכן של חיפוש Google |
| הפרת מדיניות בנושא טקסט – שם לא שגרתי | אזהרה | SAFE_SEARCH_POLICY_VIOLATION_TEXT
|
name.localizations.*.text
|
לא | הסירו או החליפו את הטקסט שסומן. מדיניות התוכן של חיפוש Google |
| הפרת מדיניות בנושא טקסט – תיאור | אזהרה | SAFE_SEARCH_POLICY_VIOLATION_TEXT
|
description.localizations.*.text
|
לא | צריך להסיר או להחליף את הטקסט שסומן בתיאור. מדיניות התוכן של חיפוש Google |
| הפרת מדיניות בנושא טקסט – כתובת לתצוגה | אזהרה | SAFE_SEARCH_POLICY_VIOLATION_TEXT
|
display_address.localizations.*.text
|
לא | צריך להסיר או להחליף את הטקסט שסומן בכתובת לתצוגה. מדיניות התוכן של חיפוש Google |
| חסרה הגדרת ברירת מחדל של מיקום גיאוגרפי לקטגוריית המוסד | ERROR | MISSING_REQUIRED_FIELD
|
local_data.establishment_category.default_locale
|
לא | צריך לציין ערך לקטגוריית העסק המקומית של נקודת העניין שתואמת לשפה default_locale שהוצהרה.
|
| חסר יום פתיחה בשעות הפעילות | ERROR | MISSING_REQUIRED_FIELD
|
local_data.business_hours.time_ranges.open_day
|
לא | צריך לציין יום פתיחה תקין בשעות הפעילות. |
| חסרה שעת פתיחה בשעות הפעילות | ERROR | MISSING_REQUIRED_FIELD
|
local_data.business_hours.time_ranges.open_time
|
לא | צריך לציין שעת פתיחה תקינה. |
| חסר יום סגירה בשעות הפעילות | ERROR | MISSING_REQUIRED_FIELD
|
local_data.business_hours.time_ranges.close_day
|
לא | צריך לציין יום סגירה תקין בשעות הפעילות. |
| חסרה שעת סגירה בשעות הפעילות | ERROR | MISSING_REQUIRED_FIELD
|
local_data.business_hours.time_ranges.close_time
|
לא | צריך לציין שעת סגירה תקינה. |
| שעת הפתיחה של העסק מאוחרת משעת הסגירה | ERROR | NOT_LESS_THAN_FIELD
|
local_data.business_hours.time_ranges.open_time,
local_data.business_hours.time_ranges.close_time
|
לא | צריך לציין צמד תקין של שעת פתיחה ושעת סגירה, ולוודא ששעת הפתיחה מוקדמת משעת הסגירה. |
| הערך המינימלי של טווח המחירים גדול מהערך המקסימלי | ERROR | INVALID_PRICE_RANGE
|
local_data.price_range.min_price,
local_data.price_range.max_price
|
לא | צריך לציין טווח מחירים תקין, שבו המחיר המינימלי נמוך מהמחיר המקסימלי. |
| חסר מזהה מותג | ERROR | MISSING_REQUIRED_FIELD
|
local_data.brand_landing_pages.brand_id
|
לא | צריך לציין מזהה מותג תקין. |
| מזהה מותג כפול בתוך נקודת עניין | ERROR | DUPLICATE_UNIQUE_PROPERTY
|
local_data.brand_landing_pages.brand_id
|
לא | צריך לוודא שכל brand_id הוא ייחודי במטען הייעודי (payload) של נקודת העניין. צריך להסיר את הכפילויות.
|
| חסרה כתובת ה-URL שמוגדרת כברירת מחדל למותג | ERROR | MISSING_REQUIRED_FIELD
|
local_data.brand_landing_pages.default_url
|
לא | צריך להזין כתובת URL תקינה שמוגדרת כברירת המחדל של המותג. |
| כתובת URL של מותג בפורמט שגוי או לא תקין | ERROR | INVALID_ATTRIBUTE_VALUE
|
local_data.brand_landing_pages.default_url
|
לא | מוודאים שכתובת ה-URL שמוגדרת כברירת המחדל של המותג משתמשת בפרוטוקול HTTP או HTTPS נתמך ובתחביר תקין. |
| חסרה כתובת דף נחיתה מקומי של המותג | ERROR | MISSING_REQUIRED_FIELD
|
local_data.brand_landing_pages.localized_landing_pages.url
|
לא | צריך לציין כתובת URL תקינה של דף הנחיתה המותאם לשוק המקומי. |
| כתובת דף הנחיתה המותאם לשוק המקומי של המותג לא תקינה או בפורמט שגוי | ERROR | INVALID_ATTRIBUTE_VALUE
|
local_data.brand_landing_pages.localized_landing_pages.url
|
לא | מוודאים שכתובת דף הנחיתה המותאם לשוק המקומי משתמשת בפרוטוקול HTTP/HTTPS נתמך ובתחביר תקין. |
| כתובת URL כפולה של דף נחיתה מקומי של המותג | ERROR | DUPLICATE_UNIQUE_PROPERTY
|
local_data.brand_landing_pages.localized_landing_pages.url
|
לא | צריך לוודא שכל url הוא ייחודי בכל דפי הנחיתה המותאמים לשוק המקומי של נקודות העניין. צריך להסיר את הכפילויות.
|
| חסר לוקאל של דף נחיתה מקומי של המותג | ERROR | MISSING_REQUIRED_FIELD
|
local_data.brand_landing_pages.localized_landing_pages.locales
|
לא | צריך לספק קבוצה תקינה של הגדרות מיקום לדף הנחיתה המותאם לשוק המקומי. |
| שפה ואזור כפולים בדף הנחיתה המקומי של המותג | ERROR | DUPLICATE_UNIQUE_PROPERTY
|
local_data.brand_landing_pages.localized_landing_pages.locales
|
לא | צריך לוודא שכל locale הוא ייחודי בכל דפי הנחיתה המותאמים לנקודות עניין. צריך להסיר את הכפילויות.
|
| הפרת מדיניות בנושא טקסט – קטגוריית העסק | אזהרה | SAFE_SEARCH_POLICY_VIOLATION_TEXT
|
local_data.establishment_category.localizations.*.text
|
לא | צריך להסיר או להחליף את הטקסט שסומן בקטגוריית העסק. מדיניות התוכן של חיפוש Google |
קודי בעיות
בקטעים הבאים מפורטים הגורמים והשלבים לפתרון של כל קוד בעיה.
חסר שדה חובה
קוד הבעיה: MISSING_REQUIRED_FIELD
חומרה: שגיאה (חוסמת את הצגת המודעות)
אפשרות לערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את פיד נקודות העניין)
השגיאה הזו קורית כשישות שנטמעה חסרה מאפיין חובה אחד או יותר שנדרש לפי מפרט הפיד של נקודות עניין.
בודקים בחלונית פרטי הבעיה איזה מאפיין חסר, ואז מיישמים את התיקון המתאים:
1. חסר מזהה נקודת עניין (poi_id)
- הסיבה: השדה
poi_idריק, מכיל ערך null או חסר באובייקט של ישות השורש. - תיקון: צריך לספק מזהה מחרוזת ייחודי וקבוע לנכס.
{
"poi_id": "test_restaurant_1"
}
2. חסר שם מקומי או לוקאל ברירת מחדל (name)
- הסיבה: באובייקט
nameחסרה המחרוזתdefault_localeאו המערךlocalizationsעם לוקאל תואם. - תיקון: צריך לספק גם את
default_localeוגם לפחות רשומת לוקליזציה אחת שתואמת ללוקאל הזה.
{
"name": {
"localizations": [
{
"locale": "en",
"text": "Tasty Bites Test Restaurant"
}
],
"default_locale": "en"
}
}
3. חסרה כתובת מקומית או כתובת ברירת מחדל (display_address)
- הסיבה: באובייקט
display_addressחסרה המחרוזתdefault_localeאו המערךlocalizations. - תיקון: צריך לספק גם את
default_localeוגם לפחות רשומת לוקליזציה אחת שתואמת ללוקאל הזה עבור הכתובת המעוצבת.
{
"display_address": {
"localizations": [
{
"locale": "en",
"text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
}
],
"default_locale": "en"
}
}
4. חסר תיאור מותאם לשוק המקומי או לוקאל ברירת מחדל (description)
- הסיבה: כשהאובייקט
descriptionנכלל, חסרdefault_localeאו חסרה ההתאמה לשוק המקומי. - תיקון: צריך לספק גם את
default_localeוגם לפחות רשומת לוקליזציה אחת שתואמת ללוקאל הזה בשביל התיאור.
{
"description": {
"localizations": [
{
"locale": "en",
"text": "A mock restaurant for testing the POI feed ingestion."
}
],
"default_locale": "en"
}
}
5. חסרות קואורדינטות גיאוגרפיות (location.latitude מתוך location.longitude)
- הסיבה: באובייקט
locationחסר הערך המספרי שלlatitudeאו שלlongitude. - תיקון: צריך לציין את
latitudeוגם אתlongitudeכמספרים בנקודה צפה במעלות עשרוניות רגילות של WGS84.
{
"location": {
"latitude": 37.422,
"longitude": -122.084
}
}
6. חסרה כתובת דואר מובנית (location.address)
- הסיבה: באובייקט
location.addressחסרים רכיבי כתובת חובה (country,localityאוpostal_code). - תיקון: מאכלסים את אובייקט הכתובת המובנית למשלוח דואר בהתאם לתקני ISO.
{
"location": {
"address": {
"country": "US",
"locality": "Mountain View",
"postal_code": "94043",
"street_address": "1600 Amphitheatre Pkwy"
}
}
}
7. חסרה הגדרת ברירת מחדל של שפה ואזור לקטגוריית המוסד (local_data.establishment_category.default_locale)
- הסיבה: האובייקט
local_data.establishment_categoryקיים, אבלdefault_localeחסר, ריק או לא תואם לאף רשומה במערךlocalizations. - תיקון: צריך לציין תג שפה חוקי של BCP 47 עבור
default_localeולספק לפחות מחרוזת אחת שמותאמת לשפה המקומית שתואמת ללוקאל הזה.
{
"local_data": {
"establishment_category": {
"default_locale": "en",
"localizations": [
{
"locale": "en",
"text": "Restaurant"
}
]
}
}
}
8. חסר יום פתיחה בשעות הפעילות (local_data.business_hours.time_ranges.open_day)
- הסיבה: חסרה רשומה ב-
local_data.business_hours.time_ranges,open_dayאו שהיא מוגדרת כ-DAY_OF_WEEK_UNSPECIFIED. - תיקון: צריך לציין מחרוזת תקינה של יום בשבוע (למשל,
"MONDAY","TUESDAY"וכו').
{
"local_data": {
"business_hours": {
"time_ranges": [
{
"open_day": "MONDAY",
"open_time": { "hours": 11, "minutes": 0 },
"close_day": "MONDAY",
"close_time": { "hours": 21, "minutes": 0 }
}
]
}
}
}
9. חסרה שעת פתיחה (local_data.business_hours.time_ranges.open_time)
- הסיבה: ברשומה ב-
local_data.business_hours.time_rangesחסר האובייקטopen_time. - תיקון: מציינים את
open_timeעםhours(0-23) ו-minutes(0-59).
{
"local_data": {
"business_hours": {
"time_ranges": [
{
"open_day": "MONDAY",
"open_time": { "hours": 11, "minutes": 0 },
"close_day": "MONDAY",
"close_time": { "hours": 21, "minutes": 0 }
}
]
}
}
}
10. חסר יום הסגירה של שעות הפעילות (local_data.business_hours.time_ranges.close_day)
- הסיבה: חסרה רשומה ב-
local_data.business_hours.time_ranges, או שהיא מוגדרת כ-DAY_OF_WEEK_UNSPECIFIED.close_day - תיקון: צריך לציין מחרוזת תקינה של יום בשבוע (למשל,
"MONDAY","TUESDAY"וכו').
{
"local_data": {
"business_hours": {
"time_ranges": [
{
"open_day": "MONDAY",
"open_time": { "hours": 11, "minutes": 0 },
"close_day": "MONDAY",
"close_time": { "hours": 21, "minutes": 0 }
}
]
}
}
}
11. חסרה שעת הסגירה של העסק (local_data.business_hours.time_ranges.close_time)
- הסיבה: ברשומה ב-
local_data.business_hours.time_rangesחסר האובייקטclose_time. - תיקון: מציינים את
close_timeעםhours(0-23) ו-minutes(0-59).
{
"local_data": {
"business_hours": {
"time_ranges": [
{
"open_day": "MONDAY",
"open_time": { "hours": 11, "minutes": 0 },
"close_day": "MONDAY",
"close_time": { "hours": 21, "minutes": 0 }
}
]
}
}
}
12. מזהה המותג חסר (local_data.brand_landing_pages.brand_id)
- הסיבה: רשומה ב-
local_data.brand_landing_pagesמכילה ערך ריק, ערך null או שחסר בה ערךbrand_id. - הפתרון: צריך לספק מזהה מחרוזת לא ריק שתואם להגדרת המותג של השותף הרשום.
{
"local_data": {
"brand_landing_pages": [
{
"brand_id": "tasty_bites_brand",
"default_url": "https://www.tastybitestest.com"
}
]
}
}
13. חסרה כתובת ה-URL שמוגדרת כברירת מחדל של המותג (local_data.brand_landing_pages.default_url)
- הסיבה: חסר ערך ב-
local_data.brand_landing_pagesdefault_urlאו שהערך הוא מחרוזת ריקה. - תיקון: צריך לספק כתובת URL חלופית תקינה של דף נחיתה מסוג HTTP או HTTPS למשתמשים שהמיקום שלהם לא תואם לכתובות ה-URL המותאמות לשוק המקומי.
{
"local_data": {
"brand_landing_pages": [
{
"brand_id": "tasty_bites_brand",
"default_url": "https://www.tastybitestest.com"
}
]
}
}
14. חסרה כתובת דף נחיתה מקומי של המותג (local_data.brand_landing_pages.localized_landing_pages.url)
- הסיבה: פריט בתוך
localized_landing_pagesמכיל שדהurlחסר או ריק. - פתרון: צריך לספק כתובת URL תקינה ומלאה מסוג HTTP או HTTPS של דף הנחיתה המותאם לשוק המקומי.
{
"local_data": {
"brand_landing_pages": [
{
"brand_id": "tasty_bites_brand",
"default_url": "https://www.tastybitestest.com",
"localized_landing_pages": [
{
"url": "https://www.tastybitestest.com/en",
"locales": ["en-US", "en-GB"]
}
]
}
]
}
}
15. חסר לוקאל של דף נחיתה מקומי של המותג (local_data.brand_landing_pages.localized_landing_pages.locales)
- הסיבה: בפריט בתוך
localized_landing_pagesחסר מערךlocalesאו שהוא ריק. - תיקון: צריך לציין לפחות קוד אחד תקין של שפה או לוקאל בתקן BCP 47 (למשל,
["en-US"]) במערךlocales.
{
"local_data": {
"brand_landing_pages": [
{
"brand_id": "tasty_bites_brand",
"default_url": "https://www.tastybitestest.com",
"localized_landing_pages": [
{
"url": "https://www.tastybitestest.com/en",
"locales": ["en-US", "en-GB"]
}
]
}
]
}
}
חרגת ממספר התמונות המקסימלי
קוד הבעיה: EXCEEDED_MAX_COUNT
חומרה: אזהרה
אפשרות ערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את המטען הייעודי (payload) של הפיד)
השגיאה הזו קורית כשמטען הייעודי (payload) של ישות נקודת עניין מכיל יותר מ-5 אובייקטים של תמונות במערך images.
תיקון:
- צמצמו את המערך
imagesכך שיכיל עד 5 תמונות איכותיות שמייצגות את הנכס המקומי. - אם תעלו יותר מ-5 תמונות, המערכת תמחק את התמונות הנוספות.
קואורדינטות גיאוגרפיות לא תקינות
קוד הבעיה: INVALID_LATLNG
חומרה: שגיאה (חוסמת את הצגת המודעות)
אפשרות לערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את המטען הייעודי (payload) של הפיד)
השגיאה הזו מתרחשת כשהקואורדינטות הגיאוגרפיות שצוינו ב-location.latitude או ב-location.longitude נמצאות מחוץ לגבולות הכדוריים החוקיים, או מייצגות קואורדינטות ריקות לא מאוכלסות.
סיבות נפוצות ופתרונות:
- קו רוחב מחוץ לטווח: קו הרוחב חייב להיות מספר נקודה צפה (floating-point) בין
-90.0ל-90.0, כולל. - קו אורך מחוץ לטווח: קו האורך חייב להיות מספר נקודה צפה (floating-point) בין
-180.0ל-180.0, כולל. - Null Island (0,0): אם תשלחו
0.0, 0.0או מספרים שלמים של פלייסהולדר (כמו999, 999), הקואורדינטות יידחו. - קואורדינטות הפוכות: ודאו שקו הרוחב וקו האורך לא הפוכים בצינור עיבוד הנתונים של הסדרה.
דוגמה למטען ייעודי (payload) תקין:
{
"location": {
"latitude": 37.422,
"longitude": -122.084
}
}
כתובת URL לא תקינה או לא חוקית
קוד הבעיה: INVALID_ATTRIBUTE_VALUE
חומרה: שגיאה (חוסמת את הצגת המודעות)
אפשרות לערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את המטען הייעודי (payload) של הפיד)
השגיאה הזו מתרחשת כשערך של מאפיין נכשל באימות הסכימה, בדרך כלל כשכתובת דף הנחיתה או כתובת ה-URL של התמונה של השותף לא תקינה מבחינה תחבירית.
דרישות:
- פרוטוקול: כתובות URL חייבות לציין במפורש את
http://אוhttps://(מומלץ מאוד להשתמש ב-HTTPS). - קידוד: כתובות URL שמכילות תווים מיוחדים, רווחים או תווים שאינם תווי ASCII חייבות להיות מקודדות באחוזים בצורה תקינה (RFC 3986).
- דומיין קנוני: ודאו שהדומיין מוגדר במלואו (לדוגמה,
https://example.com/local/123, ולאexample.com/local/123אוwww.example).
דוגמה למטען ייעודי (payload) תקין:
{
"url": "https://www.tastybitestest.com/en"
}
תמונה לא תקינה או לא נגישה
קוד הבעיה: INVALID_IMAGE
חומרה: אזהרה
אפשרות ערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את המטען הייעודי (payload) של הפיד)
האזהרה הזו מופיעה בשלב של אחזור התמונות האסינכרוני, כשהסורק של Google לא יכול להוריד, לפענח או לאמת את נכס המדיה מ-image.url.
התמונה הלא תקינה תושמט, אבל הנכס עדיין יוכל להופיע.
סיבות נפוצות ופתרונות:
- שגיאות HTTP (404 / 403 / 500): כתובת ה-URL של התמונה מחזירה קוד סטטוס HTTP שאינו 200. חשוב לוודא שהתמונות נגישות לכולם בלי אימות, חומות קובצי Cookie או הגבלות של רשימת כתובות IP מותרות.
- חסימה של קובץ robots.txt: מוודאים שהרשת להעברת תוכן (CDN) מאפשרת את סוכני המשתמש
Googlebotו-Googlebot-Image. - פורמט קובץ לא נתמך: התמונות צריכות להיות בפורמטים רגילים של רסטר (
JPEG,PNG,WebP). אין תמיכה בקובצי GIF מונפשים, בקובצי SVG ובפורמטים של מצלמה גולמית. פרטים נוספים זמינים בהנחיות בנוגע לתמונות. - כשלים באישור SSL: ודאו שלשרת המארח של התמונות יש שרשרת אישורי SSL תקינה.
מזהה כפול של נקודת עניין
קוד הבעיה: DUPLICATE_ENTITY
חומרה: שגיאה (חוסמת את הצגת המודעות)
אפשרות לערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את המטען הייעודי (payload) של הפיד)
השגיאה הזו קורית כשאותה מחרוזת poi_id מופיעה יותר מפעם אחת בתוך קבוצת קבצים של פיד אחד.
תיקון:
- מוודאים שלכל דף עסקי מקומי בפיד יש
poi_idייחודי ודטרמיניסטי. - אם למלון מקומי יש כמה סוגי חדרים או תעריפים, צריך לאחד אותם תחת ישות שורש אחת של נקודת עניין, במקום ליצור רשומות כפולות של ישויות עם מזהים זהים.
ישות תואמת כפולה
קוד הבעיה: DUPLICATE_MATCHED_ENTITY
חומרה: שגיאה (חוסמת את הצגת המודעות)
אפשרות לערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את המטען הייעודי (payload) של הפיד או להשתמש בכלים להתאמת ישויות של נקודות עניין)
השגיאה הזו מתרחשת כששתי רשומות poi_id נפרדות או יותר בפיד תואמות לאותו דף מקום קנוני במפות Google. אם כמה עסקים ממופים לאותה ישות ב-Google, כל הרשומות המתנגשות נחסמות להצגה עד שהכפילות נפתרת.
איך לפתור את הבעיה:
- זיהוי הנכסים המתנגשים: פותחים את Ingestion Viewer (הטמעה > היסטוריה), בוחרים את הרצת ההטמעה האחרונה ומרחיבים את החלונית Validations. לוחצים על השורה של
DUPLICATE_MATCHED_ENTITYשמשתפת את אותו מזהה קבוצה של Issue Info כדי לראות את כל הרשומות שלpoi_idשתואמות לאותה ישות ב-Google. - הסרת רשומות כפולות מהפיד: אם הרשומות המתנגשות של
poi_idמייצגות את אותו מיקום פיזי של העסק, צריך להסיר את הרשומות הכפולות מהפיד כדי שתישלח רק רשומה אחת שלpoi_idלאותו עסק. - תיקון התאמות שגויות של עסקים עצמאיים: אם הרשומות המתנגשות ב-
poi_idמייצגות עסקים נפרדים ועצמאיים שהותאמו בטעות לאותה ישות ב-Google, פותחים את העסק שהותאם בטעות בתצוגת המלאי ולוחצים על עריכת ההתאמה כדי לבחור או להציע את דף המקום הייעודי במפות Google. הוראות מפורטות זמינות במדריך התאמת ישויות של נקודות עניין.
ישות לא תואמת
קוד הבעיה: UNMATCHED_ENTITY
חומרה: שגיאה (חוסמת את הצגת המודעות)
אפשרות לערעור: לא (צריך להשתמש בכלים להתאמת ישויות של נקודות עניין או לתקן את המטא-נתונים של הישות)
הבעיה הזו מצביעה על כך שתהליך ההתאמה של Google לא הצליח להתאים בין הדף העסקי המקומי שלכם לבין מקום קנוני במפות Google.
איך לפתור את הבעיה:
- אימות מאפייני הליבה: מוודאים שהמאפיינים
name,display_address,location.address,url,telephoneו-location.latitude/location.longitudeשל המיקום משקפים במדויק את המיקום הפיזי של הנכס. - בדיקת פרטי ההתאמה: בעמודה פרטי התאמה בתצוגת המלאי אפשר לראות מקומות מועמדים.
- משתמשים בכלי לתיקון התאמות של נקודות עניין: לוחצים על עריכת ההתאמה ב-Actions Center כדי לחפש ידנית את מזהה המקום הנכון ב-Google ולאשר אותו. הוראות מפורטות זמינות במדריך התאמת ישויות של נקודות עניין.
הפרת המדיניות בנושא תמונות בחיפוש Google
קוד הבעיה: SAFE_SEARCH_POLICY_VIOLATION_IMAGE
חומרה: שגיאה (חוסמת את הצגת המודעות)
אפשר לערער: כן
קודים רלוונטיים של בעיות שקשורות למדיניות: מדיניות התוכן של חיפוש Google בנושא תמונות
אם לדעתכם התמונה סומנה בטעות (תוצאה חיובית כוזבת), לוחצים על יצירת ערעור בחלונית פרטי הבעיה.
הפרת המדיניות בנושא טקסט בתוכן של חיפוש Google – שם
קוד הבעיה: SAFE_SEARCH_POLICY_VIOLATION_TEXT
חומרה: החומרה משתנה בהתאם לשדה (פרטים בהמשך)
השדה המושפע: name.localizations.*.text
אפשר לערער: כן (שגיאה בלוקאל שמוגדר כברירת מחדל בלבד); לא (אזהרה בלוקאל שלא מוגדר כברירת מחדל)
- ברירת המחדל של השפה והאזור (
name.default_locale): שגיאה (חוסמת את הצגת המודעות). כל נקודת העניין חסומה להצגה. אם לדעתכם הטקסט של שם ברירת המחדל של הלוקאל סומן בטעות (תוצאה חיובית כוזבת), לחצו על יצירת ערעור בחלונית פרטי הבעיה. - לוקאל שאינו ברירת מחדל: אזהרה (לא חוסמת את הצגת המודעות). רק הלוקליזציה שסומנה תושמט, ונקודת העניין תמשיך להיות כשירה להצגה. אי אפשר לערער על אזהרות בלוקאלים שאינם ברירת המחדל, ואפשר לפתור אותן על ידי עדכון המטען הייעודי (payload) של הפיד.
קודים רלוונטיים של בעיות שקשורות למדיניות: מדיניות התוכן של חיפוש Google
הפרת המדיניות בנושא טקסט בתוכן של חיפוש Google – תיאור
קוד הבעיה: SAFE_SEARCH_POLICY_VIOLATION_TEXT
חומרה: אזהרה (לא חוסמת את הצגת המודעות)
השדה המושפע: description.localizations.*.text
אפשרות לערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את המטען הייעודי (payload) של הפיד)
האזהרה הזו מופיעה כשהטקסט ב-description.localizations מסומן בגלל הפרה של מדיניות התוכן של חיפוש Google. הלוקליזציה של התיאור שסומן (או השדה description כולו אם הלוקאל שמוגדר כברירת מחדל סומן) מושמטת, אבל נקודת העניין עדיין יכולה להופיע.
קודים רלוונטיים של בעיות שקשורות למדיניות: מדיניות התוכן של חיפוש Google
הפרת המדיניות בנושא טקסט של תוכן בחיפוש Google – כתובת לתצוגה
קוד הבעיה: SAFE_SEARCH_POLICY_VIOLATION_TEXT
חומרה: אזהרה (לא חוסמת את הצגת המודעות)
השדה המושפע: display_address.localizations.*.text
אפשרות לערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את המטען הייעודי (payload) של הפיד)
האזהרה הזו מופיעה כשהטקסט של הכתובת המעוצבת בשדה display_address.localizations מכיל תוכן שאסור לפי המדיניות בנושא טקסט תוכן בחיפוש Google. הלוקליזציה של הכתובת שסומנה (או השדה display_address כולו, אם הלוקאל שמוגדר כברירת מחדל סומן) תושמט, אבל נקודת העניין עדיין תוכל להופיע.
קודים רלוונטיים של בעיות שקשורות למדיניות: מדיניות התוכן של חיפוש Google
שעת הפתיחה של העסק מאוחרת יותר משעת הסגירה
קוד הבעיה: NOT_LESS_THAN_FIELD
חומרה: שגיאה (חוסמת את הצגת המודעות)
השדות המושפעים: local_data.business_hours.time_ranges.open_time,
local_data.business_hours.time_ranges.close_time
אפשרות לערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את המטען הייעודי (payload) של הפיד)
השגיאה הזו מתרחשת כששעת הפתיחה open_time מאוחרת משעת הסגירה close_time או שווה לה באותו יום.
סיבות נפוצות ופתרונות:
- היפוך באותו יום: ודאו שהשעה
open_timeמוקדמת מהשעהclose_time(למשל, 09:00 עד 17:00). - משמרות לילה: אם העסק נפתח ביום מסוים ונסגר אחרי חצות ביום הבא (למשל, מ-21:00 עד 02:00), צריך להגדיר את
close_dayליום הבא (למשל,open_day:"FRIDAY",close_day:"SATURDAY").
דוגמה למטען ייעודי (payload) תקין:
{
"local_data": {
"business_hours": {
"time_ranges": [
{
"open_day": "MONDAY",
"open_time": { "hours": 9, "minutes": 0 },
"close_day": "MONDAY",
"close_time": { "hours": 17, "minutes": 0 }
}
]
}
}
}
הערך המינימלי של טווח המחירים גדול מהערך המקסימלי
קוד הבעיה: INVALID_PRICE_RANGE
חומרה: שגיאה (חוסמת את הצגת המודעות)
השדות המושפעים: local_data.price_range.min_price,
local_data.price_range.max_price
אפשרות לערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את המטען הייעודי (payload) של הפיד)
השגיאה הזו קורית כשהערך של min_price גבוה מהערך של max_price, או כשמצוינים קודי מטבע שונים ב-min_price וב-max_price.
סיבות נפוצות ופתרונות:
- ערכים הפוכים: ודאו שהערך של
min_priceנמוך מהערך שלmax_priceאו שווה לו. - חוסר התאמה במטבע: ודאו שגם
min_price.currency_codeוגםmax_price.currency_codeתואמים לאותו קוד מטבע בן שלוש אותיות לפי תקן ISO 4217 (למשל,"USD").
דוגמה למטען ייעודי (payload) תקין:
{
"local_data": {
"price_range": {
"min_price": {
"currency_code": "USD",
"units": 15,
"nanos": 0
},
"max_price": {
"currency_code": "USD",
"units": 45,
"nanos": 0
}
}
}
}
עותק משוכפל של מאפיין ייחודי בנקודת עניין
קוד הבעיה: DUPLICATE_UNIQUE_PROPERTY
חומרה: שגיאה (חוסמת את הצגת המודעות)
אפשרות לערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את המטען הייעודי (payload) של הפיד)
השגיאה הזו מתרחשת כששדה או רכיב משנה שצריכים להיות ייחודיים בישות POI אחת מכילים רשומות כפולות.
בודקים את החלונית "פרטי הבעיה" כדי לזהות את המאפיין שמפר את הייחודיות:
1. מזהה מותג כפול בנקודת עניין (local_data.brand_landing_pages.brand_id)
- הסיבה: אותה מחרוזת
brand_idמופיעה בכמה רשומותbrand_landing_pagesשל נקודת עניין אחת. - הפתרון: מאחדים את כל דפי הנחיתה של המותג לאובייקט
brand_landing_pagesאחד.
דוגמה למטען ייעודי (payload) תקין:
{
"local_data": {
"brand_landing_pages": [
{
"brand_id": "brand_zenchef",
"default_url": "https://bookings.zenchef.com/results?rid=287722"
},
{
"brand_id": "brand_opentable",
"default_url": "https://www.opentable.com/r/287722"
}
]
}
}
2. כתובת דף נחיתה כפולה של מותג עם התאמה לשוק המקומי (local_data.brand_landing_pages.localized_landing_pages.url)
- הסיבה: אותה כתובת דף נחיתה בדיוק מוגדרת כמה פעמים ב-
localized_landing_pagesלאותו מותג. - תיקון: ודאו שכל רשומת URL היא ייחודית, או שייכו כמה לוקאלים למערך
localesשל רשומת URL אחת.
דוגמה למטען ייעודי (payload) תקין:
{
"local_data": {
"brand_landing_pages": [
{
"brand_id": "brand_zenchef",
"default_url": "https://bookings.zenchef.com/results?rid=287722",
"localized_landing_pages": [
{
"url": "https://bookings.zenchef.com/en/results?rid=287722",
"locales": ["en-US"]
},
{
"url": "https://bookings.zenchef.com/fr/results?rid=287722",
"locales": ["fr-FR"]
}
]
}
]
}
}
3. לוקאל כפול של דף נחיתה מקומי של מותג (local_data.brand_landing_pages.localized_landing_pages.locales)
- הסיבה: אותו קוד לוקאל (למשל,
"en-US") מופיע כמה פעמים ב-localized_landing_pagesלאותו מותג. - תיקון: מקצים כל תג לוקאל לדף נחיתה אחד בדיוק שמותאם לשוק המקומי.
דוגמה למטען ייעודי (payload) תקין:
{
"local_data": {
"brand_landing_pages": [
{
"brand_id": "brand_zenchef",
"default_url": "https://bookings.zenchef.com/results?rid=287722",
"localized_landing_pages": [
{
"url": "https://bookings.zenchef.com/en/results?rid=287722",
"locales": ["en-US", "en-GB"]
},
{
"url": "https://bookings.zenchef.com/fr/results?rid=287722",
"locales": ["fr-FR"]
}
]
}
]
}
}
כתובת ה-URL של המותג לא תקינה או לא חוקית
קוד הבעיה: INVALID_ATTRIBUTE_VALUE
חומרה: שגיאה (חוסמת את הצגת המודעות)
אפשרות לערעור: לא (צריך לפתור את הבעיה על ידי עדכון המטען הייעודי (payload) של הפיד)
השדות המושפעים: local_data.brand_landing_pages.default_url,
local_data.brand_landing_pages.localized_landing_pages.url
השגיאה הזו מתרחשת כשכתובת ה-URL שמוגדרת כברירת המחדל של המותג או כתובת דף הנחיתה המותאמת לשוק המקומי נכשלת באימות תחביר ה-URI.
דרישות:
- פרוטוקול: צריך לציין במפורש
http://אוhttps://(https://נדרש להצגה בסביבת ייצור). - תחביר: כתובת URL תקינה, מקודדת באחוזים, תואמת ל-RFC 3986, עם שם דומיין שמוגדר במלואו.
דוגמה למטען ייעודי (payload) תקין:
{
"local_data": {
"brand_landing_pages": [
{
"brand_id": "tasty_bites_brand",
"default_url": "https://www.tastybitestest.com/en",
"localized_landing_pages": [
{
"url": "https://www.tastybitestest.com/en/reservation",
"locales": ["en-US"]
}
]
}
]
}
}
הפרת המדיניות בנושא טקסט בתוכן של חיפוש Google – קטגוריית העסק
קוד הבעיה: SAFE_SEARCH_POLICY_VIOLATION_TEXT
חומרה: אזהרה (לא חוסמת את הצגת המודעות)
אפשרות לערעור: לא (כדי לפתור את הבעיה, צריך לעדכן את המטען הייעודי (payload) של הפיד)
השדה המושפע: local_data.establishment_category.localizations.*.text
האזהרה הזו מופיעה כשהטקסט של קטגוריית העסק המקומית לא עובר את מסנני התוכן האוטומטיים של החיפוש הבטוח. בזמן שהלוקליזציה של קטגוריית המוסד שסומנה (או השדה establishment_category כולו אם הלוקאל שמוגדר כברירת מחדל סומן) מושמטת, נקודת העניין עדיין כשירה להצגה.
תיקון:
- עמידה בדרישות המדיניות: צריך להסיר או להחליף את הטקסט שסומן בקטגוריית העסק במונחים סטנדרטיים של קטגוריית עסק, בהתאם למדיניות התוכן של חיפוש Google.
דוגמה למטען ייעודי (payload) תקין:
{
"local_data": {
"establishment_category": {
"default_locale": "en",
"localizations": [
{
"locale": "en",
"text": "Restaurant"
},
{
"locale": "fr",
"text": "Restaurant gastronomique"
}
]
}
}
}