Zum Inhalt springen

Durchsuchen Sie die Anleitungen für Multistore Inventory Sync.

    Markdown herunterladenKopie dieser Anleitung speichern

    Metafelder synchronisieren

    KI-Übersicht

    Hier erfahren Sie, wie Sie Produkt- und Varianten-Metafelder in Tipo Sync von einem Source store in einen Destination store synchronisieren. Sie aktivieren die Metafeld-Freigabe im Source store und die Metafeld-Synchronisierung im Destination store und wählen dann per namespace.key aus, welche Metafelder synchronisiert werden. Die Datentypen müssen in beiden Shops exakt übereinstimmen.

    Mehr anzeigenWeniger anzeigen
    • Referenztypen und MetaObjects werden nicht unterstützt; die Datentypen der Metafelder müssen in beiden Shops übereinstimmen.
    • Öffnen Sie im Source store Settings, aktivieren Sie Share Metafields, wählen Sie die Ressource Product oder Variant und fügen Sie Definitionen als namespace.key hinzu.
    • Öffnen Sie im Destination store Stores, öffnen Sie die Verbindungsdetails, aktivieren Sie Metafields sync und wählen Sie die Ressourcen aus.
    • Klicken Sie auf Save; fehlende Definitionen werden im Destination store automatisch erstellt.
    • Ein leerer Wert im Source store überschreibt nie einen vorhandenen Wert im Destination store.

    Von KI erstellte Zusammenfassung. Sie kann Fehler enthalten – lesen Sie daher die vollständige Anleitung unten.

    Diese Anleitung erklärt, wie Sie Metafelder in der Tipo-App von Ihrem Quell-Shop in Ihren Ziel-Shop synchronisieren.

    • Produkt-Metafelder
    • Varianten-Metafelder (wenn Sie sie aktivieren)

    Die Tipo-App kann Metafelder synchronisieren für:

    • Material, Größentabelle, Spezifikationen
    • individuelle Badges (z. B. „best_seller“)
    • zusätzliche Produktdetails, die von Themes/Apps verwendet werden

    Metafelder sind benutzerdefinierte Felder in Shopify, in denen zusätzliche Produktdaten gespeichert werden, zum Beispiel:


    • Mehrzeiliger Text
    • Rich Text
    • Ganzzahl
    • Dezimalzahl
    • Datum und Uhrzeit
    • Datum
    • Abmessung
    • Volumen
    • Gewicht
    • Wahr oder falsch
    • Bewertung
    • URL
    • Geldbetrag
    • Link
    • JSON

    🚫 Noch nicht unterstützt:
    Referenztypen (z. B. Produktreferenz, Sammlungsreferenz) werden derzeit nicht unterstützt.


    🛠️ Schritt 1: Metafelder im Quell-Shop konfigurieren

    Abschnitt betitelt „🛠️ Schritt 1: Metafelder im Quell-Shop konfigurieren“
    1. Öffnen Sie die App > klicken Sie auf Einstellungen (Settings) > aktivieren Sie Metafelder teilen (Share Metafields)
    2. Wählen Sie die Ressource, die Sie teilen möchten:
      • Produktressource (Product resource) – Produkt-Metafelder teilen.
      • Variantenressource (Variant resource) – Varianten-Metafelder teilen.
    3. Fügen Sie bestimmte Metafeld-Definitionen hinzu, um einzugrenzen, welche Metafelder geteilt werden.
      • Klicken Sie auf das Symbol Metafelder durchsuchen (Browse metafields), oder

      • geben Sie die Metafeld-Definition im folgenden Format ein:

        namespace.key

        Zum Beispiel:

        custom.materialseo.titlespecifications.weight
    4. Click Save to update the changes

    🛠️ Schritt 2: Metafelder im Ziel-Shop konfigurieren

    Abschnitt betitelt „🛠️ Schritt 2: Metafelder im Ziel-Shop konfigurieren“
    1. Öffnen Sie die App > klicken Sie auf Shops (Stores) > klicken Sie auf die URL des Quell-Shops, um die Verbindungsdetails zu öffnen
    1. Aktivieren Sie Metafeld-Synchronisierung (Metafields sync)

    2. Wählen Sie aus, was synchronisiert werden soll

      Wählen Sie unter Erlaubte Daten (Allow data) eine oder beide Optionen:

      • Produktressource → Produkt-Metafelder synchronisieren
      • Variantenressource → Varianten-Metafelder synchronisieren
    3. Klicken Sie rechts auf das Suchsymbol, um alle unterstützten Metafelder anzuzeigen > klicken Sie auf die Schaltfläche Gültiges Metafeld zur Synchronisierung auswählen (Select valid metafield to sync)

    1. Klicken Sie auf Speichern, um die Änderungen zu übernehmen

    1) Wenn der Ziel-Shop die Metafeld-Definition nicht hat

    Abschnitt betitelt „1) Wenn der Ziel-Shop die Metafeld-Definition nicht hat“

    Die App erstellt die Metafeld-Definition bei Bedarf automatisch im Ziel-Shop.

    Nach der Erstellung erscheinen die synchronisierten Metafeld-Werte beim Produkt bzw. bei der Variante im Ziel-Shop.

    2) Wenn Metafelder existieren, aber nicht „strukturiert“ sind (unstrukturierte Metafelder)

    Abschnitt betitelt „2) Wenn Metafelder existieren, aber nicht „strukturiert“ sind (unstrukturierte Metafelder)“

    In einigen Fällen werden Metafelder auch dann synchronisiert, wenn sie im Ziel-Shop nicht vollständig definiert bzw. strukturiert wurden.

    So prüfen Sie sie im Shopify Admin:

    • Öffnen Sie die Shop-Einstellungen → Metafelder und Metaobjekte
    • Wählen Sie Produkt (oder Variante)
    • Öffnen Sie Unstrukturierte Metafelder anzeigen

    💡 Tipp: Sie können diese Metafelder später manuell definieren bzw. strukturieren, damit Ihre Shop-Daten sauber und konsistent bleiben.

    3) Wenn der Quell-Shop keinen Wert hat, wird der Ziel-Shop nicht überschrieben

    Abschnitt betitelt „3) Wenn der Quell-Shop keinen Wert hat, wird der Ziel-Shop nicht überschrieben“

    Wenn ein Metafeld im Ziel-Shop existiert, der Wert im Quell-Shop aber leer ist, überschreibt Tipo Sync den Wert im Ziel-Shop nicht.

    4) Die Datentypen müssen übereinstimmen (sehr wichtig)

    Abschnitt betitelt „4) Die Datentypen müssen übereinstimmen (sehr wichtig)“

    Die Datentypen der Metafelder müssen im Quell- und im Ziel-Shop genau übereinstimmen.

    Beispiele für nicht übereinstimmende Datentypen:

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

    ⚠️ Wenn die Datentypen nicht übereinstimmen, kann die Synchronisierung fehlschlagen oder das Metafeld wird übersprungen.


    📌 Beispiel: Ein Produkt-Metafeld synchronisieren – „Material“

    Abschnitt betitelt „📌 Beispiel: Ein Produkt-Metafeld synchronisieren – „Material““

    Sie möchten mit unserer App ein benutzerdefiniertes Produkt-Metafeld namens Material (z. B. „Cotton“, „Leather“, „Wool“) von Ihrem Quell-Shop in Ihren Ziel-Shop synchronisieren.

    In Ihrem Quell-Shop:

    1. Gehen Sie zum Shopify Admin > öffnen Sie die Shop-Einstellungen > Metafelder und Metaobjekte > wählen Sie Produkt (oder Variante)
    2. Klicken Sie auf Definition hinzufügen (falls noch nicht erstellt) > füllen Sie die Metafeld-Definition aus:
      • Name: Material
      • Namespace: custom
      • Key: material
      • Typ: Einzeiliger Text

    => Damit erhalten Sie den vollständigen Metafeld-Schlüssel: custom.material

    Wiederholen Sie diesen Schritt in Ihrem Ziel-Shop (Schlüssel und Typ müssen übereinstimmen).

    Schritt 2: Metafeld-Daten zu Produkten hinzufügen

    Abschnitt betitelt „Schritt 2: Metafeld-Daten zu Produkten hinzufügen“

    Gehen Sie in Ihrem Quell-Shop zu einem Produkt und scrollen Sie nach unten zu Metafelder > Geben Sie unter Material Folgendes ein: Cotton

    Dieses Produkt hat nun das Metafeld custom.material = "Cotton".

    Schritt 3: Die Synchronisierung in der Tipo-App konfigurieren

    Abschnitt betitelt „Schritt 3: Die Synchronisierung in der Tipo-App konfigurieren “
    • Öffnen Sie unsere App im Ziel-Shop > gehen Sie zu Verbindungskonfiguration > Metafeld-Synchronisierung (Metafield Sync)
    • Wählen Sie Bestimmte Metafelder (Specific Metafields) > und geben Sie den Metafeld-Schlüssel genau so ein: custom.material

    Ergebnis

    • Unsere App findet custom.material im Quell-Shop
    • Wenn es im Ziel-Produkt nicht vorhanden ist, erstellt die App es
      => Ergebnis: custom.material = "Cotton" in beiden Shops
    • Wenn es im Ziel-Shop existiert, der Wert im Quell-Shop aber leer ist, überschreiben wir den Wert nicht

    Frage 1: Wie lege ich namespace.key in meinem Shop fest?

    Abschnitt betitelt „Frage 1: Wie lege ich namespace.key in meinem Shop fest?“

    Um ein bestimmtes Metafeld zu synchronisieren, geben Sie den Schlüssel der Metafeld-Definition im folgenden Format ein: namespace.key (zum Beispiel: custom.color).

    So finden Sie ihn in Ihrem Shopify Admin:

    1. Gehen Sie zu Ihrem Shopify Admin > navigieren Sie zu Einstellungen > Benutzerdefinierte Daten > Produkte
    2. Klicken Sie auf das Metafeld, das Sie synchronisieren möchten
      → Sie sehen die Werte für Namespace und Key
    3. Kombinieren Sie sie im Format namespace.key
      → Beispiel: custom.description

    Frage 2: Warum werden meine Metafelder nicht synchronisiert?

    Abschnitt betitelt „Frage 2: Warum werden meine Metafelder nicht synchronisiert?“

    Wenn Ihre Metafelder nicht korrekt synchronisiert werden, kann das einen der folgenden Gründe haben:

    1. Die Metafeld-Synchronisierung ist nicht aktiviert
      Stellen Sie sicher, dass die Metafeld-Synchronisierung in beiden Shops aktiviert ist:
      • Aktivieren Sie Metafelder teilen im Quell-Shop.
      • Aktivieren Sie Metafelder empfangen (Receive Metafields) im Ziel-Shop.
    1. Der Schlüssel der Metafeld-Definition wurde nicht hinzugefügt

    Neben der Aktivierung der Metafeld-Synchronisierung müssen Sie auch den Schlüssel der Metafeld-Definition (namespace.key) hinzufügen, den Sie synchronisieren möchten.

    • Gehen Sie zu Einstellungen → Metafelder teilen
    • Stellen Sie sicher, dass Aktivieren (Enable) angehakt ist
    • Fügen Sie unter Erlaubte Daten die Metafeld-Definition im folgenden Format hinzu:
      namespace.key
      Beispiel: custom.material
    1. Nicht unterstützte Metafeld-Typen
      Einige Metafeld-Datentypen werden nicht unterstützt, zum Beispiel Referenztypen oder Metaobjekte.

    Rot: Nicht unterstützte Metafelder, die von der App nicht synchronisiert werden können

    1. Nicht übereinstimmende Metafeld-Typen zwischen den Shops
      Das Metafeld im Quell- und im Ziel-Shop muss denselben Datentyp und dieselbe Struktur haben.
      Häufige Abweichungen sind:
    • Ein Metafeld ist Einzeiliger Text, das andere Mehrzeiliger Text.
    • Ein Metafeld verwendet Einzelwert, das andere Werteliste.

    Um diese Probleme zu beheben, prüfen Sie, ob die Metafelder in beiden Shops denselben Namespace, denselben Key und denselben Datentyp haben, und versuchen Sie die Synchronisierung dann erneut.


    🙋 Benötigen Sie weitere Hilfe?

    Wenn Sie weitere Hilfe benötigen, schreiben Sie uns gerne an hi@tipo.io. Wir unterstützen Sie gerne.