To use the Product Guide in your website or shop, you need to configure the integration code and put it into your site. Following pages describe the possibilities and parameters in detail.
The integration code consists of two components:
<!-- begin excentos site integration code --> <script src="//environment/projectName/systemName/applicationName/locale/loadadvisor?theme=themeName"> </script> <!-- end excentos site integration code -->
Parameters used by the integration page
excentos will provide you a separate document for your project-specific documentation of the parameter values used for your Product Guides. This general documentation only describes the meaning of the parameters and shows some general examples.
Describes the host name of the excentos webservice.
service is used for "live production systems", and stage is used to test changes before being deployed live.
You shall provide separate integration pages per environment; please see our documentation on the environments and how to use them to effectively test, integrate and operate the Product Guides.
Your project name that can be used across several systems and applications.
|systemName||DE, UK, FR, B2B_FR|
The system name defines a specific range of products and a specific configuration, often for one market or country.
excentos typically uses the country's ISO country in uppercase letters but it can be anything, even a brand name.
Options that can be changed from one system to the others are e.g. product assortment, prices, recommendation behavior, question flow, list of questions and answers displayed, content and images, general behavior. A systemName can also be used to model B2B versus B2C applications based on the same core.
Name of the Product Guide application.
|locale||de_DE, en_UK, de_CH, de_AT, fr_CH|
The locale defines the language content displayed in the Product Guide.
excentos typically uses the ISO code (but can deviate from it if required).
The locale can also be used to model different content for different target groups, e.g. a binocular Product Guide can use hunting-language and images for hunting fans and birding-language / images for bird observation gurus (and yes, these two target groups need to receive different buying arguments).
|themeName||mobile, desktop, default, river, sunrise, earth|
The theme defines the HTML/CSS style used by the Product Guide.
Every application can use several themes (e.g. Bike Advisor long pager, Bike Advisor Wizard. One theme can be used across different applications (e.g. Bike Advisor and Jewellery Advisor use the same Wizard). A theme can also be used to distinguish between several brands or to style the user interface for channel partners differently.
Required HTML code
This code is required to display the Product Guide:
<!-- begin excentos content area --> <div id="xc_application"> <div id="xc_application_pane"></div> <div id="xc_loader"></div> </div> <!-- end excentos content area -->
Recommended HTML code
Example including all the required and recommended HTML code:
excentos supports several Environments for effective development, testing and deployment procedures.
excentos requires several Integration Pages to cover Stage and Service Environments for effective testing of changes within the Product Guide and / or your shop or website. Please read the documentation on Service and Stage Environments that also defines which Integration Pages for which Environments you need to provide.
During one browser session users can always return to the Product Guide with all entries still active.
If a user exits the Product Guide to the shopping cart or to product detail pages and returns afterwards all his inputs and entries remain active. excentos saves the user profile and always will show the last rendered view to the returning user. The user make use of his entered data as long as he is in the same browser session.