Integration
Implementation

Quin AI Documentation

Quin is a revenue optimisation tool to increase online revenue by tracking visitors in realtime, predicting the next moves in session and enables real time targeting.

This document takes you through how you can connect your website with Quin. Once you insert the connection script and also tracking codes, you will be ready to use Quin. Quin only tracks page views and click events.

Setup

Please insert the following setup code anywhere where you put all your scripts, usually before <body>Don't forget to give priority to this script before calling the "event tracking" scripts

CAUTION: Please don't forget to change the name element with YOUR COMPANY NAME

Event Tracking

Page view events

There are three types of page view events. You can tag the pages according to their categories, such your homepage (www.acme.com)'s category is home, action is click and label is homepage.

Category

home
listing
detail

Action

pageview
pageview
pageview

Label

homepage
breadcrumb
breadcrumb

Home Page Tracking JS

Listing Page Tracking JS

Detail Page Tracking JS

CAUTION: All numeric values like price and discount should be "float". If your data has string format please cast it to float.  You can find the sample code @Breaking Change section.

Click Events

There can be many types of click events. You can tag the button, links or any other elements according to their categories. Click events has only click as Action and their labels should be set based on the information they send.  

Category

listing
detail
cart
checkout
service

Action

click
click
click
click
click

Label

<differs based on action>
<differs based on action>
<differs based on action>
<differs based on action>
<differs based on action>

Events without Extra Information

Please find the events in the Event Implementation

Events with Extra Information

Some click events, e.g. "add to basket" may send extra information like item, item category, price and etc. Please find the events in the Event Implementation

Item object can be null in some categories
CAUTION
: All numeric values like price and discount should be "float". If your data has string format please cast it to float. You can find the sample code @Breaking Change section.
CAUTION: If the event has quantity information, please send the information outside the item object with the 'value' field.

Breaking Change

To convert the string values like price to float you can use the following code

Event Implementation

Event table

Below the table contains necessary events to run Quin to learn customer behaviours.
Category
home
listing
listing
listing
detail
detail
detail
detail
detail
detail
detail
cart
cart
cart
cart
cart
cart
checkout
checkout
checkout
checkout
checkout
checkout
service
Action
pageview
pageview
click
click
pageview
click
click
click
click
click
click
click
click
click
click
click
click
click
click
click
click
click
click
click
Label
homepage
<breadcrumb>
addtobasket
filter
<breadcrumb>
addtobasket
addtofavourites
productinfo
deliveryinfo
comments
quantity
quantity
gotocart
continueshopping
removefromcart
emptycart
checkout
login
discountcode
deliveryfee
address
paymenttype
purchasecompleted
addtobasket
Item.ID <urun kodu>
N/A
N/A
8399479
N/A
8399479
8399479
8399479
8399479
8399479
N/A
8399479
8399479
N/A
N/A
8399479
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
Item.Name
N/A
N/A
Acme LED TV
N/A
Acme LED TV
Acme LED TV
Acme LED TV
Acme LED TV
Acme LED TV
N/A
Acme LED TV
Acme LED TV
N/A
N/A
Acme LED TV
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
Item.Category
N/A
N/A
Electronics> TV> Acme LED TV
N/A
Electronics> TV> Acme LED TV
Electronics> TV> Acme LED TV
Electronics> TV> Acme LED TV
Electronics> TV> Acme LED TV
Electronics> TV> Acme LED TV
N/A
Electronics> TV> Acme LED TV
Electronics> TV> Acme LED TV
N/A
N/A
Electronics> TV> Acme LED TV
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
Item.Price
N/A
N/A
9999
N/A
9999
9999
9999
9999
9999
N/A
9999
9999
N/A
N/A
9999
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
Item.Discount.Price
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
Item.Currency
N/A
N/A
TL
N/A
TL
TL
TL
TL
TL
N/A
TL
TL
N/A
N/A
TL
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
Value*
N/A
N/A
1
N/A
N/A
1
N/A
N/A
N/A
N/A
2
3
N/A
N/A
2
N/A
N/A
N/A
N/A
N/A
N/A
N/A
<total basket size>
N/A
*Value field is a conditional field and it holds:
  • "quantity" when the event has a quantity information
  • "total basket price" when the event is purchase completed