Integration Option Three

Integration Option Three allows a Retailer to call their E-commerce server for organic products and serve them, then merge and reorder the results after the CitrusAd server has been individually called. This integration method is likely to take the least time to integrate as minimal development resources are required.

Integration Summary

During ad serving:

  • Products are requested from the e-commerce server

  • Organic products are returned to the website from the e-commerce server

  • Organic products are shown on the website

  • Ads are requested to CitrusAd

  • Ads are returned to the retailer's e-commerce server

  • The e-commerce server serves the ads to the website

  • Ads are shown on the website

  • Impressions are reported to CitrusAd

  • Clicks are reported to CitrusAd

  • Purchases related to ads are reported to CitrusAd

For an end user, this means organic listings will show intermittently before product ads are merged and reordered.


Step 1

Customer loads e-commerce website and makes a Category and Sub Category selection.

Step 2

The front end website requests data from each e-commerce server according to categories selected by the customer (e.g Laptop - Windows).

Step 3

The e-commerce server returns the organic product listings to the user's browser.

Step 4

Organic product listings are shown to the user's browser

Step 5

Retailer’s server calls the CitrusAd API and requests ads from the “Laptop - Windows” category. *Retailer also sends customer ID (#13Xv652s) to CitrusAd as part of the Ad request to ensure ads returned are relevant.

Step 6

CitrusAd uses the retailer inventory (catalogue) and sales data to calculate the most relevant ads for the request (for the category and the person viewing the page). Within 50ms CitrusAd will return ads to the Retailer server in the form of product code (GTIN) and URL for Banner Ads.

Step 7

Retailer server sends sponsored products and Banner Ad content to the front end website.

Step 8

The organic listings, Product Listing Ads and Banner Ad content are merged.

Step 9

Retailer records which ads have been viewed and clicked on within the web browser using the CitrusAd Javascript SDK.

Step 10

Retailer reports any ads that have been purchased to CitrusAd.

If you have specific integration requirements, please bring this to the attention of CitrusAd to ensure you are integrated as efficiently as possible.