Podczas tworzenia kanału produktów w Product Feed Pro lub Product Feed Elite, każdy wiersz na ekranie mapowania atrybutów jest wypełniany przy użyciu jednego z dostępnych atrybutów wtyczki.
Ten artykuł to kompletny przewodnik referencyjny do tych atrybutów — czym są, do jakiej grupy należą i przykład wartości, którą generują.
W selektorze atrybutów, atrybuty są zorganizowane w czterech wbudowanych grupach plus dwie, które wtyczka generuje automatycznie:
- Atrybuty główne — podstawowe dane produktu, w tym identyfikatory, tytuły, opisy, linki, stan magazynowy, wymiary i wszystkie warianty cenowe
- Atrybuty obrazów — główny obraz, dodatkowe obrazy i warianty specyficzne dla formatu
- Taksonomia kategorii Google — pole taksonomii produktów Google (dostępne tylko w regułach i filtrach)
- Inne pola — informacje o sklepie, wartości logiczne, tagi, recenzje, powiadomienia konsumenckie i pola pomocnicze
- Atrybuty dynamiczne — generowane automatycznie z atrybutów produktów WooCommerce i niestandardowych taksonomii
- Atrybuty niestandardowe — generowane automatycznie z pól meta produktu i atrybutów wariacji
Ten artykuł dzieli warianty cenowe na własną sekcję dla łatwiejszego skanowania, mimo że pojawiają się one w sekcji Atrybuty główne w selektorze. Wszystkie inne sekcje bezpośrednio odpowiadają grupowaniu selektora.
Używaj tej referencji razem z selektorem atrybutów w kreatorze kanałów. Jeśli szukasz konkretnego pola i nie możesz go znaleźć, sprawdź sekcje Dynamiczne i Niestandardowe — wiele specyficznych dla sklepu atrybutów pojawia się tam automatycznie.
Przejdź do:
- Atrybuty główne
- Atrybuty cenowe
- Atrybuty obrazu
- Inne pola
- Atrybuty dynamiczne
- Atrybuty niestandardowe
- Uwagi dotyczące użytkowania
- FAQ
Atrybuty główne
Atrybuty główne obejmują podstawowe dane produktu, których oczekuje każdy kanał. Są one zawsze dostępne niezależnie od typu produktu lub kanału.
Identyfikacja i podstawowe informacje
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Identyfikator produktu | Identyfikator produktu WooCommerce. Stabilny unikalny identyfikator — używaj go jako pola id, chyba że Twój kanał wymaga identyfikatorów opartych na SKU. | 1234 |
| SKU | Kod jednostki magazynowej produktu. | BOOT-BLK-10 |
| SKU_ID (Facebook) | Format SKU specyficzny dla Facebooka. | BOOT-BLK-10 |
| SKU_ITEM_GROUP_ID (Facebook) | Format SKU grupy elementów specyficzny dla Facebooka dla wariantów. | BOOT-BLK |
| Wc_post_id_product_id (Facebook) | Identyfikator posta WooCommerce w formacie oczekiwanym przez Facebook. Użyj tego dla kanałów katalogu Facebook zamiast Identyfikatora produktu, gdy Twój katalog Facebook jest powiązany z identyfikatorami postów. | 1234 |
| Nazwa produktu | Tytuł tej konkretnej wariacji, tak jak jest wyświetlany w sklepie. | Buty turystyczne męskie – czarne, rozmiar 10 |
| Slug nazwy produktu | Wersja nazwy produktu bezpieczna dla adresów URL. | meskie-buty-turystyczne-czarne-rozmiar-10 |
| Nazwa produktu myślnik | Nazwa wariacji ze spacjami zastąpionymi myślnikami. | Meskie-Buty-Turystyczne-–-Czarne,-Rozmiar-10 |
| Nazwa produktu produkt nadrzędny | Tytuł nadrzędnego produktu zmiennego — taki sam dla wszystkich wariacji. | Buty turystyczne męskie |
| Nazwa produktu produkt nadrzędny myślnik | Tytuł produktu nadrzędnego ze spacjami zastąpionymi myślnikami. | Buty-Turystyczne-Męskie |
| Nazwa produktu małe litery | Nazwa wariacji napisana małymi literami. | buty turystyczne męskie – czarne, rozmiar 10 |
| Nazwa produktu pierwsze litery wielkie | Nazwa wariacji z pierwszą literą każdego słowa napisaną wielką. | Buty turystyczne męskie – czarne, rozmiar 10 |
| Nieprzetworzona nazwa produktu | Nazwa wariacji z zachowanym kodem HTML, przed zastosowaniem jakichkolwiek filtrów WooCommerce. | Buty męskie <em>turystyczne</em> – czarne, rozmiar 10 |
| Nieprzetworzona nazwa produktu nadrzędny produkt | Nazwa produktu nadrzędnego z zachowanym kodem HTML — nie zawiera atrybutów wariacji. | Buty męskie <em>turystyczne</em> |
| SKU produktu nadrzędnego zmiennego | SKU produktu nadrzędnego — wspólne dla wszystkich wariacji tego produktu. | BOOT-BLK |
Opisy
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Opis produktu | Pełny opis tej wariacji (bez kodu HTML). Jeśli nie ma opisu specyficznego dla wariacji, używany jest opis produktu nadrzędnego. | Wersja w kolorze czarnym posiada wzmocniony nosek i ulepszoną przyczepność podeszwy do technicznych szlaków. |
| Nieprzefiltrowany opis produktu | Opis wariacji z zachowanym kodem HTML. | <p>Wersja w kolorze czarnym posiada wzmocniony nosek...</p> |
| Krótki opis produktu | Krótki opis tej wariacji (bez kodu HTML). Jeśli nie ustawiono, używany jest krótki opis produktu nadrzędnego. | Czarny, wzmocniony nosek, rozmiar 10 |
| Nieprzefiltrowany krótki opis produktu | Krótki opis wariacji z zachowanym kodem HTML. | <ul><li>Czarny</li><li>Wzmocniony nosek</li></ul> |
| Opis produktu nadrzędnego produktu | Pełny opis nadrzędnego produktu zmiennego — taki sam dla wszystkich wariantów, niezależnie od przetwarzanego wariantu. | Wytrzymały, wodoodporny but trekkingowy ze wsparciem kostki i podeszwą Vibram. |
| Krótki opis produktu nadrzędnego produktu | Krótki opis nadrzędnego produktu zmiennego — wspólny dla wszystkich wariantów. | Wodoodporny, wsparcie kostki, podeszwa Vibram |
| Nieprzefiltrowany opis produktu nadrzędnego produktu | Opis produktu nadrzędnego z zachowanym kodem HTML. | <p>Wytrzymały, wodoodporny but trekkingowy ze wsparciem kostki i podeszwą Vibram.</p> |
| Nieprzefiltrowany krótki opis produktu nadrzędnego produktu | Krótki opis produktu nadrzędnego z zachowanym kodem HTML. | <ul><li>Wodoodporny</li><li>Wsparcie kostki</li><li>Podeszwa Vibram</li></ul> |
| Opis produktu wariacji | Opis wprowadzony bezpośrednio w panelu wariacji — tylko tekst na poziomie wariacji, bez odniesienia do produktu nadrzędnego. | Lekka, czarna opcja ze wzmocnionym noskiem. |
| Krótki opis produktu wariacji | Krótki opis wprowadzony w panelu wariacji — bez odniesienia do produktu nadrzędnego. | Czarny, wzmocniony nosek. |
| Nieprzefiltrowany opis produktu wariacji | Opis z panelu wariacji z zachowanym kodem HTML. | <p>Lekka czarna opcja ze wzmocnionym noskiem.</p> |
| Niefiltrowany krótki opis wariacji produktu | Krótki opis panelu wariacji z zachowaniem HTML. | <p>Czarny, wzmocniony nosek.</p> |
Linki
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Link | Kanoniczny adres URL tej konkretnej wariacji, w tym parametry zapytania atrybutów. | https://yourstore.com/products/mens-hiking-boot/?attribute_pa_color=black&attribute_pa_size=10 |
| Link bez parametrów | Adres URL wariacji ze wszystkimi usuniętymi parametrami zapytania — przekierowuje do strony produktu nadrzędnego. | https://yourstore.com/products/mens-hiking-boot/ |
| Link do produktu zmiennego | Adres URL nadrzędnego produktu zmiennego. Zawsze wskazuje stronę nadrzędną, niezależnie od przetwarzanej wariacji — przydatne, gdy chcesz, aby wszystkie warianty udostępniały jeden adres URL produktu. | https://yourstore.com/products/mens-hiking-boot/ |
| Link dodawania do koszyka | Bezpośredni adres URL, który dodaje produkt do koszyka. | https://yourstore.com/?add-to-cart=1234 |
| Link do koszyka | Adres URL strony koszyka. | https://yourstore.com/cart/ |
Status i widoczność produktu
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Typ produktu | Prosty, zmienny lub grupowany. | zmienny |
| Typ zawartości | Oznaczenie używane przez niektóre kanały do kategoryzacji produktów. | produkt |
| Obraz spoza lokalnej domeny | Czy główny obraz produktu jest hostowany na zewnętrznym serwerze, a nie na Twoim własnym. | nie |
| Wykluczony z katalogu | Czy produkt jest ukryty w katalogu sklepu. | nie |
| Wykluczony z wyszukiwania | Czy produkt jest ukryty w wyszukiwaniu w witrynie. | nie |
| Wykluczony ze wszystkiego (ukryty) | Czy produkt jest wykluczony zarówno z katalogu, jak i z wyszukiwania. | nie |
| Widoczność | Ustawienie widoczności produktu w WooCommerce. | widoczny |
| Wyróżnione | Czy produkt jest oznaczony jako wyróżniony. | tak |
| Wirtualny | Czy produkt jest wirtualny. | nie |
| Do pobrania | Czy produkt jest do pobrania. | nie |
Informacje o kategorii
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Kategoria | Główna kategoria WooCommerce produktu. | Obuwie |
| Kategoria (oddzielone przecinkami) | Wszystkie kategorie przypisane do produktu, oddzielone przecinkami. | Obuwie, Buty, Wyprzedaż |
| Kategoria (nie używane do mapowania) | Surowy ciąg kategorii przed jakimkolwiek przetwarzaniem. Dostępny w regułach i filtrach — nie do bezpośredniego mapowania kolumn kanału. | Obuwie |
| Link do kategorii | Adres URL głównej strony kategorii. | https://yourstore.com/product-category/footwear/ |
| Ścieżka kategorii | Pełna ścieżka nawigacji. | Odzież > Obuwie > Buty |
| Skrócona ścieżka kategorii | Skrócona ścieżka kategorii. | Obuwie > Buty |
| Ścieżka kategorii Skroutz | Ścieżka kategorii w formacie wymaganym przez Skroutz. | Odzież/Obuwie/Buty |
| Główna kategoria Yoast / Rankmath | Główna kategoria ustawiona w Yoast SEO lub RankMath. | Buty |
| Kategoria Google (tylko dla reguł i filtrów) | Kategoria taksonomii produktów Google. Dostępna do użytku w regułach i filtrach — nie do bezpośredniego mapowania pól. | Odzież i akcesoria > Buty |
Podatek
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Status podatkowy | Czy produkt podlega opodatkowaniu. | opodatkowany |
| Klasa podatkowa | Klucz wewnętrznej klasy podatkowej przypisany do produktu. | standardowa |
| Nazwa klasy podatkowej | Nazwa klasy podatkowej czytelna dla człowieka. | Standardowa |
| VAT | Kwota VAT naliczona do ceny produktu. | 18.00 |
Stan magazynowy i zapasy
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Ilość [Stan magazynowy] | Aktualna ilość produktów w magazynie. | 25 |
| Status magazynowy WooCommerce | Status magazynowy WooCommerce. | w magazynie |
| Dostępność | Etykieta dostępności magazynowej do wyjścia kanału. | w magazynie |
| Liczba wariantów | Całkowita liczba wariantów dla produktu zmiennego. | 6 |
| Liczba wariantów w magazynie | Liczba wariantów aktualnie w magazynie. | 4 |
Szczegóły produktu i metadane
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Stan | Stan produktu. | nowy |
| Notatka do zakupu | Notatka wyświetlana klientom po zakupie. | Dziękujemy za zamówienie! |
| Waluta | Aktywny kod waluty sklepu. | USD |
| Całkowita liczba zamówień produktu | Liczba zamówień produktu w całym okresie. | 142 |
Wymiary
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Waga | Waga produktu (w jednostce wagi WooCommerce). | 0.8 |
| Szerokość | Szerokość produktu. | 15 |
| Wysokość | Wysokość produktu. | 12 |
| Długość | Długość produktu. | 30 |
Wysyłka
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Wysyłka | Pełne szczegóły wysyłki ze stref wysyłki WooCommerce. | flat_rate:5.99 USD |
| Koszt wysyłki | Tylko numeryczna wartość kosztu wysyłki. | 5.99 |
| Najniższe koszty wysyłki | Najtańsza dostępna stawka wysyłki dla produktu. | 4.99 |
| Slug klasy wysyłkowej | Bezpieczny dla adresu URL klucz klasy wysyłkowej przypisanej do produktu. | ciężkie-przedmioty |
| Nazwa klasy wysyłkowej | Czytelna dla człowieka nazwa klasy wysyłkowej. | Ciężkie Przedmioty |
Identyfikatory produktu (GTIN / MPN)
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Yoast WooCommerce GTIN8 | 8-cyfrowy Globalny Numer Handlowy (z Yoast WooCommerce SEO). | 12345678 |
| Yoast WooCommerce GTIN12 | 12-cyfrowy GTIN (format UPC). | 012345678901 |
| Yoast WooCommerce GTIN13 | 13-cyfrowy GTIN (format EAN). | 0123456789012 |
| Yoast WooCommerce GTIN14 | 14-cyfrowy GTIN. | 00012345678905 |
| Yoast WooCommerce ISBN | Międzynarodowy Znormalizowany Numer Książki. | 978-3-16-148410-0 |
| Globalny unikalny identyfikator (GTIN, UPC, EAN lub ISBN) | Połączone pole GTIN — wyświetla dowolną wypełnioną wartość. | 0123456789012 |
| Yoast WooCommerce MPN | Numer części producenta (z Yoast WooCommerce SEO). | BT-BLK-2024 |
| Identyfikator grupy elementów | Grupuje wszystkie warianty produktu. Automatycznie wypełniane z identyfikatora produktu nadrzędnego. | 1230 |
Dostępność i daty
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Data i godzina publikacji pliku | Data i godzina publikacji wpisu produktu w pliku. | 2024-01-15 09:00:00 |
| Data utworzenia produktu | Data publikacji produktu w WooCommerce. | 2023-06-01 |
| Dni od utworzenia produktu | Liczba dni od utworzenia produktu. Przydatne do filtrowania nowości. | 326 |
| Data rozpoczęcia wyprzedaży | Data rozpoczęcia zaplanowanej ceny promocyjnej. | 2024-12-20 |
| Data zakończenia wyprzedaży | Data zakończenia zaplanowanej ceny promocyjnej. | 2024-12-31 |
| Data dostępności + 1 tydzień | Dzisiejsza data plus 1 tydzień. Użyj do plików pre-order, które wymagają przyszłej daty dostępności. | 2026-05-07 |
| Data dostępności + 2 tygodnie | Dzisiejsza data plus 2 tygodnie. | 2026-05-14 |
| Data dostępności + 3 tygodnie | Dzisiejsza data plus 3 tygodnie. | 2026-05-21 |
| Data dostępności + 4 tygodnie | Dzisiejsza data plus 4 tygodnie. | 2026-05-28 |
| Data dostępności + 5 tygodni | Dzisiejsza data plus 5 tygodni. | 2026-06-04 |
| Data dostępności + 6 tygodni | Dzisiejsza data plus 6 tygodni. | 2026-06-11 |
| Data dostępności + 7 tygodni | Dzisiejsza data plus 7 tygodni. | 2026-06-18 |
| Data dostępności + 8 tygodni | Dzisiejsza data plus 8 tygodni. | 2026-06-25 |
| Identyfikator regionu | Identyfikator regionu używany przez kanały wymagające danych produktów targetowanych geograficznie. | US-NY |
Oceny i recenzje
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Ocena całkowita | Liczba zatwierdzonych recenzji klientów. | 38 |
| Średnia ocena | Średnia ocena gwiazdkowa wszystkich recenzji. | 4.7 |
| Liczba sprzedaży | Liczba razy, gdy produkt został sprzedany. | 142 |
Atrybuty cenowe
Wtyczka zapewnia szeroki zakres wariantów cenowych, dzięki czemu możesz wygenerować dokładnie taki format ceny, jakiego wymaga każdy kanał. Wszystkie atrybuty cenowe są częścią grupy Główne atrybuty w selektorze — są one prezentowane tutaj w osobnej sekcji dla łatwiejszego przeglądania.
Ceny standardowe
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Cena | Aktualnie aktywna cena — cena promocyjna, jeśli trwa promocja, w przeciwnym razie cena regularna. | 89.95 |
| Cena regularna | Cena katalogowa bez rabatu. | 119.95 |
| Cena promocyjna | Cena po rabacie (pusta, gdy promocja nie jest aktywna). | 89.95 |
| Data obowiązywania ceny promocyjnej | Pełny zakres dat promocji w formacie interwałowym ISO 8601, zgodnie z wymaganiami Google Shopping. | 2024-12-20T00:00+00:00/2024-12-31T23:59+00:00 |
| Cena z VAT na froncie | Aktywna cena z uwzględnieniem VAT, wyświetlana klientom na froncie. | 107.94 |
| Cena regularna z VAT na froncie | Cena regularna z VAT. | 143.94 |
| Cena promocyjna z VAT na froncie | Cena promocyjna z VAT. | 107.94 |
| Cena bez VAT | Aktywna cena bez VAT. | 74.96 |
| Cena regularna bez VAT | Cena regularna bez VAT. | 99.96 |
| Cena promocyjna bez VAT | Cena promocyjna bez VAT. | 74.96 |
Zaokrąglone ceny
Dostępne są warianty zaokrąglone dla cen aktywnych, regularnych i promocyjnych — zarówno z VAT, jak i bez. Używaj ich, gdy kanał wymaga cen w pełnych liczbach lub określonej liczby miejsc dziesiętnych.
| Atrybut | Przykładowy wynik |
|---|---|
| Cena zaokrąglona | 90 |
| Cena regularna zaokrąglona | 120 |
| Cena promocyjna zaokrąglona | 90 |
| Cena z VAT na froncie zaokrąglona | 108 |
| Cena regularna z VAT na froncie zaokrąglona | 144 |
| Cena promocyjna z VAT na froncie zaokrąglona | 108 |
| Cena bez VAT zaokrąglona | 75 |
| Cena regularna bez VAT zaokrąglona | 100 |
| Cena promocyjna bez VAT zaokrąglona | 75 |
Ceny systemowe
Ceny systemowe to surowe ceny wewnętrzne WooCommerce przed dostosowaniami wyświetlania na froncie (np. wtyczki do konwersji walut lub nadpisy wyświetlania podatków). Używaj ich, gdy inne pola cenowe zwracają nieoczekiwane wartości z powodu aktywnej wtyczki cenowej.
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Cena systemowa | Surowa aktywna cena z bazy danych WooCommerce. | 89.95 |
| Systemowa cena regularna | Surowa cena regularna z bazy danych WooCommerce. | 119.95 |
| Systemowa cena promocyjna | Surowa cena promocyjna z bazy danych WooCommerce. | 89.95 |
| Systemowa cena z VAT | Systemowa cena z dodanym VAT. | 107.94 |
| Cena regularna systemu z VAT | Cena regularna systemu z dodanym VAT. | 143.94 |
| Cena promocyjna systemu z VAT | Cena promocyjna systemu z dodanym VAT. | 107.94 |
| Cena systemu bez VAT | Cena systemu z usuniętym VAT. | 74.96 |
| Cena regularna systemu bez VAT | Cena regularna systemu z usuniętym VAT. | 99.96 |
| Cena promocyjna systemu bez VAT | Cena promocyjna systemu z usuniętym VAT. | 74.96 |
Ceny specyficzne dla kanałów (Pinterest / TikTok / Vivino)
Te atrybuty formatują ceny w formacie kwota waluta wymaganym przez Pinterest, TikTok i Vivino (np. 89,95 USD).
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Cena Pinterest / TikTok / Vivino | Aktywna cena z dodanym kodem waluty. | 89,95 USD |
| Cena regularna Pinterest / TikTok / Vivino | Cena regularna z dodanym kodem waluty. | 119,95 USD |
| Cena promocyjna Pinterest / TikTok / Vivino | Cena promocyjna z dodanym kodem waluty. | 89,95 USD |
| Cena Pinterest / TikTok / Vivino bez VAT | Aktywna cena bez VAT, z kodem waluty. | 74,96 USD |
| Cena regularna Pinterest / TikTok / Vivino bez VAT | Cena regularna bez VAT, z kodem waluty. | 99,96 USD |
| Cena promocyjna Pinterest / TikTok / Vivino bez VAT | Cena promocyjna bez VAT, z kodem waluty. | 74,96 USD |
Ceny z separatorem
Ceny z separatorem formatują wartość ceny z separatorem tysięcy, zgodnie z wymaganiami niektórych europejskich kanałów i platform handlowych.
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Cena z separatorem | Aktywna cena sformatowana z separatorem tysięcy. | 1.299,95 |
| Separator ceny regularnej | Cena regularna z separatorem tysięcy. | 1.499,95 |
| Separator ceny promocyjnej | Cena promocyjna z separatorem tysięcy. | 1.299,95 |
Typy cen specjalnych
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Procent zniżki | Procentowy rabat między ceną regularną a ceną aktywną. | 25 |
| Cena WCML bez geolokalizacji | Cena z WooCommerce Multilingual (WCML) bez zastosowanych poprawek geolokalizacyjnych. Użyj tego, gdy Twój sklep korzysta z WCML i potrzebujesz bazowej ceny bez geolokalizacji w pliku danych. | 89.95 |
| Minimalna cena Mix & Match | Najniższa możliwa cena, gdy produkt jest częścią zestawu Mix & Match. | 79.95 |
| Minimalna cena regularna Mix & Match | Minimalna cena regularna (niepromocyjna) w zestawie Mix & Match. | 99.95 |
| Maksymalna cena Mix & Match | Najwyższa możliwa cena w zestawie Mix & Match. | 139.95 |
| Maksymalna cena regularna Mix & Match | Maksymalna cena regularna (niepromocyjna) w zestawie Mix & Match. | 159.95 |
| Koszt własny sprzedaży (cogs) | Koszt jednostkowy produktu. Wymaga wtyczki COGS lub niestandardowego pola. | 42.00 |
| Wartość kosztu własnego sprzedaży | Całkowita wartość wszystkich jednostek zapasów według ceny zakupu. | 1,050.00 |
| Całkowita wartość kosztu własnego sprzedaży | Całkowita wartość COGS, w tym wszystkie warianty i ilości. | 1,260.00 |
Atrybuty obrazu
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Główny obraz | Główny obraz produktu. W przypadku produktów zmiennych zwraca obraz wariantu, jeśli jest ustawiony; w przeciwnym razie wraca do obrazu produktu nadrzędnego. | https://yourstore.com/wp-content/uploads/hiking-boot-black.jpg |
| Główny obraz prosty i wariantów | Główny obraz zwracany zarówno dla produktów prostych, jak i ich wariantów. | https://yourstore.com/wp-content/uploads/hiking-boot.jpg |
| Obraz wyróżniony | Wyróżniony obraz produktu (zawsze obraz produktu nadrzędnego, a nie obraz wariantu). | https://yourstore.com/wp-content/uploads/hiking-boot-featured.jpg |
| Dodatkowy obraz 1 | Pierwszy obraz z galerii. | https://yourstore.com/wp-content/uploads/hiking-boot-side.jpg |
| Dodatkowy obraz 2–10 | Dodatkowe obrazy galerii, indywidualnie adresowalne do 10. | https://yourstore.com/wp-content/uploads/hiking-boot-back.jpg |
| Wszystkie obrazy (oddzielone przecinkami) | Wszystkie obrazy produktów w jednym ciągu oddzielonym przecinkami. | https://yourstore.com/.../main.jpg,https://yourstore.com/.../side.jpg |
| Wszystkie obrazy galerii (oddzielone przecinkami) | Wszystkie obrazy galerii z wyłączeniem głównego obrazu produktu. | https://yourstore.com/.../side.jpg,https://yourstore.com/.../back.jpg |
| Wszystkie obrazy Kogan (oddzielone pionową kreską) | Wszystkie obrazy w formacie rozdzielanym pionową kreską wymaganym przez kanał Kogan. | https://yourstore.com/.../main.jpg\|https://yourstore.com/.../side.jpg |
Inne pola
Informacje o sklepie
Te pola wyprowadzają informacje na poziomie sklepu, a nie dane produktu. Mają tę samą wartość dla każdego produktu w kanale, co czyni je równoważnymi wartościom statycznym — ale są automatycznie wypełniane z ustawień WordPress/WooCommerce.
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| URL strony | Główny adres URL Twojej witryny WordPress. | https://yourstore.com |
| Tytuł strony | Tytuł Twojej witryny WordPress (z Ustawienia → Ogólne). | Nazwa Twojego sklepu |
| URL sklepu | Adres URL Twojego sklepu WooCommerce. | https://yourstore.com/shop/ |
| URL strony Regulaminu (WooCommerce) | Adres URL strony przypisanej jako Regulamin w WooCommerce. | https://yourstore.com/terms/ |
| URL strony Polityki prywatności (WordPress) | Adres URL strony przypisanej jako Polityka prywatności w WordPress (Ustawienia → Prywatność). | https://yourstore.com/privacy-policy/ |
| URL strony | Adres URL konkretnej strony WordPress (wybranej za pomocą selektora atrybutów). | https://yourstore.com/returns/ |
| URL wpisu | Adres URL konkretnego wpisu WordPress (wybranego za pomocą selektora atrybutów). | https://yourstore.com/blog/hiking-tips/ |
Wartości logiczne
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Prawda (logiczne) | Wyprowadza dosłowną wartość true dla każdego produktu. Użyj, gdy kanał wymaga stałej wartości logicznej true dla pola. | prawda |
| Fałsz (logiczne) | Wypisuje dosłowną wartość false dla każdego produktu. Użyj, gdy kanał wymaga stałej wartości logicznej false dla pola. | false |
Tagi produktu
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Tagi produktu | Wszystkie tagi przypisane do produktu, oddzielone przecinkami. | wędrówki, outdoor, wodoodporny |
| Tagi produktu spacja | Tagi oddzielone spacjami zamiast przecinkami. | wędrówki outdoor wodoodporny |
Recenzje i dowody społeczne
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Recenzje | Treść recenzji produktu lub liczba recenzji, w zależności od oczekiwań kanału dla danego pola. | 38 |
| Ocena recenzji | Średnia ocena gwiazdkowa wszystkich recenzji. | 4.7 |
Narzędzia i wyświetlanie
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Kolejność menu | Numericzna kolejność sortowania ustawiona w edytorze produktu. | 5 |
| Autor | Użytkownik WordPress, który utworzył produkt. | admin |
| Rata | Informacje o płatności ratalnej (jeśli skonfigurowano za pomocą kompatybilnej wtyczki). | 4 x 22,49 zł |
| Wyróżnienie produktu | Wypunktowane najważniejsze cechy produktu (jeśli uzupełnione). | Wodoodporny, podeszwa Vibram, wsparcie kostki |
| Obliczenia wtyczki | Zwraca yes dla nowych produktów, które mają markę i co najmniej jeden z identyfikatorów GTIN lub MPN; w przeciwnym razie zwraca no. Używane przez Google Shopping dla pola identifier_exists. Użyj jako filtr kanału, aby wykluczyć produkty, które nie mają wymaganych danych identyfikacyjnych. | tak |
| Wartość statyczna | Stała wartość tekstowa, którą wpisujesz — stosowana identycznie do każdego produktu w kanale. Użyj dla wymaganych pól, gdzie wszystkie produkty mają tę samą wartość (np. condition = new, return_window = 30). | nowy (lub cokolwiek wpiszesz) |
Informacje dla konsumenta
Pola informacji dla konsumenta są używane przez niektóre kanały (głównie na rynkach regulowanych) do wyświetlania obowiązkowych ujawnień produktów wraz z ofertami.
| Atrybut | Opis | Przykładowy wynik |
|---|---|---|
| Uwaga dla konsumenta 1 | Pierwsze pole uwagi dla konsumenta. | Ten produkt zawiera chemikalia znane jako szkodliwe. |
| Uwaga dla konsumenta 2 | Drugie pole uwagi dla konsumenta. | Nieodpowiednie dla dzieci poniżej 3 roku życia. |
| Uwaga dla konsumenta 3 | Trzecie pole uwagi dla konsumenta. | Opakowanie należy utylizować w sposób odpowiedzialny. |
Atrybuty dynamiczne
Atrybuty dynamiczne są generowane automatycznie z atrybutów produktów WooCommerce i niestandardowych taksonomii. Nie wymagają konfiguracji — pojawiają się w selektorze atrybutów, gdy tylko wtyczka wykryje je w Twoich produktach.
Konwencja nazewnictwa: Atrybuty produktów WooCommerce są poprzedzone prefiksem Product (np. Product Color, Product Size). Niestandardowe taksonomie pojawiają się bezpośrednio pod ich zarejestrowaną etykietą (np. Brands, Themes).
| Atrybut | Źródło | Przykładowy wynik |
|---|---|---|
| Kolor produktu | Atrybut WooCommerce pa_color | Czarny |
| Rozmiar produktu | Atrybut WooCommerce pa_size | 10 |
| Marki | Niestandardowa taksonomia brands | Salomon |
| Motywy | Niestandardowa taksonomia themes | Outdoor |
Wykluczone taksonomie: Wtyczka wyklucza taksonomie strukturalne i niezwiązane z produktami — menu WordPress, kategorie i tagi postów, formaty postów, kategorie portfolio/FAQ/szablonów/elementów/slajdów, a także typ produktu WooCommerce, widoczność produktu, kategorie produktów, klasy wysyłkowe i tagi produktów.
Atrybuty niestandardowe
Niestandardowe atrybuty są generowane z pól meta produktów i atrybutów wariacji, które nie pasują do standardowych atrybutów WooCommerce. Wtyczka skanuje wszystkie opublikowane produkty i wariacje, aby zbudować tę listę.
Prefiks: Wszystkie niestandardowe atrybuty używają prefiksu custom_attributes_.
Buforowanie: Niestandardowe atrybuty są buforowane przez 24 godziny. Jeśli dodasz nowe pola meta i nie widzisz ich w selektorze, przejdź do Product Feed → Ustawienia i kliknij Wyczyść bufor niestandardowych atrybutów.
| Wygenerowany atrybut | Nazwa wyświetlana w selektorze | Przykładowy wynik |
|---|---|---|
custom_attributes_sku | SKU | BOOT-BLK-10 |
custom_attributes_total_sales | Całkowita sprzedaż | 142 |
custom_attributes_product_brand | Marka produktu | Salomon |
Uwagi dotyczące użytkowania
Mapowanie pól
- Użyj tych atrybutów podczas mapowania danych produktu do pól specyficznych dla kanału
- Różne kanały mogą wymagać różnych kombinacji tych atrybutów
Reguły i filtry przesyłania
- Wszystkie atrybuty mogą być używane w regułach i filtrach kanału
- Atrybuty cenowe otrzymują specjalną obsługę formatowania waluty
- Atrybuty kategorii mogą być używane do filtrowania opartego na kategoriach
Kompatybilność z kanałami
- Niektóre atrybuty są specjalnie zaprojektowane dla określonych kanałów (np. Facebook, Pinterest, TikTok, Vivino)
- Sprawdź wymagania docelowego kanału, aby określić, których atrybutów użyć
Względy wydajnościowe
- Atrybuty niestandardowe są buforowane przez 24 godziny
- Atrybuty dynamiczne są generowane na żądanie
- W przypadku dużych katalogów rozważ ograniczenie zakresu atrybutów niestandardowych za pomocą opcji atrybutów podstawowych
Implementacja techniczna
Klasa Product_Feed_Attributes oferuje kilka metod:
get_attributes()– Zwraca wszystkie dostępne atrybuty (domyślne + niestandardowe + dynamiczne)get_dynamic_attributes()– Pobiera dynamicznie generowane atrybuty taksonomiiget_custom_attributes()– Pobiera niestandardowe atrybuty pól metaajax_get_attributes()– Punkt końcowy AJAX do pobierania atrybutów w interfejsie administratora
Często zadawane pytania
Nie mogę znaleźć potrzebnego atrybutu — gdzie powinienem szukać?
Najpierw sprawdź sekcje Dynamiczne i Niestandardowe w selektorze. Atrybuty dodane za pomocą paneli atrybutów produktów WooCommerce pojawiają się jako atrybuty dynamiczne. Atrybuty przechowywane w polach meta produktów pojawiają się jako atrybuty niestandardowe (z prefiksem
custom_attributes_). Jeśli Twój atrybut nadal się nie pojawia, przejdź do Product Feed → Settings, kliknij Clear custom attributes cache i odśwież kreator kanału.Jaka jest różnica między „Cena” a „Cena systemowa”?
Cena wyświetla aktywną cenę po wszelkich dostosowaniach front-end (wtyczki walutowe, nadpisy wyświetlania podatków itp.). Cena systemowa to surowa wartość przechowywana w bazie danych WooCommerce przed tymi dostosowaniami. Użyj ceny systemowej, gdy inna wtyczka zakłóca wyświetlanie ceny i potrzebujesz oryginalnej, zapisanej wartości.
Jaka jest różnica między „Cena” a „Cena regularna”?
Cena wyświetla cenę, którą klient zapłaciłby w tej chwili — cenę promocyjną, gdy trwa promocja, w przeciwnym razie cenę regularną. Użyj Ceny dla głównego pola
price w kanale. Użyj Ceny regularnej i Ceny promocyjnej jako oddzielnych pól, gdy Twój kanał (np. Google Shopping) potrzebuje obu wartości jednocześnie.Co robi „Obliczenie wtyczki”?
Zwraca
tak dla nowych produktów, które mają markę i co najmniej jeden z identyfikatorów GTIN lub MPN, a w przeciwnym razie nie. Użyj go jako filtra kanału, aby wykluczyć produkty, którym brakuje danych identyfikacyjnych wymaganych przez bardziej rygorystyczne kanały, takie jak Google Shopping.Kiedy powinienem użyć wartości statycznej?
Gdy pole jest wymagane przez kanał, ale każdy produkt w Twoim sklepie ma tę samą odpowiedź. Na przykład, jeśli każdy sprzedawany przez Ciebie produkt jest nowy, ustaw
stan na wartość statyczną nowy zamiast mapować go na atrybut produktu.Kiedy powinienem używać atrybutów typu Boolean zamiast wartości statycznej?
Użyj Prawda (Boolean) lub Fałsz (Boolean), gdy pole kanału wyraźnie oczekuje wartości logicznej (
true/false), a nie ciągu znaków. Niektóre kanały (np. enable_search w OpenAI) wymagają prawidłowej wartości logicznej — statyczna wartość true jako ciąg znaków może zostać odrzucona.Do czego służą atrybuty przesunięcia daty dostępności?
Kanały obsługujące oferty przedsprzedażowe często wymagają przyszłej daty dostępności. Zamiast ustawiać statyczną datę, która się dezaktualizuje, użyj daty dostępności + N tygodni, aby wygenerować datę, która zawsze będzie N tygodni od dzisiaj, automatycznie utrzymując aktualność dat dostępności przedsprzedażowej.
Do czego służą ceny z separatorami?
Niektóre europejskie kanały i platformy handlowe oczekują cen sformatowanych z kropką jako separatorem tysięcy i przecinkiem jako separatorem dziesiętnym (np.
1.299,95 zamiast 1299.95). Użyj atrybutów cen z separatorami, gdy specyfikacja kanału wymaga tego formatu.Jak dodać nowy atrybut produktu, aby pojawił się w selektorze?
Dodaj go jako atrybut produktu WooCommerce (w sekcji Produkty → Atrybuty) lub jako pole niestandardowe w swoich produktach. Atrybuty dynamiczne aktualizują się na żądanie. Atrybuty niestandardowe aktualizują się co 24 godziny lub po kliknięciu Wyczyść pamięć podręczną atrybutów niestandardowych w sekcji Product Feed → Ustawienia.
Dlaczego „Kategoria Google” jest dostępna tylko dla reguł i filtrów, a nie do bezpośredniego mapowania?
Pole taksonomii produktów Google jest używane przez wtyczkę wewnętrznie do dopasowywania reguł na podstawie kategorii. Możesz tworzyć reguły, które mają zastosowanie do produktów w określonej kategorii Google, ale samo pole nie jest wyprowadzane jako kolumna kanału — zamiast tego zmapuj swoje kategorie WooCommerce na taksonomię Google w sekcji Mapowanie kategorii ustawień kanału.
Potrzebujesz więcej pomocy?
Użytkownicy Product Feed Elite: otwórz zgłoszenie pomocy technicznej, a zespół się tym zajmie.
Użytkownicy Product Feed Pro: opublikuj nowy temat na forum pomocy technicznej WordPress.org, a zespół odpowie tam.
