תצוגת מלאי

סקירה כללית

הכלי לצפייה במלאי ב-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). אי אפשר לערער על בעיות בישויות שמוצגות עם אזהרה. כדי לפתור את האזהרות, צריך לתקן את הבעיה הבסיסית.

סוגי בעיות: בעיות שאפשר לערער עליהן לעומת בעיות שאי אפשר לערער עליהן

  1. בעיות שלא ניתן לערער עליהן (בעיות טכניות, בעיות שקשורות לאיכות הנתונים ואימות אזהרות):
    • השגיאות האלה נגרמות בגלל שגיאות בסכימה, שדות חובה חסרים, קואורדינטות לא תקינות, כתובות URL לא תקינות, מזהים כפולים או אזהרות תוכן שלא חוסמות את ההעלאה (כמו שמות של עסקים בשפות שאינן ברירת המחדל, או שפות כלשהן לתיאורים, כתובות לתצוגה וקטגוריות של מוסדות).
    • פתרון: השותפים צריכים לתקן את הנתונים הבסיסיים בפיד המקור ולהעלות קובץ פיד מעודכן.
  2. בעיות שאפשר לערער עליהן (חסימת תוכן והפרות מדיניות):
    • האירוע מופעל כשנכסי תמונות או טקסט נדרשים של נכס נכשלים בבדיקה של מסנני בטיחות תוכן אוטומטיים, עם חומרה מסוג 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, כל הרשומות המתנגשות נחסמות להצגה עד שהכפילות נפתרת.

איך לפתור את הבעיה:

  1. זיהוי הנכסים המתנגשים: פותחים את Ingestion Viewer (הטמעה > היסטוריה), בוחרים את הרצת ההטמעה האחרונה ומרחיבים את החלונית Validations. לוחצים על השורה של DUPLICATE_MATCHED_ENTITY שמשתפת את אותו מזהה קבוצה של Issue Info כדי לראות את כל הרשומות של poi_id שתואמות לאותה ישות ב-Google.
  2. הסרת רשומות כפולות מהפיד: אם הרשומות המתנגשות של poi_id מייצגות את אותו מיקום פיזי של העסק, צריך להסיר את הרשומות הכפולות מהפיד כדי שתישלח רק רשומה אחת של poi_id לאותו עסק.
  3. תיקון התאמות שגויות של עסקים עצמאיים: אם הרשומות המתנגשות ב-poi_id מייצגות עסקים נפרדים ועצמאיים שהותאמו בטעות לאותה ישות ב-Google, פותחים את העסק שהותאם בטעות בתצוגת המלאי ולוחצים על עריכת ההתאמה כדי לבחור או להציע את דף המקום הייעודי במפות Google. הוראות מפורטות זמינות במדריך התאמת ישויות של נקודות עניין.

ישות לא תואמת

קוד הבעיה: UNMATCHED_ENTITY
חומרה: שגיאה (חוסמת את הצגת המודעות)
אפשרות לערעור: לא (צריך להשתמש בכלים להתאמת ישויות של נקודות עניין או לתקן את המטא-נתונים של הישות)

הבעיה הזו מצביעה על כך שתהליך ההתאמה של Google לא הצליח להתאים בין הדף העסקי המקומי שלכם לבין מקום קנוני במפות Google.

איך לפתור את הבעיה:

  1. אימות מאפייני הליבה: מוודאים שהמאפיינים name,‏ display_address,‏ location.address,‏ url,‏ telephone ו-location.latitude/location.longitude של המיקום משקפים במדויק את המיקום הפיזי של הנכס.
  2. בדיקת פרטי ההתאמה: בעמודה פרטי התאמה בתצוגת המלאי אפשר לראות מקומות מועמדים.
  3. משתמשים בכלי לתיקון התאמות של נקודות עניין: לוחצים על עריכת ההתאמה ב-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"
        }
      ]
    }
  }
}