GLAMI TOP integration guide

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.

You can check whether your shop-system supports this function in the How to connect your store to GLAMI section or directly with the shop-system.

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.

Link to GTM template https://tagmanager.google.com/gallery/#/owners/glami/templates/top-gtm-template.

C) Integration with Javascript (programmer needed)

Adding the opt-in code

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.de/js/compiled/or.js', 'glami_or');

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

glami_or('create');
</script>

Place the code just before the ending html element </BODY>.

Replace the values in red with dynamic values specific to your site and the order.

All parameters are required.

The following table describes the available settings:

Opt-in code example

Variable values are usually replaced on the order confirmation page with the code on the server-side. The following example shows how to implement opt-in code with PHP:

<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.de/js/compiled/or.js', 'glami_or');

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

glami_or('create');
</script>

Troubleshooting

This section describes some common errors you might encounter when implementing opt-in code.