# Metafelder synchronisieren

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

### ℹ️ Was sind Metafelder?

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

***

### ✅ **Unterstützte Metafeld-Typen**

* 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

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

<figure><img src="/media/4360c99527c6a4de655c.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

<figure><img src="/media/7a7d4dfafe848ed0a876.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

***

### 🛠️ 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

<figure><img src="/media/b99e7e334515ad4e086d.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

2. Aktivieren Sie **Metafeld-Synchronisierung (Metafields sync)**
3. 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
4. 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)**&#x20;

<figure><img src="/media/4360c99527c6a4de655c.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

<figure><img src="/media/7a7d4dfafe848ed0a876.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

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

***

### &#x20;🔄 Was bei der Synchronisierung passiert

#### **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)**

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.

<figure><img src="/media/755ea231da077f6819c8.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **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)**

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“

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.

#### **Schritt 1: Das Metafeld in Shopify definieren**

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

<figure><img src="/media/e68676d721f26cb93ef7.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **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"`.

<figure><img src="/media/97a6ddb98ed50e435682.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **Schritt 3: Die Synchronisierung in der Tipo-App konfigurieren**&#x20;

* Ö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`&#x20;

<figure><img src="/media/7a7d4dfafe848ed0a876.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

**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**

***

### ❓FAQs

#### 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?

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

<figure><img src="/media/4360c99527c6a4de655c.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

2. **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`&#x20;

<figure><img src="/media/f4d2b012b6b982aa41e6.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

3. **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

<figure><img src="/media/85f75cd1117f373c78df.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

4. **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.
