Page tree
Skip to end of metadata
Go to start of metadata

Business process

This document covers the technical side of Gravity integration. To get the Gravity recommendation engine integrated with your site, the business agreement and specification of your business requirements is necessary. To get more information about the business process please contact us at

Integration steps

To embed our recommendations to your site you have to proceed only three steps:

Step 1: Upload initial data

We ask you to send three different kinds of data to our server:

  • Item catalog - our engine requires the list of the recommendable content (products you are selling, advertisements, videos, etc.) and some additional information like category, name and price. The easiest way to provide this data is to upload a file to our server in one of the available formats. For more information about the file formats and the exact method of uploading check the Item Catalog page.
  • User catalog - if you have registered users on your site you can enhance recommendation accuracy by uploading some information about them. We take privacy very seriously and do not need any confidential data, only anonymous information like unique user id, ZIP code and country code. For more details visit the User Catalog page.

  • User events - the most important part of our recommendation algorithms is based on collaborative filtering. This is why we require you to log user actions and forward them to our server. For more details see the Behavior Tracking 

Step 2: Maintaining item and user catalog

Don’t forget to maintain the uploaded catalog information. The simpliest way to do this is to periodically upload the whole catalog. If you make your catalog files available by HTTPFTP or as an RSS feed you can configure our recommendation engine to update its database automatically. 

If your item catalog not changes very frequently (for example a webshop) then this periodical updates are enough, but if your item catalog changes very frequently (for example a classified site or a video streaming site) then we also ask for real-time item catalog updates. Which can be done by using one of our server side APIs.

Step 3: Displaying recommendation and tracking user events

After the first two steps we have the necessary information to initialize the recommendation engine for your site, and we are ready to provide you and your users high quality, personalized recommendations. The only thing you have to do is display the recommendations on your site and to keep our event database up-to-date by tracking the user events and forwarding them to the recommendation engine. There are two different way to accomplish this:

  • JavaScript - Just embed a few JavaScript snippets into your site, and customize our HTML template to fit it into your site’s look and feel. More information about this is available here: JavaScript API
  • Server side - If you are willing to implement the widget displaying the recommendations yourself, then you may opt for the more secure, server to server communication method. For more information, visit the Server API site.
JavaScript integrationServer side integration

We take care of everything else

In the background, we process your data and continuously improve the quality of the recommendations we provide you. To speed up the process we have templates for different kind of websites, however if you have some special requests you can contact us anytime.



  • No labels