Plik danych to główne źródło danych, którego Google używa do uzyskiwania dostępu do Twoich pojazdów i ich wyświetlania. Obecnie obsługujemy pliki danych w formacie CSV, które możesz opcjonalnie skompresować w formacie ZIP lub GZ.
Utworzenie pliku danych
Aby sformatować informacje na potrzeby usługi informacji o pojazdach, użyj formatu opisanego w Format pliku danych, atrybutów podanych w Specyfikacji pliku danych oraz naszego pliku danych przykładowego. Zalecamy rozpoczęcie od kilku testowych pojazdów i przesłanie przykładowego pliku CSV do narzędzia do sprawdzania, aby sprawdzić format pliku danych. Później możesz zwiększyć zasięg, aby obejmował cały asortyment w Google.
Pamiętaj, aby uwzględnić w pliku danych te informacje, abyśmy mogli dokładnie dopasować pojazdy do salonów samochodowych w Google:
- Wymagany: kod sklepu
- Szczegółowe informacje znajdziesz w artykule Dopasowywanie danych o salonach sprzedaży.
- Wymagany: nazwa i adres pocztowy salonu sprzedaży
- Zalecane: identyfikator miejsca w Google lub adres URL Map Google.
- Te dane jednoznacznie identyfikują profil firmy w Google i eliminują niejednoznaczność w porównaniu z dopasowaniami, które wykorzystują nazwę i adres pocztowy.
Format pliku danych
Prześlij plik danych jako plik CSV (wartości rozdzielane przecinkami) lub TSV (wartości rozdzielane tabulatorami). Upewnij się, że plik spełnia te wymagania:
- Format CSV musi być zgodny ze standardem RFC 4180:
- Nie umieszczaj podwójnych cudzysłowów w pliku, chyba że są one ujęte w znaki ucieczki.
- Aby zmienić znaczenie podwójnego cudzysłowu, użyj 2 podwójnych cudzysłowów i dodatkowo otocz całe pole CSV podwójnymi cudzysłowami. Więcej informacji znajdziesz w sekcjach 2.5–2.7 dokumentu RFC 418.
- Przykładem prawidłowego użycia cudzysłowów jest
"Wheels 17"" Alloy", które wyświetla się jakoWheels 17" Alloy.
- Nie umieszczaj podwójnych cudzysłowów w pliku, chyba że są one ujęte w znaki ucieczki.
- Opcjonalnie możesz skompresować plik w formacie ZIP lub GZ.
- Plik danych musi zawierać 1 plik. Nie obsługujemy stosowania wielu fragmentów plików, czyli dzielenia na fragmenty.
- Każda wersja pliku danych musi zawierać cały asortyment dla wszystkich salonów, które chcesz wyświetlać w Google. Ponieważ każdy plik danych zawiera asortyment dla wszystkich Twoich salonów, nie musisz tworzyć osobnych kont dla każdego z nich. Po przetworzeniu pliku danych pojazdy zostaną pogrupowane według dealera na stronie diagnostycznej w portalu partnera.
- Nie obsługujemy częściowych (przyrostowych) aktualizacji zasobów reklamowych.
Przykładowy kanał
Jako szablon plików danych możesz użyć tego przykładowego pliku CSV:
store_code,id,VIN,year,make,model,trim,exterior_color,interior_color,mileage,condition,price,dealership_name,dealership_address,link,image_link,additional_image_link,vehicle_option,vehicle_fulfillment,legal_disclaimer
123,123,JA4AR3AW8GZ057772,2016,Mitsubishi,Outlander Sport,SE,Silver,Black,90377,Used,13998 USD,Dealer 123,123 Street,http://www.example.com/JA4AR3AW8GZ057772,http://www.image.com/image1,"http://www.image.com/image2, http://www.image.com/image3","Bluetooth,Rear View Camera,Front Seat Heaters,Navigation System",IN_STORE,"Price does not include taxes, fees"
Przesyłanie pliku danych do skrzynki referencyjnej SFTP
Gdy rejestrujesz konto do wyświetlania informacji o pojazdach, skrzynka referencyjna SFTP jest tworzona automatycznie. Aby przesłać pliki CSV, użyj informacji SFTP podanych na stronie Plik danych w portalu partnera.
Pliki można przesyłać za pomocą SFTP na wiele sposobów. Najczęstsze sposoby to użycie wiersza poleceń (Terminal) lub programu SFTP. Która metoda sprawdzi się najlepiej, zależy od tego, jak zarządzasz swoim asortymentem. Dlatego nie podajemy tutaj szczegółowych instrukcji eksportowania i przesyłania pojazdów na serwer SFTP Google.
Aby zminimalizować opóźnienia związane z przetwarzaniem pliku danych przez Google, zalecamy:
- Upewnij się, że Twój kanał przechodzi weryfikację w narzędziu.
- Sprawdź, czy dane pojazdu są zgodne ze specyfikacją pliku danych oraz z naszymi zasadami i ograniczeniami.
- Przesyłaj plik danych co najmniej raz dziennie.
- Prześlij całą listę produktów dla każdego salonu, który chcesz wyświetlać w Google.
Wyniki przetwarzania pliku danych
Po przesłaniu pliku danych możesz sprawdzić wyniki przetwarzania. Na stronie Plik danych w portalu dla partnerów widać stan każdego przesłanego pliku danych. Sprawdza on tylko podstawowe problemy z plikami i danymi, takie jak brak wymaganych pól lub nieprawidłowe formatowanie. Pełne wyniki przetwarzania będą dostępne na stronie Diagnostyka po kilku godzinach.
Utrzymywanie kanału
Zalecamy przesyłanie najnowszej wersji pliku danych co 4 godziny. Istnieją 2 główne powody, dla których zalecamy tak częste odświeżanie pliku danych:
- Częstsze przesyłanie plików danych zwiększa ogólną aktualność danych. Dzięki temu czas między aktualizacją asortymentu a przekazaniem danych do Google jest krótszy.
- Częste aktualizacje umożliwiają szybsze wykrywanie przerw w dostawie danych i ich odzyskiwanie, co może spowodować nieprawidłowe przetworzenie pliku danych.
Za każdym razem, gdy przesyłasz plik danych, sprawdź, czy zawiera on cały asortyment wszystkich dealerów. Pojazdy i dealerzy, których nie ma w pliku danych, są usuwani z Google w ciągu kilku godzin.
Po przesłaniu pliku danych do Google czas potrzebny na zaktualizowanie danych zależy od typu aktualizacji. Liczby w poniższej tabeli są szacunkowe i nie są gwarantowane.
| Zmiana pliku danych | Oczekiwany czas aktualizacji w Google |
|---|---|
| Dodawanie nowego salonu | 1 dzień |
| Usuwanie salonu samochodowego | 6 godzin |
| Zmiana profilu firmy w salonie samochodowym | 12 godzin |
| Dodawanie, usuwanie i aktualizowanie samochodu | 6 godzin |
Subskrybuj alerty dotyczące plików danych
Możesz otrzymać e-maila z powiadomieniem, gdy Google nie otrzyma pliku danych lub gdy nie zostanie on przetworzony przez ponad 24 godziny. W portalu dla partnerów otwórz stronę Konto i dodaj nowy adres e-mail, na który mają być wysyłane alerty dotyczące plików danych.