1. Strona główna
  2. Specyfikacje
  3. Specyfikacja feeda produktowego

Specyfikacja feeda produktowego

YouLead umożliwia automatyczne, regularne importowanie bazy produktów Klienta. Podstawowym celem takiej operacji jest m.in. możliwość odznaczania, który z Kontaktów interesował się danymi produktami. Dzięki importowi możliwe staje się także segmentowanie Kontaktów po oglądanych produktach, definiowanie reguł na zdarzenie „Obejrzano produkt” oraz segmentacje bardziej zaawansowane, np. po atrybutach oglądanego produktu (np. pokaż Kontakty, które interesowały się produktami o kolorze X).

System YouLead obsługuje dwa typu plików: CSV oraz XML.

Techniczna realizacja feeda produktowego typu CSV powinna mieć postać pliku:

  • rozdzielanego średnikami, lub innym separatorem, który nie jest używany w żadnym polu produktów (dodatkowo, nie mogą to być spacje, ani inne białe znaki)
  • w kodowaniu UTF-8, 
  • dostępnego po protokole http pod określonym adresem url, 
  • nie może być niespójności, jeśli chodzi o ilość kolumn dla każdego produktu. Każdy produkt powinien mieć tę samą niezmienioną liczbę kolumn

Mile widziane jest, by pierwszy wiersz zawierał nazwy kolumn, przy czym dokładna nazwa kolumn nie jest istotna i służy jedynie wstępnej weryfikacji, która kolumna za co odpowiada.

Techniczna realizacja feeda produktowego typu XML powinna mieć postać pliku: (format docelowy nie jest ważny, tzn. każdy feed przygotowywany pod integrację np. ceneo, również jest obsługiwany przez YouLead, ważne żeby zawierał poniższe wymagania):

  • w kodowaniu UTF-8, 
  • dostępnego po protokole http pod określonym adresem url. 
  • Każdy produkt powinien być oddzielony jako osobny obiekt z podanymi wybranymi polami
  • Nie może być niespójności w polach produktu, tzn. Wszystkie produkty powinny posiadać te same pola

Plik jest importowany raz na dobę (w godzinach nocnych) i w oparciu o jego treść aktualizowana jest baza produktów w YouLead.

Plik produktowy może być:

  • zaciągany z serwera ftp,
  • wypakowywany z archiwum typu ZIP,
  • pobierany z serwisów typu CRM.

Jednak w powyższych przypadkach nazwa pliku powinna być podana przez klienta i niezmienna.

W przypadku CRM, powinna zostać dołączona dokumentacja do obsługi serwisu, przesłanie danych dostępowych oraz podanie metody zwracającej produkty.

Plik powinien zawierać następujące kolumny:

  1. Identyfikator – unikalny identyfikator produktu, który będzie używany do porównywania informacji o produkcie w feedzie produktowym z bazą produktów w YouLead. W przypadku kilku feedów produktowych identyfikator (alias) musi być również unikalny. 
  2. Nazwa produktu (używana np. do wyświetlenia podczas komunikacji z Kontaktem) [kolumna obowiązkowa]
  3. Kompletny Url (z http:// lub https://) do podstrony z opisem produktu [kolumna obowiązkowa]
  4. Photo Url, czyli kompletny Url (z http:// lub https://) do miniaturki zdjęcia produktu [kolumna rekomendowana]
  5. Kategoria produktu – pole opcjonalne, służy do kategoryzowania produktów np. marka, lokalizacja etc. [kolumna rekomendowana]
  6. Active – (0/1) informacja czy produkt jest nadal w sprzedaży (1=TAK, 0=NIE). Kolumna nie jest obowiązkowa, jednak jej obecność lub brak powodują nieco inne działanie feeda produktowego.

    W przypadku braku tej kolumny, feed traktowany jest jako kompletna baza produktów będących aktualnie w sprzedaży. Jeśli w YouLead znajdują się inne produkty (niewystępujące obecnie w feedzie), zostaną one oznaczone jako „Nieaktywne” czyli niebędące w sprzedaży. Dodatkowo wszystkie produkty obecne zarówno w feedzie jak i w YouLead są aktualizowane w YouLead (następuje nadpisanie wszystkich cech, nazwy, adresu url, photo url, kategorii na wartości obecne w feedzie). Produkty występujące w feedzie a nieobecne w YouLead są dodawane do YouLead.

    W przypadku, gdy kolumna Active jest obecna w feedzie produktowym, YouLead podczas importu aktualizuje swoją bazę produktów w oparciu o feed, tzn. odnajduje wszystkie produkty o takim samym identyfikatorze w feedzie oraz w bazie YouLead i aktualizuje w bazie YouLead wszystkie cechy, nazwę, kategorię, url, photo url oraz kolumnę Active (!) na wartości obecne w feedzie. W przypadku produktów istniejący w YouLead a nieobecnych w feedzie – YouLead nie zmienia ich atrybutów
  7. Cecha1 [kolumna rekomendowana] – zawiera wybrany, ustalony atrybut produktu (np. cena, kolor, rozmiar itp.)
  8. Cecha2 [j.w.]
  9. Cecha10 [j.w.]

Przykładowy wiersz pliku z feedem produktowym:

Id;Nazwa;Url;PhotoUrl;Kategoria;Kolor
A001-1;laptop XYZ;http://www.strona.pl/A001-1/Details/1;http://www.strona.pl/images/aad.jpg;Laptopy;srebrny

Z feedem produktowym związany jest sposób przekazywania informacji z przeglądarki odnośnie oglądanego przez Kontakt produktu:

ylData = window.ylData = window.ylData || []; ylData.push({ ‚product’: { ‚products’: [‚productId’] } });

gdzie productId jest identyfikatorem produktu z przekazanej bazy produktów (plik CSV), kolumna „Identyfikator”.

Dokładniejsze informacje temat przekazywania informacji odnośnie przeglądanego produktu do YouLead znajdują się w dokumentacji API YouLead.

Jeżeli występuje więcej niż jeden feed, Aliasy produktów nie powinny być takie same. W każdym feedzie produktowym aliasy powinny być różne.

Zaktualizowany 27 sierpnia 2021

Czy ten artykuł był pomocny?

Polecane artykuły