Plik danych o asortymencie produktów dostępnych lokalnie to lista produktów, które sprzedajesz w każdym sklepie. Niektóre atrybuty są wymagane w przypadku wszystkich produktów, niektóre – dla określonych produktów, a inne są tylko zalecane.
Ceny i dostępność produktów w asortymencie mogą się często zmieniać w poszczególnych sklepach. Zwiększ częstotliwość przesyłania pliku danych, by dokonywać częstszych aktualizacji danych o asortymencie. Jeśli napotkasz problemy z częstotliwością przesyłania pliku danych, skontaktuj się z naszym zespołem pomocy przy użyciu formularza kontaktowego. Pamiętaj również, że synchronizacja lokalizacji sklepów z kontem Merchant Center może potrwać do 24 godzin, dlatego zalecamy przesłanie pliku danych o asortymencie po 24 godzinach od połączenia kont lub zaktualizowania kodu sklepu w Profilach Firm.
Aby przesłać dane produktów przez interfejs API, dowiedz się więcej o interfejsie Google Content API.
Przesyłanie pliku danych o asortymencie produktów dostępnych lokalnie
Typ pliku: plik danych o asortymencie produktów dostępnych lokalnie jest dostępny jako plik tekstowy rozdzielany znakami tabulacji, plik XML lub przez interfejs API.
Utwórz nowy plik danych o asortymencie produktów dostępnych lokalnie: aby utworzyć i zarejestrować nowy plik danych o asortymencie produktów dostępnych lokalnie, wykonaj te kroki.
Ważne: niektóre atrybuty w specyfikacji pliku danych o asortymencie produktów dostępnych lokalnie zawierają spacje i podkreślenia. Aby sprawdzić, czy przesyłane atrybuty zawierają prawidłowe znaki i spacje, postępuj zgodnie z wytycznymi poniżej dotyczącymi Twojego typu pliku:
- Pliki rozdzielane tabulatorami: wymagane są spacje. Jeśli atrybut ma podkreślenia, użyj spacji zamiast znaku „_”.
- XML API lub JSON API: wymagane są podkreślenia – po otrzymaniu pliku są zamieniane na odstępy.
Podsumowanie wymagań dotyczących atrybutów
Atrybut | Wymagania związane z przesyłaniem | |
---|---|---|
Wymagane informacje o asortymencie |
Kod sklepu |
Wymagane dla wszystkich produktów. Uwaga: w atrybucie kod sklepu |
Opcjonalne informacje o asortymencie |
Okres obowiązywania ceny promocyjnej Ilość |
Zalecane w przypadku każdego produktu w pliku danych, aby podać więcej informacji o cenie, ilości i dostawie tego samego dnia. Pamiętaj, że w przypadku domyślnej ceny obowiązującej w całym kraju jej podanie jest opcjonalne. Jeśli cena w danym sklepie ulegnie zmianie, musisz podać cenę. |
Opcjonalne atrybuty odbioru w sklepie |
Metoda odbioru Gwarantowana dostępność produktu do odbioru |
Zalecane w przypadku wszystkich produktów w pliku danych, które można odebrać w sklepie. Ważne: od 1 września 2024 r. atrybut metoda odbioru |
Opcjonalne informacje o dostawie lokalnej | Etykieta dostawy lokalnej [local_shipping_label] |
Wymagane w pliku danych, jeśli chcesz umożliwić dostawę tego samego dnia, gdy tylko niektóre produkty w danym sklepie kwalifikują się do dostawy tego samego dnia. |
Wymagane informacje o asortymencie
Te atrybuty zawierają podstawowe informacje o każdym produkcie z asortymentu sklepu.
[store_code]
– identyfikator sklepu z Profili Firmy
Unikalny identyfikator alfanumeryczny dla każdego sklepu lokalnego. W tym atrybucie rozróżniana jest wielkość liter. Atrybut ten musi odpowiadać kodom sklepu przesłanym w Profilach Firmy.
Kiedy używać: wymagany w przypadku wszystkich produktów w pliku danych.
Typ | Tekst (ciąg znaków) |
Przykład dla tekstu rozdzielanego tabulatorami | Sklep123 |
Przykład w formacie XML | <g:store_code>Sklep123</g:store_code> |
[id]
– identyfikator produktu
Unikalny, alfanumeryczny identyfikator produktu stosowany we wszystkich Twoich sklepach.
Jeśli sprzedajesz ten sam produkt w wielu sklepach, ta sama wartość atrybutu identyfikator pojawi się dla wielu kodów sklepów. Podaj jeden atrybut identyfikator [id]
dla każdego sklepu i użyj atrybutu dostępność [availability]
, aby określić zapas danego produktu dostępny w danym sklepie.
Jeśli masz kilka plików danych tego samego typu dla danego kraju, wszystkie identyfikatory zawartych w nich produktów również muszą być unikatowe. Jeśli w całym Twoim asortymencie kody SKU są unikalne i spełniają poniższe wymagania, zalecamy użycie w tym atrybucie kodów SKU.
Kiedy używać: wymagany w przypadku wszystkich produktów w pliku danych.
Typ | Tekst (ciąg znaków) |
Przykład dla tekstu rozdzielanego tabulatorami | 421486 |
Przykład w formacie XML | <g:id>421486</g:id> |
Ważne:
- Użyj tych samych wartości atrybutu identyfikator zarówno w podstawowym pliku danych, jak i w pliku danych o asortymencie produktów dostępnych lokalnie.
- Odstępy na początku i na końcu oraz znaki przejścia do nowej linii (0x0D) są usuwane.
- Każda sekwencja znaku przejścia do nowej linii (0x0D) i znaków odstępu (znaków Unicode z cechą odstępu) jest zamieniana na jeden odstęp (0x20).
- Dopuszczalne są tylko prawidłowe znaki Unicode, co wyklucza następujące znaki:
- znaki sterujące (poza znakiem przejścia do nowej linii 0x0D),
- znaki funkcyjne,
- znaki prywatnego użytku,
- pary zastępcze,
- nieprzypisane punkty kodowe (w szczególności wszystkie punkty kodowe większe niż 0x10FFFF).
- Gdy już prześlesz produkt, nie możesz zmieniać atrybutu identyfikator
[id]
podczas aktualizowania pliku danych. Tego samego identyfikatora nie można też później użyć dla innego produktu. - Uwzględnij tylko te produkty, które można kupić w sklepach.
[availability]
– stan dostępności produktu
- „w magazynie” [in_stock]: oznacza, że produkt jest w magazynie w Twoim lokalnym sklepie.
- „niedostępny” [out_of_stock]: oznacza, że produktu nie ma w magazynie w Twoim lokalnym sklepie.
- „ograniczona dostępność” [limited_availability]: oznacza, że w Twoim lokalnym sklepie znajduje się tylko kilka sztuk danego produktu.
- „w sklepie, dostępny na zamówienie” oznacza, że produkt jest dostępny na zamówienie w lokalnym sklepie (np. lodówka, którą należy wysłać z magazynu). Jeśli podajesz także atrybut ilość
[quantity]
, użyj wartości „1” dla produktów dostępnych na zamówienie.
Typ | Tekst (ciąg znaków). Musi to być jedna z 4 akceptowanych wartości: „in stock”, „out of stock”, „limited availability” lub „on display to order”. |
Przykład dla tekstu rozdzielanego tabulatorami | w magazynie |
Przykład w formacie XML | <g:availability>in stock</g:availability> |
Opcjonalne informacje o asortymencie
Możesz zastosować te atrybuty, aby podać dodatkowe informacje o cenie, ilości i dostępności produktów.
[price]
– cena produktu
Standardowa cena Twojego produktu. Jeśli podasz cenę w pliku danych o asortymencie i podstawowym pliku danych, cena z pliku danych o asortymencie zastąpi cenę z podstawowego pliku danych w przypadku powiązanego sklepu.
Kiedy używać: wymagana w przypadku wszystkich produktów w pliku danych.
Typ | Liczba (waluta jest przypisywana automatycznie na podstawie kraju, w którym znajduje się sklep). |
Przykład dla tekstu rozdzielanego tabulatorami | 299.99 |
Przykład w formacie XML | <g:price>299.99</g:price> |
[sale_price]
– reklamowana obniżona cena produktu
Reklamowana tymczasowa cena promocyjna, która zastępuje wartość podaną w atrybucie cena [price]
w tym pliku danych i pliku danych o produktach dostępnych lokalnie.
Zalecamy przesłanie atrybutu okres obowiązywania ceny promocyjnej [sale_price_effective_date]
w przypadku wszystkich produktów, dla których obowiązują ceny promocyjne, ponieważ będzie on określać, kiedy cena promocyjna powinna zacząć obowiązywać. Jeśli okres obowiązywania ceny promocyjnej nie zostanie podany, obniżona cena będzie obowiązywać, dopóki produkt będzie zawarty w pliku danych.
Typ | Liczba |
Przykład dla tekstu rozdzielanego tabulatorami | 279.99 |
Przykład w formacie XML | <g:sale_price>279.99</g:sale_price> |
[sale_price_effective_date]
.[sale_price_effective_date]
– zakres dat, w którym produkt jest oferowany po obniżonej cenie
Okres, w którym obowiązuje reklamowana cena promocyjna.
Więcej informacji o definicjach cen promocyjnych
Typ | Tekst (ciąg znaków), ISO8601, gdzie data rozpoczęcia i data zakończenia są rozdzielone ukośnikiem (/) |
Przykład dla tekstu rozdzielanego tabulatorami |
Przykłady w strefie UTC: Wszystkie wartości czasu należy podać w formacie 24-godzinnym. |
Przykład w formacie XML | <g:sale_price_effective_date>2021-07-19T09:00-0800/2021-07-26T21:00-0800</g:sale_price_effective_date> |
[quantity]
– liczba produktów dostępnych w magazynie
Liczba produktów dostępnych w magazynie danego sklepu. Jeśli przesyłasz produkty, które są tymczasowo niedostępne, podaj w tym atrybucie wartość „0”.
Atrybut ilość nie jest już wymagany. Pamiętaj, aby przesłać wartość atrybutu dostępność dla wszystkich swoich produktów.
Typ | Liczba całkowita |
Przykład dla tekstu rozdzielanego tabulatorami | 4 |
Przykład w formacie XML | <g:quantity>4</g:quantity> |
Ważne:
- Google określa produkty jako „w magazynie”, jeśli wartość tego atrybutu wynosi co najmniej 3. Wartość 1–2 oznacza „ograniczoną dostępność”, a jeśli wartość wynosi 0, produkt jest „niedostępny”.
- Jeśli zdecydujesz się przesłać ilość i dostępność, zasoby zostaną sklasyfikowane na podstawie niższej wartości.
Opcjonalne atrybuty odbioru w sklepie
Dodaj te atrybuty do pliku danych o asortymencie produktów dostępnych lokalnie, aby dodać informacje o odbiorze w danym sklepie.
Metoda odbioru[pickup_method]
– opcja odbioru produktu w sklepie
[pickup_method]
nie będzie już wymagany.Określ opcję odbioru dla tego produktu.
- buy: cała transakcja jest dokonywana online.
- reserve: produkt jest zarezerwowany online, a transakcja jest dokonywana w sklepie.
- ship_to_store: produkt jest kupowany online i wysyłany do lokalnego sklepu, gdzie klient może go odebrać.
- not_supported: produkt nie jest dostępny do odbioru w sklepie.
Typ | Tekst (ciąg znaków). Musi to być jedna z 4 akceptowanych wartości:
buy, reserve, ship_to_store lub not_supported |
Przykład dla tekstu rozdzielanego tabulatorami | buy |
Przykład w formacie XML | <g:pickup_method>buy</g:pickup_method> |
[pickup_sla]
– czas, w którym produkt jest dostępny do odbioru w sklepie
Określ przewidywaną datę, kiedy zamówienie będzie gotowe do odbioru, w zależności od daty złożenia zamówienia.
- same_day: produkt jest dostępny do odbioru w określonych godzinach tego samego dnia, w którym zostało złożone zamówienie.
- next_day: produkt jest dostępny do odbioru następnego dnia po złożeniu zamówienia.
- 2-day: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za 2 dni.
- 3-day: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za 3 dni.
- 4-day: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za 4 dni.
- 5-day: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za 5 dni.
- 6-day: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za 6 dni.
- multi-week: produkt zostanie wysłany do sklepu i klient będzie mógł go odebrać za ponad tydzień.
Typ | Tekst (ciąg znaków). Musi to być jedna z 8 akceptowanych wartości:
same_day, next_day, two_day, three_day, four_day, five_day, six_day lub multi_week |
Przykład dla tekstu rozdzielanego tabulatorami | same_day |
Przykład w formacie XML | <g:pickup_sla>same_day</g:pickup_sla> |
Opcjonalne informacje o dostawie lokalnej
Dodaj ten atrybut do pliku danych o asortymencie produktów dostępnych lokalnie, aby podać informacje o dostawie lokalnej.
Etykieta dostawy lokalnej [local_shipping_label]
Jeśli chcesz umożliwić dostawę tego samego dnia, gdy tylko część lokalnego asortymentu w Twoim sklepie kwalifikuje się do dostawy tego samego dnia, musisz dodać atrybut etykieta dostawy lokalnej [local_shipping_label]
do plików danych o asortymencie produktów dostępnych lokalnie.
Wartość przesłana dla tego atrybutu powinna być nazwą etykiety dostawy tego samego dnia lub etykiet utworzonych na poziomie konta w ustawieniach dostawy tego samego dnia. Każda etykieta dostawy tego samego dnia odpowiada jednej unikalnej grupie ustawień dostawy tego samego dnia. Zostanie ona dodana do wybranych kwalifikujących się produktów w pliku danych o asortymencie produktów dostępnych lokalnie.
Aby dodatkowo skonfigurować dostawę tego samego dnia, możesz ustawić maksymalny promień dostawy w milach lub kilometrach. Ostateczny termin możesz też ustawić według liczby godzin przed zamknięciem, gdy zamówienia są przyjmowane do dostarczenia w ciągu dnia, lub według konkretnej godziny. Możesz również określić, czy produkty z dostawą tego samego dnia będą kwalifikować się do dostawy następnego dnia, jeśli zamówienia na te produkty zostaną złożone po ostatecznym terminie składania zamówień.
Ten atrybut jest opcjonalny, jeśli wszystkie Twoje sklepy oferują dostawę tego samego dnia w przypadku wszystkich produktów lub jeśli wszystkie produkty na liście kwalifikujących się sklepów są objęte dostawą tego samego dnia. Więcej informacji o dostawie tego samego dnia