Integracja z feedem produktowym (XML, Google Merchant)

Połącz dowolny sklep internetowy ze swoim chatbotem ChatLab za pomocą feedu produktowego. Jeśli Twoja platforma nie posiada natywnej integracji z ChatLab, feed jest sposobem na przekazanie chatbotowi Twojego katalogu: odczytuje on produkty z pliku, indeksuje je za pomocą AI Search i odpowiada kartami produktów prowadzącymi do Twojego sklepu.

Ważne: Najlepsze praktyki dla e-commerce

Po zakończeniu poniższej integracji zapoznaj się z kompleksowym przewodnikiem po optymalizacji chatbota pod kątem e-commerce: Jak skonfigurować ChatLab dla Twojego sklepu e-commerce

Co zapewnia integracja

Wyszukiwanie produktów AI - Klienci opisują własnymi słowami to, czego potrzebują, a chatbot znajduje pasujące produkty w Twoim katalogu. Odpowiedź zawiera:

• Nazwę i opis produktu
• Cenę (oraz cenę promocyjną, jeśli znajduje się w feedzie)
• Zdjęcie produktu
• Bezpośredni link do strony produktu w Twoim sklepie
• Markę, dostępność, GTIN / SKU oraz inne atrybuty z feedu

Kategorie - Gdy feed zawiera typ produktu (na przykład "Dom > Kuchnia > Czajniki"), chatbot może zawęzić wyszukiwanie do konkretnej kategorii.

Zaplanowane odświeżanie - Katalog jest odświeżany zgodnie z ustawionym przez Ciebie harmonogramem, dzięki czemu nowe produkty, ceny i dostępność trafiają do chatbota bez Twojej ingerencji.

Czego integracja nie zapewnia

Feed jest plikiem, a nie bezpośrednim połączeniem ze sklepem, dlatego chatbot nie może:

• sprawdzać statusu zamówienia
• dodawać produktów do koszyka ani składać zamówień
• odczytywać stanów magazynowych na żywo pomiędzy odświeżeniami

Karty produktów zawsze odsyłają do Twojego sklepu, gdzie klient finalizuje zakup. Jeśli potrzebujesz śledzenia zamówień lub dodawania do koszyka, skorzystaj z natywnej integracji.

Wymagania

• Integracja Feed XML dostępna w Twoim planie
• Pakiet AI Search product pack (pakiet produktów AI Search) przypisany do chatbota: określa on, ile produktów można zaindeksować
• Feed produktowy w formacie XML Google Merchant (Google Shopping), dostępny pod publicznym adresem https. Obsługiwane są pliki skompresowane (.gz) oraz zabezpieczone loginem i hasłem.

Krok 1: Pobierz feed produktowy ze swojego sklepu

Większość platform umożliwia wyeksportowanie feedu Google Merchant od razu po instalacji lub za pomocą bezpłatnego rozszerzenia:

• Magento / Adobe Commerce - rozszerzenie feedu Google Shopping (na przykład z Magento Marketplace) generuje plik XML pod adresem takim jak https://yourstore.com/feeds/google.xml
• IdoSell - Marketing i integracje, Porównywarki cen i marketplace, Google Merchant: włącz feed i skopiuj jego adres
• OpenCart - Rozszerzenia, Kanały (Feeds), Google Base: włącz go i skopiuj adres URL feedu danych
• BigCommerce - Channel Manager, Google Shopping lub aplikacja do obsługi feedów z BigCommerce App Marketplace
• Shopware - Marketing, Porównania produktów, Google Shopping: utwórz eksport i skopiuj jego adres URL
• osCommerce oraz sklepy dedykowane - dowolny moduł generujący feed RSS 2.0 lub Atom z atrybutami produktów g:

Feed musi zawierać przynajmniej identyfikator produktu (g:id), nazwę oraz link. Cena, zdjęcie, opis, dostępność i typ produktu sprawiają, że odpowiedzi są znacznie lepsze.

Krok 2: Połącz feed w ChatLab

1. Zaloguj się do ChatLab i wybierz swojego bota
2. Przejdź do zakładki Connect (Połącz)
3. Kliknij Connect (Połącz) na kafelku Feed XML
4. Wklej Feed URL (Adres URL feedu)
5. Jeśli feed wymaga logowania, włącz opcję The feed requires a username and password (Feed wymaga nazwy użytkownika i hasła) i wprowadź dane uwierzytelniające
6. Opcjonalnie ustaw Product language (Język produktów - dwuliterowy kod języka używanego w pliku)
7. Kliknij Test feed (Przetestuj feed) - ChatLab pobierze początek feedu i wyświetli format, liczbę znalezionych produktów, pierwsze pozycje w takiej postaci, w jakiej zostaną zaindeksowane, oraz ewentualne ostrzeżenia (brakujące ceny, linki, zdjęcia lub kategorie)
8. Kliknij Connect (Połącz)

Po udanym połączeniu ChatLab rozpocznie indeksowanie katalogu w tle. W zależności od wielkości pliku trwa to od minuty do kilkudziesięciu minut. Postęp możesz śledzić w zakładce Training > E-commerce catalog (Trenowanie > Katalog e-commerce).

Krok 3: Feedy niestandardowe (mapowanie pól)

Jeśli Twój feed nie jest w formacie Google Merchant, ChatLab nadal może go odczytać:

1. Najpierw uruchom Test feed (Przetestuj feed) - nazwy elementów znalezione w Twoim pliku pojawią się na listach wyboru mapowania
2. Otwórz Field mapping for non-standard feeds (Mapowanie pól dla niestandardowych feedów)
3. Jeśli pojedynczy produkt nie jest elementem item ani entry, wpisz nazwę w polu Product element (Element produktu)
4. Wybierz odpowiedni element dla każdego pola: Product identifier (Identyfikator produktu - wymagane), Product name (Nazwa produktu), Description (Opis), Product page URL (Adres URL strony produktu), Image URL (Adres URL zdjęcia), Price (Cena), Category path (Ścieżka kategorii) i pozostałych
5. Uruchom ponownie Test feed (Przetestuj feed) i sprawdź przykładowe produkty
6. Kliknij Connect (Połącz)

Pola pozostawione z wartością "Default (Google Merchant)" zachowują standardowe nazwy, więc plik zgodny ze standardem w ogóle nie wymaga mapowania.

Krok 4: Harmonogram odświeżania

1. Przejdź do Training > E-commerce catalog (Trenowanie > Katalog e-commerce)
2. Na karcie Feed XML kliknij Retrain (Trenuj ponownie)
3. Przycisk Retrain now! (Trenuj teraz!) natychmiast odświeża katalog
4. Aby odświeżać automatycznie, wybierz częstotliwość (codziennie, raz w tygodniu lub raz w miesiącu), dzień oraz godzinę i kliknij Schedule retrain (Zaplanuj ponowne trenowanie)

Indeksowane na nowo są tylko te produkty, które zmieniły się od ostatniego odświeżenia, a produkty usunięte z feedu znikają z katalogu chatbota. Zaplanowane odświeżanie zależy od Twojego planu: harmonogramy tygodniowe i miesięczne wymagają funkcji zaplanowanego ponownego trenowania, a harmonogramy codzienne wymagają funkcji codziennego ponownego trenowania.

Krok 5: Skonfiguruj akcję AI

Po połączeniu akcja Feed XML - AI product search jest włączana automatycznie dla chatbotów z produktem AI Search. Aby ją dostosować, przejdź do Settings > Actions (Ustawienia > Akcje) i przefiltruj listę według platformy Feed XML. Możesz zmienić etykietę akcji, instrukcje kierujące sztuczną inteligencją oraz włączyć opcję Include product card (Dołącz kartę produktu), aby przekazywać chatbotowi pełną kartę produktu zamiast krótkiego opisu.

Testowanie integracji

Otwórz widget swojego chatbota i wypróbuj polecenia:

• "Pokaż mi czajniki poniżej 200 zł" (testuje wyszukiwanie z filtrem ceny)
• "Czy macie niebieskie koszulki bawełniane?" (testuje dopasowywanie atrybutów)

W odpowiedziach powinny pojawić się produkty z Twojego feedu wraz z linkami do Twojego sklepu.

Wskazówki

• Umieszczaj typ produktu w feedzie (g:product_type) jako pełną ścieżkę, na przykład "Odzież > Męska > Koszulki" - stanie się ona kategorią, według której chatbot może filtrować
• Zadbaj o kompletność opisów w pliku; chatbot wykorzystuje je do dopasowywania pytań klientów
• Warianty jednego produktu powinny mieć wspólny identyfikator item_group_id - ChatLab wyświetli je wtedy jako jeden produkt ze wszystkimi kolorami i rozmiarami
• Jeśli Twój plik jest duży, skompresowany feed (.gz) pobierze się szybciej

Instalacja chatbota w Twoim sklepie

Aby dodać widget czatu na stronie sklepu:

1. W ChatLab przejdź do zakładki Deploy (Wdróż) dla swojego bota
2. Skopiuj fragment kodu
3. Wklej go do szablonu swojego sklepu przed zamykającym tagiem </body> lub użyj wbudowanego w platformę ustawienia typu "własny kod HTML" lub "skrypty"