Product Recommendation Systems and E-Commerce Monetization By Citrus

Squeeze more out of online shelf space

e-Commerce websites just got juicy. Thanks to Citrus, retailers can now unlock the true potential of e-Commerce by monetising online shelf space whilst enabling brands to target customers more accurately. Now that’s refreshing.

Citrus for Retailers Citrus for Suppliers

Watch the Retailer Video

Watch the Supplier Video

Refreshingly Developer Friendly

At Citrus, we think great code is sweet fruit from heaven. We’re infatuated with peeling off the layers of unnecessary details and complexities, and we love nothing more than creating beautiful, composable abstractions that deliver durable, delicious solutions.

require_once(__DIR__ . '/vendor/autoload.php');

// Configure API key authorization: TokenSecurity
Citrus\Configuration::getDefaultConfiguration()->setApiKey('Authorization', 'YOUR_API_KEY');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// Citrus\Configuration::getDefaultConfiguration()->setApiKeyPrefix('Authorization', 'Bearer');

$api_instance = new Citrus\Api\DefaultApi();
$context = new \Citrus\Model\Context(); // \Citrus\Model\Context | 

try {
    $result = $api_instance->generateProductAds($context);
} catch (Exception $e) {
    echo 'Exception when calling DefaultApi->generateProductAds: ', $e->getMessage(), PHP_EOL;
Content-Type: application/json
    "catalogId": "string",
    "customerId": "string",
    "searchTerm": "string",
    "productFilters": [
    "categoryHierarchy": [
    "substitutedProductGtin": "string",
    "pageType": "string",
    "currentCartItems": [
            "gtin": "string",
            "quantity": "number",
            "regularUnitPrice": "number",
            "totalOrderItemPriceAfterDiscounts": "number",
            "adId": "string",
            "citrusDiscountAmount": "number",
            "substitutedFor": "object"
    "maxNumberOfAds": "integer"
<script type="text/javascript">
  var citrusAd = CitrusAd.init({
    disableTracking: false,
    overrideApiAddress: ""
      Above address determines which environment clicks and impressions are being reported to.
      - Staging:
      - Production AU:
      - Production US:
  citrusAd.reportClick('adId', 'teamId').then(function (result) {
  }).catch(function (error) {
  citrusAd.reportImpression('adId', 'teamId').then(function (result) {
  }).catch(function (error) {
Full API reference Or connect automatically with our Magento plugin
Magento logo Coming December 2017

Give Citrus a Try, You’ve Got Nothing to Lose

Every minute you wait to get started with Citrus is a minute you’re missing out on potential revenue or sales. Take a trial today and see just how amazingly easy Citrus is to use, and just how easy it is to get that metaphorical old school cash register singing.
Try Citrus For Free Request a Demo

Tasty Features and Benefits

However you slice it, whether you’re a retailer, supplier or a consumer, everyone in the value chain wins. There’s the cool revenue generating functionality for retailers, the sales boosting tools for suppliers, and the oh-so-easy-to-use and ultra personalised experience for customers. Finally everyone gets a piece of the action.

Effortless Monetisation

There’s literally thousands of ad spaces and potentially millions of page views in your website just waiting to be picked off. The time for Citrus to harvest them for you is now.

New Revenue

Why let the big search engines and social media get their sticky fingers into your money? Let’s bring digital advertising revenue back into the industry where it belongs.

Control & Visibility

Lack of control and ROI of your digital expenditure leaving a bad taste in your mouth? Wash it away with a double shot of transparency, real-time reporting and control like never before.

Timing Is Everything

Citrus serves up your targeted ads right at the point of purchase, where the action and customers really are. No more spraying and praying here.

Precise Targeting

Stop wasting your budget on hit and miss campaigns. Citrus gives you the ability to target exactly who you want right down to the products they buy at a particular store.

Crystal ROI

See impressions and clicks convert directly into sales. There is no grey area at Citrus when it comes to your ROI, you will see exactly how your money is going. Like a bite?

Starting with Citrus is Simple

Do you like to jump in head first, or do you prefer a little help along the way? Everyone’s different, so that’s why we offer a wide range of implementation and support services. Just let us know how you’d like to move forward and we’ll help you make it happen.

Do it Yourself

Our easy to swallow and follow guides will get you going in a flash. Zing us an email anytime if you need help.

Let Us Help You

Cut to the chase we’ve got Citrus specialists ready for action and waiting to help you. Start reaping the rewards.

Work with a Partner

We understand your busy, work with an independent Citrus expert to get the results you need. They will make you the office champion in no time.

Need To Chat First? We’re Here To Talk
Contact Us  Request a Demo