Tworzenie katalogu produktów

Katalog produktów w ECDP odzwierciedla ofertę produktów dostępnych na Twojej stronie. Wykorzystasz go do personalizacji kampanii marketingowych, rekomendacji i automatyzacji.

Kiedy katalog jest gotowy i wypełniony produktami, możesz połączyć go z kilkoma stronami www i aplikacjami mobilnymi, które sprzedają tę samą ofertę.

Katalog produktów pozwala Ci:

• polecać produkty klientom,
• tworzyć spersonalizowane treści w kampaniach e-mail i wiadomościach scenariuszowych, bannerach i pop-upach – na podstawie tego, jak odbiorcy korzystają z oferty na Twojej stronie,
• przygotować podglądy wiadomości e-mail i przetestować je przed wysyłką,
• uruchamiać scenariusze oparte na zdarzeniach, takie jak porzucony koszyk, porzucone przeglądanie czy spadek ceny.

Informacje o katalogu produktów

Każdy katalog produktów w ECDP ma:

• ID i nazwę, po których rozpoznasz katalog, kiedy łączysz go ze stroną www albo aplikacją mobilną.
• Liczbę stron i aplikacji mobilnych połączonych z katalogiem. Jedno źródło może być w danym momencie połączone tylko z jednym katalogiem, ale jeden katalog może obsługiwać kilka źródeł naraz. Żeby zobaczyć, które dokładnie strony i aplikacje są połączone z danym katalogiem, najedź na liczbę w kolumnie Strony i aplikacje.
• Cechy systemowe i niestandardowe, które opisują produkty w katalogu. Cechy działają na poziomie jednostki biznesowej, a nie osobno dla każdego katalogu.
• Produkty dodane przez import pliku albo przez dane ze śledzenia na Twojej stronie. Zawartość katalogu dla wybranej strony przejrzysz akcją Przeglądaj.

Katalog nie ma statusu „Aktywny” ani „Nieaktywny” – istnieje, dopóki go nie usuniesz. Usunąć możesz tylko taki katalog, który nie jest połączony z żadną aktywną stroną ani aplikacją mobilną.

Zacznij od stworzenia katalogu produktów. Potem dodaj niestandardowe cechy produktów, a na końcu same produkty.

Stwórz katalog produktów

1. Przejdź do Ustawienia > Katalogi produktów.
2. Kliknij Utwórz katalog produktów.
3. Wpisz nazwę katalogu.
4. W polu Maksymalny czas nieaktywności produktu podaj, ile godzin ma minąć od ostatniej odnotowanej wizyty na stronie produktu, zanim produkt zniknie z katalogu. Domyślne jst to 48 godzin. Produkty usunięte z katalogu nie trafią do rekomendacji ani do treści marketingowych. Kiedy kod śledzący ponownie odnotuje wizytę na stronie takiego produktu, produkt wróci do katalogu i będzie gotowy do wykorzystania.
5. Zapisz ustawienia.

Katalog produktów dla strony w kilku językach

Katalog produktów utrzymuj w jednym języku. Jeśli Twoja strona i aplikacja są w tym samym języku, mogą korzystać z jednego katalogu, nie musisz utrzymywać oddzielnie dwóch jednakowych katalogów.

Jeśli prowadzisz kilka stron w różnych językach, każda z nich potrzebuje osobnego katalogu w swoim języku.

Katalog produktów dla strony z kilkoma walutami

Jeśli Twoja strona obsługuje kilka walut, nie musisz zakładać dla nich osobnych katalogów. Waluty będą dodawane na bieżąco przez kod śledzący albo import pliku.

W ECDP przejdź do Ustawienia > Katalogi produktów i użyj akcji Przeglądaj, żeby zobaczyć katalog w każdej walucie dostępnej na Twojej stronie.

Dodaj cechy produktów

Cechy produktów to informacje, które opisują produkty, np. cena, marka, kolor czy dostępność. W ECDP wykorzystasz je do personalizacji kampanii i do trafniejszego dobierania rekomendacji.

W ECDP używamy dwóch rodzajów cech:

• Cechy systemowe, takie jak ID, cena lub dostępność. Są wymagane dla każdego produktu z wyjątkiem cechy „Kategoria” (zobacz tabelę poniżej). Zadbaj o to, żeby cechy te były dostępne na każdej stronie produktu, najlepiej w warstwie danych (data layer) Twojej strony oraz w importowanym pliku z produktami. Cechy systemowe pojawiają się automatycznie w Ustawienia > Katalogi produktów > Cechy produktów i nie można ich zmienić.
• Cechy niestandardowe, czyli opcjonalne informacje o produkcie. Jeśli używasz takich cech na stronach produktów albo w pliku produktowym, dodaj je też w Ustawienia > Katalogi produktów > Cechy produktów, zanim zaczniesz dodawać produkty do katalogu.

Jakie wymagania mają cechy systemowe i niestandardowe?

Cechy systemowe

Każda cecha systemowa w katalogu produktów powinna być zgodna z tą specyfikacją:

Cechy niestandardowe

Jeśli opisujesz produkty dodatkowymi cechami, dodaj je do katalogu w Ustawienia > Katalogi produktów > Cechy produktów. Najlepiej zrób to przed importem pliku produktowego albo przed wdrożeniem kodu śledzącego na stronie.

Nazwy cech w systemie muszą być takie same jak nazwy w pliku produktowym i na Twojej stronie. Inaczej cechy nie dodadzą się poprawnie i nie wykorzystasz ich w działaniach marketingowych.

Stwórz cechę niestandardową

1. Przejdź do Ustawienia > Katalogi produktów > Cechy produktów.
2. Kliknij Dodaj niestandardową cechę produktu.
3. W polu Nazwa wpisz nazwę zgodną z nazwami cech w pliku produktowego i na Twojej stronie.
4. W polu Typ wybierz format danych, który pasuje do cechy:

5. Opcjonalnie dodaj Opis, żeby Twoi współpracownicy wiedzieli, jak korzystać z tej cechy.
6. Zapisz zmiany.

Dodaj produkty do katalogu

W ECDP produkty dodasz do katalogu na dwa sposoby.

Sposób 1: aktualizacje katalogu danymi ze śledzenia

Pierwszy sposób wykorzystuje dane zbierane przez kod śledzący ECDP zainstalowany na Twojej stronie. Kod odnotowuje wizyty klientów na stronach produktów i dodaje te produkty do katalogu.

Objęcie 90% Twojej oferty zajmuje około 7 dni. Strony produktów, których nikt nie odwiedził, nie trafią do katalogu. Kod aktualizuje też produkty, które już są w katalogu.

Włącz aktualizacje danymi ze śledzenia dla katalogu produktów:

1. Przejdź do Ustawienia > Strony WWW.
2. Kliknij Dodaj nową stronę, żeby dodać nową stronę, albo wybierz akcję Edytuj, żeby zmienić ustawienia istniejącej.
3. W sekcji Katalog produktów > Wybierz katalog wskaż wcześniej stworzony katalog, z którego chcesz korzystać.
4. W sekcji Katalog produktów > Ustawienia katalogu zaznacz Uruchom tworzenie katalogu produktów za pomocą skryptu śledzącego.
5. Zapisz ustawienia.

Sposób 2: cykliczny import pliku produktowego

Drugi sposób to import produktów z pliku produktowego. Katalog powstaje i aktualizuje się przez cykliczne importy tego pliku. Produkty są dostępne od razu po zakończeniu importu.

Jeśli produkt z poprzedniego importu nie pojawi się w kolejnym, zniknie z katalogu.

Wymagania dla pliku produktowego

• Format: XML albo CSV, bez kompresji.
• Hosting pliku: plik musi być na stronie Twojego sklepu i publicznie dostępny pod adresem URL, np: https://www.twojsklep.pl/feed.xml. Obsługujemy protokoły https i http.
• Zawartość pliku: plik powinien zawierać wymagane cechy systemowe oraz cechy niestandardowe, jeśli w nim występują.

Kiedy plik jest gotowy, zaimportuj go do ECDP. Konfiguracja różni się trochę w zależności od formatu pliku.

Zaplanuj import produktów z pliku XML

1. W Katalogi produktów > Importy kliknij Stwórz import cykliczny.
2. Wybierz XML z listy.
3. Skonfiguruj import, przechodząc przez kolejne kroki.

Podstawowe ustawienia#

1. Wpisz nazwę importu.
2. Wybierz katalog produktów, którego dotyczy import.
3. W polu Plik XML podaj adres URL, pod którym dostępny jest plik.
4. Ustaw harmonogram, czyli jak często ECDP ma pobierać dane produktowe z pliku:
   • Co 3 godziny – dane produktowe będą pobierane co 3 godziny.
   • Tryb własny – ustal własną częstotliwość: co godzinę, codziennie albo w konkretnym momencie określonym wyrażeniem cron.

Mapowanie

Mapowanie łączy dane produktowe z pliku z danymi produktowymi w ECDP.

1. Wybierz walutę, której używasz w pliku w polach Cena i Bieżąca cena.
2. W sekcji Ścieżka produktu kliknij Wybierz, żeby wskazać, gdzie w pliku znajdują się produkty:
   • Otworzy się panel ze strukturą pliku – wygląda podobnie do drzewka folderów.
   • Rozwiń elementy, jeśli trzeba, i wskaż ten, który odpowiada jednemu produktowi. W większości plików to element product wewnątrz głównego elementu feed.
   • Kiedy wskażesz miejsce produktu, ECDP odczyta i wyświetli poniżej wszystkie systemowe i niestandardowe cechy produktów.
3. Przypisz cechy systemowe i niestandardowe:
   • Kliknij przycisk Wybierz.
   • Wskaż na liście odpowiadającą nazwę cechy.
   • Powtórz to dla każdej cechy w tej sekcji.

Podgląd

1. Przejdź do sekcji Podgląd i sprawdź, czy cechy zostały zmapowane poprawnie.
2. Jeśli coś się nie zgadza:
   • Cecha jest źle zmapowana – wróć na zakładkę Mapowanie i wskaż dla niej właściwe miejsce w pliku.
   • W kolumnie brakuje cechy albo jej wartości – popraw plik i wgraj go ponownie.
3. Jeśli dane są poprawne, kliknij Zapisz, żeby dokończyć konfigurację importu.

Zaplanuj import produktów z pliku CSV

1. W Katalogi produktów > Importy kliknij Stwórz import cykliczny.
2. Wybierz CSV z listy.
3. Skonfiguruj import, przechodząc przez kolejne kroki.

Podstawowe ustawienia

1. Wpisz nazwę importu.
2. Wybierz katalog produktów, którego dotyczy import.
3. W polu Plik CSV podaj adres URL, pod którym dostępny jest plik.
4. Ustaw harmonogram, czyli jak często ECDP ma pobierać dane produktowe:
   • Co 3 godziny – dane produktowe będą pobierane co 3 godziny.
   • Tryb własny – ustal własną częstotliwość: co godzinę, codziennie albo w konkretnym momencie określonym wyrażeniem cron.

Ustawienia

1. Wybierz walutę, której używasz w pliku w polach Cena i Bieżąca cena.
2. W sekcji Ustawienia zaawansowane opisz, jak zbudowane są dane produktowe w pliku – dzięki temu odczytamy je poprawnie.
3. Wskaż, czym rozdzielone są wartości w pliku:
   • Tabulator – włącz Użyj Tab jako separator wartości
   • Przecinek albo średnik – wpisz ten znak w polu Separator wartości
4. Plik zawiera nagłówki – włącz tę opcję, jeśli każda kolumna z danymi w pliku ma nagłówek albo nazwę. Nagłówki zostaną pominięte przy imporcie.
5. Określ dodatkowe znaki, których używasz w pliku:
   • Znak cudzysłowu – wskazuje, jakim znakiem obejmujesz wartości, żeby były czytane jako jedna całość, a nie dzielone. Przydaje się przy danych takich jak ceny, w których przecinek często oddziela grosze.
   • Znak escape’ujący cudzysłów – wskazuje znak albo sekwencję, po której kolejny separator lub cudzysłów nie jest traktowany jako granica wartości, ale staje się jej częścią.
   • Znak rozpoczynający komentarz – wskazuje znak, którym oznaczasz komentarze w pliku. Komentarze zostaną pominięte przy imporcie.
   • Sposób kodowania znaków – wybierz właściwą wartość z listy. Podpowiedź: najczęściej używane jest Unicode (UTF-8), które obsługuje też polskie znaki.

Sprawdź Podgląd, żeby zobaczyć, jak dane z pliku zostały odczytane.

Mapowanie

Mapowanie przypisuje cechy produktów z pliku do cech w ECDP.

W tej sekcji kolumny z pliku są pokazane poziomo, a dane z każdej kolumny – w wierszach.

1. Kliknij listę rozwijaną po lewej stronie wiersza.
2. Wybierz cechę systemową albo niestandardową, która odpowiada danym w tym wierszu. Jeśli w wierszu jest nazwa produktu, wybierz Nazwa. Jeśli adres strony produktu – wybierz URL produktu.
3. Powtórz to dla wszystkich wierszy.
4. Kiedy przypiszesz wszystkie cechy, kliknij Zapisz. Import cykliczny jest gotowy.

Aktualizuj katalog produktów między importami

Między cyklicznymi importami możesz aktualizować katalog danymi ze śledzenia. Dzięki temu zbierzesz świeższe dane produktowe wprost ze strony i zaktualizujesz katalog, zamiast czekać na zaplanowany import.

Żeby włączyć tę opcję:

1. Przejdź do Ustawienia > Strony www.
2. Wybierz akcję Edytuj, żeby zmienić ustawienia istniejącej strony.
3. W sekcji Katalog produktów > Ustawienia katalogu:
   • Najpierw zaznacz Uruchom tworzenie katalogu produktów za pomocą skryptu śledzącego.
   • Potem zaznacz Nadpisuj produkty dodane przez import. Ta opcja zastępuje dane produktowe zaimportowane z pliku danymi zebranymi przez kod śledzący.
4. Zapisz ustawienia.

Kiedy opcja Nadpisuj produkty dodane przez import jest wyłączona, kod nie aktualizuje produktów, które już są w katalogu. Jeśli jednak na stronie pojawi się nowy produkt przed kolejnym importem, kod doda go do katalogu.

Rozwiązywanie problemów#

Katalog nie zapełnia się po konfiguracji

Jeśli masz włączone aktualizacje danymi ze śledzenia, daj temu około 7 dni. Kod śledzący zbiera dane tylko wtedy, gdy klient wejdzie na stronę produktu, więc produkty bez wizyt jeszcze się nie pojawią. Tak to działa i nie jest to błąd.

Cena albo dane produktu są nieaktualne

Produkty aktualizują się w momencie, gdy klient wejdzie na stronę danego produktu. W przypadku importów sprawdź harmonogram.

Import się nie udał

Sprawdź, czy plik jest publicznie dostępny pod podanym adresem URL i czy jest w formacie XML albo CSV. Potem upewnij się, że wszystkie wymagane cechy są na miejscu i mają poprawny format – szczególnie wartość logiczna dostępności produktów, która musi być true albo false, a nie 1/0 czy tak/nie.

Po imporcie brakuje produktów

Możliwe przyczyny:

• Błędy w mapowaniu. Przejdź na zakładkę Mapowanie i sprawdź, czy wszystkie wymagane cechy i parametry, zwłaszcza ID produktu, Nazwa, URL produktu i Cena, są przypisane poprawnie.
• Produkt zniknął z pliku. Jeśli produktu nie ma w kolejnym zaplanowanym imporcie, zostanie usunięty z katalogu. Dodaj brakujący produkt do pliku i poczekaj na import zgodnie z harmonogramem.

Katalog nie aktualizuje się zgodnie z harmonogramem

Sprawdź wyrażenie cron w ustawieniach harmonogramu w Tryb własny. Jeśli korzystasz z opcji „Co 3 godziny”, upewnij się, że plik pod Twoim adresem URL jest aktualizowany również po stronie sklepu.