Darwin & Goliath Integration

Integrating Darwin & Goliath in your website is easy, and requires, in the ideal case, only 5 minutes.

JavaScript Client Integration

To integrate Darwin & Goliath’ JavaScript client in your website, add the following snippet to that part of your page, where recommendations shall be displayed

Development System


<div id="dg-recommendations">
<script src="https://api-dev.darwingoliath.com/client/javascript/jquery.min.js" type="text/javascript"></script>
<div id="dg-partner-id" style="display: none;">$your_D&G_Partner_ID</div>
<div id="dg-app-id" style="display: none;">$your_D&G_App_ID</div>
<script src="https://api-dev.darwingoliath.com/client/javascript/getRec.js" type="text/javascript"></script>
<noscript> <p id="dg-noscript">Please activate JavaScript to see a list of related products created by <a href="https://darwingoliath.com/" target="_blank">Darwin & Goliath</a>, the Recommender-System As-a-Service that provides custom recommender systems for your e-commerce shop, ready-to-run within minutes.</p> </noscript> </div>

Production System


Meta-Data Availability

Darwin & Goliath needs access to your inventory’s meta-data such as for each item


User & Session

<meta property=”dg:user-original-id-hashed” content=”Your user id (hashed) of the current user visiting the page”>

<meta property=”dg:session-original-id” content=”Your session id of the visitor who is currently visiting the page”>

<meta property=”dg:shopping-cart-original-id” content=”Your shopping cart id of the current user”>

Item Description

<meta property=”dg:item-original-id” content=”The ID of the item in your shop”>

<meta property=”dg:collection-original-id” content=”If the item is part of a special collection, provide the id here”>

<meta property=”dg:collection-original-name” content=”If the item is part of a special collection, provide the name here”>

<meta property=”dg:item-title-or-name” content=”The title or name of the item”>

<meta property=”dg:item-description” content=”A product description of the item”>

<meta property=”dg:item-category” content=”Category of the item”>

<meta property=”dg:item-keyword” content=”A single keyword. Create additional tags for each keyword.”>

<meta property=”dg:item-manufacturer-or-brand” content=”Name of the Manufacturer or Brand”>

<meta property=”dg:item-type-main” content=”The main type of the item, e.g. phone, router, tv”>

<meta property=”dg:item-type-sub” content=”A sub-type of the item, e.g. foldable smartphone, wifi router, smart tv”>

<meta property=”dg:item-external-identifier” content=”Key value pair of an external identifier, e.g. upc-a=042100005264″>

<meta property=”dg:item-first-release-date” content=”The date the item was available on the market”>

<meta property=”dg:item-added-to-catalogue-date” content=”The date the item was added to your shop”>

<meta property=”dg:item-last-update” content=”The date the item was last updated (including price update)”>

<meta property=”dg:item-price-in-eur content=”The price in Euro. The decimal point and thousand seperator can be either ‘,’ or ‘.’, Darwin & Goliath parses it automatically”>

<meta property=”dg:item-price-in-usd content=”The price in US Dollars. The decimal point and thousand seperator can be either ‘,’ or ‘.’, Darwin & Goliath parses it automatically”>

<meta property=”dg:item-feature” content=”Abitrary key-value pair that you can use to specify features of the item. For instance colour=blue or width=30cm or screensize=5.4inch. Darwin & Goliath may use that information to identify related items. “>

<meta property=”dg:item-in-stock” content=”0 if not in stock, 1 if in stock (Boolean)”>

Item Auxiliary Data

<meta property=”dg:item-image-1-url” content=”The URL of your first image”>

<meta property=”dg:item-image-1-dimensions” content=”In pixels widthxheight like 300×400″>

<meta property=”dg:item-image-1-caption” content=”A description of the image”>

<meta property=”dg:item-image-2-url” content=”The URL of your first image”>

<meta property=”dg:item-image-2-dimensions” content=”In pixels widthxheight like 300×400″>

<meta property=”dg:item-image-2-caption” content=”A description of the image”>

<meta property=”dg:item-image-3-url” content=”The URL of your first image”>

<meta property=”dg:item-image-3-dimensions” content=”In pixels widthxheight like 300×400″>

<meta property=”dg:item-image-3-caption” content=”A description of the image”>


<meta property=”dg:app-language” content=”The language of your website in ISO 2- or 3 letters”>

<meta property=”dg:app-version” content=”If you want us to log a version number of your website, feel free to provide this number here as string.”>


Darwin & Goliath will crawl this data from your system automatically. The meta-data can be embedded in your HTML code (e.g. at http://my-company.com/products/id/12234/) or as JSON or XML through an API (e.g. http://api.my-company.com/products/id/12234/)

Data formats we currently support are:

Many content management systems like WordPress have add-ons to provide their meta-data in one of these formats. If you have your data in a different standard format, contact us and we can discuss whether we extend our parser.

Questions to Discuss

  1. If you already have a recommender-system, how can we A/B test a) your current recommender system b) no recommender system c) Darwin & Goliath
  2. What KPIs can we use to measure the success of the recommender system?
  3. How can we get data outside the rec container (e.g. add product to shopping cart; which products were bought?)
  4. How to get the google search terms, or adwords campaign that brought a user to myvolts?