Krok 2. Pliki danych

Najpierw musisz utworzyć pliki danych, a potem Google je oceni.

Tworzenie plików danych

  1. Wygeneruj pliki danych. Większość danych o asortymencie przesyłasz do Google za pomocą plików danych. Aby rozpocząć, utwórz plik danych sprzedawcy (i w stosownych przypadkach plik danych usług):

    • Plik danych o firmach: plik danych o firmach opisuje Twoich sprzedawców i linki do działań na poziomie sprzedawcy.
    • Plik danych Usługi (opcjonalny / nie zalecany): Nie zalecamy wdrażania plików danych Usługi w przypadku nowych integracji z Business Link Rezerwacji. Jeśli chcesz zachować dotychczasową integrację, postępuj zgodnie z tą starszą dokumentacją.

    Pola wymagane i zalecane

    Kanał Nazwa pola Opis Wymagany?
    Sprzedawca merchant_id Unikalny identyfikator sprzedawcy Tak
    Sprzedawca nazwa Nazwa sprzedawcy Tak
    Sprzedawca geo Adres i współrzędne geograficzne sprzedawcy Tak
    Sprzedawca telefon Numer telefonu sprzedawcy Tak
    Sprzedawca kategoria Typ miejsca sprzedawcy Opcjonalne
    Sprzedawca action_link Informacje o precyzyjnych linkach do konkretnych sprzedawców Tak
    Sprzedawca action_link_type Typ działania związanego z linkiem. Partnerzy korzystający z linku do strony składania rezerwacji powinni używać ACTION_LINK_TYPE_MAKE_DINING_RESERVATION.
    Sprzedawca brand_id Ciąg znaków identyfikujący markę przeznaczoną dla klientów, której należy użyć Opcjonalnie

    Na początek zapoznaj się z przykładowymi plikami danych

    Więcej informacji o określaniu linków akcji w plikach danych integracji Rezerwacje – Business Link znajdziesz tutaj.

    Dołącz do każdego pliku danych metadane, które informują Google, jak interpretować plik danych.

    Oto fragment metadanych pliku danych:

    "metadata": {
     "generation_timestamp": "1467993600",
     "processing_instruction": "PROCESS_AS_COMPLETE",
     "total_shards": 1
    }
  2. Wyeksportuj swoje pliki danych. Format plików danych jest opisany za pomocą składniki protokołu buffera 3, ale możesz też skorzystać z wymienionych powyżej przykładów, aby zobaczyć format JSON. Zalecamy przesyłanie plików danych w formacie JSON.

    Jeśli naprawdę chcesz użyć formatu pb3, ogólne informacje o używaniu buforów protokołu do generowania plików pb3 znajdziesz w artykule Podstawy bufora protokołu: Java.

  3. Prześlij pliki danych do skrzynki referencyjnej SFTP. Aby przesłać pliki danych, użyj informacji o sftp-owym folderze Dropbox, które zostały Ci przekazane przez Google, oraz klucza prywatnego utworzonego w konfiguracji. Serwer SFTP Google jest dostępny pod adresem sftp://partnerupload.google.com na porcie 19321.

    Przesyłaj pliki o niepowtarzalnych nazwach, np. z dodatkiem sygnatury czasowej. Unikalne nazwy ułatwiają rozwiązywanie problemów i umożliwiają wysyłanie zapytań dotyczących stanu kanału.

    Aby określić rozmiar plików danych i częstotliwość przesyłania, zastosuj te wskazówki:

    • Rozmiar plików i fragmentów pliku danych:
      • Rozmiar pliku danych nie może przekraczać 200 MB (po skompresowaniu). Skompresuj je za pomocą gzip
      • Jeśli plik może mieć więcej niż 200 MB (po kompresji), podziel go na kilka części, korzystając z tego samouczka dotyczącego dzielenia plików danych . Jednak sama ta integracja raczej nie spowoduje przekroczenia limitu 200 MB.
    • Częstotliwość pełnych aktualizacji:
      • Pełny plik danych sprzedawcy jest przesyłany raz dziennie.
      • (jeśli jest to możliwe) pełny plik danych o usłudze jest dostarczany raz dziennie;

Google ocenia pliki danych

Gdy prześlesz pliki danych, Google przetworzy je i oceni ich jakość oraz kompletność. Uwzględniamy kilka czynników:

  • pliki danych są zgodne ze specyfikacją,
  • Pliki danych zawierają wszystkie wymagane pola.
  • Każdy sprzedawca ma co najmniej 1 element action_link lub 1 usługę z co najmniej 1 elementem action_link.
  • Większość danych sprzedawcy jest zgodna z lokalizacjami w Mapach Google.