Przejdź do głównej zawartości

Przeszukaj przewodniki dla Multistore Inventory Sync.

    Pobierz MarkdownZapisz kopię tego przewodnika

    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.

    • 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:


    • 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.


    1. Otwórz aplikację > kliknij Settings > włącz Share Metafields
    2. Wybierz zasób, który chcesz udostępnić:
      • Product resource – udostępnij metapola produktów.
      • Variant resource – udostępnij metapola wariantów.
    3. 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”
    1. Otwórz aplikację > kliknij Stores > kliknij adres URL sklepu źródłowego, aby otworzyć szczegóły połączenia
    1. Włącz Metafields sync
    2. Wybierz, co synchronizować

    W sekcji Allow data zaznacz jedną lub obie opcje:

    • Product Resource → synchronizuj metapola produktów
      • Variant Resource → synchronizuj metapola wariantów
    1. Kliknij ikonę wyszukiwania po prawej stronie, aby zobaczyć wszystkie obsługiwane metapola > kliknij przycisk Select valid metafield to sync
    1. Kliknij Save, aby zapisać zmiany

    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.

    Typy danych metapól muszą dokładnie odpowiadać sobie w Source i Destination.

    Przykłady niezgodności typów danych:

    • single_line_text_field vs multi_line_text_field
    • number_integer vs number_decimal
    • product_reference vs text

    ⚠️ 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.

    W Twoim Source Store:

    1. Przejdź do Shopify Admin > otwórz Settings sklepu > Metafields and metaobjects > wybierz Product (lub Variant)
    2. 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).

    W Twoim Source Store otwórz produkt, przewiń do Metafields > w polu Material wpisz: Cotton

    Ten produkt ma teraz metapole custom.material = "Cotton".

    • 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.material w 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

    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:

    1. Przejdź do Shopify Admin > wybierz Settings > Custom Data > Products
    2. Kliknij metapole, które chcesz zsynchronizować
      → Zobaczysz wartości Namespace i Key
    3. Połącz je w formacie: namespace.key
      → Przykład: custom.description

    Jeśli metapola nie synchronizują się poprawnie, przyczyną może być jedna z poniższych sytuacji:

    1. 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.
    1. 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
    1. 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ć

    1. 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.