Documentation

Below is some technical documentation for the installation of Reziew to your site. It's meant for coders and scripters, so don’t worry if you don’t understand this; that’s our job. Get in touch to find out more

Reziew APIs
Reziew's APIs can be used to enhance the default integration on your platform (web, mobile, native apps). They provide an easy way to access review data from your account. The documentation can be found under the below link. The base URL is http://.reziew.com/api/1

API documentation

SEO Rich Snippets (Easy Way)
An easier integration to get the product rating displayed in Google search results (SEO rich snippets using microformats) consists of adding just the strict bare minimum (ratings only) on your page above the fold / below to your product title. The other more advanced way describes how to add review rich snippets using the API as opposed to the rating only. Technically this is done by integrating with the API directly (server to server). You need to call the API Reziew Average Service where you need to pass the sku of the product and it will return the average rating and number of votes. You then need to write this response on your page using a specific HTML structure and style it.

See Sample Code

Inline SEO friendly reviews (Advanced)
Although Google is able to index AJAX and third party embeds since November 2011, you might want to integrate Reziew onto your page to really have sep friendly reviews and let all search engines access your content. We offer this possibility and we recommend using it if you target a market where Bing or other search engines have a significant market share. The inline SEO friendly embed is slightly more complicated than the standard integration because it’ll require you to write some server side code (PHP, ASP, JSP, …).

Page skeleton
The code below is an HTML skeleton, you must include Reziew’s CSS and give it an id “rezCss”, add the javascript tag and write the content loaded with the above method in the div called reziew-area. What is more, you need to add the JS parameters (reziew_options) as a fallback.

Server side code
The server side code can be added anywhere you want, it’s a good practice to integrate it into the header or common functions of your website, but for the sake of the example, it was added directly into the template. Please make sure you leave a CURL timeout and you cache the response for about an hour. This will ensure your website won’t be slowed down by external calls.

See Code

Final setup: Cross domain receiver
As a final setup, you need to login to the admin, go to settings and configure the location for the cross domain receiver, the HTML page is used by the module to communicate from one server to another in Javascript. Please copy the following file to your server: Open http://demo.reziew.com/rpx_xdcomm.html and update the settings with its location.
Data feeds
Reziew can work with remote datafeeds to stay synchronized with you with orders, reviews or products. All feeds should be CSV files. There is no wide / popular standard for CSV files, this is why we defined our specs pretty clearly. All the feeds should be encoded in UTF-8, should have CSV headers and quotes should be escaped with double quotes.

Product feed
This feed may be used once at the initial import or on a weekly basis if the product catalogue is frequently updated.

Order feed
The order feed is an typically imported when going live to invite previous clients to leave a review (depending on the type of product, you can easily go up to one year or data). In addition to that, the order feed can be crawled by Reziew every week/day to download the list of orders and send the invitations to leave a review. In both cases the feeds should keep the same format. The column purchased_at can either be a full date with hour, either just a date. (YYYY-MM-DD)

Review feed
Reziew is also able to import the reviews you already have. The data available in your existing system might be different from what we require. If you have additional information, please contact us. The grade should be either an integer, either a double rounded to one decimal.

See Feeds

Single Signon
If you own an e-commerce site, it’s very likely that you users already have an account, with a name, email and eventually an avatar. If you want to use these users for consistency or safety reasons, we offer you a way to pass these users to the widget or the follow-up email. The information you pass us won’t be stored until the user leaves a comment or a review.

Read More

Post Purchase Email Configuration
Follow-up mailing setup In order for Reziew to be able to send a solicitation email to your clients, we need to know their email address, the product they bought and eventually when to send the email. How does that work? To send such information to Reziew, there is a URL to call (REST service) with several parameters. You can call this url by integrating a pixel on the checkout page for instance or alternatively you can schedule a job on your server to perform a CURL on the given URL.

Read More

Integrating Reziew
The widget is relatively easy to integrate, it only requires you to include a Javascript Tag on your product template. Above the javascript tag, there is a div called “reziew-area”. This div is the placeholder where the content of the widget will appear, you can position this div in your page at the right spot.

Read More