Introdução

Os metafields da Shopify permitem armazenar informações adicionais (como um “Subtítulo”, “Biografia do autor” ou “Cor do produto”) que não se encaixam nos campos padrão das postagens do blog. Com o Blog Importer, você pode importar esses pontos de dados extras em massa usando um formato CSV simples.

Por que importar metafields em massa?

A entrada manual para centenas de artigos é demorada e propensa a erros. Ao usar um arquivo CSV, você pode:

  • Migrar campos personalizados do WordPress: Converta automaticamente dados ACF ou outros dados personalizados em metafields da Shopify.
  • Atualização em massa: Atualize rapidamente atributos específicos em muitos artigos.
  • Manter a consistência: Garanta que os tipos de dados e valores correspondam perfeitamente.

Guia passo a passo

Passo 1: Criar definições de metafields na Shopify

Antes de importar, você deve definir os metafields no seu painel de controle da Shopify para que a loja saiba como lidar com os dados.

  1. Vá para Configurações > Metafields e metaobjetos > Posts do blog.
  2. Clique em Adicionar definição.
  3. Insira o Nome, o Namespace e chave (ex: custom.color) e selecione o Tipo (ex: Texto de uma linha).

Passo 2: Preparar seu cabeçalho CSV

No seu arquivo CSV, use o seguinte formato para as colunas de metafields: metafield_[namespace]_[key]:[type]

Por exemplo, se o seu namespace for custom, a chave for color e o tipo for single_line_text_field, o cabeçalho deve ser: metafield_custom_color:single_line_text_field

Passo 3: Corresponder os tipos de dados exatamente

A parte “type” do cabeçalho deve corresponder exatamente ao nome interno usado pela Shopify.

  • Correto: metafield_custom_price:number_decimal
  • Incorreto: metafield_custom_price:number (Deve ser específico)

Consulte a página Tipos de metafields compatíveis para obter uma lista completa dos nomes dos tipos.

Passo 4: Adicionar seus dados

Preencha as linhas abaixo do novo cabeçalho com os dados relevantes.

  • Para tipos de texto: Basta inserir a string.
  • Para tipos booleanos: Use true ou false.
  • Para referências: Use o GID (ex: gid://shopify/File/12345).

Passo 5: Importar com o Blog Importer

Abra o aplicativo Blog Importer no seu painel de controle da Shopify, carregue seu CSV e inicie a importação. O aplicativo mapeará automaticamente essas colunas para os seus metafields definidos.

Dica importante: Se a definição do metafield ainda não existir na Shopify, a importação pode falhar ou ignorar esses campos. Certifique-se sempre de que “Namespace.chave” e “Tipo” correspondam exatamente ao seu cabeçalho CSV.


FAQ

Os tipos de lista são suportados?

Sim, para tipos de lista, você pode frequentemente fornecer valores separados por vírgulas ou arrays JSON, dependendo do tipo específico. Recomendamos testar primeiro com uma única linha.

Posso atualizar artigos existentes?

Sim. Se o handle no seu CSV corresponder a um artigo existente, o Blog Importer poderá atualizar os metafields para esse artigo.


Guias relacionados