Tworzenie katalogu produktów

Katalog produktów to plik z informacjami o produktach dostępnych w Twoim e-sklepie, np. nazwę produktu, jego cenę regularną i po obniżce, dostępność.

Informacje z katalogu produktów wykorzystywane są w:

• rekomendacjach,
• tworzeniu zdarzeń takich jak porzucony koszyk, porzucone przeglądanie, które zawierają informacje o produktach.

Dwa sposoby na zbudowanie katalogu produktów

Zanim zaczniesz, zdecyduj, która metoda najlepiej pasuje do Twojego przypadku:

• Automatyczne tworzenie – skrypt śledzący umieszczony na stronie Twojego sklepu zbiera dane o produktach w tle. Nie musisz przygotowywać żadnych plików, ale zebranie danych o 90% produktów zajmuje około 7 dni.
• Import z pliku – przygotowujesz plik z katalogiem produktów (XML lub CSV) i podajesz ECDP adres URL, pod którym jest dostępny. Produkty są widoczne w platformie od razu po poprawnym imporcie.

Automatyczne tworzenie katalogu produktów

Ta metoda wymaga konfiguracji kanału Web Tracking, który wymaga umieszczenia kodu śledzącego na Twojej stronie. Kod śledzenia zbiera informacje o produkcie z każdej odwiedzonej strony produktu i przekazuje je do katalogu produktów w ECDP.

Dodanie 90% produktów zajmuje około tygodnia. Strony produktów, które nie zostały odwiedzone, nie zostaną dodane do katalogu.

Jeśli zmienisz cenę produktu, zostanie ona zaktualizowana w katalogu podczas następnej wizyty klienta.

Jak uruchomić automatyczne tworzenie katalogu produktów?

1. Przejdź do Ustawienia > Web tracking > Strony www.
2. Kliknij przycisk Stwórz nową stronę www.
3. Dodaj nazwę strony, adres URL i opcjonalny opis.
4. Wybierz główny język witryny.
5. Zaznacz pole Uruchom tworzenie katalogu produktów za pomocą skryptu śledzącego.
6. Zaznacz kolejne pole Nadpisuj produkty dodane przez import, które umożliwi zastąpienie informacji o produktach zaimportowanych z pliku informacjami pozyskanymi w procesie automatycznego budowania katalogu.
7. Zapisz zmiany.

Import katalogu produktów z pliku

Zanim stworzysz katalog produktów w ECDPr, przygotuj go zgodnie z naszymi wytycznymi.

Format pliku

Katalog produktów musi mieć postać pliku w jednym z formatów:

• XML
• CSV

Nie obsługujemy plików skompresowanych, czyli w formatach .zip i .gz.

Cechy produktów w katalogu

Cechy produktów to informacje, które opisują produkty w Twoim katalogu — np. cena, marka, kolor czy dostępność. W ECDP wykorzystasz je do personalizacji kampanii marketingowych. Dane te są pobierane z pliku XML lub CSV, w którym importujesz do systemu katalog produktów.

W katalogu występują dwa rodzaje cech:

• Cechy systemowe –wymagane dla każdego produktu (np. ID, cena, dostępność). Nie możesz ich zmieniać, są stałe i zawsze obecne w katalogu.
• Cechy niestandardowe –dodatkowe informacje, które definiujesz samodzielnie (np. marka, kolor, rozmiar). Możesz ich użyć w roli filtrów i boosterów w rekomendacjach

Cechy są dostępne dla wszystkich katalogów w Twojej jednostce biznesowej. Znajdziesz je w
Ustawienia > Web Tracking > Cechy produktów w katalogach.

Cechy systemowe

Każdy produkt w katalogu powinien zawierać następujące cechy:

Cechy niestandardowe

W katalogu możesz dodawać własne cechy produktów, takie jak waga, marka lub kolor.  Wykorzystasz je w treściach marketingowych oraz w roli filtrów i boosterów w rekomendacjach.

Dodaj je w sekcji Ustawienia > Web Tracking > Cechy produktów w katalogach, przed importem katalogu produktów.

1. Kliknij Dodaj niestandardową cechę produktu.
2. W polu Nazwa wpisz unikalną nazwę cechy.
3. W polu Typ wybierz rodzaj danych charakterystyczny dla tej cechy:

4. Opcjonalnie dodaj Opis, pomoże innym zrozumieć, jak używać tej cechy
5. Zapisz zmiany.

Przechowywanie i udostępnianie pliku z katalogiem

Plik z katalogiem musi być przechowywany na stronie Twojego sklepu i być dostępny pod adresem URL, np. https://www.twojsklep.pl/katalog.xml

Obsługujemy protokoły https i http.

Dodaj katalog produktów w formacie XML

1. W sekcji Web Tracking > Katalogi produktów kliknij Stwórz katalog produktów.
2. Wybierz z listy format XML.
3. Przejdź do konfiguracji katalogu.

Podstawowe ustawienia:

1. Wprowadź nazwę katalogu produktów.
2. Wybierz stronę WWW, do której odnosi się wczytywany przez Ciebie katalog.
3. W polu Własny plik XML wpisz adres URL, pod którym dostępny plik z katalogiem.
4. Następnie ustaw harmonogram pobierania informacji z katalogu przez ECDP:
   • Co 3 godziny – informacje o produktach będziemy pobierać co 3 godziny.
   • Tryb własny – wskaż, z jaką częstotliwością informacje z katalogu powinny być pobierane. Używając wyrażenia cron możesz ustawić dowolną częstotliwość. Jeśli ten sposób jest dla Ciebie nowy, przeczytaj

Mapowanie

Za pomocą mapowania przypiszesz dane z pliku do odpowiednich cech opisujących produkty w ECDP.

1. Wybierz Walutę używaną w Twoim katalogu produktów w polach Cena i Bieżąca cena.
2. Następnie w sekcji Lokalizacja produktu w katalogu wskaż, gdzie w pliku znajdująsię produkty:
   • Kliknij Wybierz.Otworzy się panel przedstawiający strukturę katalogu. Działa on podobnie do widoku folderów. Możesz rozwijać kolejne elementy i wybrać ten, który reprezentuje pojedynczy produkt. W większości katalogów będzie to element product wewnątrz głównego elementu feed.Po wybraniu lokalizacji produktu ECDP odczyta i wyświetli poniżej wszystkie cechy systemowe i niestandardowe produktu, takie jak cena, kategoria czy adres URL obrazka.
   • Następnie w taki sam sposób przypisz lokalizację poszczególnych cech produktu – kliknij … i wybierz odpowiednie oznaczenie cechy z listy.

Podgląd

1. Przejdź do podglądu i sprawdź, czy cechy zostały dobrze przypisane do produktów w pliku.
2. Jeśli zauważysz błąd:
   • Cecha ostała źle przypisana – przejdź do zakładki Mapowanie i przypisz odpowiednia lokalizację to tej cechy.
   • Nie widzisz cechy lub wartości w kolumnie – zaktualizuj plik z katalogiem produktów i dodaj go jeszcze raz.
3. Jeśli dane wyświetlają się poprawnie kliknij Zapisz, co zakończy konfigurację katalogu.

Dodaj katalog produktów w formacie CSV

1. W sekcji Web Tracking > Katalogi produktów kliknij Stwórz katalog produktów.
2. Wybierz z listy format CSV.
3. Przejdź do konfiguracji katalogu.

Podstawowe ustawienia

1. Wprowadź nazwę katalogu produktów.
2. Wybierz stronę WWW, do której odnosi się wczytywany przez Ciebie katalog.
3. W polu Własny plik CSV wpisz adres URL, pod którym dostępny plik z katalogiem.
4. Następnie ustaw harmonogram, w którym będzie odbywać się cykliczny import informacji z pliku do ECDP:
   • Co 3 godziny – informacje o produktach importujemy co 3 godziny.
   • Tryb własny – ustaw własną częstotliwość importu danych z pliku. Używając wyrażenia cron możesz ustawić dowolną częstotliwość.

Ustawienia

1. Wybierz Walutę używaną w Twoim katalogu produktów w polach “Cena” i “Bieżąca cena”.
2. Ustawieniach zaawansowanych wskaż, w jaki sposób dane o produktach są przechowywane w Twoim katalogu. Ułatwi to nam prawidłowe odczytanie danych.
   • Najpierw wskaż sposób rozdzielenia danych w Twoim katalogu:
     • Tabulator – włącz opcję Użyj Tab jako separator wartości
     • Przecinek lub średnik – jeśli nie używasz tabulatora. Wpisz odpowiedni znak w okno Separator wartości
   • Plik zawiera nagłówki – włącz tę opcję, jeśli w pliku każda kolumna z danymi posiada nagłówek lub tytuł. Ominiemy je podczas pobierania pliku do platformy.
   • Następnie wskaż dodatkowe znaki używane w Twoim katalogu:
     • Znak cudzysłowu – wskaż, który znak w Twoim katalogu służy do „opakowania”, dzięki czemu zostanie ona odczytana w całości, a nie rozdzielona. Jest to przydatne dla takich danych jak cena, w której stosuje się przecinki dla wyrażenia wartości dziesiętnych (grosz, cent itp.).
     • Znak escape’ujący cudzysłów – wskaż znak lub zestaw znaków, które sprawią, że następny znak rozdzielający dane w katalogu nie będzie traktowany jak separator lub „opakowanie” danych, ale jako ich integralna część.
     • Znak rozpoczynający komentarz – wskaż znak, którym oznaczasz komentarze w katalogu. Ominiemy je przy pobieraniu danych do platformy.
   • Sposób kodowania znaków – wybierz odpowiednią wartość z listy. Mała podpowiedź – najpopularniejszym sposobem kodowania jest Unicode (UTF-8), który obsługuje również polskie znaki.
3. Sprawdź w Podglądzie, jak zostały odczytane dane z pliku.

Mapowanie

Mapowanie polega na przypisaniu danych produktowych z Twojego pliku do cech produktów w platformie.  

W trakcie mapowania, kolumny z pliku będą wyświetlane poziomo, a dane z każdej kolumny będą prezentowane w wierszach.

1. Kliknij rozwijalną listę widoczną po lewej stronie każdego wiersza.
2. Wybierz ceche opisującą daną widoczną w każdym wierszu, np. jeśli wyświetlana jest nazwa produktu, wybierz cechę Nazwa. Jeśli w wierszu widzisz adres strony produktu, wybierz cechę URL. Powtórz ten krok ze wszystkimi rzędami.
3. Po przypisaniu wszystkich cech kliknij Zapisz.

Plik produktowy jest gotowy!

Z czym możesz się spotkać po zakończeniu konfiguracji?

Katalog „nie wypełnia się” po konfiguracji. Jeśli włączyłeś automatyczne tworzenie katalogu, poczekaj do 7 dni. Skrypt śledzący zbiera dane o produktach dopiero wtedy, gdy klient odwiedzi stronę produktu. Produkty, które nie zostały jeszcze odwiedzone, nie pojawią się w katalogu. To normalne zachowanie systemu.

Cena lub inne dane produktu są nieaktualne. Przy automatycznym tworzeniu katalogu dane są aktualizowane podczas kolejnej wizyty klienta na stronie produktu. Jeśli importujesz katalog produktów z pliku, sprawdź harmonogram pobierania. Jeśli potrzebujesz natychmiastowej aktualizacji, można ręcznie wymusić pobranie pliku z danymi.

Import się nie powiódł. Sprawdź, czy plik jest publicznie dostępny pod podanym adresem URL i czy jest w wymaganym formacie (XML lub CSV, nieskompresowany). Następnie zweryfikuj, czy wszystkie wymagane cechy są obecne i poprawnie sformatowane, zwłaszcza czy wartości dostępności produktu to true lub false, a nie 1/0 ani tak/nie.

Po imporcie brakuje produktów. Przejdź do zakładki Mapowanie i sprawdź, czy wszystkie wymagane cechy – w szczególności ID produktu, nazwa, URL i cena – są poprawnie przypisane. Błędne lub brakujące mapowanie to najczęstsza przyczyna niekompletnych importów.

Katalog nie aktualizuje się zgodnie z harmonogramem. Sprawdź wyrażenie cron w ustawieniach harmonogramu. Jeśli korzystasz z opcji „Co 3 godziny”, upewnij się, że plik katalogu dostępny pod podanym adresem URL jest również aktualizowany po stronie Twojego sklepu.