Pliki danych

Tworzenie plików danych

Aby dane były wyświetlane bezpośrednio w Google, muszą być regularnie przesyłane do Google. Potrzebne są te pliki danych:

Kanał Opis Częstotliwość
Sprzedawcy Opisuje Twoich sprzedawców. Co 24 godziny
Usługi Opisuje usługi oferowane przez Twoich sprzedawców. Co 24 godziny
Dostępność dostępne przedziały na usługi oferowane przez sprzedawców; Musisz podać dane dotyczące co najmniej 30 dni. Co 24 godziny

W każdym pliku danych dołącz metadane, które informują Google, jak go interpretować.

Format plików danych jest opisany za pomocą składniki protokołu buffera 3, ale możesz przesłać pliki danych w odpowiednim formacie JSON. Aby zapoznać się z formatem JSON, zapoznaj się z przykładami plików danych. Zalecamy przesyłanie plików danych w formacie JSON.

Rozmiar pliku danych, dzielenie na fragmenty i kompresja

Zapoznaj się z tymi samouczkami dotyczącymi kompresji i fragmentów:

Aby określić rozmiar plików danych, skorzystaj z tych wytycznych (plik danych może składać się z kilku plików zwanych „fragmentami”):

  • Sugerowany podział pliku danych:
    • Plik danych sprzedawcy: 1 część
    • Plik danych Usługi: 1 część
    • Plik danych o dostępności : mniej niż 20 fragmentów
  • Rozmiar plików danych i dzielenie na fragmenty:
    • Rozmiar pliku fragmentu nie powinien przekraczać 200 MB (po kompresji). W razie potrzeby użyj wielu fragmentów.
    • Pojedyncze rekordy wysłane w ramach jednego fragmentu nie muszą być wysyłane w tym samym fragmencie w przyszłych plikach danych.
    • Aby uzyskać lepszą wydajność, podziel dane równomiernie na fragmenty, aby wszystkie pliki fragmentów miały zbliżony rozmiar.
    • W razie potrzeby użyj gzip do skompresowania plików danych w formacie JSON w postaci zwykłego tekstu. Zrób to jednak dla każdego pojedynczego fragmentu pliku danych.

Przesyłanie plików danych do skrzynki referencyjnej SFTP

Prześlij pliki danych do środowiska piaskownicy. Aby to zrobić, sprawdź nazwy użytkowników na stronie Konfiguracja pliku danych w portalu dla partnerów. Serwer SFTP Google jest dostępny pod adresem sftp://partnerupload.google.com na porcie 19321.

Zalecamy nadawanie przesyłanym plikom unikalnych nazw. Możesz na przykład dodawać do nazwy każdego pliku sygnaturę czasową. Pomaga to rozwiązywać problemy i sprawdzać stan kanału.

Sprawdź, czy dane wyglądają prawidłowo

Zaloguj się w Portalu Partnera. Przełącz się na środowisko sandboksa, aby w sekcji Panele znaleźć te strony.

Pliki danych
Pokazuje statystyki podsumowania pliku danych i wskazuje błędy podczas przesyłania pliku danych.

Aby sprawdzić, czy dane są prawidłowe po ich pierwszym przesłaniu do środowiska piaskownicy, sprawdź na stronie Pliki danych, czy nie ma w nich błędów. Następnie sprawdź, czy na stronie Podsumowanie asortymentu nie ma problemów z danymi. Typowe problemy to przesyłanie danych o sprzedawcach bez usług lub przesyłanie danych o usługach bez żadnych wolnych terminów w przyszłości.

Front-end piaskownicy, który emuluje interfejs użytkownika, pokazuje, jak dane będą wyglądać z perspektywy użytkownika. Aby uzyskać do niego dostęp, upewnij się, że przełącznik środowiska u góry jest ustawiony na piaskownicę, a następnie przejdź do Inventory > Inventory , znajdź sprzedawcę, który jest „Gotowy” lub „Wdrożony (w piaskownicy)”, a następnie kliknij link w najbardziej prawej kolumnie (jeśli jest dostępny) lub kliknij wiersz i kliknij link „RwG – E2E”. Jeśli nie ma sprzedawcy ze stanem „Gotowy” lub „Wdrożony (w sandbox)”, otwórz wyłączonego sprzedawcę i usuń wszystkie problemy wymienione po prawej stronie (np. upewnij się, że przyszła dostępność została przesłana).

Jeśli nie możesz uzyskać dostępu do interfejsu piaskownicy, sprawdź, czy korzystasz z konta, które ma dostęp do interfejsu. Upewnij się też, że jest to jedyne konto, na którym jesteś zalogowany. Jeśli zalogujesz się na inne konto, a potem użyjesz funkcji Przełącz użytkownika, aby zalogować się na zatwierdzone konto Google, nadal nie będziesz mieć dostępu do interfejsu piaskownicy.

Przesyłanie plików danych do wersji produkcyjnej

Gdy będziesz regularnie przesyłać kompletne, pozbawione błędów pliki danych do środowiska piaskownicy, możesz rozpocząć przesyłanie do środowiska produkcyjnego. W tej chwili integracja nie jest aktywna.

Prześlij pełny plik danych o sprzedawcach tak szybko, jak to możliwe (co najmniej 1 tydzień przed premierą), aby rozpocząć dopasowywanie sprzedawców do wizytówek firm w Google. Sprawdź, czy dopasowanie jest prawidłowe.

Gdy wszystkie dane w pliku danych produkcyjnych są przesyłane w sposób spójny i połączone z systemem produkcyjnym, pliki danych są gotowe do sprawdzenia.

Google ocenia pliki danych

Gdy prześlesz pliki danych, Google przetworzy je i oceni ich jakość oraz kompletność. Uwzględniamy te czynniki:

  1. Pliki danych są zgodne ze specyfikacją pliku danych.
  2. Pliki danych zawierają wszystkie wymagane pola.
  3. Łączna liczba sprzedawców w plikach danych jest zgodna z liczbą uzgodnioną z Google.
  4. Dla każdego sprzedawcy zdefiniowana jest co najmniej 1 usługa.
  5. Łączna liczba usług w plikach danych jest zgodna z danymi przekazanymi przez Google.
  6. Sprawdzamy, ile usług ma wolne terminy w ciągu najbliższych 1–30 dni.
  7. Sprawdzamy, ilu sprzedawców można dopasować do funkcji w Mapach Google.