Smart Content: dokumentacja

Prezentacja

DataFirefly Smart Content personalizuje treści w Twoim sklepie PrestaShop według profilu, zachowania, koszyka i kontekstu każdego odwiedzającego. Zasada jest prosta: definiujesz segmenty (grupy odbiorców), a następnie kampanie, które łączą segment z treścią HTML wyświetlaną w wybranej strefie motywu. Na każdej stronie moduł ocenia odwiedzającego i pokazuje treść tej kampanii o najwyższym priorytecie, której segment pasuje.

Moduł obejmuje cały cykl: segmentację behawioralną, publikację wielostrefową, testy A/B, statystyki konwersji oraz dwóch asystentów AI (generowanie treści i propozycje segmentów).

Instalacja

1. Umieść katalog dfsmartcontent w folderze /modules/ swojego sklepu lub zainstaluj plik ZIP przez Moduły > Menedżer modułów > Wgraj moduł.
2. Kliknij Instaluj. Tabele i zakładki administracyjne tworzone są automatycznie.
3. Pojawia się nowe menu Smart Content z czterema podsekcjami: Pulpit, Kampanie, Segmenty i Ustawienia.

Konfiguracja ustawień

Przejdź do Smart Content > Ustawienia. Dostępne są tam dwie grupy parametrów.

Parametry AI

• Adres endpointu AI: endpoint uzupełniania rozmowy (zgodny z OpenAI i Mistral). Wartość domyślna: https://api.mistral.ai/v1/chat/completions.
• Model AI: na przykład mistral-large-latest lub gpt-4o-mini.
• Klucz API AI: Twój klucz, przechowywany po stronie serwera i nigdy nieujawniany na front-office. Dopóki pole jest puste, funkcje AI pozostają wyłączone, a reszta modułu działa normalnie.

Prywatność

• Respektuj zgodę na pliki cookie: włączone domyślnie. Znaczniki śledzenia (wyświetlenia i kliknięcia) uruchamiają się dopiero po wykryciu zgody.

Tworzenie segmentu

Segment to grupa odbiorców zdefiniowana przez jedną lub kilka reguł. Przejdź do Smart Content > Segmenty > Dodaj segment.

• Nazwa: wewnętrzna etykieta (np. „Klienci VIP”).
• Logika dopasowania: Wszystkie reguły (I) wymaga spełnienia każdej reguły; Co najmniej jedna reguła (LUB) wystarczy, że spełniona jest jedna.
• Priorytet: segmenty o wyższym priorytecie są oceniane w pierwszej kolejności.
• Reguły: dodawaj warunki wiersz po wierszu w wizualnym kreatorze.

Lista reguł

Każda reguła składa się z atrybutu, operatora i wartości. Dla list rozdziel wartości przecinkami. Dla zakresów (operator between) podaj dwie wartości rozdzielone przecinkiem.

• customer_group: grupa klientów (ID). Operatory: in / not_in.
• logged_in: odwiedzający zalogowany (1 lub 0). Operator: eq.
• new_returning: new lub returning na podstawie historii zamówień. Operator: eq.
• country: kraj (ID). Operatory: in / not_in.
• language: język (ID). Operatory: in / not_in.
• currency: waluta (ID). Operatory: in / not_in.
• device: desktop, tablet lub mobile. Operator: in.
• orders_count: liczba prawidłowych zamówień. Operatory: gte / lte / eq / between.
• total_spent: łączna wydana kwota. Operatory: gte / lte / between.
• days_since_order: liczba dni od ostatniego zamówienia. Operatory: gte / lte / between.
• cart_total: wartość bieżącego koszyka. Operatory: gte / lte / between.
• cart_has_category: kategoria obecna w koszyku (ID). Operator: in.
• cart_has_product: produkt obecny w koszyku (ID). Operator: in.
• newsletter: zapisany do newslettera (1 lub 0). Operator: eq.
• source_utm: źródło UTM sesji. Operatory: eq / contains.
• referrer: witryna odsyłająca. Operatory: contains / not_contains.
• hour_range: przedział godzinowy (np. 9,18). Operator: between.
• weekday: dzień tygodnia (1 = poniedziałek do 7 = niedziela). Operator: in.
• visits: liczba wizyt odwiedzającego. Operatory: gte / lte / eq.

Przykład: segment „Duzi klienci do odzyskania”, logika I: total_spent gte 200 oraz days_since_order gte 60.

Tworzenie kampanii

Kampania publikuje treść dla jednego lub kilku segmentów w wybranej strefie motywu. Przejdź do Smart Content > Kampanie > Dodaj kampanię.

• Nazwa: etykieta wewnętrzna.
• Strefa wyświetlania: hook, w którym pojawia się treść (lista poniżej).
• Segmenty docelowe: jeden lub kilka segmentów. Zostaw puste, aby kierować do wszystkich odwiedzających.
• Priorytet: jeśli kilka kampanii celuje w tę samą strefę, wygrywa pasująca kampania o najwyższym priorytecie.
• Testy A/B: włącz, aby publikować kilka wariantów (patrz osobna sekcja).
• Limit częstotliwości: maksymalna liczba wyświetleń na odwiedzającego (0 = bez limitu), w oknie wyrażonym w dniach.
• Data początku i końca: opcjonalny harmonogram kampanii.
• Warianty treści: treść HTML, edytowalna per język.

Dostępne strefy wyświetlania

displayHome, displayTop, displayNav1, displayBanner, displayWrapperTop, displayWrapperBottom, displayLeftColumn, displayRightColumn, displayFooter, displayProductAdditionalInfo, displayShoppingCartFooter.

Testy A/B

Włącz opcję testy A/B na kampanii, a następnie dodaj kilka wariantów. Każdy wariant ma etykietę (A, B i kolejne) oraz wagę. Moduł losuje wariant przy każdym wyświetleniu, proporcjonalnie do wag. Bez testów A/B używany jest pierwszy aktywny wariant.

Treść każdego wariantu wprowadza się per język. Pulpit porównuje następnie wyniki poszczególnych wariantów (wyświetlenia, CTR, CVR, obrót).

Generator treści AI

W edytorze kampanii panel Generator treści AI redaguje blok HTML nastawiony na konwersję. Podaj nazwę segmentu, opis grupy odbiorców, cel komunikatu i ton, wybierz język, a następnie kliknij Generuj. Wygenerowana treść trafia do pola tekstowego aktywnego wariantu i języka.

Propozycje segmentów przez AI

W sekcji Smart Content > Segmenty przycisk Propozycje segmentów przez AI otwiera stronę podsumowującą rzeczywiste statystyki Twojego sklepu (aktywni klienci, zamówienia, kupujący powracający, zapisani do newslettera). Kliknij Generuj propozycje: AI zaproponuje od 3 do 5 segmentów o wysokiej wartości, każdy z opisem, uzasadnieniem i zestawem reguł gotowych do przepisania do formularza tworzenia.

Pulpit i statystyki

Smart Content > Pulpit zbiera wyniki z wybranego okresu: wyświetlenia, kliknięcia i współczynnik klikalności (CTR), konwersje i współczynnik konwersji (CVR) oraz przypisany obrót. Jedna tabela pokazuje wyniki w podziale na kampanie, druga porównuje warianty A/B.

Jak przypisywane są konwersje

Po kliknięciu w spersonalizowany blok ostatnia interakcja (kampania, wariant, segment) zapisywana jest w cookie sesji. Przy zatwierdzeniu zamówienia moduł przypisuje konwersję i jej obrót tej kampanii, a następnie kasuje przypisanie, aby uniknąć podwójnego liczenia.

Prywatność i RODO

• Żadne dane osobowe nie są przechowywane: śledzenie opiera się na anonimowym identyfikatorze odwiedzającego (hash), używanym do limitu częstotliwości i deduplikacji.
• Opcja Respektuj zgodę na pliki cookie warunkuje uruchomienie pomiarów. Rozpoznawane sygnały: window.dfscConsentGranted = true albo cookie hideBanner=1, axeptio_authorized, cookieconsent_status=allow.
• Aby podłączyć własną platformę zgód, ustaw window.dfscConsentGranted na true po uzyskaniu zgody.

Wstawianie przez widget

Moduł implementuje interfejs widgetu PrestaShop. Blok możesz więc wstawić bezpośrednio w szablonie:

{widget name='dfsmartcontent' hook='displayHome'}

Parametr hook wskazuje, którą strefę ocenić.

FAQ i rozwiązywanie problemów

Mój blok się nie wyświetla

Sprawdź, czy kampania jest aktywna, czy jej strefa odpowiada hookowi obecnemu w Twoim motywie, czy co najmniej jeden wariant ma treść dla bieżącego języka i czy odwiedzający rzeczywiście pasuje do docelowego segmentu. Po osiągnięciu limitu częstotliwości blok nie jest już pokazywany temu odwiedzającemu w zdefiniowanym oknie.

Statystyki pozostają na zerze

Jeśli opcja zgody jest włączona, znaczniki uruchamiają się dopiero po jej udzieleniu. Sprawdź, czy Twój baner cookie wysyła jeden z rozpoznawanych sygnałów, albo ustaw window.dfscConsentGranted.

Funkcje AI zwracają błąd

Upewnij się, że klucz API, adres endpointu i model są poprawne w Ustawieniach oraz że Twój serwer może połączyć się z endpointem na wyjściu.