Mercado
SPREEAI para desarrolladores
Construye el probador
en cada pantalla.
Empieza con Shopify, el SDK web o una integración de API aprobada. Este centro lleva a tu equipo desde la primera decisión hasta un lanzamiento probado.
- 04
- rutas de integración
- v2.1
- SDK web actual
- 01
- lista de verificación de lanzamiento
Elige tu camino
Empieza donde tu
El commerce stack vive.
Elige la ruta más rápida que se adapte a tu tienda. Puedes pasar de una aplicación administrada a un SDK personalizado o una integración de API a medida que la experiencia crezca.
En vivoPróximamente
Camino más rápido
Aplicación de Shopify
Instalar, sincronizar prendas, personalizar y lanzar sin un backend personalizado.Lo mejor para tiendas Shopify ↗ v2.1.0Web personalizada
SDK web
Controla la ubicación, el estilo, los eventos, el tamaño y el comportamiento del botón de agregar al carrito.JavaScript + TypeScript ↗ DocumentosMóvil nativo
SDK de iOS
Integra la experiencia SPREEAI en un proceso de compra de iOS existente.Abrir la guía de iOS ↗ DocumentosMóvil nativo
SDK de Android
Integra la prueba virtual en una experiencia de producto para Android con controles nativos.Abrir la guía de Android ↗ Acceso de sociosSistemas personalizados
API públicas
Utilice la referencia de API aprobada para flujos de trabajo del lado del servidor y de catálogo.Referencia de la API abierta ↗Guía de inicio rápido del SDK web
Desde la instalación hasta
botón funcional.
Autentica una vez y luego muestra la prueba virtual o el tallaje en cualquier parte de la página. Utiliza las credenciales de prueba proporcionadas durante la incorporación y nunca pongas un secreto de cliente en el código del navegador.
npm install @spreeai/web-sdk
# o
yarn add @spreeai/web-sdkimport { init } from "@spreeai/web-sdk";
const sdk = await init({
clientId: "tu-id-de-cliente",
partnerId: "tu-id-de-socio",
});
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "tu-id-de-prenda" }],
enableAddToCart: true,
});
}events: {
onTryOnButtonClick: (event) => {
analytics.track("try_on_started", event);
},
onAddToCartClicked: async (event) => {
// Conéctate a tu flujo de carrito existente.
},
}El modelo de integración
Cuatro sistemas.
Un momento de cliente.
IDs de productos, variantes, imágenes y contexto de merchandising.
Las prendas pasan por los estados de procesamiento, revisión y preparación.
Tu escaparate solicita la experiencia para un producto elegible.
Pruébatelo, encuentra una talla, completa el look y vuelve a la caja.
Ruta de producción
Toma la integración
al otro lado de la línea de meta.
Un lanzamiento limpio es más que un botón que funciona. Utilice esta secuencia para alinear el acceso, los recursos, el comportamiento, la calidad y la medición.
- 01Propietario · Producto + comercio
Delimitar el primer recorrido
Elija un canal, un grupo de catálogo, un momento del cliente y una medida de éxito.
- 02Propietario · Ingeniería
Preparar el acceso
Confirme el ID de socio, las credenciales de cliente aprobadas, los permisos de la tienda y el entorno de pruebas.
- 03Propietario · Equipo de catálogo
Enviar recursos limpios
Proporcione una prenda por imagen, se requiere vista frontal, alta resolución, iluminación limpia y nombres de archivo alineados con el SKU.
- 04Propietario · Front-end
Integrar en staging
Mostrar solo en productos elegibles, conectar las variantes con el comportamiento del carrito y adaptar el punto de entrada a la marca.
- 05Propietario · Control de calidad + marca
Ejecutar control de calidad de lanzamiento
Probar dispositivos móviles y de escritorio, cobertura de navegadores, accesibilidad, rendimiento, fidelidad visual y estados de fallo.
- 06Propietario · Comercio + análisis
Habilitar y medir
Activa los productos listos, publica la experiencia en fase de pruebas y monitoriza la adopción, la finalización y la conversión.
Línea base de activos
Una buena entrada produce un mejor resultado.
- JPEG o PNG
- 2,000 × 2,000 px mínimo
- Se requiere vista frontal
- Vista posterior recomendada
- Iluminación uniforme y neutra
- SKU o ID de estilo en el nombre del archivo
Referencia del desarrollador
Encontrar el siguiente
respuesta útil.
Comienza aquí
Primeros pasos
Comprenda el acceso, las plataformas compatibles y las primeras decisiones que su equipo debe tomar.
Referencia oficial ↗ Integración gestionadaIncorporación a Shopify
Instala la aplicación, acepta los acuerdos, sincroniza las prendas, personaliza el botón y transmite en vivo.
Referencia oficial ↗ SDK websuperficie de API
Revisar la inicialización, las opciones de renderizado, el dimensionamiento, la personalización y las interfaces tipadas.
Referencia oficial ↗ API de sociosReferencia de la API pública
Explore la interfaz del lado del servidor aprobada disponible para socios autenticados.
Referencia de Swagger ↗ CalidadActivos de indumentaria
Prepara imágenes y metadatos de productos que fluyan limpiamente a través de la ingesta y la revisión.
Guía de SPREEAI ↗ ProducciónControl de calidad y lanzamiento
Usa la lista de comprobación compartida de navegador, rendimiento, accesibilidad y lanzamiento.
Guía de SPREEAI ↗ SoporteSolución de problemas
Resuelve los problemas más comunes de autenticación, elegibilidad, representación y rendimiento.
Guía de SPREEAI ↗ DocumentaciónGuías de implementación
Explora guías de inicio rápido públicas, estándares de activos, listas de verificación de lanzamiento y guías de solución de problemas.
Abrir documentación ↗No se encontraron recursos de desarrollador que coincidan. Pruebe con “Shopify”, “SDK”, “assets” o “QA”.”
Compilar para producción
Los detalles que protegen
la experiencia del cliente.
Seguridad
Mantén los secretos en el servidor, utiliza únicamente los entornos proporcionados y rota las credenciales a través del flujo de trabajo de socios.
Privacidad
Solicite imágenes de clientes con consentimiento explícito y alinee el tratamiento de datos con su plan de integración aprobado.
Rendimiento
Carga la experiencia donde sea necesario, prueba dispositivos reales y monitoriza las regresiones de la página de producto.
Accesibilidad
Preserva el acceso por teclado, el orden del foco, los nombres accesibles y una ruta utilizable cuando la experiencia no esté disponible.
Preguntas frecuentes para desarrolladores
Preguntas antes
el primer commit.
¿Qué integración debemos elegir?
Utiliza la aplicación de Shopify para obtener la vía gestionada más rápida, el SDK web para ubicaciones web personalizadas o sin cabeza (*headless*), los SDK nativos para experiencias de aplicaciones y la referencia de API aprobada para flujos de trabajo del lado del servidor acordados durante la incorporación.
¿De dónde provienen las credenciales?
SPREEAI emite el ID de socio y las credenciales aprobadas durante la incorporación. El SDK del navegador utiliza un ID de cliente y un ID de socio. Nunca incrustes un secreto de cliente en el código de la interfaz (front-end).
¿Requiere la aplicación de Shopify claves de API?
El flujo de incorporación actual de la aplicación de Shopify conecta la tienda después del paso de los acuerdos requeridos y la suscripción; la aplicación administrada no requiere copiar claves en la pantalla de configuración.
¿Por qué no aparece el botón de prueba?
Confirma que la prenda ha completado el procesamiento, está habilitada para la prueba virtual (Try-On), se asigna al producto o variante activo, y que el bloque de la aplicación o contenedor SDK está presente en la plantilla de producto.
¿Qué eventos de cliente están disponibles?
Las devoluciones de llamada del SDK documentadas cubren los clics en el botón Pruébalo y las interacciones de agregar al carrito. Conéctelas a su capa de análisis sin incluir imágenes de clientes ni datos personales innecesarios.
¿Están disponibles los webhooks de servidor?
Los webhooks de inserción del servidor no forman parte de la documentación del SDK publicada actualmente. Evalúe cualquier requisito de eventos del lado del servidor con Ingeniería de Socios antes de depender de él.
¿Dónde obtienen ayuda los desarrolladores?
Utilice la ruta de soporte técnico proporcionada durante la incorporación o por correo electrónico support@spreeai.com. Incluya el entorno, el ID del producto, el navegador o dispositivo, la marca de tiempo y una ruta de reproducción concisa; nunca envíe secretos.
¿Cuándo estará disponible el soporte de Amazon Partner Network?
La integración de Amazon Partner Network está en desarrollo. Se ha marcado intencionalmente como Próximamente hasta que la interfaz de incorporación y producción esté lista para los desarrolladores externos.
¿Listo para construir?