Salta ai contenuti

Cerca le guide di Multistore Inventory Sync.

    Scarica MarkdownSalva una copia di questa guida

    Sincronizza i metafield

    Panoramica IA

    Scopri come sincronizzare i metafield di prodotti e varianti da un Source store a un Destination store in Tipo Sync. Attivi la condivisione dei metafield nel Source store e la sincronizzazione dei metafield nel Destination store, poi scegli quali metafield sincronizzare usando namespace.key. I tipi di dati devono corrispondere esattamente tra i due negozi.

    Mostra altroMostra meno
    • I tipi di riferimento e i MetaObject non sono supportati; i tipi di dati dei metafield devono corrispondere in entrambi i negozi.
    • Nel Source store, apri Settings, attiva Share Metafields, scegli la risorsa Product o Variant e aggiungi le definizioni come namespace.key.
    • Nel Destination store, apri Stores, apri il dettaglio della connessione, attiva Metafields sync e seleziona le risorse.
    • Fai clic su Save; le definizioni mancanti vengono create automaticamente nel Destination store.
    • Un valore vuoto nel Source non sovrascrive mai un valore esistente nel Destination.

    Riepilogo generato dall'IA. Può contenere errori, quindi consulta la guida completa qui sotto.

    Questa guida spiega come sincronizzare i metafield dal negozio di origine al negozio di destinazione con l’app Tipo.

    • Metafield del prodotto
    • Metafield della variante (se li abiliti)

    L’app Tipo può sincronizzare metafield per:

    • materiale, guida alle taglie, specifiche
    • badge personalizzati (ad es. “best_seller”)
    • dettagli aggiuntivi del prodotto usati da temi o app

    I metafield sono campi personalizzati di Shopify usati per memorizzare dati aggiuntivi dei prodotti, come:


    • Testo su più righe
    • Testo RTF
    • Numero intero
    • Decimale
    • Data e ora
    • Data
    • Dimensione
    • Volume
    • Peso
    • Vero o falso
    • Valutazione
    • URL
    • Denaro
    • Link
    • JSON

    🚫 Non ancora supportati:
    I tipi di riferimento (ad es. riferimento a prodotto, riferimento a collezione) non sono attualmente supportati.


    🛠️ Passaggio 1: configura i metafield nel negozio di origine

    Sezione intitolata “🛠️ Passaggio 1: configura i metafield nel negozio di origine”
    1. Apri l’app > fai clic su Impostazioni (Settings) > attiva Condividi metafield (Share Metafields)
    2. Scegli la risorsa che vuoi condividere:
      • Risorsa prodotto (Product resource) – Condivide i metafield dei prodotti.
      • Risorsa variante (Variant resource) – Condivide i metafield delle varianti.
    3. Aggiungi definizioni di metafield specifiche per limitare quali metafield vengono condivisi.
      • Fai clic sull’icona Sfoglia metafield (Browse metafields), oppure

      • Inserisci la definizione del metafield nel formato:

        namespace.key

        Ad esempio:

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

    🛠️ Passaggio 2: configura i metafield nel negozio di destinazione

    Sezione intitolata “🛠️ Passaggio 2: configura i metafield nel negozio di destinazione”
    1. Apri l’app > fai clic su Negozi (Stores) > fai clic sull’URL del negozio di origine per aprire i dettagli della connessione
    1. Attiva Sincronizzazione metafield (Metafields sync)

    2. Scegli cosa sincronizzare

      In Dati consentiti (Allow data), seleziona una o entrambe le opzioni:

      • Risorsa prodotto → sincronizza i metafield dei prodotti
      • Risorsa variante → sincronizza i metafield delle varianti
    3. Fai clic sull’icona di ricerca a destra per vedere tutti i metafield supportati > fai clic sul pulsante Seleziona metafield validi da sincronizzare (Select valid metafield to sync)

    1. Fai clic su Salva per applicare le modifiche

    1) Se il negozio di destinazione non ha la definizione del metafield

    Sezione intitolata “1) Se il negozio di destinazione non ha la definizione del metafield”

    L’app crea automaticamente la definizione del metafield nel negozio di destinazione (quando necessario).

    Dopo la creazione, i valori dei metafield sincronizzati compariranno sul prodotto o sulla variante nel negozio di destinazione.

    2) Se i metafield esistono ma non sono “strutturati” (metafield non strutturati)

    Sezione intitolata “2) Se i metafield esistono ma non sono “strutturati” (metafield non strutturati)”

    In alcuni casi i metafield possono essere sincronizzati anche se non sono stati definiti o strutturati completamente nel negozio di destinazione.

    Per consultarli in Shopify Admin:

    • apri le Impostazioni del negozio → Metafield e metaoggetti
    • Scegli Prodotto (o Variante)
    • Apri Visualizza metafield non strutturati

    💡 Suggerimento: puoi definire o strutturare manualmente questi metafield in un secondo momento per mantenere i dati del negozio puliti e coerenti.

    3) Se il negozio di origine non ha alcun valore, la destinazione non viene sovrascritta

    Sezione intitolata “3) Se il negozio di origine non ha alcun valore, la destinazione non viene sovrascritta”

    Se un metafield esiste nel negozio di destinazione ma il valore di origine è vuoto, Tipo Sync non sovrascrive il valore di destinazione.

    4) I tipi di dati devono corrispondere (molto importante)

    Sezione intitolata “4) I tipi di dati devono corrispondere (molto importante)”

    I tipi di dati dei metafield devono corrispondere esattamente tra negozio di origine e negozio di destinazione.

    Esempi di tipi di dati non corrispondenti:

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

    ⚠️ Se i tipi di dati non corrispondono, la sincronizzazione potrebbe non riuscire o saltare quel metafield.


    📌 Esempio: sincronizzare un metafield del prodotto – “Materiale”

    Sezione intitolata “📌 Esempio: sincronizzare un metafield del prodotto – “Materiale””

    Vuoi sincronizzare un metafield personalizzato del prodotto chiamato Materiale (ad es. “Cotone”, “Pelle”, “Lana”) dal tuo negozio di origine al tuo negozio di destinazione usando la nostra app.

    Nel tuo negozio di origine:

    1. Vai a Shopify Admin > apri le Impostazioni del negozio > Metafield e metaoggetti > scegli Prodotto (o Variante)
    2. Fai clic su Aggiungi definizione (se non è già stata creata) > compila la definizione del metafield:
      • Nome: Materiale
      • Namespace: custom
      • Chiave: material
      • Tipo: Testo su una sola riga

    => Così ottieni la chiave completa del metafield: custom.material

    Ripeti questo passaggio nel tuo negozio di destinazione (chiave e tipo devono essere identici).

    Passaggio 2: aggiungi i dati dei metafield ai prodotti

    Sezione intitolata “Passaggio 2: aggiungi i dati dei metafield ai prodotti”

    Nel tuo negozio di origine, vai a un prodotto e scorri fino a Metafield > in Materiale, inserisci: Cotton

    Ora questo prodotto ha il metafield custom.material = "Cotton".

    Passaggio 3: configura la sincronizzazione nell’app Tipo

    Sezione intitolata “Passaggio 3: configura la sincronizzazione nell’app Tipo ”
    • Apri la nostra app nel negozio di destinazione > vai a Configurazione connessione > Sincronizzazione metafield
    • Scegli Metafield specifici > inserisci esattamente la chiave del metafield: custom.material

    Risultato

    • La nostra app troverà custom.material nel negozio di origine
    • Se non esiste nel prodotto di destinazione, l’app lo creerà
      => Risultato: custom.material = "Cotton" in entrambi i negozi
    • Se esiste nel negozio di destinazione ma quello di origine è vuoto, non sovrascriviamo il valore

    Per sincronizzare un metafield specifico, devi inserire la chiave di definizione del metafield in questo formato: namespace.key (ad esempio: custom.color).

    Ecco come trovarla nel tuo Shopify Admin:

    1. Vai al tuo Shopify Admin > vai a Impostazioni > Dati personalizzati > Prodotti
    2. Fai clic sul metafield che vuoi sincronizzare
      → Vedrai i valori di Namespace e Chiave
    3. Combinali in questo formato: namespace.key
      → Esempio: custom.description

    D2: perché i miei metafield non vengono sincronizzati?

    Sezione intitolata “D2: perché i miei metafield non vengono sincronizzati?”

    Se i metafield non vengono sincronizzati correttamente, la causa potrebbe essere una delle seguenti:

    1. La sincronizzazione dei metafield non è abilitata
      Assicurati che la sincronizzazione dei metafield sia attiva in entrambi i negozi:
      • Abilita Condividi metafield nel negozio di origine.
      • Abilita Ricevi metafield (Receive Metafields) nel negozio di destinazione.
    1. La chiave di definizione del metafield non è stata aggiunta

    Oltre ad abilitare la sincronizzazione dei metafield, devi anche aggiungere la chiave di definizione del metafield (namespace.key) che vuoi sincronizzare.

    • Vai a Impostazioni → Condividi metafield
    • Assicurati che Abilita (Enable) sia selezionato
    • In Dati consentiti, aggiungi la definizione del metafield in questo formato:
      namespace.key
      Esempio: custom.material
    1. Tipi di metafield non supportati
      Alcuni tipi di dati dei metafield non sono supportati, come i tipi di riferimento o i metaoggetti.

    Rosso: metafield non supportati che l’app non può sincronizzare

    1. Tipi di metafield non corrispondenti tra i negozi
      Il metafield nel negozio di origine e in quello di destinazione deve avere lo stesso tipo di dati e la stessa struttura.
      Le discrepanze più comuni sono:
    • Un metafield è Testo su una sola riga, mentre l’altro è Testo su più righe.
    • Un metafield usa Valore singolo, mentre l’altro usa Elenco di valori.

    Per risolvere questi problemi, verifica che i metafield in entrambi i negozi abbiano lo stesso namespace, la stessa chiave e lo stesso tipo di dati, quindi riprova a sincronizzare.


    🙋 Hai ancora bisogno di assistenza?

    Se hai ancora bisogno di aiuto, scrivici pure a hi@tipo.io. Saremo felici di aiutarti.