Headless commerce · import commercetools

commercetools jako headlessowe źródło produktów dla Photopilot

Import produktów, wariantów i cech z projektu commercetools.

Wczytywanie + eksport przez API lub FTP
Eksport przez FTP, Excel lub API

Umów demo Wypróbuj samodzielnie

Zgodność z RODO, dane w UE
SLA i stała osoba kontaktowa
Łączy się z Shopware, Shopify i Twoim ERP
13 sprzedawców i marek w produkcji

commercetools

Tak wygląda ścieżka

Tworzysz klienta API w commercetools.
Photopilot odczytuje produkty z SKU, key i cechami.
Obrazy i teksty trafiają do właściwych produktów i wariantów.
Dane wyjściowe trafiają przez FTP, Webshop-Excel lub API do Twojej warstwy publikacji.

Zobacz, co przychodzi i pasuje Konflikty pozostają widoczne dla Twojego zespołu.

Wyjaśnienie

Tak Photopilot współpracuje z commercetools

W środowisku commercetools treści produktowe są rozproszone między product types, wariantami, assets oraz dodatkowym ERP lub DAM. Photopilot odczytuje opublikowane produkty z Twojego projektu i przejmuje pracę nad zdjęciami oraz tekstami dla każdego wariantu. Wynik jest dostępny jako uporządkowana, przewidywalna dostawa dla serwisów, które zasilają Twój projekt.

Co Photopilot pobiera z Twojego projektu commercetools

Photopilot odczytuje dane przez product projections Twojego projektu, czyli dokładnie to, co zostało opublikowane. Dla każdego produktu pobierane są key, nazwa i opis w każdym języku, a także master variant oraz warianty z SKU i atrybutami takimi jak EAN, kolor i materiał. Istniejące images i assets traktujemy jako punkt wyjścia. Każda runda filtruje po lastModifiedAt, więc pobierane są tylko zmienione produkty.

Warianty, kolory i typy produktów

Ponieważ commercetools zwykle zapisuje kolor i rozmiar jako atrybuty wariantu w product type, Photopilot dopasowuje zdjęcia po SKU, product key i EAN. Kod koloru z Twoich atrybutów wykorzystujemy do grupowania zdjęć według koloru, tak aby każdy kolor miał własny zestaw, a rozmiary współdzieliły te same zdjęcia. Jeśli używasz wielu product types, na przykład dla odzieży, obuwia i akcesoriów, każdy typ otrzymuje własne reguły zdjęć. Dzięki temu integracja pozostaje poprawna także wtedy, gdy model danych później się rozrośnie.

Co tworzy Photopilot

Zdjęcia dostawców i zdjęcia studyjne automatycznie otrzymują właściwe tło, kadr i proporcje dla Twoich ujęć przodu. Gdy brakuje zdjęć, Photopilot tworzy zdjęcia z efektem niewidzialnego manekina, zdjęcia z modelem AI albo — z Iris jako AI creative director — kompletne zdjęcia kampanijne. Materiały i symbole prania są rozpoznawane i stanowią podstawę tekstów produktowych oraz tekstów SEO w każdym języku używanym w Twoim projekcie. Zespół contentowy zatwierdza wszystko przed publikacją.

Dostawa do Twojego composable stack

Zatwierdzone zdjęcia i teksty Twoja warstwa integracyjna pobiera przez Photopilot-API albo są one dostępne na FTP/SFTP lub w Webshop-Excel. Dla każdego wariantu zdjęcia są dostarczane w stałej kolejności, z tekstami alt i zlokalizowanymi tekstami, które od razu pasują do pól LocalizedString. Następnie Twój własny serwis zapisuje je jako images lub assets w commercetools albo w DAM. Dzięki temu jedno miejsce pozostaje właścicielem tego, co jest zapisywane w projekcie.

Co zespół widzi na co dzień

Dla każdego wariantu Photopilot pokazuje, czy jest wystarczająco dużo obrazów, które teksty nadal czekają na zatwierdzenie i co zostało już dostarczone. Nowe produkty z projektu automatycznie pojawiają się na liście zadań, więc nikt nie musi ręcznie śledzić, co doszło. Dzięki autopilotowi powtarzalne kroki, takie jak wycinanie z tła i kadrowanie, mogą przebiegać bez ręcznej pracy. Raporty pokazują dla każdej marki lub kategorii, jak kompletny jest content.

Konfiguracja w kilku krokach

Utwórz w Merchant Center klienta API z uprawnieniami do odczytu produktów i udostępnij project key, API- i auth-URL oraz client-ID i secret. Następnie wspólnie ustalamy, które atrybuty zawierają EAN, kolor i materiał oraz jak Twoja warstwa integracji pobiera output. Pierwszą rundę uruchamiamy na Twoim własnym projekcie, żeby mapowanie od razu było poprawne. Nie jest do tego potrzebny proces developmentowy.

commercetools w skrócie

Jakie dane są wymieniane: Z Twojego projektu commercetools Photopilot odczytuje produkty z ich wariantami, SKU, key i cechami. Photopilot nie zapisuje danych w commercetools.
Jak często: Domyślnie co dwie godziny. Photopilot pobiera tylko produkty, które zmieniły się w projekcie od poprzedniego cyklu.
Co dostarczasz: Project key oraz klient API z client-ID, secret i uprawnieniami do odczytu produktów.
Warto wiedzieć: Integracja jest oparta na oficjalnym commercetools-API. Najpierw testujemy ją wspólnie w Twoim projekcie.

Następnie w Photopilot

Połączone niezawodnie

Wykorzystaj dane źródłowe aż do gotowych do sprzedaży stron produktów

300.000+ przetworzone artykuły

9,5M+ zdjęcia od dostawców zindeksowane

~3.200 zdjęć dziennie edytowanych automatycznie

FAQ

Najczęstsze pytania

Jak połączyć commercetools z Photopilot?

Utwórz w Merchant Center klienta API z uprawnieniami do odczytu produktów i udostępnij project key, API-URL, auth-URL, client-ID oraz secret. Następnie Photopilot odczyta opublikowane produkty i uruchomi pierwszą rundę dla Twojego projektu.

Czy Photopilot odczytuje z commercetools produkty opublikowane czy staged?

Photopilot odczytuje opublikowane product projections. Dzięki temu pracujesz na danych widocznych także na froncie, a nie na niepełnych zmianach, które nadal są w staged.

Czy Photopilot obsługuje warianty i atrybuty kolorów w commercetools?

Tak. Photopilot odczytuje master variant oraz warianty z SKU i atrybutami, a następnie grupuje zdjęcia według koloru. Dzięki temu rozmiary w tym samym kolorze korzystają z jednego zestawu zdjęć.

Jak zdjęcia z Photopilot trafiają do commercetools?

Twoja warstwa integracji pobiera zatwierdzone obrazy i teksty przez Photopilot-API albo z FTP/SFTP i dodaje je jako images lub assets do właściwego wariantu. Nazwy plików i kolejność są stałe dla każdego wariantu, więc przetwarzanie pozostaje przewidywalne.

Czy Photopilot tworzy opisy produktów w wielu językach dla commercetools?

Tak, dla każdego języka używanego w Twoim projekcie Photopilot tworzy opisy produktów, teksty SEO i teksty alt. Są dostarczane per locale, aby pasowały bezpośrednio do pól z lokalizacją.

Czy nasz zespół developerski musi coś zbudować dla Photopilot i commercetools?

Do wczytania nie: wystarczy API-client z uprawnieniami odczytu. Do odesłania danych Twój istniejący import lub usługa integracyjna korzysta z dostawy z Photopilot, co zwykle oznacza drobną zmianę w kroku, który już masz.

Czy mogę zatwierdzić content, zanim trafi do commercetools?

Tak. Zdjęcia i teksty najpierw trafiają do oceny w Photopilot i są dodawane do dostawy dopiero po zatwierdzeniu. Przy każdym wariancie widzisz, co jest nowe lub zmienione.

Co, jeśli produkt commercetools nie ma jeszcze zdjęć?

Wtedy pojawia się w zestawieniu brakujących zdjęć. Na podstawie prostego zdjęcia produktu Photopilot może zrobić zdjęcia z modelem AI, efekt niewidzialnego manekina albo packshot, które potem samodzielnie zatwierdzasz.

Jak często Photopilot synchronizuje się z commercetools?

Domyślnie co dwie godziny, z filtrowaniem po lastModifiedAt, czyli tylko dla zmienionych produktów. Dzięki temu nawet duże katalogi pozostają lekkie w utrzymaniu.

Jak często Photopilot odczytuje dane z commercetools?

Domyślnie co dwie godziny, tylko z produktami zmienionymi w projekcie.

Czego Photopilot potrzebuje, aby połączyć commercetools?

Project key oraz klient API z client-ID, secret i uprawnieniami do odczytu produktów.

Dokąd trafiają wyniki z Photopilot?

Przez FTP/SFTP, Webshop-Excel lub API do Twojego ERP, DAM albo warstwy publikacji. Photopilot nie zapisuje danych bezpośrednio z powrotem w commercetools.

Baza wiedzy

Przeczytaj też

Tak zaczynasz

Najpierw ścieżka testowa, potem technika

Integracja to punkt wyjścia. Potem Photopilot łączy w jednym procesie przypisywanie, obróbkę, pisanie, kontrolę i publikację.