Synchronizacja metapól
Przegląd AI
Dowiedz się, jak synchronizować metapola produktów i wariantów ze Source store do Destination store w Tipo Sync. Włączasz udostępnianie metapól w Source store i synchronizację metapól w Destination store, a następnie wybierasz, które metapola synchronizować, używając namespace.key. Typy danych muszą być dokładnie takie same w obu sklepach.
Pokaż więcejPokaż mniej
- Typy Reference i MetaObjects nie są obsługiwane; typy danych metapól muszą być takie same w obu sklepach.
- W Source store otwórz Settings, włącz Share Metafields, wybierz zasób Product lub Variant i dodaj definicje w formacie namespace.key.
- W Destination store otwórz Stores, otwórz szczegóły połączenia, włącz Metafields sync i wybierz zasoby.
- Kliknij Save; brakujące definicje są tworzone w Destination store automatycznie.
- Pusta wartość ze Source nigdy nie nadpisuje istniejącej wartości w Destination.
Podsumowanie wygenerowane przez AI. Może zawierać błędy, dlatego sprawdź pełny przewodnik poniżej.
Ten przewodnik wyjaśnia, jak synchronizować metapola z Source store do Destination store w aplikacji Tipo.
ℹ️ Czym są metapola?
Dział zatytułowany „ℹ️ Czym są metapola?”- Metapola produktów
- Metapola wariantów (jeśli je włączysz)
Aplikacja Tipo może synchronizować metapola dla:
- materiału, tabeli rozmiarów, specyfikacji
- niestandardowych oznaczeń (np. „best_seller”)
- dodatkowych szczegółów produktu wykorzystywanych przez motywy/aplikacje
Metapola to niestandardowe pola w Shopify, służące do przechowywania dodatkowych danych o produkcie, takich jak:
✅ Obsługiwane typy metapól
Dział zatytułowany „✅ Obsługiwane typy metapól”- Multi-line text
- Rich text
- Integer
- Decimal
- Date and time
- Date
- Dimension
- Volume
- Weight
- True or false
- Rating
- URL
- Money
- Link
- JSON
🚫 Jeszcze nieobsługiwane:
Typy referencyjne (np. referencja do produktu, referencja do kolekcji) nie są obecnie obsługiwane.
🛠️ Krok 1: Konfiguracja metapól w Source Store
Dział zatytułowany „🛠️ Krok 1: Konfiguracja metapól w Source Store”- Otwórz aplikację > kliknij Settings > włącz Share Metafields
- Wybierz zasób, który chcesz udostępnić:
- Product resource – udostępnij metapola produktów.
- Variant resource – udostępnij metapola wariantów.
- Dodaj konkretne definicje metapól, aby ograniczyć, które metapola są udostępniane.
-
Kliknij ikonę Browse metafields lub
-
Wpisz definicję metapola w formacie:
namespace.key
-
Na przykład:
``` custom.materialseo.titlespecifications.weight ```4. Click Save to update the changes


🛠️ Krok 2: Konfiguracja metapól w Destination Store
Dział zatytułowany „🛠️ Krok 2: Konfiguracja metapól w Destination Store”- Otwórz aplikację > kliknij Stores > kliknij adres URL sklepu źródłowego, aby otworzyć szczegóły połączenia

- Włącz Metafields sync
- Wybierz, co synchronizować
W sekcji Allow data zaznacz jedną lub obie opcje:
- Product Resource → synchronizuj metapola produktów
- Variant Resource → synchronizuj metapola wariantów
- Kliknij ikonę wyszukiwania po prawej stronie, aby zobaczyć wszystkie obsługiwane metapola > kliknij przycisk Select valid metafield to sync


- Kliknij Save, aby zapisać zmiany
🔄 Co dzieje się podczas synchronizacji
Dział zatytułowany „ 🔄 Co dzieje się podczas synchronizacji”1) Jeśli Destination store nie ma definicji metapola
Dział zatytułowany „1) Jeśli Destination store nie ma definicji metapola”Aplikacja automatycznie utworzy definicję metapola w Destination store (w razie potrzeby).
Po jej utworzeniu zsynchronizowane wartości metapól pojawią się przy produkcie/wariancie w Destination store.
2) Jeśli metapola istnieją, ale nie są „ustrukturyzowane” (Unstructured metafields)
Dział zatytułowany „2) Jeśli metapola istnieją, ale nie są „ustrukturyzowane” (Unstructured metafields)”W niektórych przypadkach metapola mogą się zsynchronizować, nawet jeśli nie zostały w pełni zdefiniowane/ustrukturyzowane w Destination store.
Aby je przejrzeć w Shopify Admin:
- Otwórz Settings sklepu → Metafields and metaobjects
- Wybierz Product (lub Variant)
- Otwórz View unstructured metafields
💡 Wskazówka: Możesz później ręcznie zdefiniować/ustrukturyzować te metapola, aby dane w sklepie były uporządkowane i spójne.

3) Jeśli Source store nie ma wartości, Destination nie zostanie nadpisany
Dział zatytułowany „3) Jeśli Source store nie ma wartości, Destination nie zostanie nadpisany”Jeśli metapole istnieje w Destination, ale wartość w Source jest pusta, Tipo Sync nie nadpisze wartości w Destination.
4) Typy danych muszą się zgadzać (bardzo ważne)
Dział zatytułowany „4) Typy danych muszą się zgadzać (bardzo ważne)”Typy danych metapól muszą dokładnie odpowiadać sobie w Source i Destination.
Przykłady niezgodności typów danych:
single_line_text_fieldvsmulti_line_text_fieldnumber_integervsnumber_decimalproduct_referencevstext
⚠️ Jeśli typy danych się nie zgadzają, synchronizacja może się nie powieść lub pominie dane metapole.
📌 Przykład: Synchronizacja metapola produktu – „Material”
Dział zatytułowany „📌 Przykład: Synchronizacja metapola produktu – „Material””Chcesz zsynchronizować niestandardowe metapole produktu o nazwie Material (np. „Cotton”, „Leather”, „Wool”) z Source Store do Destination Store za pomocą naszej aplikacji.
Krok 1: Zdefiniuj metapole w Shopify
Dział zatytułowany „Krok 1: Zdefiniuj metapole w Shopify”W Twoim Source Store:
- Przejdź do Shopify Admin > otwórz Settings sklepu > Metafields and metaobjects > wybierz Product (lub Variant)
- Kliknij Add definition (jeśli nie została jeszcze utworzona) > wypełnij definicję metapola:
- Name: Material
- Namespace:
custom - Key:
material - Type: Single line text
=> To daje pełny klucz metapola: custom.material
Powtórz ten krok w swoim Destination Store (musi mieć ten sam klucz i typ).

Krok 2: Dodaj dane metapola do produktów
Dział zatytułowany „Krok 2: Dodaj dane metapola do produktów”W Twoim Source Store otwórz produkt, przewiń do Metafields > w polu Material wpisz: Cotton
Ten produkt ma teraz metapole custom.material = "Cotton".

Krok 3: Skonfiguruj synchronizację w aplikacji Tipo
Dział zatytułowany „Krok 3: Skonfiguruj synchronizację w aplikacji Tipo ”- Otwórz naszą aplikację w Destination Store > przejdź do Connect Configuration > Metafield Sync
- Wybierz Specific Metafields > wpisz klucz metapola dokładnie tak:
custom.material

Wynik
- Nasza aplikacja znajdzie
custom.materialw Source Store - Jeśli nie istnieje w produkcie w Destination, aplikacja go utworzy
=> Wynik:custom.material = "Cotton"w obu sklepach - Jeśli istnieje w Destination, a w Source jest pusty, nie nadpisujemy wartości
Q1: Jak ustawić namespace.key w sklepie?
Dział zatytułowany „Q1: Jak ustawić namespace.key w sklepie?”Aby zsynchronizować konkretne metapole, musisz wpisać klucz definicji metapola w formacie: namespace.key (na przykład: custom.color).
Oto jak go znaleźć w panelu Shopify:
- Przejdź do Shopify Admin > wybierz Settings > Custom Data > Products
- Kliknij metapole, które chcesz zsynchronizować
→ Zobaczysz wartości Namespace i Key - Połącz je w formacie:
namespace.key
→ Przykład:custom.description
Q2: Dlaczego moje metapola się nie synchronizują?
Dział zatytułowany „Q2: Dlaczego moje metapola się nie synchronizują?”Jeśli metapola nie synchronizują się poprawnie, przyczyną może być jedna z poniższych sytuacji:
- Synchronizacja metapól nie jest włączona
Upewnij się, że synchronizacja metapól jest włączona w obu sklepach:- Włącz Share Metafields w Source Store.
- Włącz Receive Metafields w Destination Store.

- Nie dodano klucza definicji metapola
Oprócz włączenia synchronizacji metapól musisz także dodać klucz definicji metapola (namespace.key), który chcesz synchronizować.
- Przejdź do Settings → Share Metafields
- Upewnij się, że Enable jest zaznaczone
- W sekcji Allow data dodaj definicję metapola w tym formacie:
namespace.key
Przykład:custom.material

- Nieobsługiwane typy metapól
Niektórych typów danych metapól nie obsługujemy, na przykład Reference types lub MetaObjects.
Czerwony: nieobsługiwane metapola, których aplikacja nie może zsynchronizować

- Niezgodne typy metapól między sklepami
Metapole w Source i Destination musi mieć ten sam typ danych i strukturę.
Typowe niezgodności to:
- Jedno metapole to Single line text, a drugie Multi-line text.
- Jedno metapole używa Single value, a drugie List of values.
Aby naprawić te problemy, upewnij się, że metapola w obu sklepach mają ten sam namespace, key i typ danych, a następnie spróbuj ponownie.
🙋 Nadal potrzebujesz pomocy?
Jeśli nadal potrzebujesz pomocy, skontaktuj się z nami pod adresem hi@tipo.io. Chętnie pomożemy.