Z tego artykułu dowiesz się, jak przesłać podstawowy plik danych, aby włączyć reklamy pojazdów.
Jeśli dane reklam pojazdów chcesz przesyłać za pomocą interfejsu API, kliknij tutaj.
Podstawowy plik danych to lista wszystkich pojazdów w Twoim asortymencie wraz z atrybutami opisowymi. Niektóre atrybuty są wymagane w przypadku wszystkich reklam pojazdów w pliku danych, niektóre są wymagane w przypadku niektórych typów reklam pojazdów, a jeszcze inne są tylko zalecane. Niepodanie wymaganego atrybutu może spowodować, że reklama pojazdu nie będzie się wyświetlać w wynikach, a brak zalecanych atrybutów może wpłynąć na skuteczność reklamy.
Zalecamy przesłanie całego asortymentu pojazdów w jednym pliku danych.
Uwaga: aby uprościć zarządzanie plikami danych, możesz nawiązać współpracę z dostawcą zewnętrznym, takim jak Fullpath lub Ansira. Dostawcy plików danych o pojazdach mogą zautomatyzować ich tworzenie i przesyłanie. Dowiedz się, jak się zarejestrować i przesłać plik danych.
Zanim zaczniesz
- Obsługiwane typy pojazdów: obsługiwane są tylko pojazdy osobowe do zastosowań niekomercyjnych, takie jak samochody czy pick-upy. Z reklam pojazdów nie można korzystać do promowania m.in. kamperów, łodzi, autobusów czy pociągów.
- Obsługiwane oferty: plik danych powinien zawierać tylko oferty pojazdów. Nie powinny się w nim znajdować oferty części zamiennych, akcesoriów ani innych produktów.
- Nagłówki atrybutów: aby plik danych został prawidłowo przetworzony, musisz używać wymienionych poniżej nagłówków atrybutów.
- Unikalne oferty pojazdów: zadbaj o to, aby każda oferta pojazdu występowała tylko raz w pliku danych. W tym celu sprawdzaj numer identyfikacyjny pojazdu (numer VIN). Jeśli dla jednego pojazdu jest dostępnych kilka kodów sklepów lub kilka rodzajów realizacji transakcji sprzedaży pojazdu, kody sklepów można podać w polach powtarzanych, a rodzaj realizacji – w atrybucie grupy. W takim przypadku nie trzeba przesyłać numeru VIN kilka razy. Jeśli prześlesz ten sam numer VIN dla kilku ofert pojazdów, oferty te zostaną odrzucone w ramach danego pliku danych.
- Wyjątek: jeśli przesyłasz oferty w kilku językach, możesz uwzględnić dane pojazdu lub numer VIN kilka razy, oddzielnie dla każdego języka (o ile odpowiednie dane są dostępne).
- W krajach EOG i Wielkiej Brytanii zamiast niego należy przesłać identyfikator
[id]. Identyfikator musi też być widoczny na stronie docelowej pojazdu.
Tworzenie podstawowego pliku danych
Krok 1. Utwórz plik tekstowy rozdzielany znakami, plik XML lub użyj interfejsu API
Na początek utwórz plik tekstowy rozdzielany znakami (zalecane) lub plik XML. Możesz też użyć interfejsu API.
Krok 2. Poinformuj nas, jakie pojazdy obejmuje Twój asortyment
Podstawowy plik danych to dla Google źródło informacji o Twoich reklamach pojazdów. Dane, które przesyłasz w tym pliku, będą się wyświetlać klientom szukającym Twoich pojazdów.
Specyfikacja pliku danych reklam pojazdów
Uwaga: aby wyświetlić całą treść, przewiń tabelę od lewej do prawej.
| Atrybut | Opis | Typ |
|---|---|---|
Kategoria produktów Google [google_product_category] |
Wymagany Kategoria produktów Google. |
Wybierz kategorię: LUB Użyj kodu kategorii: |
Realizacja transakcji sprzedaży pojazdu [vehicle_fulfillment] |
Wymagane Ten atrybut grupy jest używany z atrybutem podrzędnym |
Obsługiwane wartości:
Ten atrybut może być powtarzany maksymalnie 3 razy w przypadku każdej oferty, co pozwala sprzedawcom samochodów określić opcję każdego rodzaju realizacji. |
Tytuł [title] |
Opcjonalny Konkretny tytuł pojazdu na sprzedaż wyświetlany w Merchant Center. |
Tytuł jest generowany automatycznie na podstawie innych atrybutów. Sprzedawcy mogą go wpisać samodzielnie, ale taki tytuł nie będzie używany. |
Typ produktu [product_type] |
Opcjonalny Użyj tego atrybutu, aby wprowadzić w danych produktów własny system podziału na kategorie. |
Ciąg znaków |
Numer VIN [VIN] |
Wymagane Opcjonalny w niektórych krajach Unikalny numer identyfikacyjny każdego pojazdu. Jeśli numer VIN |
Ciąg tekstowy, 17 cyfr |
Identyfikator [id] |
Wymagany Unikalny identyfikator Twojego produktu. Może to być wewnętrzny numer inwentaryzacyjny lub numer VIN. W krajach EOG i Wielkiej Brytanii identyfikator ten powinien być też widoczny na stronie docelowej pojazdu. |
Ciąg tekstowy. Nie może się powtarzać. |
Kod sklepu [store_code] |
Opcjonalnie Unikalny identyfikator alfanumeryczny każdego salonu sprzedaży. Uwaga: w atrybucie kod sklepu wielkość liter ma znaczenie i musi ona odpowiadać kodom sklepów przesłanym w profilu firmy. |
Ciąg znaków Jest to pole powtarzane, które może przyjmować większą liczbę wartości. |
Link do zdjęcia [image_link] |
Wymagany Jedno zdjęcie konkretnego pojazdu. |
Adres URL głównego zdjęcia pojazdu. Więcej informacji o wskazówkach dotyczących zdjęć w reklamach pojazdów |
Link do dodatkowego zdjęcia [additional_image_link] |
Opcjonalny Maksymalnie 10 dodatkowych zdjęć konkretnego pojazdu. |
Dodatkowe zdjęcia pojazdu, inne niż zdjęcie przesłane w atrybucie link do zdjęcia. Zwykle służące do pokazania pojazdu pod różnymi kątami. Jest to pole powtarzane, które może przyjmować większą liczbę wartości. |
Szablon linku [link_template] |
Wymagany w przypadku ofert w sklepie i z odbiorem osobistym w sklepie Link do strony z opisem konkretnego pojazdu (VDP). Pamiętaj, aby uwzględnić parametr ValueTrack Uwaga: parametr w adresie URL powinien być zapisany za pomocą ciągu znaków „ |
Adres URL strony docelowej pojazdu w Twojej witrynie. Przykład: uwzględnienie store_code jako parametru adresu URL – http://mikemart.com/123?store={store_code} Przykład: uwzględnienie store_code jako części ścieżki adresu URL – http://acmestores.com/456/store/{store_code} |
Link [link] |
Wymagany w przypadku ofert online Link do strony z opisem konkretnego pojazdu (VDP). |
Adres URL strony docelowej pojazdu w Twojej witrynie w wersji na komputery. |
Szablon linku mobilnego [mobile_link_template] |
Opcjonalny Link do strony na urządzenia mobilne z opisem konkretnego pojazdu (VDP). Pamiętaj, aby uwzględnić parametr ValueTrack Uwaga: parametr w adresie URL powinien być zapisany za pomocą ciągu znaków „store_code”. Nie podawaj faktycznego kodu sklepu. |
Adres URL strony docelowej pojazdu w Twojej witrynie mobilnej. |
Link mobilny [mobile_link] |
Opcjonalny Link do strony na urządzenia mobilne z opisem konkretnego pojazdu (VDP). |
Adres URL strony docelowej pojazdu w Twojej witrynie mobilnej. |
Przekierowanie z reklam [ads_redirect] |
Opcjonalny Podobny do atrybutu link_template, ale może zawierać parametry śledzenia reklam. Link do strony z opisem konkretnego pojazdu (VDP). Pamiętaj, aby uwzględnić parametr ValueTrack |
Przykład: https://tracking.example.com?product=sports-car&store={store_code}&src=google¶m=abc |
Cena [price] |
Wymagany Cena sprzedaży wyświetlana w reklamie. Sprawdź, czy ta cena odpowiada najbardziej widocznej lub ostatecznej cenie na stronie docelowej z opisem konkretnego pojazdu oraz jest zgodna z lokalnymi przepisami prawa dotyczącymi informacji o cenach. W Wielkiej Brytanii do ceny wliczają się wszystkie podatki i nieopcjonalne opłaty, które faktycznie zostają poniesione przez konsumenta (w walucie lokalnej). W Stanach Zjednoczonych cena powinna być rzeczywistą ceną, za którą każdy konsument może kupić reklamowany pojazd, z wyłączeniem tylko wymaganych opłat urzędowych. |
Liczba i waluta (w formacie ISO 4217). Przykład: |
Typ ceny pojazdu [vehicle_price_type] |
Wymagany w przypadku nowych samochodów w Australii, Japonii i Kanadzie oraz używanych samochodów w Australii i Japonii. Opcjonalny w niektórych krajach Enum: All-in, Drive-away itp. Dowiedz się więcej o zastosowaniu atrybutu typ ceny pojazdu. |
Użyj atrybutu Obsługiwane wartości:
|
Sugerowana cena detaliczna pojazdu [vehicle_msrp] |
Wymagany w niektórych krajach w przypadku nowych samochodów Opcjonalny w przypadku używanych samochodów Sugerowana cena detaliczna producenta (MSRP) pojazdu w jego aktualnej konfiguracji. Jeśli MSRP różni się od ceny sprzedaży widocznej powyżej, powinna być wyświetlana oddzielnie na stronie docelowej VDP oraz oznaczona jako sugerowana cena detaliczna. |
Użyj tego samego formatowania co w atrybucie cena. |
Cena całkowita pojazdu [vehicle_all_in_price] |
Wymagany w niektórych krajach w przypadku nowych samochodów Opcjonalny w przypadku używanych samochodów Reklamowana cena zawierająca wszystkie opłaty obejmuje: wszelkie akcesoria dołączone do pojazdu, opłaty środowiskowe, dodatkową gwarancję, paliwo, fracht, inspekcję kontrolną przed wprowadzeniem na rynek (PDI), opłaty dealerskie za obsługę licencjonowania, regionalne opłaty administracyjne, inne opłaty dealerskie za piaskowanie w celu zabezpieczenia i wypełnianie opon azotem oraz rabaty i zachęty od producenta i dealera dla klienta. Ta cena musi też być widoczna na stronie z opisem pojazdu. Uwaga: reklamowana cena zawierająca wszystkie opłaty nie obejmuje podatku od sprzedaży, licencji (kosztu rejestracji i tablicy rejestracyjnej), wymiany za dopłatą ani kosztów związanych z finansowaniem pojazdu. |
Użyj tego samego formatowania co w atrybucie cena. |
|
Rata |
Opcjonalny Cena raty za pojazd w przypadku zakupu lub leasingu. Atrybut dostępny tylko w niektórych krajach. W przypadku reklam pojazdów wymagane są wszystkie 4 atrybuty podrzędne ( Atrybut podrzędny roczna stopa oprocentowania Strona docelowa pojazdu musi zawierać pełne informacje o ofercie ratalnej zgodne z lokalnymi przepisami. Informacje dotyczące rat wyświetlane w formatach reklam są oparte na reprezentatywnym przykładzie podanym na stronie docelowej i mają charakter szacunkowy. |
|
Stan [condition] |
Wymagany Stan pojazdu. Zapoznaj się z dodatkowymi wytycznymi dotyczącymi kwestii związanych z przebiegiem w kontekście stanu pojazdu. |
Obsługiwane wartości:
|
Certyfikowany używany [certified_pre-owned] |
Opcjonalny Samochód jest certyfikowanym używanym pojazdem OEM. |
Wartość logiczna (yes lub no) |
Marka [brand] |
Wymagany Nazwa firmy, która wyprodukowała pojazd. |
Ciąg znaków |
Model [model] |
Wymagany Model samochodu bez dokładnych informacji dotyczących wersji. Prześlij wartość „Model” zamiast wartości „Model deluxe” czy „Model standardowy”. |
Ciąg znaków |
Wersja [trim] |
Opcjonalnie Wymagana w Japonii Wersja modelu. |
Ciąg tekstowy (np. S, SV, SL) |
Rok [year] |
Wymagany Opcjonalny w niektórych krajach Rok modelu. |
Liczba całkowita (4 cyfry) |
Przebieg [mileage] |
Wymagany Przebieg pojazdu. Pamiętaj, aby podać jednostkę (km lub mile). |
Liczba całkowita + jednostka (km lub mile) Przykład: |
Kolor [color] |
Wymagany Kolor karoserii określony przez producenta OEM, tekst. |
Ciąg znaków Przykłady: biały, czarny, czerwony, platynowy, metaliczny trójwarstwowy Uwagi:
|
Opcja wyposażenia pojazdu [vehicle_option] |
Opcjonalny (Wymagany w przypadku bezpłatnych reklam pojazdów) Lista opisująca wyposażenie pojazdu rozdzielana przecinkami. Przykład: skórzane fotele, kamera cofania, system nawigacji, podgrzewane przednie siedzenia, klimatyzacja, szyberdach, Bluetooth. |
Ciąg znaków Maksymalna liczba obsługiwanych wartości to 200. Każda wartość może zawierać do 256 znaków. Jest to pole powtarzane, które może przyjmować większą liczbę wartości. |
Typ nadwozia [body_style] |
Opcjonalny Enum: m.in. sedan, SUV lub crossover |
Obsługiwane wartości:
|
Silnik [engine] |
Opcjonalny Wymagany w niektórych krajach Enum: benzynowy, Diesla, elektryczny, hybrydowy itp. |
Obsługiwane wartości:
|
Opis [description] |
Opcjonalny Dowolny tekst. Uwagi i opcje sprzedawcy: pole tekstowe na dodatkowe informacje o samochodzie, np. jego właścicielu lub wyposażeniu, takim jak skórzane siedzenia, kamera cofania, system nawigacji, podgrzewane przednie siedzenia, klimatyzacja, szyberdach czy radio satelitarne. |
Ciąg znaków |
Etykieta własna [custom_label_[0-4]] |
Opcjonalny Dodaj maksymalnie 5 etykiet własnych. Etykiety własne od Możesz np. oznaczyć grupę produktów według producenta, modelu lub roku produkcji. Dowiedz się, jak używać etykiet własnych w reklamach produktowych. |
Ciąg znaków Przykład:
|
Obsługiwane miejsce docelowe [included_destination] |
Opcjonalny Jeśli chcesz, aby Twój produkt wyświetlał się w dodatkowych miejscach docelowych (poza tymi określonymi w ustawieniach pliku danych), użyj atrybutu obsługiwane miejsce docelowe Dowiedz się więcej o obsługiwanym miejscu docelowym [included_destination]. |
Obsługiwane wartości:
|
Wykluczone miejsce docelowe [excluded_destination] |
Opcjonalny Jeśli chcesz, aby dany produkt nie wyświetlał się w konkretnych miejscach docelowych, użyj atrybutu wykluczone miejsce docelowe Dowiedz się więcej o wykluczonym miejscu docelowym [excluded_destination]. |
Obsługiwane wartości:
|
Data pierwszej rejestracji [date_first_registered] |
Wymagany w niektórych krajach w przypadku pojazdów używanych Opcjonalna w innych krajach |
Ciąg znaków (RRRR-MM) Przykład:2020-07 |
Zużycie paliwa [fuel_consumption] |
Wymagany w niektórych krajach w przypadku nowych samochodów z silnikiem benzynowym, Diesla, hybrydowym lub hybrydowym typu plug-in Ilość zużywanego paliwa w litrach podczas przebycia 100 km danym pojazdem. W przypadku silników na gaz ziemny należy podać wartość w kg/100 km. Uwaga: podane wartości muszą być mierzone w połączonym cyklu testowym. |
Liczba + jednostka (l/100 km lub kg/100 km) Przykład:6.2 l/100km |
|
Zużycie paliwa po rozładowaniu baterii |
Wymagany w niektórych krajach Przykład: 6.2 l/100km (jednostka jest podana małą literą „L”) W przypadku silników na gaz ziemny należy podać wartość w kg/100 km. |
Liczba + jednostka (l/100 km lub kg/100 km) |
Emisja CO2 [co2_emissions] |
Wymagany w niektórych krajach w przypadku nowych samochodów. Jeśli atrybut engine = electric, wpisz 0 g/km. Emisja CO2 przez dany pojazd podawana w g/km. Uwaga: podane wartości muszą być mierzone w połączonym cyklu testowym. |
Liczba + jednostka Przykład:120 g/km |
Zużycie energii [energy_consumption] |
Wymagany w niektórych krajach w przypadku nowych samochodów, gdy atrybut engine to plug-in hybrid lub electric. Uwaga: podane wartości muszą być mierzone w połączonym cyklu testowym. |
Liczba + jednostka Przykład:17.2 kWh/100km |
|
Zasięg na napędzie elektrycznym |
Wymagany w niektórych krajach w przypadku nowych samochodów, gdy atrybut engine to plug-in hybrid lub electric Zasięg pojazdów elektrycznych na napędzie elektrycznym. Uwaga: podane wartości muszą być mierzone w połączonym cyklu testowym. W przypadku pojazdów hybrydowych typu plug-in należy zgodnie z wytycznymi lokalnego regulatora rynku podać równorzędny zasięg na napędzie elektrycznym (EAER) w kilometrach. |
Liczba całkowita + jednostka (km/mile) Przykład: 2333 mile |
|
Certyfikat |
Wymagany w Niemczech w przypadku nowych samochodów. Certyfikat emisji pojazdu (np. BMWK w Niemczech lub ADEME we Francji). |
|
Standard emisji [emissions_standard] |
Standard emisji powiązany z wartością emisji CO2 pojazdu. Wymagany we Włoszech w przypadku nowych samochodów. |
Obsługiwane wartości:
|
Koszty związane z pojazdami [vehicle_expenses] |
Opcjonalne Wymagane w Japonii w przypadku pojazdów używanych. Różne koszty, w tym ubezpieczenie, opłaty rejestracyjne itp. |
Liczba i waluta (w formacie ISO 4217) |
Kategoria pojazdu [vehicle_category] |
Opcjonalny w Japonii. Kategoria pojazdu. Ten atrybut jest obecnie używany tylko w Japonii. Kei jidosha: lekkie pojazdy z silnikami o pojemności do 660 cm³. Futsu sha: średnie pojazdy z silnikami o pojemności 660–2000 cm3 oraz inne, które nie są klasyfikowane jako ani Kei jidosha, ani Ogata sha. Ogata sha: silniki w dużych pojazdach. |
Obsługiwane wartości:
|
Gwarancja [warranty] |
Opcjonalna i dostępna tylko w Japonii. Jeśli atrybut nie jest określony, oznacza to „Brak gwarancji”. Okres obowiązywania: liczba (w miesiącach) Przebieg: liczba (w kilometrach) W przypadku gwarancji niezwiązanych z przebiegiem, a zależnych tylko od okresu, określ czas obowiązywania w miesiącach, a pole dotyczące przebiegu pozostaw puste. |
Atrybut grupy |
Obejmuje obowiązkowy przegląd pojazdu [vehicle_mandatory_inspection_included] |
Wymagany w Japonii w przypadku pojazdów używanych Jeśli pojazd jest sprzedawany z obowiązkowym przeglądem i konserwacją wykonanymi przed dostawą, w Japonii wyświetla się informacja „obejmuje przegląd okresowy”. |
Wartość logiczna (yes lub no) |
Zastosowanie atrybutów cena
Uwaga: aby wyświetlić całą treść, przewiń tabelę od lewej do prawej.
| Kraj |
Typ asortymentu |
Typ reklamodawcy |
price |
vehicle_price_type |
|
|
|---|---|---|---|---|---|---|
| Australia | Używany | Wszyscy | Wymagany |
Wymagany
|
Opcjonalny | Nie dotyczy* |
| Nowy | Wszyscy | Wymagany | Wymagany
|
Wymagany | Nie dotyczy* | |
| Kanada | Używany | Wszyscy | Wymagany | Opcjonalny
Nie dotyczy. Pozostaw atrybut pusty lub nie podawaj go w pliku danych. |
Opcjonalny | Opcjonalny |
| Nowy | Wszyscy | Wymagany | Wymagany
|
Opcjonalny | Wymagany | |
| Francja | Obie opcje | Wszyscy | Wymagany | Opcjonalny
Nie dotyczy. Pozostaw atrybut pusty lub nie podawaj go w pliku danych. |
Opcjonalny | Nie dotyczy* |
| Niemcy | Obie opcje | Wszyscy | Wymagany | Opcjonalny
Nie dotyczy. Pozostaw atrybut pusty lub nie podawaj go w pliku danych. |
Opcjonalny | Nie dotyczy* |
| Japonia | Obie opcje | Wszyscy | Wymagany |
Wymagany
|
Opcjonalny | Nie dotyczy* |
| Wielka Brytania | Obie opcje | Wszyscy | Wymagany | Opcjonalny
Nie dotyczy. Pozostaw atrybut pusty lub nie podawaj go w pliku danych. |
Opcjonalny | Nie dotyczy* |
| Stany Zjednoczone | Używany | Wszyscy | Wymagany | Opcjonalny
Nie dotyczy. Pozostaw atrybut pusty lub nie podawaj go w pliku danych. |
Opcjonalny | Nie dotyczy* |
| Nowy | Wszyscy | Wymagany | Opcjonalny
Nie dotyczy. Pozostaw atrybut pusty lub nie podawaj go w pliku danych. |
Wymagany | Nie dotyczy* |
Nie dotyczy* – pozostaw atrybut pusty lub nie podawaj go w pliku danych.
all_in_price
Dotyczy Kanady
vehicle_price_type = all_in_price |
Wymagany w przypadku wszystkich ofert nowych samochodów w Kanadzie.
drive_away_price
Dotyczy Australii
Cena całkowita obejmuje opłatę skarbową, podatek od samochodów luksusowych (jeśli dotyczy), obowiązkowe ubezpieczenie od odpowiedzialności cywilnej, rejestrację i dostawę od dealera.
- Ten typ ceny lub parametr
estimated_drive_away_price(poniżej) jest wymagany w Australii w przypadku nowych samochodów. - Ten typ ceny lub parametr
excluding_government_charges_price(poniżej) jest wymagany w Australii w przypadku samochodów używanych.
vehicle_price_type = drive_away_price |
estimated_drive_away_price
Dotyczy Australii
Szacowana cena całkowita opisana wyżej obejmuje opłatę skarbową, podatek od samochodów luksusowych (jeśli dotyczy), obowiązkowe ubezpieczenie od odpowiedzialności cywilnej, rejestrację i dostawę od dealera, ale jest tylko ceną szacunkową. Rzeczywista cena całkowita może się różnić w zależności od regionu lub innych czynników.
- Ten typ ceny lub parametr
drive_away_price(powyżej) jest wymagany w Australii w przypadku nowych samochodów.
vehicle_price_type = estimated_drive_away_price |
excluding_government_charges_price
Dotyczy Australii
Cena bez opłaty skarbowej nie obejmuje opłat celnych, podatków ani innych opłat pobieranych bezpośrednio od konsumentów przez organy zewnętrzne.
Ten typ ceny lub parametr drive_away_price (powyżej) jest wymagany w Australii w przypadku samochodów używanych.
vehicle_price_type = excluding_government_charges_price |
vehicle_base_price
Dotyczy Japonii
Cena podstawowa pojazdu nie obejmuje ubezpieczenia ani opłat rejestracyjnych.
- Wymagana w przypadku nowych i używanych samochodów w Japonii.
vehicle_price_type = vehicle_base_price |
- Reklamy pojazdów nie mają atrybutu dostępność
[availability], dlatego go nie przesyłaj. Przesłanie go może spowodować błędy w pliku danych. - Jeśli nie podasz wartości opcjonalnego atrybutu, Google uzna, że nie został on przesłany.
Częstsze aktualizacje asortymentu
Ceny i dostępność produktów w asortymencie mogą się często zmieniać. Aby częściej aktualizować dane o asortymencie, zwiększ częstotliwość przesyłania pliku danych. Aby przesłać dane produktów przez interfejs API, dowiedz się więcej o interfejsie Google Content API.
