Jeżeli chcesz by Twoje ramki rekomendacji

  • zawierały zaawansowane efekty CSS3
  • zawierały wywoływane akcje w języku PHP metodą POST
  • wyświetlały produkty w różnych językach w zależności od aktywnej obecnie wersji językowej w przeglądarce klienta
  • zawierały cenę produktu niższą niż standardowa ze względu na zalogowanego stałego klienta

możliwe jest wygenerowanie rekomendacji w formacie JSON. Dzięki temu produkty wskazane do rekomendacji zostają przekazane poprzez format JSON, a sam wygląd ramki oraz wykorzystane atrybuty (typu cena, nazwa, obrazek) są określane przez klienta.

Aby włączyć taki format odpowiedzi skryptów należy w kreatorze drag&drop przełączyć opcję Włącz tryb JS callback na Tak.

Poniżej pojawią się trzy dodatkowe pola:

  • Kod JS callback: Twoja funkcja javascript, która przetworzy zwróconego przez nas JSONa z produktami i wygeneruje widget na Twojej stronie
  • Wybierz z katalogu pola: niewymagane; nazwy pól opisujące produkt (oddzielone spacją), które mają się znaleźć w zwróconym JSONie
  • JS callback timeout: czas w milisekundach jak długo może czekać nasz skrypt na pojawienie się Twojej funkcji (wartość między 0 a 100000)

Po wprowadzeniu odpowiednich ustawień (wymagana jedynie nazwa funkcji) i zapisaniu widgetu, przy następnym wywołaniu naszego skryptu QON.js zamiast HTMLa widgetu pobrany zostanie JSON z listą produktów oraz JavaScript, który wywoła funkcję podaną w Kod JS callback.

Twoja funkcja podana w polu Kod JS callback musi przyjmować jako parametr wywołania JSONa z listą produktów, które mają pojawić się w widgecie, na przykład:

quartic_rec(rekomendacje)

Właśnie ta zmienna rekomendacje przejmuje zawartość obiektu JSON.

Przykładowa zawartość JSON z rekomendacjami

quartic_rec([{"id":"389231","title":"Produkt 1","link":"http://www.quarticon.com/produkt_1.html","image":"http://www.quarticon.com/produkt_1_image.jpg","price":"7,50","old_price":"9,75","custom_1":"","custom_2":"","custom_3":"","custom_4":"","custom_5":""},{"id":"349605","title":"Produkt 2","link":"http://www.quarticon.com/produkt_2","image":"http://www.quarticon.com/produkt_2_image.jpg","price":"24,75","old_price":null,"custom_1":"","custom_2":"","custom_3":"","custom_4":"","custom_5":""}]) 

Przykładowa funkcja wywołująca rekomendacje

function quartic_rec(rekomendacje){

for (var i=0;i<rekomendacje.length;i++({

console.log(rekomendacje[i].title);

}

}

Powyższa przykładowa funkcja quartic_rec wyświetli w konsoli nazwę każdego produktu.

Nazwy pól opisujące produkt

W polu Select from catalogue należy podać pola produktu, które chcemy aby pojawiły się w zwracanym JSONie. Jeśli będzie puste, w JSONie znajdą się wszystkie pola opisujące produkt, a są to:

Aby w wygenerowanym JSONie były tylko te pola które chcemy należy do Wybierz z katalogu pola wprowadzić tylko te z powyższych nazw pól, które nas interesują.
Jeśli chcesz by w zwracanym JSONie były tylko pola id, ponieważ reszta danych zostanie pobrana z Twojego serwera w zależności od wersji językowej sklepu, do pola Wybierz z katalogu należy wprowadzić następującą treść:

id link

Jak działa wywołanie JSON

  1. Po pobraniu snippetu widgetu w formacie JSON z javascriptem sprawdzane jest czy podana przez Ciebie funkcja jest zdefiniowana. Jeśli jest, przerywa działanie skryptu i wywołuje Twoją funkcję z JSONem z produktami podanymi jako parametr wywołania funkcji. Jeśli nie jest zdefiniowana, po 15 minutach próbuje ponownie.
  2. Po upływie czasu podanego w JS callback timeout działanie skryptu zostaje przerwane.
  3. Jeśli podczas wywołania Twojej funkcji wystąpi błąd, działanie skryptu zostaje przerwane, a informacja o błędzie zostaje przesłana do nas pod adres: https://api.quarticon.com/er/?id=wdgJson&message=exception%20<komunikat błędu>

Przekierowanie z ramki rekomendacji do produktu

Aby system Quarticon prawidłowo rejestrował kliknięcia i sprzedaż z ramek rekomendacji wymagane jest wykorzystanie linków do produktu, które zostają przekazane w rekomendacjach w formacie JSON. Aby jednak nie pokazywać jawnie linków do produktów przekierowujących przez serwery Quarticon, warto wykorzystać funkcję onclick dla elementów danego produktu rekomendowanego. Poniżej znajduje się przykład składni HTML zbudowanej w opisany powyżej sposób:

<a href=”http://www.somepage.com/product_1″ onclick=”window.location.href = ‚http://rec.quartic.pl/c.php?qrid=ad_5714d78a54b27&amp;qdpi=9l89&amp;pid=4&amp;ci=50996&amp;c=a6f271f4043b5ba0&amp;p=73007&amp;ss=rtb_8329&amp;url=%2F%2Fwww.somepage.com%2product_1’; return false;”>Product 1</a>

Jak widać w powyższym przykładzie, atrybut href dla elementu klikanego pozostał niezmieniony, natomiast za pomocą metody onclick, wskazującą na inny URL dla window.location.href z dodatkową instrukcją return false, blokujemy przekierowanie przez standardowy atrybut href i wykorzystujemy niejawnie przekierowanie przez URL określony w metodzie onclick. Docelowym adresem produktu widocznym w przeglądarce po przejściu na produkt pozostanie pierwotny adres htttp://www.somepage.com/product_1.

Czy udało Ci się znaleźć odpowiedź na swoje pytanie?