Widok Zasoby reklamowe

Przegląd

Przeglądarka asortymentu w Centrum działań zapewnia wgląd w stan pozyskiwania, stan dopasowania miejsca i uprawnienia do wyświetlania lokalnego asortymentu w ciekawym miejscu.

Ta przeglądarka wyświetla problemy niezależnie od poszczególnych operacji pozyskiwania – problemy stanowe reprezentujące aktywny stan wyświetlania każdego dostawcy usług, w tym wszelkie możliwe tryby awarii (zasady, ostrzeżenia, błędy itp.), które mogą wystąpić.

za pomocą tego narzędzia możesz:

  • Wyszukiwanie i sprawdzanie wszystkich dostawców usług i ich stanu wyświetlania na żywo.
  • diagnozować błędy weryfikacji danych i naruszenia zasad dotyczących treści;
  • Przesyłaj odwołania dotyczące naruszeń zasad i śledź ich stan.
  • Sprawdzanie diagnostyki dopasowywania dostawców usług i przesyłanie propozycji ręcznego dopasowania.
  • Sprawdź nieprzetworzone ładunki JSON z ostatnich przetworzeń kanału.

Kolumny tabeli asortymentu

Widok listy wyświetla wszystkich przesłanych dostawców usług z pliku danych o ciekawych miejscach, uporządkowanych hierarchicznie według podmiotu. Możesz filtrować według identyfikatora lokalnego miejsca, stanu dopasowania, integracji i platformy.

Kolumny tabeli podsumowania Opis
Identyfikator lokalnego miejsca Unikalny identyfikator lokalnej usługi podany w pliku danych (poi_id).
Nazwa miejsca w języku lokalnym Zlokalizowana nazwa właściwości lokalnej wyodrębniona z pliku danych.
Stan dopasowania Wskazuje, czy ciekawe miejsce zostało dopasowane do wizytówki w Mapach Google:
• Tak (zielona plakietka): dopasowano do miejsca w Mapach Google.
• Nie (czerwona plakietka): brak dopasowania; wymaga sprawdzenia lub propozycji dopasowania.
Integracja To jest integracja z jednostką agregującą lokalne oferty.
Surface Docelowa platforma wyświetlania (np. wyszukiwarka).
Stan wyświetlania Stan kwalifikowania się do wyświetlania w czasie rzeczywistym:
• Włączone (zielony wskaźnik): kwalifikuje się do wyświetlania i jest aktywnie wyświetlane na platformach Google.
• Wyłączone (czerwony wskaźnik): wyświetlanie jest zablokowane z powodu błędów weryfikacji, naruszeń zasad lub stanu niedopasowania.
Błędy Liczba aktywnych problemów o poziomie ważności „Błąd”. Jeśli w przypadku danej usługi wystąpi jakikolwiek błąd, nie będzie ona mogła wyświetlać się na żadnej platformie.
Ostrzeżenia Liczba aktywnych problemów o poziomie ważności Ostrzeżenie. Miejsca zakwaterowania z ostrzeżeniami nadal mogą się wyświetlać.
Informacje o meczu Zawiera przycisk Edytuj dopasowanie, który otwiera interaktywny panel poprawiania dopasowania.

Widok szczegółów ciekawego miejsca

Kliknięcie dowolnego identyfikatora ciekawego miejsca w widoku listy powoduje przejście na stronę z informacjami o danym elemencie.

Widok szczegółów składa się z 4 rozwijanych sekcji:

1. Informacje podstawowe

Podsumowuje metadane encji wysokiego poziomu:

  • Nazwa ciekawego miejsca: nazwa firmy wyodrębniona z data[].name.localizations.
  • Identyfikator miejsca: unikalny identyfikator podmiotu partnera (poi_id).
  • Źródło danych: dokładna nazwa pliku danych, z którego została pobrana ta encja.

2. Stan wyświetlania

Podział możliwości wyświetlania według integracji i miejsca docelowego:

  • Integracja i platforma: branża i platforma docelowa (np. Local Aggregator Unit na Search).
  • Stan wyświetlania: bieżący stan Enabled lub Disabled.
  • Problemy: wyświetla plakietki problemów dla wszystkich aktywnych błędów lub ostrzeżeń (np. Unmatched entity, Policy Violation). Kliknięcie plakietki problemu powoduje otwarcie panelu szczegółów problemu.
  • Odwołania: wyświetla stany unieważnienia lub odwołania (Under review, Approved lub Rejected).

3. Informacje o dopasowaniu

Wyświetla diagnostykę dopasowywania miejsc:

  • Dane wejściowe dopasowania: sformatowany adres pocztowy wyodrębniony z pliku danych (street_address, locality, region, postal_code, country).
  • Typ dopasowania: mechanizm dopasowywania (np. Location).
  • Przestrzeń nazw dopasowania: branża, do której będą stosowane zmiany dopasowania (np. Local Aggregator Unit).
  • Stan dopasowania: Yes (zielony) lub No (czerwony).
  • Dane wyjściowe dopasowania: nazwa miejsca, adres i identyfikator miejsca w Mapach Google.
  • Edytuj dopasowanie: przycisk otwierający okno propozycji dopasowania.

4. Nieprzetworzony kod JSON

Udostępnia interaktywną przeglądarkę kodu z numerami wierszy i wyróżnianiem składni, która wyświetla pełny przeanalizowany ładunek JSON (item_proto) w celu szybkiego debugowania i weryfikacji schematu. Wartości danych przedstawione tutaj będą odzwierciedlać wartości otrzymane z pliku danych o ważnych miejscach.

Przepływ pracy dotyczący problemów i klasyfikacji

Elementy, w których wykryto problemy, są wyłączone (jeśli oznaczono je jako BŁĄD) lub mają obniżoną jakość (jeśli oznaczono je jako OSTRZEŻENIE). Od ostrzeżeń dotyczących problemów z elementami nie można się odwołać. Można je rozwiązać, naprawiając problem, którego dotyczą.

Typy problemów: odwołanie możliwe i niemożliwe

  1. Problemy, od których nie można się odwołać (problemy techniczne, problemy z jakością danych i ostrzeżenia):
    • Spowodowane błędami schematu, brakiem wymaganych pól, nieprawidłowymi współrzędnymi, uszkodzonymi adresami URL, zduplikowanymi identyfikatorami lub nieblokującymi ostrzeżeniami dotyczącymi treści (takimi jak nazwy firm w języku innym niż domyślny lub dowolne języki w opisach, adresach wyświetlanych i kategoriach placówek).
    • Rozwiązanie: partnerzy muszą poprawić dane w źródłowym pliku danych i przesłać zaktualizowany plik danych.
  2. Problemy, od których można się odwołać (blokowanie treści i naruszenia zasad):
    • Uruchamiany, gdy wymagane komponenty tekstowe lub graficzne usługi nie przejdą automatycznych filtrów bezpieczeństwa treści z poziomem ważności BŁĄD.
    • Rozwiązanie: jeśli treści są zgodne z zasadami platformy, partnerzy mogą kliknąć przycisk Odwołaj się obok problemu w Centrum działań, aby przesłać odwołanie. Partnerzy muszą podać powód i uzasadnienie, a nasz zespół ds. odwołań sprawdzi i zatwierdzi lub odrzuci prośby. O podjętych decyzjach poinformujemy Cię za pomocą narzędzia i e-maila.

Katalog problemów z jednostką agregującą lokalnie

W tabeli poniżej znajdziesz pełny zestaw błędów weryfikacji i kodów problemów ze zgodnością z zasadami dotyczących integracji z jednostką agregującą:

Opis problemu Poziom ważności Kod problemu Pole, którego dotyczy problem / argumenty Czy można się odwołać? Działanie / odpowiednia zasada
Brak identyfikatora POI ERROR MISSING_REQUIRED_FIELD poi_id Nie Podaj unikalną wartość: poi_id. Zobacz specyfikację pliku danych o ciekawych miejscach.
Brak domyślnych ustawień regionalnych w polu „name” ERROR MISSING_REQUIRED_FIELD name.default_locale Nie Podaj prawidłowy kod języka w formacie BCP 47 dla domyślnych ustawień regionalnych. Zobacz Pomoc w wielu językach.
Nie znaleziono domyślnej lokalizacji dla pola „name” ERROR MISSING_REQUIRED_FIELD name.localizations Nie Podaj wartość zlokalizowanej nazwy ciekawego miejsca zgodną z zadeklarowanym językiem (default_locale).
Brak domyślnego języka w polu „description” ERROR MISSING_REQUIRED_FIELD description.default_locale Nie Podaj prawidłowy domyślny język opisu usługi zgodny ze standardem BCP 47.
Nie znaleziono domyślnej lokalizacji dla pola „description” ERROR MISSING_REQUIRED_FIELD description.localizations Nie Podaj tekst opisu zgodny z językiem: default_locale.
Brak domyślnych ustawień regionalnych w polu „display_address” ERROR MISSING_REQUIRED_FIELD display_address.default_locale Nie Określ prawidłowe domyślne ustawienia regionalne w formacie BCP 47 dla wyświetlanego adresu.
Nie znaleziono domyślnej lokalizacji dla pola „display_address” ERROR MISSING_REQUIRED_FIELD display_address.localizations Nie Podaj sformatowany tekst adresu zgodny z zadeklarowanym językiem (default_locale).
Przekroczono maksymalną liczbę obrazów OSTRZEŻENIE EXCEEDED_MAX_COUNT images Nie Ogranicz liczbę zdjęć do maksymalnie 5 na każde ciekawe miejsce. Nadmiarowe obrazy są odrzucane.
Nieprawidłowa współrzędna szerokości geograficznej ERROR INVALID_LATLNG location.latitude Nie Wpisz prawidłową szerokość geograficzną z zakresu od -90.0 do +90.0. Zobacz Definicja współrzędnych geograficznych.
Nieprawidłowa współrzędna długości geograficznej ERROR INVALID_LATLNG location.longitude Nie Wpisz prawidłową długość geograficzną z zakresu od -180.0 do +180.0. Zobacz Definicja współrzędnych geograficznych.
Brak współrzędnej szerokości geograficznej ERROR MISSING_REQUIRED_FIELD location.latitude Nie Podaj wartość szerokości geograficznej, aby uzupełnić parę współrzędnych. Zobacz Definicja współrzędnych geograficznych.
Brak współrzędnej długości geograficznej ERROR MISSING_REQUIRED_FIELD location.longitude Nie Podaj wartość długości geograficznej, aby uzupełnić parę współrzędnych. Zobacz Definicja współrzędnych geograficznych.
Brak adresu lub adres nieustrukturyzowany ERROR MISSING_REQUIRED_FIELD location.address Nie Podaj uporządkowany adres pocztowy, w tym ulicę, miejscowość, kod pocztowy i kraj.
Nieprawidłowy lub niepoprawny adres URL ERROR INVALID_ATTRIBUTE_VALUE url Nie Upewnij się, że URL strony docelowej używa obsługiwanego protokołu HTTP/HTTPS i prawidłowej składni.
Nieprawidłowy lub niedostępny obraz OSTRZEŻENIE INVALID_IMAGE image.url Nie Sprawdź, czy adresy URL obrazów są publicznie dostępne i nie wymagają uwierzytelnienia ani nie zwracają błędów 4xx/5xx.
Zduplikowany identyfikator miejsca ERROR DUPLICATE_ENTITY poi_id Nie Upewnij się, że każdy identyfikator (poi_id) jest unikalny w całym pliku danych. usuniesz zduplikowane wpisy,
Zduplikowany dopasowany element ERROR DUPLICATE_MATCHED_ENTITY POI Nie Usuń z pliku danych zduplikowane wpisy lub użyj narzędzia Dopasowywanie elementów ciekawych miejsc, aby dopasować różne firmy do ich niezależnych wizytówek w Mapach Google.
Niedopasowany element ERROR UNMATCHED_ENTITY POI Nie Dopasuj ciekawe miejsce do wizytówki miejsca w Mapach Google za pomocą narzędzia Dopasowywanie ciekawych miejsc.
Naruszenie zasad dotyczących obrazów ERROR SAFE_SEARCH_POLICY_VIOLATION_IMAGE image Tak Usuń lub zastąp oznaczone zdjęcie albo kliknij Odwołaj się, aby przesłać uzasadnienie. Zobacz zasady dotyczące obrazów w treściach w wyszukiwarce Google.
Naruszenie zasad dotyczących tekstu – nazwa domyślna ERROR SAFE_SEARCH_POLICY_VIOLATION_TEXT name.localizations.*.text Tak Usuń lub zastąp tekst oznaczonej nazwy albo kliknij Odwołaj się. Zobacz zasady dotyczące treści tekstowych w wyszukiwarce Google.
Naruszenie zasad dotyczących tekstu – nazwa inna niż domyślna OSTRZEŻENIE SAFE_SEARCH_POLICY_VIOLATION_TEXT name.localizations.*.text Nie Usuń lub zastąp tekst oznaczonej nazwy. Zobacz zasady dotyczące treści tekstowych w wyszukiwarce Google.
Naruszenie zasad dotyczących tekstu – opis OSTRZEŻENIE SAFE_SEARCH_POLICY_VIOLATION_TEXT description.localizations.*.text Nie Usuń lub zastąp oznaczony tekst opisu. Zobacz zasady dotyczące treści tekstowych w wyszukiwarce Google.
Naruszenie zasad dotyczących tekstu – wyświetlany adres OSTRZEŻENIE SAFE_SEARCH_POLICY_VIOLATION_TEXT display_address.localizations.*.text Nie Usuń lub zastąp oznaczony tekst wyświetlanego adresu. Zobacz zasady dotyczące treści tekstowych w wyszukiwarce Google.
Brak domyślnych ustawień regionalnych dla kategorii placówki ERROR MISSING_REQUIRED_FIELD local_data.establishment_category.default_locale Nie Podaj wartość zlokalizowanej kategorii placówki dla miejsca, które odpowiada zadeklarowanemu językowi default_locale.
Brak dnia otwarcia w godzinach otwarcia ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.open_day Nie Podaj prawidłowy dzień otwarcia w godzinach otwarcia.
Brak godziny otwarcia w godzinach pracy ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.open_time Nie Podaj prawidłowe godziny otwarcia firmy.
Brak dnia zamknięcia w godzinach otwarcia ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.close_day Nie Podaj prawidłowy dzień zamknięcia godzin otwarcia.
Brak godziny zamknięcia firmy ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.close_time Nie Podaj prawidłową godzinę zamknięcia godzin otwarcia.
Godziny otwarcia: godzina otwarcia jest późniejsza niż godzina zamknięcia ERROR NOT_LESS_THAN_FIELD local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time Nie Podaj prawidłową parę godzin otwarcia i zamknięcia, upewniając się, że godzina otwarcia jest wcześniejsza niż godzina zamknięcia.
Minimalna wartość przedziału cenowego jest większa niż wartość maksymalna ERROR INVALID_PRICE_RANGE local_data.price_range.min_price, local_data.price_range.max_price Nie Podaj prawidłowy przedział cenowy, w którym cena minimalna jest niższa niż cena maksymalna.
Brak identyfikatora marki ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.brand_id Nie Podaj prawidłowy identyfikator marki.
Zduplikowany identyfikator marki w miejscu ERROR DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.brand_id Nie Upewnij się, że każdy identyfikator (brand_id) jest unikalny w ramach danych miejsca. usuniesz zduplikowane wpisy,
Brak domyślnego adresu URL marki ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.default_url Nie Podaj prawidłowy domyślny adres URL marki.
Nieprawidłowy format lub nieprawidłowy adres URL marki ERROR INVALID_ATTRIBUTE_VALUE local_data.brand_landing_pages.default_url Nie Upewnij się, że domyślny adres URL marki używa obsługiwanego protokołu HTTP/HTTPS i prawidłowej składni.
Brak adresu URL zlokalizowanej strony docelowej marki ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.localized_landing_pages.url Nie Podaj prawidłowy adres URL zlokalizowanej strony docelowej.
Nieprawidłowy lub niepoprawny adres URL strony docelowej zlokalizowanej dla marki ERROR INVALID_ATTRIBUTE_VALUE local_data.brand_landing_pages.localized_landing_pages.url Nie Upewnij się, że adres URL zlokalizowanej strony docelowej używa obsługiwanego protokołu HTTP/HTTPS i prawidłowej składni.
Zduplikowany URL strony docelowej zlokalizowanej dla marki ERROR DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.localized_landing_pages.url Nie Upewnij się, że każdy element url jest unikalny na stronach docelowych zlokalizowanych dla danego miejsca. usuniesz zduplikowane wpisy,
Brak języka zlokalizowanej strony docelowej marki ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.localized_landing_pages.locales Nie Podaj prawidłowy zestaw języków dla zlokalizowanej strony docelowej.
Zduplikowane ustawienia regionalne strony docelowej zlokalizowanej pod kątem marki ERROR DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.localized_landing_pages.locales Nie Upewnij się, że każdy element locale jest unikalny na stronach docelowych zlokalizowanych dla danego miejsca. usuniesz zduplikowane wpisy,
Naruszenie zasad dotyczących tekstu – kategoria placówki OSTRZEŻENIE SAFE_SEARCH_POLICY_VIOLATION_TEXT local_data.establishment_category.localizations.*.text Nie Usuń lub zastąp tekst oznaczony jako kategoria placówki. Zobacz zasady dotyczące treści tekstowych w wyszukiwarce Google.

Kody problemów

W sekcjach poniżej znajdziesz szczegółowe informacje o przyczynach i sposobach rozwiązania problemów związanych z poszczególnymi kodami.

Brakuje wymaganego pola

Kod problemu: MISSING_REQUIRED_FIELD
Waga: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując plik danych o ciekawych miejscach)

Ten błąd występuje, gdy w przetworzonym elemencie brakuje co najmniej jednego atrybutu wymaganego przez specyfikację pliku danych o punktach zainteresowania.

Sprawdź w panelu Szczegóły problemu, której konkretnie właściwości brakuje, a następnie zastosuj odpowiednie rozwiązanie:

1. Brak identyfikatora ważnego miejsca (poi_id)

  • Przyczyna: pole poi_id jest puste, ma wartość null lub brakuje go w obiekcie encji głównej.
  • Rozwiązanie: podaj trwały, unikalny identyfikator właściwości w postaci ciągu znaków.
{
  "poi_id": "test_restaurant_1"
}

2. Brak domyślnego języka lub zlokalizowanej nazwy (name)

  • Przyczyna: w obiekcie name brakuje ciągu tekstowego default_locale lub tablicy localizations z pasującymi ustawieniami językowymi.
  • Rozwiązanie: podaj zarówno default_locale, jak i co najmniej 1 wpis lokalizacji pasujący do tego języka.
{
  "name": {
    "localizations": [
      {
        "locale": "en",
        "text": "Tasty Bites Test Restaurant"
      }
    ],
    "default_locale": "en"
  }
}

3. Brak domyślnego języka lub zlokalizowanego adresu (display_address)

  • Przyczyna: w obiekcie display_address brakuje ciągu znaków default_locale lub tablicy localizations.
  • Rozwiązanie: podaj zarówno default_locale, jak i co najmniej 1 wpis lokalizacyjny pasujący do tego języka w przypadku sformatowanego adresu.
{
  "display_address": {
    "localizations": [
      {
        "locale": "en",
        "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
      }
    ],
    "default_locale": "en"
  }
}

4. Brak domyślnego języka lub zlokalizowanego opisu (description)

  • Przyczyna: gdy obiekt description jest uwzględniony, brakuje default_locale lub pasującej lokalizacji.
  • Rozwiązanie: podaj zarówno default_locale, jak i co najmniej 1 wpis lokalizacyjny pasujący do tego języka w opisie.
{
  "description": {
    "localizations": [
      {
        "locale": "en",
        "text": "A mock restaurant for testing the POI feed ingestion."
      }
    ],
    "default_locale": "en"
  }
}

5. Brak współrzędnych geograficznych (location.latitude / location.longitude)

  • Przyczyna: w obiekcie location brakuje wartości liczbowej latitude lub longitude.
  • Rozwiązanie: podaj wartości latitude i longitude jako liczby zmiennoprzecinkowe w standardowych stopniach dziesiętnych WGS84.
{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

6. Brak uporządkowanego adresu pocztowego (location.address)

  • Przyczyna: obiekt location.address nie zawiera obowiązkowych komponentów adresu (country, locality lub postal_code).
  • Rozwiązanie: wypełnij obiekt uporządkowanego adresu pocztowego zgodnie ze standardami ISO.
{
  "location": {
    "address": {
      "country": "US",
      "locality": "Mountain View",
      "postal_code": "94043",
      "street_address": "1600 Amphitheatre Pkwy"
    }
  }
}

7. Brak domyślnego języka dla kategorii placówki (local_data.establishment_category.default_locale)

  • Przyczyna: obiekt local_data.establishment_category jest obecny, ale brakuje obiektu default_locale, jest on pusty lub nie pasuje do żadnego wpisu w tablicy localizations.
  • Rozwiązanie: podaj prawidłowy tag języka w formacie BCP 47 dla default_locale i podaj co najmniej 1 zlokalizowany ciąg znaków pasujący do tego języka.
{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        }
      ]
    }
  }
}

8. Brak dnia otwarcia w godzinach otwarcia (local_data.business_hours.time_ranges.open_day)

  • Przyczyna: brakuje wpisu w local_data.business_hours.time_rangesopen_day lub jest on ustawiony na DAY_OF_WEEK_UNSPECIFIED.
  • Rozwiązanie: podaj prawidłowy ciąg znaków dnia tygodnia (np. "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. Brak godziny otwarcia w godzinach pracy (local_data.business_hours.time_ranges.open_time)

  • Przyczyna: we wpisie w local_data.business_hours.time_ranges brakuje obiektu open_time.
  • Działanie naprawcze: określ open_time, podając hours (0–23) i 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. Brak dnia zamknięcia w godzinach otwarcia (local_data.business_hours.time_ranges.close_day)

  • Przyczyna: brakuje wpisu w local_data.business_hours.time_rangesclose_day lub jest on ustawiony na DAY_OF_WEEK_UNSPECIFIED.
  • Rozwiązanie: podaj prawidłowy ciąg znaków dnia tygodnia (np. "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. Brak godziny zamknięcia w godzinach otwarcia (local_data.business_hours.time_ranges.close_time)

  • Przyczyna: we wpisie w local_data.business_hours.time_ranges brakuje obiektu close_time.
  • Działanie naprawcze: określ close_time, podając hours (0–23) i 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. Brak identyfikatora marki (local_data.brand_landing_pages.brand_id)

  • Przyczyna: wpis w local_data.brand_landing_pages ma pustą lub brakującą wartość brand_id albo wartość null.
  • Rozwiązanie: podaj niepusty ciąg znaków identyfikatora, który pasuje do konfiguracji zarejestrowanej marki partnera.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

13. Brak domyślnego adresu URL marki (local_data.brand_landing_pages.default_url)

  • Przyczyna: brakuje wpisu w local_data.brand_landing_pagesdefault_url lub jest on pustym ciągiem znaków.
  • Rozwiązanie: podaj prawidłowy zastępczy adres URL strony docelowej HTTP/HTTPS dla użytkowników, których region nie pasuje do zlokalizowanych adresów URL.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

14. Brak adresu URL zlokalizowanej strony docelowej marki (local_data.brand_landing_pages.localized_landing_pages.url)

  • Przyczyna: element w obiekcie localized_landing_pages ma brakujące lub puste pole url.
  • Rozwiązanie: podaj prawidłowy, pełny adres URL HTTP/HTTPS zlokalizowanej strony docelowej.
{
  "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. Brak języka strony docelowej zlokalizowanej dla marki (local_data.brand_landing_pages.localized_landing_pages.locales)

  • Przyczyna: w elemencie localized_landing_pages brakuje tablicy locales lub jest ona pusta.
  • Rozwiązanie: podaj co najmniej 1 prawidłowy kod języka lub regionu w formacie BCP 47 (np. ["en-US"]) w tablicy 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"]
          }
        ]
      }
    ]
  }
}

Przekroczono maksymalną liczbę obrazów

Kod problemu: EXCEEDED_MAX_COUNT
Waga: ostrzeżenie
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)

Ten błąd występuje, gdy ładunek encji POI zawiera więcej niż 5 obiektów graficznych w tablicy images.

Działanie naprawcze:

  • Przytnij tablicę images, aby zawierała maksymalnie 5 wysokiej jakości reprezentatywnych zdjęć lokalnego obiektu.
  • Wszystkie obrazy przekraczające limit 5 zostaną odrzucone.

Nieprawidłowe współrzędne geograficzne

Kod problemu: INVALID_LATLNG
Ważność: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)

Ten błąd występuje, gdy współrzędne geograficzne podane w polu location.latitude lub location.longitude wykraczają poza prawidłowe granice sferyczne lub reprezentują niezaludnione współrzędne o wartości null.

Typowe przyczyny i rozwiązania:

  • Szerokość geograficzna poza zakresem: szerokość geograficzna musi być liczbą w reprezentacji zmiennoprzecinkowej z zakresu od -90.0 do 90.0 włącznie.
  • Długość geograficzna poza zakresem: Długość geograficzna musi być liczbą w reprezentacji zmiennoprzecinkowej z zakresu od -180.0 do 180.0 (włącznie).
  • Null Island (0,0): przesłanie wartości 0.0, 0.0 lub liczb całkowitych zastępczych (takich jak 999, 999) powoduje odrzucenie współrzędnych.
  • Zamienione współrzędne: sprawdź, czy szerokość i długość geograficzna nie są odwrócone w potoku serializacji.

Przykład prawidłowego ładunku:

{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

Nieprawidłowy format adresu URL lub nieprawidłowy adres URL

Kod problemu: INVALID_ATTRIBUTE_VALUE
Ważność: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)

Ten błąd występuje, gdy wartość atrybutu nie przejdzie weryfikacji schematu. Najczęściej dzieje się tak, gdy adres URL strony docelowej partnera lub adres URL obrazu jest nieprawidłowy pod względem składni.

Wymagania:

  • Protokół: adresy URL muszą wyraźnie określać http:// lub https:// (zdecydowanie zalecamy HTTPS).
  • Kodowanie: adresy URL zawierające znaki specjalne, spacje lub znaki spoza zestawu ASCII muszą być prawidłowo zakodowane za pomocą znaku procenta (RFC 3986).
  • Domena kanoniczna: upewnij się, że domena jest w pełni kwalifikowana (np. https://example.com/local/123, a nie example.com/local/123 lub www.example).

Przykład prawidłowego ładunku:

{
  "url": "https://www.tastybitestest.com/en"
}

Nieprawidłowy lub niedostępny obraz

Kod problemu: INVALID_IMAGE
Waga: ostrzeżenie
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)

To ostrzeżenie pojawia się na etapie asynchronicznego pobierania obrazu, gdy robot Google nie może pobrać, zdekodować ani zweryfikować zasobu multimedialnego z: image.url. Nieprawidłowy obraz zostanie pominięty, ale obiekt nadal będzie mógł się wyświetlać.

Typowe przyczyny i rozwiązania:

  • Błędy HTTP (404 / 403 / 500): adres URL obrazu zwraca kod stanu HTTP inny niż 200. Upewnij się, że obrazy są dostępne publicznie bez uwierzytelniania, ścian cookie lub ograniczeń dotyczących listy dozwolonych adresów IP.
  • Blokowanie przez plik robots.txt: upewnij się, że Twoja sieć dostarczania treści (CDN) zezwala na dostęp klientom użytkownika Googlebot i Googlebot-Image.
  • Nieobsługiwany format pliku: obrazy muszą być w standardowych formatach rastrowych (JPEG, PNG, WebP). Animowane GIF-y, pliki SVG i nieprzetworzone formaty z aparatu nie są obsługiwane. Więcej informacji znajdziesz we wskazówkach dotyczących obrazów.
  • Błędy certyfikatu SSL: sprawdź, czy serwer hostujący obrazy ma prawidłowy łańcuch certyfikatów SSL.

Zduplikowany identyfikator ważnego miejsca

Kod problemu: DUPLICATE_ENTITY
Ważność: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)

Ten błąd występuje, gdy ten sam ciąg znaków poi_id pojawia się więcej niż raz w jednym zbiorze plików kanału.

Działanie naprawcze:

  • Upewnij się, że każda lokalna wizytówka w pliku danych ma unikalny, deterministyczny identyfikator poi_id.
  • Jeśli lokalny obiekt ma kilka typów pokoi lub stawek, skonsoliduj je w ramach jednego elementu nadrzędnego POI, zamiast generować duplikaty rekordów elementów z identycznymi identyfikatorami.

Zduplikowany dopasowany element

Kod problemu: DUPLICATE_MATCHED_ENTITY
Waga: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych lub korzystając z narzędzi do dopasowywania elementów ciekawych miejsc)

Ten błąd występuje, gdy co najmniej 2 różne wpisy poi_id w pliku danych pasują do tej samej kanonicznej wizytówki miejsca w Mapach Google. Gdy kilka firm jest mapowanych na ten sam podmiot Google, wszystkie kolidujące wpisy są blokowane do czasu usunięcia duplikatu.

Jak rozwiązać ten problem:

  1. Zidentyfikuj właściwości, które powodują konflikt: otwórz Przeglądarkę pozyskiwania (Pozyskiwanie > Historia), wybierz ostatnie pozyskiwanie i rozwiń panel Weryfikacje. Kliknij wiersz DUPLICATE_MATCHED_ENTITY, który ma ten sam identyfikator grupy Informacje o problemie, aby wyświetlić wszystkie rekordy poi_id, które pasują do tego samego podmiotu Google.
  2. Usuń z pliku danych zduplikowane informacje: jeśli kolidujące wpisy poi_id reprezentują tę samą fizyczną lokalizację firmy, usuń z pliku danych zduplikowane wpisy, aby przesłać tylko 1 wpis poi_id dotyczący tej placówki.
  3. Popraw nieprawidłowe dopasowania w przypadku niezależnych firm: jeśli kolidujące wpisy poi_id reprezentują oddzielne, niezależne firmy, które zostały nieprawidłowo dopasowane do tego samego podmiotu Google, otwórz nieprawidłowo dopasowaną firmę w widoku asortymentu i kliknij Edytuj dopasowanie, aby wybrać lub zaproponować dedykowaną wizytówkę miejsca w Mapach Google. Szczegółowe instrukcje znajdziesz w przewodniku po dopasowywaniu elementów w miejscach.

Niedopasowany element

Kod problemu: UNMATCHED_ENTITY
Ważność: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (użyj narzędzi do dopasowywania elementów ciekawych miejsc lub popraw metadane elementu)

Ten problem oznacza, że potok dopasowywania Google nie był w stanie uzgodnić Twojej wizytówki lokalnej z kanonicznym miejscem w Mapach Google.

Jak rozwiązać ten problem:

  1. Sprawdź atrybuty podstawowe: upewnij się, że atrybuty name, display_address, location.address, url, telephone i location.latitude/location.longitude dokładnie odzwierciedlają lokalizację fizyczną obiektu.
  2. Sprawdź informacje o dopasowaniu: w kolumnie Informacje o dopasowaniu w widoku asortymentu sprawdź potencjalne miejsca.
  3. Użyj narzędzia do poprawiania dopasowania ważnych miejsc: w Centrum działań kliknij Edytuj dopasowanie, aby ręcznie wyszukać i potwierdzić prawidłowy identyfikator miejsca Google. Szczegółowe instrukcje znajdziesz w przewodniku po dopasowywaniu elementów ciekawych miejsc.

Naruszenie zasad dotyczących obrazów w wyszukiwarce Google

Kod problemu: SAFE_SEARCH_POLICY_VIOLATION_IMAGE
Waga: BŁĄD (blokuje wyświetlanie)
Możliwość odwołania: tak

Kody problemów związanych z zasadami: zasady dotyczące obrazów w treściach w wyszukiwarce Google.

Jeśli uważasz, że obraz został oznaczony przez pomyłkę (fałszywy alarm), w panelu Szczegóły problemu kliknij Utwórz odwołanie.

Naruszenie zasad dotyczących treści tekstowych w wyszukiwarce Google – nazwa

Kod problemu: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Ważność: różni się w zależności od pola (szczegóły poniżej)
Pole, którego dotyczy problem: name.localizations.*.text
Możliwość odwołania: tak (tylko w przypadku BŁĘDU w domyślnych ustawieniach regionalnych); nie (w przypadku ostrzeżenia w niedomyślnych ustawieniach regionalnych)

  • Domyślne ustawienia regionalne (name.default_locale): BŁĄD (blokuje wyświetlanie). Wyświetlanie całego miejsca docelowego jest zablokowane. Jeśli uważasz, że tekst nazwy domyślnego ustawienia regionalnego został oznaczony przez pomyłkę (fałszywy alarm), w panelu Szczegóły problemu kliknij Utwórz odwołanie.
  • Ustawienia regionalne inne niż domyślne: ostrzeżenie (nie blokuje wyświetlania). Pominięta zostanie tylko oznaczona lokalizacja, a ciekawe miejsce nadal będzie mogło się wyświetlać. Od ostrzeżeń dotyczących języków innych niż domyślny nie można się odwołać. Można je rozwiązać, aktualizując dane w pliku danych.

Kody problemów związanych z zasadami: Zasady dotyczące treści w wyszukiwarce Google

Naruszenie zasad dotyczących tekstu w treściach w wyszukiwarce Google – opis

Kod problemu: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Waga: ostrzeżenie (nie blokuje wyświetlania)
Pole, którego dotyczy problem: description.localizations.*.text
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)

To ostrzeżenie pojawia się, gdy tekst w description.localizations zostanie oznaczony jako naruszający zasady dotyczące tekstu w wyszukiwarce Google. Chociaż oznaczone tłumaczenie opisu (lub całe pole description, jeśli oznaczono domyślne ustawienia regionalne) jest pomijane, miejsce nadal może się wyświetlać.

Kody problemów związanych z zasadami: Zasady dotyczące treści w wyszukiwarce Google

Naruszenie zasad dotyczących tekstu treści w wyszukiwarce Google – adres wyświetlany

Kod problemu: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Waga: ostrzeżenie (nie blokuje wyświetlania)
Pole, którego dotyczy problem: display_address.localizations.*.text
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)

To ostrzeżenie pojawia się, gdy sformatowany tekst adresu w display_address.localizations zawiera treści zabronione przez zasady dotyczące treści tekstowych w wyszukiwarce Google. Chociaż oznaczona lokalizacja adresu (lub całe pole display_address, jeśli oznaczono domyślne ustawienia regionalne) zostanie pominięta, ciekawe miejsce nadal będzie mogło się wyświetlać.

Kody problemów związanych z zasadami: Zasady dotyczące treści w wyszukiwarce Google

Godzina otwarcia firmy jest późniejsza niż godzina zamknięcia

Kod problemu: NOT_LESS_THAN_FIELD
Waga: błąd (blokuje wyświetlanie)
Pola, których dotyczy problem: local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time
Możliwość odwołania: nie (rozwiąż problem, aktualizując dane w pliku danych)

Ten błąd występuje, gdy godziny otwarcia open_time są późniejsze niż close_time lub równe tej wartości dla tego samego przedziału dnia.

Typowe przyczyny i rozwiązania:

  • Odwrócenie tego samego dnia: upewnij się, że godzina open_time jest wcześniejsza niż close_time (np. 09:00–17:00).
  • Zmiany nocne: jeśli lokal jest otwierany jednego dnia i zamykany po północy następnego dnia (np. od 21:00 do 2:00), ustaw close_day na następny dzień (np. open_day: "FRIDAY", close_day: "SATURDAY").

Przykład prawidłowego ładunku:

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 9, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 17, "minutes": 0 }
        }
      ]
    }
  }
}

Minimalna wartość przedziału cenowego jest większa niż wartość maksymalna

Kod problemu: INVALID_PRICE_RANGE
Waga: błąd (blokuje wyświetlanie)
Pola, których dotyczy problem: local_data.price_range.min_price, local_data.price_range.max_price
Możliwość odwołania: nie (rozwiąż problem, aktualizując dane w pliku danych)

Ten błąd występuje, gdy wartość min_price przekracza wartość max_price lub gdy min_price i max_price mają różne kody waluty.

Typowe przyczyny i rozwiązania:

  • Odwrócone wartości: upewnij się, że wartość min_price jest mniejsza lub równa wartości max_price.
  • Niezgodność waluty: sprawdź, czy parametry min_price.currency_code i max_price.currency_code mają ten sam trzyliterowy kod waluty według normy ISO 4217 (np. "USD").

Przykład prawidłowego ładunku:

{
  "local_data": {
    "price_range": {
      "min_price": {
        "currency_code": "USD",
        "units": 15,
        "nanos": 0
      },
      "max_price": {
        "currency_code": "USD",
        "units": 45,
        "nanos": 0
      }
    }
  }
}

Zduplikowana unikalna usługa w ramach ważnego miejsca

Kod problemu: DUPLICATE_UNIQUE_PROPERTY
Ważność: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)

Ten błąd występuje, gdy pole lub element podrzędny, który musi być unikalny w obrębie pojedynczej encji POI, zawiera zduplikowane wpisy.

Sprawdź w panelu Szczegóły problemu, która właściwość narusza unikalność:

1. Zduplikowany identyfikator marki w miejscu (local_data.brand_landing_pages.brand_id)

  • Przyczyna: ten sam ciąg znaków brand_id pojawia się w wielu wpisach brand_landing_pages dla jednego miejsca.
  • Rozwiązanie: skonsoliduj wszystkie strony docelowe tej marki w jednym obiekcie brand_landing_pages.

Przykład prawidłowego ładunku:

{
  "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. Zduplikowany adres URL zlokalizowanej strony docelowej marki (local_data.brand_landing_pages.localized_landing_pages.url)

  • Przyczyna: ten sam adres URL strony docelowej jest zdefiniowany wielokrotnie w elemencie localized_landing_pages dla tej samej marki.
  • Rozwiązanie: upewnij się, że każdy wpis adresu URL jest unikalny, lub powiąż wiele języków w tablicy locales pojedynczego wpisu adresu URL.

Przykład prawidłowego ładunku:

{
  "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. Zduplikowany język strony docelowej zlokalizowanej dla marki (local_data.brand_landing_pages.localized_landing_pages.locales)

  • Przyczyna: ten sam kod języka (np. "en-US") powtarza się w wielu wpisach w pliku localized_landing_pages dla tej samej marki.
  • Rozwiązanie: przypisz każdy tag języka do dokładnie jednej zlokalizowanej strony docelowej.

Przykład prawidłowego ładunku:

{
  "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"]
          }
        ]
      }
    ]
  }
}

Nieprawidłowy lub niepoprawnie sformatowany adres URL marki

Kod problemu: INVALID_ATTRIBUTE_VALUE
Ważność: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)
Pola, których dotyczy problem: local_data.brand_landing_pages.default_url, local_data.brand_landing_pages.localized_landing_pages.url

Ten błąd występuje, gdy domyślny adres URL marki lub adres URL zlokalizowanej strony docelowej nie przejdzie weryfikacji składni identyfikatora URI.

Wymagania:

  • Protokół: musisz wyraźnie określić http:// lub https:// (https:// jest wymagany w przypadku wyświetlania w środowisku produkcyjnym).
  • Składnia: musi to być prawidłowy, zakodowany procentowo adres URL zgodny ze standardem RFC 3986 z pełną i jednoznaczną nazwą domeny.

Przykład prawidłowego ładunku:

{
  "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"]
          }
        ]
      }
    ]
  }
}

Naruszenie zasad dotyczących tekstu w treściach w wyszukiwarce Google – kategoria placówki

Kod problemu: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Waga: ostrzeżenie (nie blokuje wyświetlania)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)
Pole, którego dotyczy problem: local_data.establishment_category.localizations.*.text

To ostrzeżenie pojawia się, gdy tekst kategorii lokalnej placówki nie przechodzi automatycznych filtrów treści SafeSearch. Jeśli lokalizacja kategorii oznaczonej placówki (lub całe pole establishment_category, jeśli oznaczono domyślne ustawienia regionalne) zostanie pominięta, ciekawe miejsce nadal będzie mogło się wyświetlać.

Działanie naprawcze:

Przykład prawidłowego ładunku:

{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        },
        {
          "locale": "fr",
          "text": "Restaurant gastronomique"
        }
      ]
    }
  }
}