Demandware Cartridge Set-Up

US & Canada only.

Incorporating the bizrate® Survey Cartridge into your store is easily done through the Demandware interface. Start by logging in to the Demandware Business Manager site. This process is for US and Canadian stores only. For stores who require a British, French, or German version, please contact Robert Mumby at our London office at rmumby@shopzilla.com.

1.       Download and Import the bizrate cartridge

Once you have logged in, click on “Site” in the left hand list to see a Site List from which to choose the website to which you wish to add the bizrate Survey Cartridge. Click on the website and then click on the “Administration” option in the left hand list to expand the menu. Within this “Administration” menu, please click on either one of the “Site Development” options (highlighted in yellow below).

Please click on either one of the “Site Development” options

Once in the “Site Development” menu, click on “Import & Export” link. On the Import & Export” page, please select “upload” under the “Import & Export Files” (as highlighted below).

On the Import & Export” page, please select “upload” under the “Import & Export Files”

This will take you to a page to upload the Bizrate_settings.xml file (as shown below).

The Bizrate_settings.xml file

Upon completion of the upload of the Bizrate_settings.xml file, go back to the “Import & Export” screen and select “Import” under the “Meta Data” section (as highlighted below). Then import the Bizrate_settings.xml file to your site.

Upon completion of the upload of the Bizrate_settings.xml file, go back to the “Import & Export” screen and select “Import” under the “Meta Data” section (as highlighted below). Then import the Bizrate_settings.xml file to your site.

2.       Applying the bizrate® cartridge to your website(s)

Once you have completed importing the xml file, click on “Administration” in the left hand list to expand the menu. Within this “Administration” menu, please click on either one of the “Sites” options.  Once in “Sites”, please click on the “Manage Sites” link.

This will open a list of the active sites on the Demandware platform in your account. Click on the site for which you wish to add the bizrate Survey cartridge. This will open the General Settings page for that site. Click on the Settings tab. In the space named “Cartridges,” add the name of the bizrate Survey cartridge (“int_bizrate_survey”) before your store front cartridge name (we called our storefront cartridge “testapp”), and then click “Apply”. In this example and in the highlighted screenshot below, the cartridge name is “int_bizrate_survey:testapp”. Our tests were conducted using the default storefront app from Demandware called SiteGenesis version 2.10.1.

Applying the bizrate® cartridge to your website(s)

3.       Required settings

At this point you are almost done with the setup! You will now customize the standard survey settings.

Please go to the “Sites” menu and choose the site for which you want to customize the settings (“SiteGenesis” is the site name in our example). The options available for that specific site (“Site-SiteGenesis”) will then appear. From this menu, please select “Site Preferences”.

Required settings

In the “Site Preferences” menu, please select the “Custom Preferences” option.

In the “Site Preferences” menu, please select the “Custom Preferences” option.

This will yield a page with all of the standard settings that you may customize. From this list, please select “Bizrate Settings” for the bizrate® Survey cartridge implementation.

From this list, please select “Bizrate Settings” for the bizrate® Survey cartridge implementation.

All of these settings, the “Default Value” for each, may remain the same or may be edited (see Optional Settings below for editing options) EXCEPT for BizrateMID. You MUST change the default BizrateMID to the MID number that bizrate provided to you upon registration at merchant.shopzilla.com (see locating your MID). Please type the correct MID into the open text box provided, and then click “Apply”. If you do not change the BizrateMID to your site’s unique MID, then bizrate insights will not be able to track your data and provide you with free customer insights and ratings reports.

Required settings

4.       Site template modifications

Some site templates need slight modifications in order to allow the bizrate® survey invitations to appear.

Please go to your Demandware Studio to edit the templates. You will be adding one bizrate survey call (a line of code) to one set of templates and another bizrate survey call (a line of code) to the order confirmation or receipt page only.

The first line of code and template update will be for the non-buyer, or visitor, survey. You may put this code on the template for any and all pages of your site for which you may want a visitor to receive an invitation to take a short survey upon completion of their visit. Bizrate recommends that you put this code on all pages except for checkout and any pages subsequent to checkout.

To update your templates for the non-buyer surveys, you will need to put the following line of code in the isml template which will be receiving visitor traffic to call our survey invitation (based on the default or optional settings you set-up).

<isinclude template=“bizratesurvey/nonbuyer.isml”/>

For our example, we put the code in the footer.isml template and placed it right before the footer data. In the SiteGenesis v2.10.1 footer.isml, this will be on line #6 in-between the </iscomment> and <div id=”footer”> tags as shown below.

EXAMPLE

</iscomment>

<isinclude template=“bizratesurvey/nonbuyer.isml”/>

<div id=“footer”>

The second line of code and template update will be for the buyer survey. You MUST put this code on the order confirmation page or order receipt page ONLY. The template for that is pt_orderconfirmation.isml.

To update your templates for the buyer survey, you will need to put the following line of code in your pt_orderconfirmation.isml template. In the SiteGenesis v2.10.1 pt_orderconfirmation.isml, this is on line #74 right after the </div> tag and before the include for the page footer, as shown below.

<isinclude template=“bizratesurvey/buyer.isml”/>

Here is an example of the call incorporated into the standard pt_orderconfirmation.isml code.

EXAMPLE

</div><!– END: main –>

<isinclude template=“bizratesurvey/buyer.isml”/>

<isinclude template=“components/footer/footer”/>

Congratulations! You are done!

Please see our full documentation for Optional Settings and how to QA your implementation.