Krok 2. Pliki danych

Najpierw musisz utworzyć pliki danych, a 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. Na początek utwórz plik danych sprzedawcy (i w razie potrzeby plik danych usług):

    • Plik danych sprzedawców: plik danych Merchants zawiera informacje o sprzedawcach i linki do działań na poziomie sprzedawcy.
    • Plik danych usług (opcjonalny / niezalecany): nie zalecamy implementowania plików danych o usługach w przypadku nowych integracji typu Ordering Redirect. Jeśli chcesz zachować istniejącą integrację, postępuj zgodnie z tą starszą dokumentacją.

    Pola wymagane i zalecane

    Kanał Nazwa pola Opis Wymagana?
    Sprzedawca merchant_id Unikalny identyfikator sprzedawcy Tak
    Sprzedawca nazwa Nazwa sprzedawcy Tak
    Sprzedawca geo Adres i współrzędne geograficzne sprzedawcy Tak
    Sprzedawca telefon Telefon sprzedawcy Tak
    Sprzedawca category Typ miejsca sprzedawcy Przydatne
    Sprzedawca action_link Informacje o precyzyjnych linkach dla sprzedawców Tak
    Sprzedawca action_link_type Partnerzy korzystający z przekierowania zamówień powinni zapoznać się z przewodnikiem po zamawianiu jedzenia na wynos i z dostawą. Tak
    Sprzedawca food_ordering_metadata Określ opłaty i czas dostawy za zamawianie jedzenia. Polecane
    Sprzedawca brand_id Ciąg znaków określający markę przeznaczoną dla klientów, której należy użyć Opcjonalnie

    Na początek obejrzyj przykładowe pliki danych

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

    Oto fragment metadanych kanału:

    "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ładni bufora protokołu 3, ale możesz zapoznać się z wspomnianymi wyżej przykładami, aby poznać format JSON. Zalecamy przesyłanie plików danych w formacie JSON.

    Jeśli naprawdę chcesz korzystać z formatu pb3, ogólne informacje o tym, jak używać buforów protokołów do generowania pliku pb3, znajdziesz w dokumentacji bufora protokołu: Java.

  3. Prześlij pliki danych do skrzynki referencyjnej SFTP. Aby przesłać pliki danych, skorzystaj z informacji o skrzynce referencyjnej SFTP, które przesłaliśmy Ci przez Google, oraz z klucza prywatnego utworzonego podczas konfiguracji. Serwer SFTP Google jest dostępny pod adresem sftp://partnerupload.google.com na porcie 19321.

    Prześlij pliki o unikalnych nazwach, np. z nazwą zawierającą sygnaturę czasową. Unikalne nazwy pomagają rozwiązywać problemy i umożliwiają wysyłanie zapytań o stan pliku danych.

    Aby określić rozmiar plików danych i częstotliwość przesyłania, skorzystaj z tych wytycznych:

    • Rozmiar plików danych i fragmentów:
      • Po skompresowaniu rozmiar pliku danych nie może przekraczać 200 MB. Skompresuj je za pomocą: gzip
      • Jeśli rozmiar pliku przekracza 200 MB (po skompresowaniu), podziel go na kilka fragmentów zgodnie z samouczkiem dotyczącym fragmentowania plików danych . Jednak w przypadku samej integracji raczej nie zostanie osiągnięty limit 200 MB.
    • Częstotliwość pełnych aktualizacji:
      • Kompletny plik danych sprzedawcy jest dostarczany raz dziennie.
      • (Jeśli zaimplementowano) Pełny plik danych usługi jest dostarczany raz dziennie.

Google ocenia pliki danych

Gdy prześlesz pliki danych, Google przetwarza je i ocenia pod względem jakości i kompletności. Bierzemy pod uwagę kilka czynników:

  • Pliki danych są zgodne ze specyfikacjami.
  • Pliki danych zawierają wszystkie wymagane pola.
  • Każdy sprzedawca ma co najmniej jedną usługę action_link lub jedną ze zdefiniowaną co najmniej jedną usługą (action_link).
  • Większość Twoich danych sprzedawcy jest zgodna z lokalizacjami w Mapach Google.