LeadStar właśnie wzbogacił się o kolejne narzędzie pomagające w promocji programów i zarabianiu wynagrodzenia. Tym razem (na prośbę naszych Wydawców) udostępniamy Ci pliki produktowe tzw. Product feed. Jest to raczej narzędzie dla zaawansowanych Partnerów, którzy mają własne zaplecze IT. Po co one są i jak z nich korzystać dowiesz się z poniższego wpisu.

Co to jest product feed?

Product feed to plik zawierający opis i parametry produktów oferowanych przez reklamodawców. Zwykle takie pliki są przygotowywane przez sklepy internetowe i zawierają cały ich asortyment. Plik produktowy w LeadStar jest dostępny w formacie XML w ustandaryzowanej formie (niezależnej od reklamodawcy). Najważniejszą jego zaletą jest stała aktualizacja – pobieramy dane od reklamodawców co 12 godzin.

Plik produktowy jest taką gazetką reklamodawcy. Zawiera jego ofertę wraz z aktualnymi cenami na chwilę pobrania. Jednak po pewnym czasie te dane się przedawniają. Ceny zmieniają się na bieżąco, zmienia się dostępność produktów. Stąd musisz pobierać regularnie plik produktowy i aktualizować dane na jego podstawie.

Specjalnie na potrzeby działania tego rozwiązania przygotowaliśmy nowy serwer. Stąd pliki produktowe są dostępne pod domeną https://productfeed.pl. Dzięki temu obciążenie, jakie może wynikać z pobierania i aktualizacji danych (mówimy tutaj o dziesiątkach megabajtów i wielu tysiącach produktów), nie wpłynie na prędkość działania LeadStar.

Jak skonfigurować product feed?

Aby skonfigurować product feed, wybierz z menu „Narzędzia > Product feed”. Klasycznie Twoim oczom ukaże się lista dotychczas zdefiniowanych plików produktowych. Masz możliwość ich edycji lub ew. usunięcia w przypadku, gdy któryś nie będzie Ci już potrzebny. Zakładając jednak, że na razie lista jest pusta, kliknij przycisk „Przygotuj nowy product feed”.

Product feed – główny ekran

Konfiguracja jest tak samo prosta, jak w przypadku innych narzędzi dostępnych w LeadStar.pl. Sprowadza się do ustalenia wewnętrznego opisu (który jest widoczny tylko dla Ciebie) oraz wybraniu programu, dla którego chcesz wygenerować plik produktowy. Możesz wybierać z kampanii, które spełniają jednocześnie następujące warunki:

  • jesteś zapisany do danego programu i jest on aktywny,
  • przygotowaliśmy obsługę product feed dla tego reklamodawcy.

Ze względu na to, że pliki produktowe są dosyć duże, a każdy reklamodawca dostarcza je we własnym formacie, w praktyce musimy przygotowywać odrębnie każdy z nich. Stąd jeżeli nie znajdziesz na liście programu, na jakim Ci zależy, napisz do nas!

Dla każdego pliku produktowego możesz dodatkowo wybrać listę kategorii sklepu, które Cię interesują. Pozwoli to, w razie potrzeby, zmniejszyć wielkość pliku i ilość produktów znajdujących się w nim. Jeżeli chcesz replikować cały asortyment, po prostu nie zaznaczaj żadnej kategorii. Dostępna lista jest zgodna z danymi od reklamodawcy i LeadStar nie może w nią ingerować.

Jeżeli tylko posiadasz własne domeny, na których masz u nas ustawione strony partnerskie, możesz wybrać jedną z nich dla generowanych linków. Wtedy każdy link w pliku produktowym będzie kierował właśnie na Twoją domenę. Działa to w podobny sposób, co w przypadku linków we własnej domenie.

Product feed – edycja

Na koniec wystarczy zapisać zmiany. Jeżeli wszystko będzie w porządku, w sekcji poniżej zatytułowanej „Kod product feed do pobrania” pojawi się dedykowany dla Ciebie adres URL kierujący do pliku produktowego. Jeżeli skopiujesz go i wkleisz w przeglądarkę od razu po przygotowaniu, to zapewne zobaczysz błąd. Będzie tak, ponieważ pliki są przygotowywane przez serwer co 2 minuty. Musisz więc chwilkę odczekać.

Możesz teraz wrócić na główną listę i sprawdzić status Twojego product feed’a. Dostępne statusy to:

  • wyłączony – pojawi się wtedy, gdy wyłączymy product feed dla danego reklamodawcy,
  • tymczasowo wstrzymany – oznacza, że mogą być chwilowe problemy techniczne z pobraniem danych,
  • oczekuje na wygenerowanie – zwykle pojawia się dla nowo zdefiniowanych plików produktowych, które oczekują na wygenerowanie przez nasz serwer,
  • wymuszono generowanie – status, który pojawia się po wprowadzeniu i zapisaniu zmian w konfiguracji Twojego pliku produktowego, lub w przypadku pierwszego wywołania URL pliku po 7 dniach nieaktywności,
  • brak pobrania od 7 dni – nieaktywny – jeżeli nie pobierzesz pliku produktowego w ciągu 7 dni, serwer automatycznie go wyłączy. W takim przypadku wywołaj jednorazowo URL pliku produktowego. Pojawi się błąd, ale serwer dostanie sygnał, że trzeba wygenerować plik dla Ciebie od nowa. Status zmieni się na „wymuszono generowanie” i po ok. 5 minutach będziesz mógł ponownie pobierać dane,
  • aktywny – plik produktowy jest gotowy do pobrania.

Pliki produktowe są aktualizowane raz na 12 godzin. Stąd częstsze ich pobieranie mija się z celem.

Product feed – błąd w przypadku niepobrania pliku w ciągu ostatnich 7 dni

Struktura pliku

Opis struktury pliku znajduje się w panelu zaraz pod adresem URL kierującym do Twojego pliku produktowego. Najważniejsza informacja jest taka, że struktura tego pliku jest standaryzowana przez nas niezależnie od reklamodawcy. Część pól jest stała i znajduje się zawsze w pliku, który pobierzesz. Są to:

  • unikalne ID produktu reklamodawcy,
  • adres URL produktu,
  • adres URL do zdjęcia produktu,
  • nazwa produktu,
  • nazwa producenta,
  • kategoria lub ścieżka kategorii,
  • długi opis,
  • bieżąca cena,
  • cena przed promocją,
  • znacznik promocji.

Dodatkowo na ten moment, zależnie od reklamodawcy, mogą być dostępne pola:

  • kod EAN,
  • rozmiar lub dostępne rozmiary produktu,
  • materiał[-y] produktu,
  • kolor[-y] produktu,
  • koszt dostawy,
  • skrócony opis.

Ceny oraz koszty dostawy są zawsze polami liczbowymi ze znakiem kropki rozdzielającym złote od groszy. Pozostałe pola są jako tzw. CHARACTER DATA (<![CDATA[ ….. ]]>).

Jeżeli po wywołaniu URL pliku produktowego system znajdzie jakiś błąd, to zamiast powyższych danych dostaniesz informację o powodzie wystąpienia błędu. Np. w przypadku niepobierania pliku przez okres 7 dni (o którym wspomniałem przy opisie statusów) pierwsze wywołanie spowoduje zwrócenie następującego komunikatu:

Product feed – plik niepobierany od 7 dni

Najważniejsze pole, czyli adres URL produktu, kieruje bezpośrednio do sklepu reklamodawcy do danego produktu. Jeżeli podczas konfigurowania pliku produktowego wybierzesz własną domenę, linki te będą na nią kierować. Kliknięcie tego linku rejestruje akcję w Twoim panelu powiązaną z danym reklamodawcą. Dokonany w ten sposób zakup zostanie rozliczony na Twoje konto.

Jeżeli będziesz sprawdzać statystyki klików/wniosków zwróć uwagę, że domyślnie wszystkie akcje z takich linków mają ustawione EPI1 na „product feed ID xxxxx”, gdzie „xxxxx” zawiera unikalne ID produktu reklamodawcy. W łatwy sposób możesz więc sprawdzić statystyki tylko i wyłącznie z takich akcji. Wystarczy skorzystać z zaawansowanego wyszukiwania jak na poniższym zrzucie:

Zaawansowane wyszukiwanie w statystykach

Jeżeli chcesz dowiedzieć się więcej, o tym czym różni się klik od wniosku, zapraszam do lektury tego wpisu.

Na koniec

Podobnie jak paczki XML czy API, pliki produktowe są raczej narzędziem dla zaawansowanych Wydawców. Jednak nawet w takim przypadku wychodzimy naprzeciw ich potrzebom. Dlatego, jeżeli uważasz, że masz dobry pomysł na nowe rozwiązanie lub poprawienie istniejącego – pisz do nas!


Artur Szkarłat

Co tu dużo pisać. Wieloletnie doświadczenie w projektowaniu i budowaniu systemów afiliacyjnych oraz partnerskich. Uwielbiam automatyzować i usprawniać narzędzia tak, żeby jak najlepiej służyły swoim użytkownikom w myśl zasady "system dla człowieka a nie człowiek dla systemu". Prywatnie sklejam amatorsko modele, lubię VR i dobrą muzykę.