Escolha o identificador em que os nomes dos seus arquivos se baseiam e, depois, o quanto ele precisa corresponder: exato, a imagem contém o identificador ou o identificador contém o nome da imagem. Na dúvida, comece com Associar por SKU exato.
Guia rápido de decisão
- Arquivos com o nome exato dos SKUs ou códigos de barras? → Associar por SKU / CÓDIGO DE BARRAS exato.
- Nomes com o SKU e mais texto? → Associar se a imagem contém o SKU.
- Uma foto compartilhada por várias variantes com um código base comum? → Associar se o SKU contém o nome da imagem.
- Nem SKU nem código de barras batem com os nomes? → Coloque o código da imagem em um metacampo e use Associar por METACAMPO exato, ou experimente a associação com IA.
De onde vem cada identificador
| Identificador | Valor lido da Shopify |
|---|---|
| SKU | O SKU da variante |
| CÓDIGO DE BARRAS | O código de barras da variante (EAN, UPC, GTIN) |
| TÍTULO | O título do produto (não o da variante) |
| METACAMPO | O metacampo de produto ou variante definido em Configurações → Associação por metacampo (namespace.key) |
| ID DA VARIANTE | O ID numérico da variante na URL do admin, por ex. 44436602683565 |
Os valores são convertidos para minúsculas e aparados. Variantes com valor vazio são ignoradas e nunca podem ser associadas.
As três formas de associação
| Forma | Associa quando | Exemplo |
|---|---|---|
| Exato | O nome do arquivo é igual ao identificador | AB1234.jpg → SKU AB1234 |
| A imagem contém o identificador | O identificador aparece no nome do arquivo | photo-ab1234-front.jpg → SKU AB1234 |
| O identificador contém o nome da imagem | O nome do arquivo aparece no identificador | AB1234.jpg → SKUs AB1234-S, AB1234-M, AB1234-L |
- A imagem contém o identificador: vence a correspondência mais longa. Se um nome de arquivo contém
ab12eab1234, só a variante comab1234recebe a imagem, então SKUs curtos não roubam imagens. - O identificador contém o nome da imagem: vencem todas as correspondências. Uma imagem pode ir para muitas variantes. Sempre confira a contagem na prévia antes de enviar.
Todos os tipos de associação
| Opção | Use quando |
|---|---|
| Associar por SKU exato | Os arquivos têm exatamente o nome do SKU. O padrão e a escolha mais segura. |
| Associar se a imagem contém o SKU | Os nomes têm texto extra: nikon-d750-AB1234-front.jpg. |
| Associar se o SKU contém o nome da imagem | Os arquivos têm um código base que os SKUs estendem: AB1234.jpg → todos os tamanhos. |
| Associar por CÓDIGO DE BARRAS exato | Os arquivos têm o nome do EAN/UPC/GTIN. Muito confiável. |
| Associar se a imagem contém o CÓDIGO DE BARRAS | Arquivos como 7891234567890-1200x1200.jpg. |
| Associar se o CÓDIGO DE BARRAS contém o nome da imagem | Raro. Os nomes trazem um código de barras truncado. |
| Associar por TÍTULO exato | Sem SKUs nem códigos de barras; os nomes reproduzem exatamente o título do produto. |
| Associar se a imagem contém o TÍTULO | Os nomes trazem o título do produto e mais texto. |
| Associar se o TÍTULO contém o nome da imagem | Os nomes trazem uma palavra marcante do título. Confira a prévia com cuidado. |
| Associar por METACAMPO exato | Você guarda um código de imagem (de ERP ou fornecedor) em um metacampo. |
| Associar se a imagem contém o METACAMPO | O mesmo, com texto extra nos nomes. |
| Associar se o METACAMPO contém o nome da imagem | O metacampo tem um valor composto que inclui o código. |
| Associar por ID DA VARIANTE exato | Você renomeou os arquivos com os IDs de variante da Shopify. 100% inequívoco. |
| Associar se a imagem contém o ID DA VARIANTE | Arquivos como photo-44436602683565.webp. |
Associação com IA (beta)
Associar SKU / CÓDIGO DE BARRAS / TÍTULO / METACAMPO com IA lê cada nome de arquivo como uma pessoa leria, então separadores diferentes, palavras extras, nomes de cores ou números de imagem não impedem uma correspondência. Ela compara os nomes brutos, sem regras de limpeza.
- Nomes óbvios são associados na hora; o restante é avaliado em lotes na página de resultados, com um indicador de progresso.
- Cada associação com IA mostra um nível de confiança, e sugestões com pouca confiança ficam sem associação.
- Você revisa cada associação antes do envio, como nos demais tipos.
- Lojas no plano gratuito podem avaliar até 1.000 imagens por dia (5.000 por mês) com IA; os planos pagos não têm limite.
Identificadores duplicados
Se duas variantes compartilham o mesmo SKU, código de barras ou título, só a primeira fica com a imagem por padrão. Esse é o motivo mais comum de alguns produtos receberem imagens e outros não. Títulos de produto, em especial, costumam se repetir. Se o seu catálogo compartilha identificadores de propósito, peça para ativarmos a associação com várias variantes ou vários produtos.
Todos os status de produto (ativo, rascunho e arquivado) são incluídos, a menos que excluamos os arquivados para a sua loja.
Opções que podemos ativar para a sua loja
Elas não estão nas configurações do app. Fale conosco e nós as ativamos:
- Ler as subpastas da pasta selecionada.
- Associação com várias variantes / produtos para identificadores compartilhados.
- Vincular a mesma imagem a várias variantes de um produto.
- Associar cada imagem uma única vez.
- Vincular a todos os identificadores correspondentes em vez de só ao mais longo.
- Substituir só as imagens da variante associada em vez das do produto inteiro.
- Excluir produtos arquivados ou filtrar por coleção ou fornecedor.
- Regras de limpeza de identificadores: remover os últimos N caracteres, ignorar o texto depois de um hífen, substituir caracteres.
- Formatos de texto alt: só o valor da opção, metacampo + título, sufixo personalizado.
- Normalização Unicode para títulos com acentos.