Zbuduj z
SPREEAI.

Aplikacja Shopify

Użyj aplikacji zarządzanej, gdy sklep działa na Shopify i nie wymaga niestandardowego zaplecza. Obecny proces wdrażania łączy sklep po zawarciu umów i subskrypcji; nie wymaga kopiowania kluczy API do ekranu konfiguracji.

1. Zainstaluj oficjalną aplikację SPREEAI i wypełnij formularz zarządzany w celu uzyskania zgody.
2. Zsynchronizuj początkową grupę katalogów i przejrzyj stany gotowości produktów.
3. Dostosuj rozmieszczenie i styl w zduplikowanym motywie.
4. Sprawdź kwalifikujące się produkty, warianty, zachowanie na urządzeniach mobilnych i dodawanie do koszyka.
5. Opublikuj dopiero po zatwierdzeniu przez markę i kontrolę jakości.

Otwórz oficjalny przewodnik wprowadzający Shopify

Szybki start dla zestawu SDK sieci Web

Używać @spreeai/web-sdk do niestandardowego rozmieszczenia, stylizacji, zdarzeń, rozmiarów i zachowania koszyka.

npm install @spreeai/web-sdk@3.0.0

import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";

// Add <div id="spreeai-try-on"></div> to the product page first.
const sdk = await init({ clientId: "your-client-id" });

if (sdk) {
  await sdk.renderTryOnButton({
    elementId: "spreeai-try-on",
    garments: [{ garmentId: "your-garment-id" }],
    enableAddToCart: true,
  });
}

Zainicjuj raz, renderuj tylko dla kwalifikującego się produktu i połącz udokumentowane wywołania zwrotne klienta z istniejącą analityką. Potwierdź bieżący interfejs w oficjalna referencja API Web SDK

Dostęp do API

Publiczne referencje Swaggera należy stosować wyłącznie w przypadku przepływów pracy po stronie serwera zatwierdzonych podczas wdrażania. Zachowaj poufne informacje na serwerze, oddziel dostęp do testów i produkcji oraz ogranicz zakres poświadczeń do minimalnego wymaganego środowiska.

Bezpośrednie punkty końcowe REST, webhooki lub zachowania uwierzytelniania nieobecne w zatwierdzonym odniesieniu publicznym należy traktować jako niedostępne do momentu ich potwierdzenia przez Partner Engineering.

Otwórz zatwierdzony publiczny odnośnik do interfejsu API

Bazowa wartość aktywów odzieżowych

• JPEG lub PNG; minimalna rozdzielczość 2000 × 2000 px, preferowana rozdzielczość około 4K.
• Jeden element garderoby na zdjęcie, wyśrodkowany, z wyraźnymi krawędziami i neutralnym, równomiernym oświetleniem.
• Wymagany jest widok z przodu. Zalecany jest widok z tyłu, gdy ta opcja jest włączona.
• Stały numer SKU, styl lub identyfikator odzieży zawarty w nazwie pliku i rekordzie katalogowym.
• Brak rąk, wieszaków, rekwizytów do stylizacji, znaków wodnych lub niepowiązanych ze sobą elementów garderoby, które mogłyby zasłaniać przedmiot.
• Przed włączeniem funkcji sprawdzono mapowanie wariantów.

Kontrola jakości i uruchomienie

• Przetestuj całą ścieżkę klienta w bieżących przeglądarkach mobilnych i stacjonarnych.
• Sprawdź mapowanie produktów i wariantów, gotowość odzieży i zachowanie koszyka.
• Sprawdź dostęp do klawiatury, kolejność zaznaczania, dostępne nazwy i zachowanie awaryjne.
• Zmierz wydajność strony produktu przed i po włączeniu SPREEAI.
• Stany ładowania, puste, niedostępne, przekroczenia limitu czasu i ponownej próby.
• Potwierdź treść zgody i zatwierdzone przetwarzanie zdjęć klienta.
• Przed rozpoczęciem produkcji uzyskaj akceptację inżynieryjną, handlową, zapewnienia jakości i marki.

Rozwiązywanie problemów

Przycisk się nie pojawia

Potwierdź inicjalizację SDK, identyfikator klienta, identyfikator elementu hosta, kwalifikowalność produktu, gotowość odzieży i mapowanie wariantów. Następnie sprawdź błędy konsoli przeglądarki i sieci bez udostępniania tokenów.

Wyświetla się niewłaściwy produkt lub wariant

Porównaj identyfikatory produktów i wariantów w sklepie z rekordami wysłanymi do SPREEAI. Sprawdź, czy wygenerowane żądanie zmienia się, gdy kupujący zmienia warianty.

Doświadczenie jest powolne lub niedostępne

Przetestuj znany, gotowy produkt, zweryfikuj aktywne środowisko, zbadaj zablokowane żądania i porównaj czystą sesję przeglądarki. Zarejestruj znacznik czasu i powtarzalną sekwencję dla wsparcia technicznego.

Uzyskaj wsparcie programisty

E-mail support@spreeai.com z identyfikatorem środowiska, produktu lub odzieży, przeglądarką lub urządzeniem, przybliżonym znacznikiem czasu, oczekiwanym zachowaniem i krokami odtwarzania. Nie należy uwzględniać sekretów ani zdjęć klientów.