Tutorial

Dodawanie Metafieldów do Produktów Shopify

Dodawanie lub aktualizowanie metafieldów dla wielu produktów jednocześnie może być czasochłonne, jeśli jest wykonywane ręcznie. DataEase ułatwia ten proces: eksportuj swoje produkty, edytuj wartości metafieldów w Excelu lub CSV używając par namespace:key, a następnie zaimportuj je z powrotem do Shopify — wszystko z bezpieczną walidacją typów.

🎯 Cel

Dodaj lub zaktualizuj metafieldy produktów masowo, używając CSV/Excel i DataEase. Używaj czystych par namespace:key z wartościami o bezpiecznych typach.


📋 Instrukcje Krok po Kroku

1. Eksportuj Produkty

W DataEase przejdź do Nowy Eksport → Produkty. Uwzględnij co najmniej:

  • id
  • handle

Opcjonalnie dodaj istniejące metafieldy, aby przejrzeć bieżące dane.

To da ci plik ze wszystkimi produktami gotowymi do edycji.


2. Wybierz Metodę Edycji Metafieldów

DataEase obsługuje dwie metody edycji metafieldów:

Dynamiczne kolumny (zalecane): Dodaj jedną kolumnę na klucz, nazwaną metafield: {namespace} / {key} (np. metafield: my_fields / material). Wprowadź wartość bezpośrednio w komórce.

Pojedyncza kolumna “metafields”: Podaj wiele wpisów w jednej komórce jako namespace:key = value; namespace2:key2 = value2 (oddzielone średnikiem).


3. Edytuj Plik

Otwórz wyeksportowany plik w Excelu lub Google Sheets. Dla każdego wiersza, który chcesz zmienić:

  1. Ustaw command = UPDATE
  2. Wypełnij wartości metafieldów używając odpowiedniego formatu:
    • Stringi: zwykły tekst (np. Organic Cotton)
    • Liczby: formaty numeryczne (np. 42, 19.95)
    • Booleany: TRUE / FALSE
    • Data/Czas: format ISO-8601 (np. 2025-11-05T10:00:00+01:00)
    • JSON: prawidłowy JSON (np. {"color":"red","size":"m"})

Po zakończeniu zapisz plik jako .xlsx lub .csv.


4. Importuj i Zweryfikuj

  1. W DataEase rozpocznij Nowy Import
  2. Prześlij edytowany plik
  3. Mapuj kolumny (preferowane ID Produktu)
  4. Uruchom Walidację

Otwórz raport walidacji i napraw wszelkie problemy z typem/formatem zaznaczone w Statusie Walidacji.


5. Uruchom Import

Po pomyślnej walidacji kliknij Uruchom Import, aby zastosować swoje metafieldy do Shopify.

Po zakończeniu, sprawdź produkty w panelu administracyjnym Shopify, aby potwierdzić, że wszystko wygląda poprawnie.


📝 Ważne Uwagi

  • Usuwanie metafieldu: Pozostaw komórkę dynamicznej kolumny pustą dla tego klucza przy UPDATE, aby go usunąć
  • Typy: Walidator sprawdza typy metafieldów Shopify (string, number, boolean, date_time, json, itp.). Używaj odpowiednich formatów, aby przejść walidację
  • Spójność: Zachowaj spójność namespace i kluczy (my_fields.material, nie mieszaj wielkości liter/spacji)
  • Metafieldy wariantów: Stosuj tę samą metodę na eksportach na poziomie wariantów (zobacz przewodnik Warianty) używając ID Wariantu i odpowiednich kolumn metafieldów

💡 Minimalne Przykłady CSV

Dynamiczne kolumny (zalecane):

id,command,metafield: my_fields / material,metafield: my_fields / season
gid://shopify/Product/123,UPDATE,Organic Cotton,Summer 2025

Pojedyncza kolumna “metafields”:

id,command,metafields
gid://shopify/Product/456,UPDATE,"my_fields:material = Organic Cotton; my_fields:season = Summer 2025"

Usunięcie metafieldu (dynamiczna kolumna pozostawiona pusta):

id,command,metafield: my_fields / material
gid://shopify/Product/789,UPDATE,

🎉 To wszystko!

Twoje metafieldy zostały teraz dodane lub zaktualizowane masowo.
Jeśli napotkasz jakiekolwiek problemy lub masz pytania, skontaktuj się z naszym zespołem wsparcia.