Hello
Welcome to Trustisto Front API documentation. You can use our API to fully integrate you website with Trustisto Mrketing Automation.
If you have any problem with our API our developers are happy to help. You can create your ticket at ...
Initialization
To install Trustisto on you website please embed this code:
<script>
(function(a,b,c,d,e,f,g,h,i){
h=a.SPT={u:d},a.SP={init:function(a,b){h.ai=a;h.cb=b},
go:function(){(h.eq=h.eq||[]).push(arguments)}},
g=b.getElementsByTagName(c)[0],f=b.createElement(c),
f.async=1,f.src="//js"+d+e,i=g.parentNode.insertBefore(f,g)
})(window,document,"script",".trustisto.com","/socialproof.js");
SP.init("WEBSITE_ID");
</script>
Make sure to replace
WEBSITE_IDwith your Website ID.
To start using Trustisto you need to embed our initalization snippet on your website.
You can put this code before </body> (end body tag) or you can put it inside you Tag Manager.
You can find your Website ID here: How to find website ID?
Customer ID
<script>
SP.go('setCustomerId', "CUSTOMER_ID"; // optional
</script>
Make sure to replace
CUSTOMER_IDwith real Customer ID.
You can pass Custommer ID if you wnat to identyfiy users using you ID system.
On Page Load
Homepage
<script>
SP.go('startPage');
</script>
This snippet should be called on the homepage of your website.
Category
<script>
SP.go('categoryPage', {
categoryId: "CATEGORY_ID" // optional, but recommended
});
</script>
This snippet should be called on the category page of your website.
Search
<script>
SP.go('searchPage', {
searchQuery: "SEARCH_QUERY" // optional, but recommended
});
</script>
This snippet should be called on the search page of your website.
Search & Category
<script>
SP.go('categoryAndSearchPage', {
searchQuery: "SEARCH_QUERY", // optional, but recommended, null if category page
categoryId: "CATEGORY_ID" // optional, but recommended, null if search page
});
</script>
In some case search & category are the same pages from the technical point of view. In that case plase use this snippet.
Product Page
<script>
SP.go('productPage', {
productId: "PRODUCT_ID".
product: "PRODUCT_NAME",
link: "PRODUCT_URL",
image: "PRODUCT_IMAGE_URL"
});
</script>
Make sure to replace
PRODUCT_*fields with real data.
This snippet should be called on the product page of your website. You need to pass product information in order to have ability to display those infoormation later in notifications.
Basket Page
Minimal version:
<script>
SP.go('basketPage')
</script>
Full version:
<script>
SP.go('basketPage', [{
productId: "PRODUCT_1_ID".
product: "PRODUCT_1_NAME",
link: "PRODUCT_1_URL",
image: "PRODUCT_1_IMAGE_URL",
quantity: PRODUCT_1_QUANTITY // integer or string
price: PRODUCT_1_SINGLE_PRICE, // float or string
sum: SUM // float or string, qsum = uantity * price
}, {
productId: "PRODUCT_2_ID".
product: "PRODUCT_2_NAME",
link: "PRODUCT_2_URL",
image: "PRODUCT_2_IMAGE_URL",
quantity: PRODUCT_2_QUANTITY // integer or string
price: PRODUCT_2_SINGLE_PRICE, // float or string
sum: SUM // float or string, sum = quantity * price
}]);
</script>
This snippet should be called on the basket page of your website.
You should use verion when you have been using AddToBasket Page Events. So all products have been saved in Local Cache, and we can now get them.
Thank You Page
Order information:
<script>
SP.go('thankYouPage', {
order: {
id: "ORDER_ID",
total: "ORDER_TOTAL" // float ex. 123.00
}
});
</script>
Order information & delivery:
<script>
SP.go('thankYouPage', {
order: {
id: "ORDER_ID",
total: "ORDER_TOTAL" // float ex. 123.00
},
client: {
firstname: "CUSTOMER-NAME",
city: "CUSTOMER-CITY",
email: "CUSTOMER-EMAIL"
}
});
</script>
Full version:
<script>
SP.go('thankYouPage', {
order: {
id: "ORDER_ID",
total: ORDER_TOTAL // float or string, ex. 123.00 or "123.00"
},
client: {
firstname: "CUSTOMER-NAME",
city: "CUSTOMER-CITY",
email: "CUSTOMER-EMAIL"
},
basket: [{
productId: "PRODUCT_1_ID".
product: "PRODUCT_1_NAME",
link: "PRODUCT_1_URL",
image: "PRODUCT_1_IMAGE_URL",
quantity: PRODUCT_1_QUANTITY // integer or string
price: PRODUCT_1_SINGLE_PRICE, // float or string
sum: SUM // float or string, qsum = uantity * price
}, {
productId: "PRODUCT_2_ID".
product: "PRODUCT_2_NAME",
link: "PRODUCT_2_URL",
image: "PRODUCT_2_IMAGE_URL",
quantity: PRODUCT_2_QUANTITY // integer or string
price: PRODUCT_2_SINGLE_PRICE, // float or string
sum: SUM // float or string, sum = quantity * price
}]
});
</script>
Make sure to replace
PRODUCT_*fields with real data.
This snippet should be called on purchase confirmation page.
Order information
You should use this verion when you have been using "Add To Basket" or "Full Basket Page Snippet", and "Save Client" Page Events. So all products & delivery informations have been saved in Local Cache, and we can now get them.
Order information & delivery
You should use this verion when you have been using "Add To Basket" or "Full Basket Page Snippet", but NOT "Save Client" Page Events. So all products informations have been saved in Local Cache, and we can now get them.
Full version
You should use this verion when you have been NOT using "Add To Basket" or "Full Basket Page Snippet", and NOT using "Save Client" Page Events.
On User Action
Add To Basket
This snippet should be called when user add some product to basket.
<script>
SP.go('addToBasket', {
productId: "PRODUCT_ID".
product: "PRODUCT_NAME",
link: "PRODUCT_URL",
image: "PRODUCT_IMAGE_URL"
});
</script>
Make sure to replace
PRODUCT_*fields with real data.
Remove From Basket
This snippet should be called when user remove given product from basket.
<script>
SP.go('removeFromBasket', {
productId: "PRODUCT_ID"
});
</script>
Make sure to replace
PRODUCT_*fields with real data.