GLAMI TOP integration guide for developers

GLAMI TOP is a service that helps your eshop get customer feedback on your services and the quality of the products they have purchased from you.

1. Implementing the consent collection

Setting up consent collection allows us to find out whether customers want to participate in the GLAMI TOP program and allows you to send GLAMI all necessary transaction information.

Integration instructions

The collection of consent in the form of a pop-up should be collected on the last page of the ordering process - on the payment confirmation page for immediate payment by card or other method, or on the order confirmation page for bank transfer or cash on delivery.

All confirmation pages must use HTTPS.

Since this module triggers the opt-in survey, all the order data in this module must be accurate and correct. Do not cover the opt-in survey with any other content on the order confirmation page.

A) Your shop-system supports GLAMI TOP (no programmer needed)

If your shop-system already supports GLAMI TOP, the integration will be very simple. You can set up the consent collection (point 1) directly in the administration of your shop system. Go to the administration of your shop-system and look for the module for GLAMI TOP. Follow the instructions.

Setup sending of all parameters - all are mandatory. Examples of parameters with explanation can be found in the table below.

After the implementation of the module, it is still necessary to set DNS records (point 2 of this integration guide), for more information see below.

B) Integration with Google Tag Manager (programmer needed)

If you use Google Tag Manager, you can speed up the setup of data collection using a template in the GTM Gallery.

Proceed as in C) Integration with Javascript. Set the sending of all parameters - all are mandatory. Examples of parameters with explanation can be found in the table below.

After the implementation of the module, it is still necessary to set DNS records (point 2 of this integration guide), for more information see below.

C) Integration with Javascript (programmer needed)

Paste the following HTML snippet into the order confirmation page:

<script>
(function (f, a, s, h, i, o, n) {
f['GlamiOrderReview'] = i;
f[i] = f[i] || function () {(f[i].q = f[i].q || []).push(arguments);};
o = a.createElement(s), n = a.getElementsByTagName(s)[0];
o.async = 1; o.src = h; n.parentNode.insertBefore(o, n);
})(window,document,'script','//www.glami.cz/js/compiled/or.js', 'glami_or');

glami_or('addParameter', 'merchant_id','your_GLAMI_TOP_API_Key', 'cz');
glami_or('addParameter', 'order_id', 'ORDER_1');
glami_or('addParameter', 'email', 'name@domain.cz');
glami_or('addParameter', 'language', 'cs');
glami_or('addParameter', 'items', [
 {
 id: 36463570,
 name: 'Long laces, red'
 },
 {
 id: 'XT-27927237',
 name: 'T-shirt with moose pattern'
 }
]);

glami_or('create');
</script>

<script>
(function (f, a, s, h, i, o, n) {
f['GlamiOrderReview'] = i;
f[i] = f[i] || function () {(f[i].q = f[i].q || []).push(arguments);};
o = a.createElement(s), n = a.getElementsByTagName(s)[0];
o.async = 1; o.src = h; n.parentNode.insertBefore(o, n);
})(window,document,'script','//www.glami.cz/js/compiled/or.js', 'glami_or');

glami_or('addParameter', 'merchant_id','your_GLAMI_TOP_API_Key', 'cz');
glami_or('addParameter', 'order_id', 'X95624');
glami_or('addParameter', 'email', 'john@doe.cz');
glami_or('addParameter', 'language', 'cs');
glami_or('addParameter', 'items', [
{
id: 36463570,
name: 'long laces, red'
},
{
id: 'MD-27927237',
name: 'Blue T-shirt'
}
]);

glami_or('create');
</script>