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
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.
Po upływie czasu podanego w JS callback timeout działanie skryptu zostaje przerwane.
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&qdpi=9l89&pid=4&ci=50996&c=a6f271f4043b5ba0&p=73007&ss=rtb_8329&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.