Overview of the Citrus Platform.

What Citrus Offers

If you haven't heard of Citrus before, or you are unfamiliar with what we do, take a look at our Citrus homepage​. In summary, Citrus is a unique digital ad serving engine that provides relevant native Product Listing Ads and Banner Ad content in real time.

Using first party sales data from the retailer, Citrus is able to deliver relevant and personalised ad content to the retailer's e-commerce server in the form of barcode and image URL, each and every time a new page is loaded, and does so in less than 50ms 95 percent of the time.

Citrus makes it possible for your retail e-commerce website to offer Product Listing Ads and Banner Ads to advertisers, thereby increasing retailer revenue. This is done with the "Citrus API".

The Citrus API makes it possible for you (the retailer) to place advertisements on your e-commerce website and email marketing based on parameters that you set. After you define the slots on your websites in which advertisements are placed, the slots become available for advertisers to bid on. You (the retailer) determine which items in your catalog you want to advertise, and Citrus makes it possible for advertisers to bid on the opportunity to advertise those items.

In its very simplified form, Citrus allows advertisers to create Ad campaigns that appear on each retailer's site. Advertisers will be able to promote their products to the top of a retailer's website and track the performance of those products in real time. Advertisers use the Citrus Admin Portal to select products, budgets, advertising strategies and “keywords” that they wish for their products to appear at the top of the page for.

How Citrus Works

The Citrus API is organised around REST. The Citrus API has predictable, resource-oriented URLs and uses HTTP response codes to indicate API errors. This API uses built-in HTTP features such as HTTP authentication and HTTP verbs, which are understood by off-the-shelf HTTP clients.

Authentication to the Citrus API is handled through the use of API keys. These are used during communication between your backend and the Citrus API.

The Citrus API supports uploading products, catalogs, customers, and order information. This data is used in the generation of ads. You can use the Citrus API to request ads and to report on user interactions with those ads.

Integration Workflow Options

We support many integration options depending on your individual infrastructure and needs. See the "Integration Workflow Options" page to learn more: