Pliki danych (starsza wersja)

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 usług w przypadku nowych integracji początkowych. 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 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

    Więcej informacji o określaniu linków działań w starszych plikach danych integracji startowej znajdziesz tutaj.

    W każdym pliku umieść metadane kanału, które informują Google o tym, jak je 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 sama integracja ze starszą wersją polecenia inicjującego prawdopodobnie nie osiągnie limitu 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.