recommender_api

Mobiplus Recommender API

Έχουμε 2 τρόπους διαθέσιμους για την λειτουργία διασύνδεσης με το Mobiplus Recommendation Engine

Λειτουργία API

Λήψη δεδομένων από recommendation API:

  • Το αρχείο recommendation.js θα πρέπει να προστεθεί στην ιστοσελίδα.
  • Με το παραπάνω API μπορούμε να λάβουμε Recommendations δίνοντας παραμέτρους το id του πελάτη ή το id ενός ή και παραπάνω προϊόντων.
  • Επίσης για την σωστή λειτουργία του Recommendation Engine θα πρέπει να στέλνουμε κάποια βασικά δεδομένα σε κάθε συναλλαγή.
  • Ακολουθούν παραδείγματα για τις παραπάνω λειτουργίες.

Παράμετροι των παρακάτω συναρτήσεων είναι ο κωδικός του πελάτη (userid) και το token το οποίο σας το παρέχουμε εμείς. Σε περίπτωση που δεν γνωρίζουμε τον πελάτη γιατί δεν έχει κάνει sign in τότε καλούμε την παρακάτω συνάρτηση με NULL το userid.


Λήψη δεδομένων σε μορφή: JSON

get_user_items_json(userid,token);


Λήψη δεδομένων σε μορφή: HTML

get_user_items_html(userid,token);




Παράμετροι των παρακάτω συναρτήσεων είναι ο κωδικός του/των προϊόντων.
Στην περίπτωση που έχουμε παραπάνω από 1 προϊόν, τότε η List θα πρέπει να είναι ένα string με τα id των προϊόντων χωρισμένα με κόμμα «,», πχ:

list=108,109,150,286;


H παράμετρος token είναι ένα string το οποίο σας το δίνουμε εμείς.


Λήψη δεδομένων σε μορφή: JSON

get_history_items_json(list,token);


Λήψη δεδομένων σε μορφή: HTML

get_history_items_html(list,token);




Αποστολή δεδομένων κατά την συναλλαγή ενός πελάτη που έχει κάνει sign in ή και αγνώστου.
Σε αυτή την περίπτωση καλούμε την συνάρτηση:

item_click(userid,itemid,clicktype,sessionid,token);


ΠαράμετροςΠληροφορίες
useridΟ κωδικός του πελάτη σας (κενό αν δεν έχει κάνει sign in).
itemidΟ κωδικός του προϊόντος.
clicktypeΈνα string με μία από τις δυο τιμές (basket, favorite).
basketΗ τιμή δίνεται όταν το προϊόν έχει προστεθεί στο καλάθι αγορών,
favoriteΔίνετε στην περίπτωση που έχει γίνει προσθήκη στην wish list.
SessionidΕίναι ο κωδικός του session που έχει δημιουργηθεί εκείνη την στιγμή για το πελάτη σας




Λειτουργία Rest Web Service

Κάνοντας κλήση στο REST Web Service με τις αντίστοιχες παραμέτρους έχουμε τις εξής δυνατότητες:
Οι τιμές των παραμέτρων: clientid, projectid, date, θα δίνονται από εμάς.

Απαραίτητο για την κλήση των υπόλοιπων WebServices

/clienttoken?client_id= clientid&project_id= projectid&exp_date=date



/reco?itemsid= itemsid&userid= userid&sessionid=sessionid&token= token


ΠαράμετροςΠληροφορίες
itemsidΣτη περίπτωση παραπάνω από ένα id προϊόντος θα πρέπει να υπάρχει “,” κόμμα που να χωρίζει τα id. Π.χ itemsid = 108 ή itemsid= 108,109,250,456
useridΗ Παράμετρος είναι το id του εγγεγραμμένου χρήστη.
sessionidΗ παράμετρος sessionid είναι το sessionid, που χρησιμοποιεί ο πελάτης σας εκείνη τη στιγμή.
tokenΗ παράμετρος μπορεί να ανακτηθεί χρησιμοποιώντας το προηγούμενο WS “clienttoken”.

Η παράμετροι itemsid και userid μπορεί να είναι και NULL.

Η παράμετροι sessionid και clienttoken είναι υποχρεωτικές.



Κάθε φορά που ο πελάτης κάνει click σε ένα προϊόν τότε θα πρέπει να καλείτε το παρακάτω WS δίνοντας τον αντίστοιχο λόγο που έκανε click σε ένα προϊόν.

/clickinsert?userid= userid&itemid=itemid&clicktype=clicktype&sessionid=sessionid&token=token


ΠαράμετροςΠληροφορίες
useridΗ Παράμετρος είναι το id του εγγεγραμμένου χρήστη.
itemidΗ Παράμετρος είναι το id του προϊόντος.
clicktypeΗ Παράμετρος είναι ο λόγος που έκανε click και μπορεί να είναι μια από τις παρακάτω τιμές: clicktype = click ή wishlist ή basket

Η παράμετρος sessionid είναι το sessionid που χρησιμοποιεί ο πελάτης σας εκείνη τη στιγμή.

Η παράμετρος token μπορεί να ανακτηθεί χρησιμοποιώντας το προηγούμενο WS “clienttoken”.

Μόνο η παράμετρος userid μπορεί να είναι κενή.

Όλες οι άλλες παράμετροι είναι υποχρεωτικές.



/saleinsert?itemid=itemid&userid=userid&sessionid=sessionid&purchaseprice=purchaseprice&name=name&timestamp=timestamp&token=token


ΠαράμετροςΠληροφορίες
itemidΗ Παράμετρος είναι το id του προϊόντος.
useridΗ Παράμετρος είναι το id του εγγεγραμμένου χρήστη.
sessionidΗ παράμετρος είναι το sessionid, που χρησιμοποιεί ο πελάτης σας εκείνη τη στιγμή.
purchasepriceΗ Παράμετρος είναι η τιμή του προϊόντος.
nameΗ Παράμετρος είναι το όνομα του προϊόντος.
timestampΗ Παράμετρος είναι το timestamp της αγοράς. Π.χ «2021-3-22 19:30:10».
tokenΗ παράμετρος μπορεί να ανακτηθεί χρησιμοποιώντας το προηγούμενο WS “clienttoken”.

Όλες οι άλλες παράμετροι είναι υποχρεωτικές.