Sincronizar metacampos
Resumo de IA
Saiba como sincronizar metacampos de produto e de variante de uma loja de origem para uma loja de destino no Tipo Sync. Ativa a partilha de metacampos na loja de origem e a sincronização de metacampos na loja de destino e depois escolhe os metacampos a sincronizar usando namespace.key. Os tipos de dados têm de ser exatamente iguais nas duas lojas.
Ver maisVer menos
- Os tipos de referência e os MetaObjects não são suportados; os tipos de dados dos metacampos têm de ser iguais em ambas as lojas.
- Na loja de origem, abra Settings, ative Share Metafields, escolha o recurso Product ou Variant e adicione definições como namespace.key.
- Na loja de destino, abra Stores, abra o detalhe da ligação, ative Metafields sync e selecione os recursos.
- Clique em Save; as definições em falta são criadas automaticamente na loja de destino.
- Um valor vazio na origem nunca substitui um valor existente no destino.
Resumo gerado por IA. Pode conter erros, por isso consulte o guia completo abaixo.
Este guia explica como sincronizar metacampos da sua loja de origem para a sua loja de destino na aplicação Tipo.
ℹ️ O que são metacampos?
Seção intitulada “ℹ️ O que são metacampos?”- Metacampos de produto
- Metacampos de variante (se os ativar)
A aplicação Tipo pode sincronizar metacampos para:
- material, tabela de tamanhos, especificações
- distintivos personalizados (por exemplo, “best_seller”)
- detalhes adicionais do produto utilizados por temas/aplicações
Os metacampos são campos personalizados do Shopify utilizados para armazenar dados adicionais do produto, tais como:
✅ Tipos de metacampo suportados
Seção intitulada “✅ Tipos de metacampo suportados”- Texto de várias linhas
- Texto formatado
- Número inteiro
- Decimal
- Data e hora
- Data
- Dimensão
- Volume
- Peso
- Verdadeiro ou falso
- Classificação
- URL
- Dinheiro
- Hiperligação
- JSON
🚫 Ainda não suportado:
Os tipos de referência (por exemplo, referência de produto, referência de coleção) não são suportados de momento.
🛠️ Passo 1: configurar os metacampos na loja de origem
Seção intitulada “🛠️ Passo 1: configurar os metacampos na loja de origem”- Abra a aplicação > clique em Definições (Settings) > ative Partilhar metacampos (Share Metafields)
- Escolha o recurso que pretende partilhar:
- Recurso de produto (Product resource) – partilha os metacampos de produto.
- Recurso de variante (Variant resource) – partilha os metacampos de variante.
- Adicione definições de metacampo específicas para limitar os metacampos que são partilhados.
-
Clique no ícone Procurar metacampos (Browse metafields), ou
-
Introduza a definição do metacampo no formato:
namespace.keyPor exemplo:
custom.materialseo.titlespecifications.weight
-
- Click Save to update the changes


🛠️ Passo 2: configurar os metacampos na loja de destino
Seção intitulada “🛠️ Passo 2: configurar os metacampos na loja de destino”- Abra a aplicação > clique em Lojas (Stores) > clique no URL da loja de origem para abrir os detalhes da ligação

-
Ative a Sincronização de metacampos (Metafields sync)
-
Escolha o que sincronizar
Em Permitir dados (Allow data), selecione uma ou ambas as opções:
- Recurso de produto (Product Resource) → sincroniza os metacampos de produto
- Recurso de variante (Variant Resource) → sincroniza os metacampos de variante
-
Clique no ícone de pesquisa à direita para ver todos os metacampos suportados > clique no botão Selecionar metacampo válido para sincronizar (Select valid metafield to sync)


- Clique em Guardar para atualizar as alterações
🔄 O que acontece durante a sincronização
Seção intitulada “ 🔄 O que acontece durante a sincronização”1) Se a loja de destino não tiver a definição do metacampo
Seção intitulada “1) Se a loja de destino não tiver a definição do metacampo”A aplicação cria automaticamente a definição do metacampo na loja de destino (quando necessário).
Depois de criada, os valores dos metacampos sincronizados aparecem no produto/variante na loja de destino.
2) Se os metacampos existirem mas não estiverem “estruturados” (metacampos não estruturados)
Seção intitulada “2) Se os metacampos existirem mas não estiverem “estruturados” (metacampos não estruturados)”Em alguns casos, os metacampos podem ser sincronizados mesmo que não tenham sido totalmente definidos/estruturados na loja de destino.
Para os consultar no Shopify Admin:
- abra as Definições da loja → Metacampos e metaobjetos
- Escolha Produto (ou Variante)
- Abra Ver metacampos não estruturados
💡 Sugestão: pode definir/estruturar manualmente estes metacampos mais tarde para manter os dados da sua loja limpos e consistentes.

3) Se a loja de origem não tiver valor, o destino não é substituído
Seção intitulada “3) Se a loja de origem não tiver valor, o destino não é substituído”Se um metacampo existir no destino mas o valor na origem estiver vazio, o Tipo Sync não substitui o valor do destino.
4) Os tipos de dados têm de corresponder (muito importante)
Seção intitulada “4) Os tipos de dados têm de corresponder (muito importante)”Os tipos de dados dos metacampos têm de corresponder exatamente entre a origem e o destino.
Exemplos de incompatibilidade de tipos de dados:
single_line_text_fieldvsmulti_line_text_fieldnumber_integervsnumber_decimalproduct_referencevstext
⚠️ Se os tipos de dados não corresponderem, a sincronização pode falhar ou ignorar esse metacampo.
📌 Exemplo: sincronizar um metacampo de produto – “Material”
Seção intitulada “📌 Exemplo: sincronizar um metacampo de produto – “Material””Pretende sincronizar um metacampo de produto personalizado chamado Material (por exemplo, “Cotton”, “Leather”, “Wool”) da sua loja de origem para a sua loja de destino através da nossa aplicação.
Passo 1: definir o metacampo no Shopify
Seção intitulada “Passo 1: definir o metacampo no Shopify”Na sua loja de origem:
- Aceda ao Shopify Admin > abra as Definições da loja > Metacampos e metaobjetos > escolha Produto (ou Variante)
- Clique em Adicionar definição (se ainda não estiver criada) > preencha a definição do metacampo:
- Nome: Material
- Namespace:
custom - Chave:
material - Tipo: texto de linha única
=> Isto dá-lhe a chave completa do metacampo: custom.material
Repita este passo na sua loja de destino (a chave e o tipo têm de ser iguais).

Passo 2: adicionar dados de metacampo aos produtos
Seção intitulada “Passo 2: adicionar dados de metacampo aos produtos”Na sua loja de origem, aceda a um produto e desloque-se para baixo até Metacampos > Em Material, introduza: Cotton
Este produto passa a ter o metacampo custom.material = "Cotton".

Passo 3: configurar a sincronização na aplicação Tipo
Seção intitulada “Passo 3: configurar a sincronização na aplicação Tipo ”- Abra a nossa aplicação na loja de destino > aceda a Configuração da ligação > Sincronização de metacampos
- Escolha Metacampos específicos > introduza exatamente a chave do metacampo:
custom.material

Resultado
- A nossa aplicação encontra
custom.materialna loja de origem - Se não existir no produto de destino, a aplicação cria-o
=> Resultado:custom.material = "Cotton"nas duas lojas - Se existir no destino mas a origem estiver vazia, não substituímos o valor
❓Perguntas frequentes
Seção intitulada “❓Perguntas frequentes”P1: como definir o namespace.key na sua loja?
Seção intitulada “P1: como definir o namespace.key na sua loja?”Para sincronizar um metacampo específico, tem de introduzir a chave de definição do metacampo neste formato: namespace.key (por exemplo: custom.color).
Veja como a encontrar no seu Shopify Admin:
- Aceda ao seu Shopify Admin > navegue até Definições > Dados personalizados > Produtos
- Clique no metacampo que pretende sincronizar
→ Vai ver os valores de Namespace e Chave - Combine-os neste formato:
namespace.key
→ Exemplo:custom.description
P2: porque é que os meus metacampos não estão a ser sincronizados?
Seção intitulada “P2: porque é que os meus metacampos não estão a ser sincronizados?”Se os seus metacampos não estão a ser sincronizados corretamente, pode dever-se a uma das seguintes razões:
- A sincronização de metacampos não está ativada
Certifique-se de que a sincronização de metacampos está ativada nas duas lojas:- Ative Partilhar metacampos na loja de origem.
- Ative Receber metacampos (Receive Metafields) na loja de destino.

- A chave de definição do metacampo não foi adicionada
Além de ativar a sincronização de metacampos, tem também de adicionar a chave de definição do metacampo (namespace.key) que pretende sincronizar.
- Aceda a Definições → Partilhar metacampos
- Certifique-se de que a opção Ativar (Enable) está selecionada
- Em Permitir dados, adicione a definição do metacampo neste formato:
namespace.key
Exemplo:custom.material

- Tipos de metacampo não suportados
Alguns tipos de dados de metacampo não são suportados, como os tipos de referência ou os metaobjetos.
Vermelho: metacampos não suportados que não podem ser sincronizados pela aplicação

- Tipos de metacampo incompatíveis entre lojas
O metacampo na origem e no destino tem de ter o mesmo tipo de dados e a mesma estrutura.
As incompatibilidades mais comuns incluem:
- Um metacampo é de texto de linha única, enquanto o outro é de texto de várias linhas.
- Um metacampo utiliza valor único, enquanto o outro utiliza lista de valores.
Para resolver estes problemas, confirme que os metacampos nas duas lojas têm o mesmo namespace, a mesma chave e o mesmo tipo de dados, e tente sincronizar novamente.
🙋 Ainda precisa de ajuda?
Se ainda precisar de ajuda, não hesite em contactar-nos através de hi@tipo.io. Teremos todo o gosto em ajudá-lo(a).