Integration Methods

To get Exorbyte Commerce to work properly, you have to meet some basic requirements:

  • Use Browsers with activated JavaScript and versions of at least: FireFox 3.5, Internet Explorer 7, Chrome 4, Safari 4
  • Your Shop System should use JQuery 1.4.2 or should be compatible to that.
  • Your Web Server should use one of the languages: ASP, PHP, Java
  • Your Product Data has to be available via any URL (password protection is optional) and has to be stored there in a supported data format (see below).

Exorbyte Commerce is integrable basically into every shop system via a simple code snippet.

If you may have questions, please do not hesitate to contact our support. We are happy to help you.

t exorbyte Commerce Search voll funktionsfähig läuft, sollten lediglich folgende Voraussetzungen erfüllt sein:

¡    Nutzung von Browsern mit aktivem JavaScript bzw. Active Scripting und folgenden Mindestversionen:

      FireFox 3.5, Internet Explorer 7 und 8, Chrome 4.0.24, Safari 4

¡    Ihr Shop-System sollte JQuery 1.4.2 nutzen bzw. dazu kompatibel sein.

¡    Ihr Webserver sollte eine der Sprachen nutzen: ASP, PHP oder Java

¡    Ihre Produktdaten müssen über eine beliebige (passwortgeschützte) URL abrufbar sein und dabei in einem

      unterstützten Datenformat abgelegt werden (siehe unten).

 

Falls Sie hierzu Fragen haben sollten, zögern Sie bitte nicht, unseren Support zu kontaktieren.

Wir helfen Ihnen gerne weiter.

Step 1: Choose a package and register

Select your desired Exorbyte Commerce package and click on "30-day trial". Create an account by easy registration. You are logged into your account immediately and the 30-day trial period begins. Once your package selection has been confirmed, you have basically created a project. This takes you directly to the project settings.

Step 2: Prepare and store product data

Supported Data Formats

 

Exorbyte Commerce accesses your product information via a URL (password protection is optional), and automatically indexed for searching. This requires that the product information is exported in a supported format. Several common data formats are supported. As a rule, these can be created or exported directly from your shop system.

If you need help for this, please click on one of the suppliers. There you will find clear instructions on creating the respective data formats.

 

File Formats
Billiger.de Google (UK, US) Elm@r Shopping.com Yahoo
CSV (tab) Yes Yes Yes Yes -
Excel CSV Yes - Yes Yes -
XML RSS1 - Yes - - -
XML RSS2 - Yes - - -
Atom 0.3/1.0 XML - Yes - - -
Shopping XML - - - Yes -
Yahoo XML - - - - Yes

 

Data Field Names

 

Billiger.de

Google
(UK, US)

Elm@r

Shopping.com

Yahoo

Description

aid

id

privateid

Merchant SKU

id

Product number: required, used by Auto-Suggest and Search, not displayed

name

title

name

Product Name

description

Product name: required, used by Auto-Suggest and Search, displayed

link

link

url

Product URL

url

Direct URL to the product: required, called when the user clicks on the product

price

price

price

Price

baseprice

Price: required, Plichtfeld, unit-separator character must be "." (e.g. 5.99), can be filtered on the results page, is displayed in the Search, can optionally be displayed in Auto-Suggest (please contact support if required)

brand

brand

brand

Brand / Manufacturer

brand

Brand: displayed as facet on the results page and can be filtered, can be configured to be displayed in Auto-Suggest, is searched by Auto-Suggest and Search

shop_cat

product_type

type

Category ID / Category Name

path

Product category: displayed as facet on the results page and can be filtered, can be configured to be displayed in Auto-Suggest, is searched by Auto-Suggest and Search.

Note on Shopping Format: If the Category_ID field is present, the category IDs of the shopping format during import are replaced by the relevant category descriptions.

isbn, ean, mpnr

isbn, mpn, upc

isbn, ean

ISBN, MPN, UPC, EAN

isbn, ean, mpnr

Other product numbers (such as isbn, ean, mpnr): searched by Auto-Suggest and Search, is not displayed

desc

description

longdescription/ shortdescription

Product Description

caption

Product description: is searched by Search but not by Auto-Suggest, is displayed on the results page

Note on the Elm@r Format: Longdescription or Shortdescription: If Longdescription ist present, then only this is searched.

image

image_link

pictureurl

Image URL

picture

URL to the product image: the images are displayed on the results page

dlv_time

availability

deliverable

Estimated Ship Date

availability

Availability: arbitrary content (e.g.: in stock / dispatched in 3-5 days / delivery date on request), can be used for displaying delivery status on the results page (please contact support for details)

bias

bias

bias

bias

bias

Bias: percental weighting of the match quality, values between 0 and 100

Example: normal products have a bias value of 100, so the calculated match is not devalued. Accessories have a bias value of 80, so accessories are devalued and are displayed below unbiased products when similar.

Important: If you use biasing, all products must be assigned a bias value. Products without a bias value are evaluated as 0 and are thus devalued.

alias

alias

alias

alias

alias

   
Alias: additional keywords for the product, separate multiple aliases with pipe-characters ("|") (*), searched by Auto-Suggest and Search, words are not displayed

Note: use concise terms with which the product should additionally be found, do not use long descriptions (roughly between 1 and 3 keywords).

(*) Do not use pipe to separate aliases if pipe is also used as the field separator in a CSV file. In this case, multiple single words can be separated by a blank space. Alternatively, use a field seperation character other than pipe in the CSV file.

filter

filter

filter

filter

filter

Filter: additional attributes of the product as a key-value pair can be used as a filter to restrict search results. Several attributes are concatenated with "&". Format: key = value1, value2
Example: color = red = & Equipment Air Conditioning, Power Steering

Note: Use matching attribute name for all products.

 

Store Product Data and Test

Your logged into the Management Console and you are on the page „Project Settings“

 

Step 3: Integrate into Your Online Store / Portal

  • Click on “Shop Integration” in the navigation bar on the left and fill out all necessary fields. Please choose the approach “Pure JavaSript”, so you do not have to install Exorbyte Commerce on your own webserver.
  • Click on “Test Your Integration Now" in the navigation bar on the left to see your store with the new search. Test the search simply with some search queries. Please note that you have not made any design settings yet.
  • Please click on “Submit for Setup” if everything is shown properly. You will receive an email requesting to integrate the attached code snippet into the header (head tag) of each page the search is utilized.

So the basic integration is done. Now you can configure the search as required.

Note: If you would like to install Exorbyte Commerce on your own webservers and/or have more than 100,000 searches per month, we recommend that you proceed as described in this pdf.

If you may have questions, please do not hesitate to contact our support. We are happy to help you.

Exorbyte Commerce Search ist generell in alle Shop-Systeme per einfachem Code-Snippet integrierbar.

Step 4: Configure your project as required

Now you can configure your new search software Exorbyte Commerce as required, according to your chosen package. Please bear in mind that you have to click on "Submit for Setup" for each change. When integrating with JavaScript, it is not necessary to adapt the code.