Mercado
SPREEAI para desarrolladores
Construye el probador
en cada pantalla.
Connect your catalogue. Shape the customer journey. Bring Always On into your storefront with the integration path that fits your team.
Elige tu camino
Empieza donde tu
El commerce stack vive.
Use Shopify for a managed setup, or integrate with our SDKs and APIs. Choose the features your business needs and keep your brand’s shopping journey.
En vivoPróximamente
Camino más rápido
Aplicación de Shopify
Nuestra tecnología está disponible a través de nuestra asociación Shopify. Instalar la aplicación, conectar su catálogo y formar la experiencia para su tienda.Mejor para Shopify Storefronts SDK webWeb 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 + Tipo de escritorio DocumentosMóvil nativo
SDK de iOS
Integra la experiencia SPREEAI en un proceso de compra de iOS existente.Guía abierta DocumentosMóvil nativo
SDK de Android
Integra la prueba virtual en una experiencia de producto para Android con controles nativos.Guía de Android abierto 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.Open API de referenciaGuía de inicio rápido del SDK web
Su primera integración.
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.
Un camino centrado para lanzar
Prepararse. Conectar con
Vive con confianza.
Tres milas, con una lista de control práctica para cada uno.
- 01 - Preparación
Un punto de partida claro.
Alinear el viaje, el acceso y el catálogo.
Preparación de la lista de control
- Seleccione un canal, grupo de catálogo y medida de éxito.
- Confirmar el acceso de los socios, las credenciales y las permisiones de escaneamiento.
- Proporcionar una imagen de vestido limpia y alineada con SKU.
- 02 - Conectar
Que se sienta nativo.
Construido en estacionamiento. Probar todo el viaje.
Lista de control de integración
- Render para productos elegibles y conectar variantes y comportamiento de la cesta.
- Compara la experiencia con la marca.
- Verificar los estados móviles, de escritorio, accesibilidad, rendimiento y fracaso.
- 03 El lanzamiento
Aprende de uso real.
Permite productos y medidas preparados.
Inicio Checklist
- Confirmar la disponibilidad del producto y publicar la experiencia de etapa.
- Monitorización de la adopción, la realización y la conversión.
- Utilice los resultados para guiar la siguiente categoría o viaje.
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.
SPREEAI Guía ProducciónControl de calidad y lanzamiento
Usa la lista de comprobación compartida de navegador, rendimiento, accesibilidad y lanzamiento.
SPREEAI Guía SoporteSolución de problemas
Resuelve los problemas más comunes de autenticación, elegibilidad, representación y rendimiento.
SPREEAI Guía 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.
Documentación abiertaNo 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?