Identificadores de produto e variants#
O target da storefront deve identificar o mesmo produto que o catálogo do merchant. A maioria das falhas de integração começa com uma incompatibilidade entre esses dois valores.
Escolha um identificador estável#
Use o productCode exibido para o produto preparado. No tutorial do Shopify, este é o variant SKU. Os campos de request da Product Import API são definidos na Referência de importação; não substitua esses nomes de campo por nomes de atributos da storefront.
Mantenha os identificadores idênticos, incluindo maiúsculas e minúsculas. Não os gere a partir de nomes de exibição mutáveis nem presuma que um ID de produto interno da plataforma é igual a um SKU.
Mapeie a variant selecionada#
| Estado da storefront | Comportamento do target |
|---|---|
| Uma variant preparada está selecionada | Defina seu productCode exato |
| A seleção muda | Atualize o target e limpe o estado do SDK obsoleto usando seu guia de integração |
| Nenhum SKU ou produto correspondente existe | Mantenha o botão criado oculto ou desabilitado |
| Um card de produto aponta para uma variant padrão | Use o identificador dessa variant de forma consistente |
Para Shopify, conecte o helper de sincronização do tutorial ao callback real de mudança de variant do seu theme. Para outras storefronts, siga páginas dinâmicas.
Valide o mapeamento#
Escolha duas variants com produtos visivelmente diferentes. Registre seus códigos de catálogo, inspecione cada data-product-code renderizado nas ferramentas de desenvolvedor do navegador e, em seguida, abra o Viewer para cada um. Repita após navegar sem recarregar a página completamente.
Quando um identificador mudar no seu sistema de origem, coordene a importação do catálogo e o release da storefront. Uma resposta de importação HTTP bem-sucedida é apenas aceitação; inspecione o Status da tarefa e as falhas dos itens antes de confiar no novo código.