Widget HTML lub JavaScript

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&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.

By rekomendacje