Utiliser le bon identifiant
Un identifiant de produit, un SKU ou un identifiant de variante en vitrine n'est pas automatiquement un identifiant de vêtement SPREEAI. Conservez un mappage créé via votre flux de travail d'ingestion ou de synchronisation Shopify. Le vêtement doit appartenir au partenaire authentifié et être disponible pour l'essayage.
Cartographier une sélection de produits
import type { RenderTryOnButtonOptions } from "@spreeai/web-sdk";
export const productOptions: RenderTryOnButtonOptions = {
elementId: "spreeai-try-on",
garments: [{
garmentId: "SPREEAI_GARMENT_ID",
variant: { color: "blue", fit: "regular" },
availableSizes: ["S", "M", "L"],
price: "$59.00",
}],
showSizes: true,
showPrices: true,
};variant peut filtrer la couleur, la coupe, le sexe et le style. La correspondance documentée ne respecte pas la casse. Faites correspondre la couleur par son nom, par exemple blue, plutôt que par une valeur hexadécimale.
Préparation du vêtement
| État ou condition | Action d'intégration |
|---|---|
| Non synchronisé/ingestion incomplète | Conservez l'expérience normale du produit ; ne promettez pas de disponibilité d’essai. |
| Prêt mais désactivé dans Shopify | Vérifiez et activez explicitement le produit prévu. Prêt seul ne le fait pas vivre. |
| Vêtement disponible et variante assortie | Afficher le bouton pour cette sélection. |
| Aucune tenue disponible correspondante | Attendez-vous à un retour au premier vêtement du tableau. |
| La validation échoue | Aucun bouton n'est rendu ; étudiez la console et le mappage du produit. |
Maintenir les données produit à jour
- Mettez à jour le prix affiché et les tailles en stock lorsque la sélection de produits change.
- Utilisez des ID de conteneur uniques pour les boutons de produits distincts.
- Lors du rendu d'un bouton, transmettez la sélection actuelle de vêtement et de variante.
- Examinez les données du panier renvoyées par rapport à votre propre catalogue avant de créer une mutation de panier.
Préparer les actifs vestimentaires
Utiliser le courant normes d'image des vêtements pour les images et les métadonnées prises en charge. Résoudre les problèmes de traitement avant d'activer les produits ; ne remplacez pas les identifiants de vêtements par des espaces réservés pour les données de production.