Last Updated yesterday
Konfiguracja i obsługa modułu PShow AI Feed
Konfiguracja i obsługa modułu PShow AI Feed
Moduł wysyła produkty sklepu do OpenAI, aby ChatGPT mógł polecać je kupującym, także w reklamach. Produkty trafiają do OpenAI jako plik, który moduł wysyła na serwer SFTP Twojego konta reklamowego w OpenAI. Taki plik to w module katalog. Każdy katalog ma własne kraje, język i walutę, więc możesz przygotować np. jeden katalog z cenami w złotych, a drugi w euro. Poniżej opisana jest cała konfiguracja: konto w OpenAI, ustawienia modułu, pierwsza wysyłka, wysyłka automatyczna i sprawdzanie wyników.Etap 1. Konto reklamowe i klucz API w OpenAI
Do wysyłki potrzebne jest konto reklamowe w OpenAI. Klucz API pozwala modułowi samodzielnie założyć feed produktów i dostęp SFTP oraz sprawdzać, jak OpenAI przetworzyło każdy wysłany plik.Krok 1. Zaloguj się w Ads Manager na stronie
ads.openai.com albo załóż tam konto reklamowe. Krok 2. Przejdź do strony ustawień Ads Manager (
ads.openai.com/settings) i utwórz klucz API reklamodawcy (Advertiser API key). Skopiuj klucz, wpiszesz go w module w etapie 3. Uwaga. Konto reklamowe musi mieć dostęp do feedów produktowych. Jeżeli moduł pokaże komunikat Konto reklamowe OpenAI nie ma jeszcze dostępu do feedów produktowych, skontaktuj się z opiekunem konta w OpenAI. Jeżeli nie chcesz korzystać z klucza API, możesz wpisać dane SFTP otrzymane od OpenAI ręcznie (etap 5, wariant B).
Etap 2. Dane sklepu wysyłane z każdym produktem
Te dane są wspólne dla wszystkich katalogów i trafiają do OpenAI razem z każdym produktem.Krok 1. W menu panelu wybierz PrestaShow Modules > PShow AI Feed. Otworzy się lista Katalogi wysyłane do OpenAI, a pod nią panel Dane sklepu wysyłane z każdym produktem.
Krok 2. (Opcjonalnie) W polu Nazwa sprzedawcy wpisz nazwę sklepu, którą zobaczą użytkownicy ChatGPT. Pozostaw puste, aby użyć nazwy sklepu.
Krok 3. (Opcjonalnie) W polu Strona sprzedawcy wpisz adres strony głównej sklepu. Pozostaw puste, aby użyć adresu sklepu.
Krok 4. W polu Strona z zasadami zwrotów wybierz stronę CMS z zasadami zwrotów. OpenAI wymaga jej adresu dla każdego produktu. Jeżeli w sklepie nie ma jeszcze takiej strony, utwórz ją:
- PrestaShop 1.7, 8 i 9: Wygląd > Strony,
- PrestaShop 1.6: Preferencje > CMS.
Krok 5. (Opcjonalnie) W polu Kraj sklepu wybierz kraj, w którym działa sklep. Domyślnie moduł używa domyślnego kraju sklepu.
Krok 6. W polu Opis produktu wybierz, który opis ma trafić do OpenAI: Opis albo Podsumowanie (krótki opis). Gdy wybrany opis jest pusty, moduł wyśle drugi.
Krok 7. (Opcjonalnie) W polu Rozmiar zdjęć wybierz rozmiar zdjęć produktów. Domyślnie moduł wybiera duży rozmiar.
Krok 8. Kliknij Zapisz pod panelem.
Uwaga. Dopóki nie wybierzesz strony z zasadami zwrotów, nad listą katalogów widać ostrzeżenie Nie wybrano strony z zasadami zwrotów. Pozostałe ustawienia możesz zapisać, ale katalogi nie zostaną wysłane do OpenAI.
Etap 3. Klucz API w module
Pomiń ten etap, jeżeli wpiszesz dane SFTP ręcznie (etap 5, wariant B).Krok 1. Pod panelem danych sklepu znajduje się panel Połączenie z API reklam OpenAI. W polu Klucz API reklamodawcy (Advertiser API key) wklej klucz skopiowany w etapie 1.
Krok 2. Kliknij Zapisz pod panelem. Klucz jest przechowywany w postaci zaszyfrowanej. Po zapisaniu pole jest puste, a pod nim widać informację Klucz jest zapisany. Pozostaw pole puste, aby go nie zmieniać.
Uwaga. Aby usunąć zapisany klucz, ustaw przełącznik Usuń zapisany klucz API na Tak i kliknij Zapisz.
Etap 4. Dodanie katalogu
Katalog określa, które produkty, w jakim języku i w jakiej walucie trafią do OpenAI oraz w jakich krajach będą widoczne. W poniższym przykładzie zostanie dodany katalog dla Polski z cenami w złotych.Krok 1. Kliknij ikonę + (Dodaj katalog) w nagłówku listy Katalogi wysyłane do OpenAI.
Krok 2. W panelu Katalog w polu Nazwa wpisz nazwę, po której rozpoznasz katalog. W tym przykładzie wpisz
Polska PLN. Jeżeli feed zostanie założony kluczem API (etap 5, wariant A), feed w OpenAI otrzyma tę samą nazwę. Krok 3. Upewnij się, że przełącznik Aktywny jest ustawiony na Tak. Automatyczna wysyłka (etap 7) obejmuje tylko aktywne katalogi.
Krok 4. W polu Kraj główny wybierz kraj, którego użytkownicy ChatGPT zobaczą produkty. Ceny zawierają podatki tego kraju. Lista zawiera aktywne kraje sklepu. W tym przykładzie wybierz Polska.
Krok 5. (Opcjonalnie) W polu Pozostałe kraje wybierz kolejne kraje, w których produkty mają być widoczne. Otrzymają te same ceny i tę samą walutę co kraj główny.
Krok 6. W polach Język i Waluta wybierz język nazw i opisów oraz walutę cen. W tym przykładzie wybierz Polski i złoty (PLN).
Uwaga. OpenAI domyślnie pokazuje produkty ze standardowej wysyłki w USA. Inne kraje i waluty wymagają potwierdzenia przez OpenAI.
Krok 7. (Opcjonalnie) W panelu Produkty, w drzewie Kategorie, zaznacz kategorie, z których produkty mają trafić do katalogu. Wysyłane są produkty z co najmniej jednej zaznaczonej kategorii. Nie zaznaczaj nic, aby wysłać produkty ze wszystkich kategorii.
Krok 8. (Opcjonalnie) W polu Producenci wybierz producentów, których produkty mają trafić do katalogu. Nie wybieraj nic, aby wysłać produkty wszystkich producentów.
Krok 9. Ustaw przełącznik Wysyłaj kombinacje jako osobne produkty:
- Tak - każda kombinacja trafia do OpenAI jako osobny produkt z własną ceną, dostępnością i zdjęciem, powiązany ze swoim produktem. Nazwa zawiera wariant, np.
Koszulka - S, Biały, - Nie - produkt z kombinacjami trafia do OpenAI jako jeden produkt.
Krok 10. (Opcjonalnie) Ustaw przełącznik Ukrywaj produkty niedostępne w magazynie na Tak, jeśli ChatGPT nie ma pokazywać produktów, których brak w magazynie. Są one nadal wysyłane, ale oznaczone jako niedostępne, dzięki czemu znikają z ChatGPT od razu.
Krok 11. OpenAI wymaga marki dla każdego produktu. W polu Produkty bez producenta wybierz, co zrobić z produktami, które nie mają przypisanego producenta:
- Nie wysyłaj ich - takie produkty zostaną pominięte,
- Wysyłaj je z marką podaną poniżej - wpisz wtedy markę w polu Marka dla produktów bez producenta, np. nazwę sklepu.
Krok 12. W panelu Połączenie z OpenAI (SFTP) pozostaw pola dostępu puste, jeśli korzystasz z klucza API, bo wypełni je działanie masowe w etapie 5. Pole Nazwa pliku ma domyślnie wartość
products (bez rozszerzenia, moduł doda je sam), a Format pliku ma domyślnie wartość CSV (.csv), opisaną w przewodniku OpenAI dla reklam. Krok 13. Kliknij Zapisz. Katalog pojawi się na liście.
Etap 5. Połączenie katalogu z OpenAI
Moduł wysyła plik katalogu na serwer SFTP feedu w OpenAI. Dane dostępu możesz uzyskać automatycznie, kluczem API (wariant A), albo wpisać je ręcznie (wariant B).Wariant A. Automatycznie, kluczem API
Krok 1. Na liście katalogów zaznacz pole wyboru przy katalogu.
Krok 2. Kliknij Działania masowe pod listą i wybierz Utwórz feed i dostęp SFTP w OpenAI. Potwierdź komunikat.
Krok 3. Moduł zakłada feed w OpenAI z krajami katalogu, pobiera dane dostępu SFTP i zapisuje je w katalogu. Po chwili zobaczysz komunikat, że feed jest gotowy w OpenAI, a w kolumnie Feed w OpenAI pojawi się jego ID. Możesz przejść do etapu 6.
Uwaga. Feed jest zakładany tylko raz. Ponowne użycie tego działania dla tego samego katalogu tworzy nowy dostęp SFTP, a dotychczasowe hasło SFTP przestaje działać. Kraje feedu OpenAI zapisuje przy jego zakładaniu. Każdy wysłany produkt zawiera i tak aktualną listę krajów katalogu.
Wariant B. Ręcznie, danymi od OpenAI
Krok 1. Na liście katalogów kliknij Edytuj przy katalogu i przejdź do panelu Połączenie z OpenAI (SFTP).
Krok 2. W polu Serwer wklej adres otrzymany od OpenAI, np.
sftp://user@sftp.example.com:22. Port i nazwa użytkownika zostaną uzupełnione automatycznie. Możesz też wpisać osobno Serwer, Port i Nazwę użytkownika.Krok 3. W polu Hasło wpisz hasło SFTP. Jeżeli OpenAI przekazało dostęp kluczem zamiast hasła, wklej klucz w polu Prywatny klucz SSH. Hasło służy wtedy do odblokowania klucza.
Krok 4. Kliknij Zapisz. Hasło i klucz są przechowywane w postaci zaszyfrowanej. Przy kolejnej edycji te pola są puste: pozostaw je puste, aby nie zmieniać zapisanych danych. Aby je usunąć, ustaw przełącznik Usuń zapisane hasło i klucz na Tak.
Uwaga. Katalog połączony ręcznie nie ma ID feedu w OpenAI, więc historia eksportów nie pokaże dla niego statusu przetworzenia pliku w OpenAI.
Etap 6. Pierwsza wysyłka
Krok 1. (Zalecane) Zaznacz katalog na liście, kliknij Działania masowe i wybierz Sprawdź połączenie SFTP. Jeżeli dane są poprawne, zobaczysz komunikat Polska PLN: połączenie działa.
Krok 2. (Opcjonalnie) Wybierz w działaniach masowych Wygeneruj plik bez wysyłania. Plik pojawi się w historii eksportów, gdzie możesz go pobrać i sprawdzić, zanim cokolwiek trafi do OpenAI.
Krok 3. Wybierz w działaniach masowych Wyślij do OpenAI. Po wysyłce zobaczysz komunikat z liczbą wysłanych i pominiętych produktów, np. Polska PLN: wysłano do OpenAI produktów: 120, pominięto: 3. Kolumny Ostatni eksport i Ostatni wynik pokażą datę i wynik wysyłki.
Uwaga. Każda wysyłka zastępuje plik na serwerze pełnym katalogiem. Po zmianie nazwy pliku lub formatu moduł usuwa z serwera poprzedni plik. Moduł nigdy nie wysyła pustego pliku, bo taki plik usunąłby z ChatGPT wszystkie produkty sklepu.
Etap 7. Automatyczna wysyłka (CRON)
OpenAI zaleca aktualizację produktów co najmniej raz dziennie. Wysyłkę wykonuje wtedy zadanie CRON na serwerze sklepu.Krok 1. Nad listą katalogów skopiuj adres zadania CRON, np.
https://twoj-sklep.pl/pl/module/pshowaifeed/cron?token=.... Krok 2. W panelu hostingu dodaj zadanie CRON, które co najmniej raz dziennie otwiera ten adres, np. poleceniem
curl -s "adres zadania CRON". Dobrą porą jest noc, gdy w sklepie jest mały ruch. Krok 3. Każde wywołanie wysyła wszystkie aktywne katalogi sklepu. Dla katalogów połączonych kluczem API moduł sprawdza też przed wysyłką status wcześniejszych wysyłek w OpenAI.
Wskazówka. Aby zadanie wysyłało tylko jeden katalog, dopisz do adresu jego ID, np.
&id_catalog=3. ID katalogu widać w pierwszej kolumnie listy. Uwaga. W sklepie z kilkoma sklepami (multistore) każdy sklep ma własny adres zadania CRON, który wysyła tylko katalogi tego sklepu. Wybierz sklep na górze strony, aby zobaczyć jego adres.
Etap 8. Historia eksportów i wyniki z OpenAI
Krok 1. W menu bocznym modułu kliknij Historia eksportów. Lista pokazuje każdą wysyłkę i każdy wygenerowany plik: datę, katalog, wynik, status w OpenAI, liczbę wysłanych i pominiętych produktów oraz rozmiar pliku.
Krok 2. Kliknij Zobacz przy wpisie, aby otworzyć szczegóły. Przyciskiem Pobierz plik na górze strony pobierzesz wysłany plik. Tabela Pominięte produkty pokazuje, które produkty nie trafiły do pliku i dlaczego, np. brak zdjęcia, brak opisu, brak producenta albo cena wynosi zero. Uzupełnij te dane w produktach, a trafią do OpenAI przy kolejnej wysyłce.
Krok 3. Po wysyłce OpenAI przetwarza plik. Kolumna Status w OpenAI pokazuje wynik:
- Przetwarzanie w OpenAI - OpenAI jeszcze przetwarza plik,
- Przyjęty przez OpenAI - plik został przyjęty bez problemów,
- Przyjęty z błędami - plik został przyjęty, ale część wierszy ma problemy,
- Odrzucony przez OpenAI albo Nieprzetworzony przez OpenAI - produkty z tego pliku nie zostały zaktualizowane.
Krok 4. Status jest sprawdzany automatycznie przy otwarciu szczegółów wpisu (nie częściej niż raz na minutę) oraz przez zadanie CRON przed kolejną wysyłką. Aby sprawdzić go od razu, kliknij Sprawdź status w OpenAI na górze strony szczegółów.
Uwaga. Status w OpenAI jest widoczny tylko dla katalogów połączonych kluczem API (etap 5, wariant A), gdy klucz jest zapisany w module. Moduł przechowuje pliki ostatnich 5 eksportów każdego katalogu.
Ważne informacje
- Do OpenAI trafiają tylko produkty aktywne i widoczne w sklepie. Każdy z nich musi mieć nazwę, opis, zdjęcie, markę (producenta albo markę zastępczą z ustawień katalogu) i cenę większą od zera.
- Produkt usunięty lub wyłączony w sklepie znika z pliku przy kolejnej wysyłce, ale OpenAI może go pokazywać jeszcze do 14 dni. Produkty niedostępne w magazynie znikają z ChatGPT od razu, jeśli w katalogu włączona jest opcja Ukrywaj produkty niedostępne w magazynie.
- W sklepie z kilkoma sklepami (multistore) katalog należy do sklepu, w którym go utworzono. Aby go edytować lub wysłać, wybierz ten sklep na górze strony.