Dandomain Webshop

This guide walks you through how to set up the integration between Dandomain Webshop and Heyloyalty. The purpose of the integration is to give you the opportunity to work data-driven with email marketing and marketing automation by utilizing both purchase and behavioral data from your webshop. The guide takes you step by step through the setup – from the necessary preparations to the technical implementation – so you can quickly and easily get started creating more relevant customer experiences and strengthening your customer loyalty.

The value of integration

If you run a webshop and want to build stronger relationships with your customers – without spending hours on manual work – then this integration is for you. With Dandomain Online Store and Heyloyalty connected, you get access to your customers’ behavior and purchases, which you can use to communicate more relevantly, personally and effectively.

Increased loyalty
When you start working with marketing automation and personalized messaging, you can meet your customers with content that actually matters to them. This creates a better relationship – and ultimately more loyal customers who want to come back.

Improved customer experience
Your customers today expect relevant and timely messages. With data from your online store, you can automatically send content, offers and information tailored to the individual customer – creating an experience that feels both personal and valuable.

Targeted communication
Instead of sending the same thing to everyone, you can segment your customers and target the right audiences with the right messages. This makes your communication more precise – and far more effective.

Dropout prediction and prevention
With insights into your customers’ behavior, you can identify those who are losing interest. This allows you to intervene in time with relevant campaigns and automated flows to retain more customers.

Streamlined processes
Automating your marketing activities saves you time and resources. You’re freed from manual work and can focus on growing your business – while the system makes sure you send the right messages to the right people.

Turn your webshop visitors into loyal customers. With the 2-way integration between Heyloyalty and Dandomain Webshop, you can work data-driven with email marketing and marketing automation – and get better results with less effort.

Before you begin

To make it easier for you, we recommend that you read the frequently asked questions and find the various documents, IDs, login information, etc. that you will need for the setup. See more below.

Frequently Asked Questions

Do I need a developer?
No.

How long does it take to finish setting up the integration?
Depending on how well you know Heyloyalty and DanDomain, it probably takes somewhere between 10-30 minutes.

Does the integration retrieve backward data?
Yes.

Do I need access to other systems?
You must have access to Heyloyalty – and your Heyloyalty account must be active.
You must also have access to the DanDomain backend.

Which data is being imported?
Read the Fields in the integration section at the bottom of this page for the full overview. Basically, all behavioral data from the webshop is included as well as all purchase data.

Can I segment on data coming through the integration?
Yes. Any data that comes through the integration can be used to segment your future communication. You can also use this data to start and stop your flows.

What you need to set up the integration

You should have Heyloyalty open in one tab.

• A tracking integration Read more about Tracking here
• Open the DanDomain backend in another tab.

The integration operates via Dandomain Webshop’s API and Heyloyalty’s tracking database. Read more about Tracking here.

Setting up the integration

With the above preparation, you are now ready to set up the integration between Dandomain Webshop and Heyloyalty.

Create API client

Set up the API in your Dandomain Online Store via Settings –> API –> Create API client –> Enter a name. The name is secondary and for your own use only. You can optionally just call it Heyloyalty. Finish with Save.

Enable API:SOAP access in your Dandomain Webshop via Settings –> API:SOAP –> tick.

Create employee

Use your own user profile or create a new ‘fictitious employee’ (or a dummy user) that is linked to the integration. Please note that if this user is deleted at some point, the integration will stop working until a new employee in Dandomain Webshop is connected to the integration.

Set up or create the employee in your Dandomain Webshop via Settings –> Employees –> Create employee –> Fill in the information. For Application access, the employee must have access to the API (Has access to the SOAP API).

NOTE! The user’s email must not contain ÆØÅ. In addition, be  sure  to save the email and username of this employee, as you will need both to set up the integration in  Heyloyalty  later!  

Finish with Save.

Create or use product feed

The integration automatically downloads your Google Shopping Ads price portal – i.e. your product feed.

Double check that this price portal is active via Sales channels –> Price portals –> Google Shopping Ads. Make sure that Active is checked and that under products it says all. Then you can save the settings.

Tip: You can use a feed other than Google Shopping Ads, but you need to set it up and map it in Heyloyalty yourself.
See the guide here.

Create the integration in Heyloyalty

Now you open Heyloyalty.

Integrations –> Integrations –> Integrate with HostedShop –> Set Up Integration

Fill in the information. The Email and Password must be the email and password of the employee you created or used above in the section Create employee.

You will find the shop ID in the top right corner when you are logged in to your backend on Dandomain Webshop. An example of a shop id is shop123456.

Subscriber distribution is recommended to be on Overall on a list. This will make it easier for you to manage your members in the future and avoid duplicates.

Double opt-in to the lists is left on Do not use double opt-in. This can be changed in the settings on the list afterwards, but for now, you need to leave it on Do not use double opt-in, because the integration will automatically retrieve all your members who have signed up for your newsletter.

Avoid subscribing currently unsubscribed member, you also leave the page Fetch unsubscribed members and add them to list, because a customer may have unsubscribed by mistake, or wants to hear from you again.

In Shop settings, fill in four fields.

• API ID and API secret .
  Found in the Dandomain Webshop backend:
  Home –> Settings –> API –> Click on the name of the API client in the ‘Set up API’ section.

• ID for orderstatus: bought (You can read the default values in the next paragraph, but if you haven’t changed the default settings, you can simply move on to the next step)

• ID for orderstatus: annulled (You can read the default values in the next item, so if you haven’t changed the default settings, you can simply move on to the next item)

The different IDs for order status can be found in Dandomain Webshop here:

Settings –> Store settings –> Orders –> Create and edit order status

By default, the order status for purchases is 1,2,3,4,6,7,8 and for canceled it is 5.

Note: There must be a comma between the order status numbers and no spaces in the order status field.

For purchases, look for the following order statuses: Ordre modtaget, Under behandling, Afsendt, Klar til afhentning, Delvist afsendt og Afhentet:

For order status cancelled, look for Canceled, which in the above screenshots is 5 (which is the default).

Tip: If you have NOT changed the order status IDs, you can leave these fields empty in the integration setup in Heyloyalty below.  

This means that the integration page in Heyloyalty is filled in something like this:

Your integration is now ready and will fetch all future transactions from Dandomain Webshop.

Tip: If you get an error message here, contact Heyloyalty support.    

Create Tracking in Heyloyalty

Tip: If you do not have a Premium license, follow the steps below anyway, but select the Lost basket trigger option instead of Tracking under List integrations.

Set up Tracking by clicking on Integrations –> List Integrations –> Tracking –> Setup Integration –> Create new Tracking.

Fill in the fields.

Note: Under the product feed option, select “Google Shopping Feed” as the integration has created this feed from your DanDomain webshop.

If you need help filling in the fields, read this guide

Remember to change Connecting HostedShop buying behavior to Yes. You can only do this if you have a Premium license. If you have a Basic license, you need to leave it at No.

Create Script for Tracking

Create your tracking script by visiting the https://tracking.heycommerce.dk/gettrackingscript page.

Leave the field Hvilken webshop har du i dag on Smartweb.

Select the session time, type the same number you selected in the previous point. The standard will be 45.

Then you need to have your API key in Heyloyalty, you can find it in Heyloyalty via Settings –> Account Information –> API key (copy the entire API key).

Paste the copied API key and press Create tracking script.

A script is now being generated. Copy the entire script (including the line break at the top and indents).

Tip: The script looks like this (the two yellow markings are unique in your script and should be replaced with your own API key and your chosen session time): 

            <script> 
                            var hlt; 
                            var HLTrackingLoaded = function (HLTracking) { 
                                hlt=HLTracking; 
                                HLTracking.initialize(‘HERE-IS-YOUR-API-KEY’, HERE-IS-YOUR-SESSION-TIME); 
                                HLTracking.trackEvent(‘Visit’); 
                            } 
                            </script> 
                            <script> 
                            (function (d, t) { 
                                var g = d.createElement(t), 
                                    s = d.getElementsByTagName(t)[0]; 
                                    h = “https:” == document.location.protocol ? “https://” : “http://”; 
                                    g.src = h + ‘tracking.heyloyalty.com/smartweb.js’; 
                                s.parentNode.insertBefore(g, s); 
                            }(document, ‘script’)); 
                            document.onsubmit = function(e) { 
                                hlt.trackClick(e); 
                            } 
                            </script> 

Implementation of tracking in DanDomain Webshop

Paste the newly copied script as Javascript into your DanDomain Webshop backend.

Find it by logging in to DanDomain Webshop — > Sales channels –> Online Store –> Design –> Actions –> Insert Javascript –> Page content (bottom)

Finish with Save.

Tip: If you have multishop in DanDomain Webshop, please contact us for help generating a script that can work across your different webshops.  

Note: Our standard tracking script can only be used on standard hosted shops. If customer development has been implemented on your webshop, it may affect the tracking script and it may not work as expected. You can check the different events under the activity feed. It can be found in Heyloyalty here: statistics > activity feed. 

Check if the integration is set up correctly

Once you’ve finished setting up the integration, it’s a good idea to check if it works as expected.

You can start by checking if a list has been created in Heyloyalty. The list will typically be called something like *_total. It can also be called, for example, *DK_samlet if you have multiple language layers in your online store.

If your product feed is mapped correctly, you will be able to insert a product feed when setting up campaigns. Here you will have the opportunity to search for your products directly in Heyloyalty. You can read more about how to insert a product feed here.

If you have inserted the tracking script on your website, you should also check if behavioral events from your webshop are registered in Heyloyalty. You can see this under Activity feed. Remember to choose the right list.

General information about integration

Worth knowing about the integration

Once the integration is set up, Heyloyalty fetches all historical purchase data on the members that are created.

If a customer has purchased four times in your webshop but only chooses to sign up for the newsletter in connection with the fifth purchase, then this person will be created with five orders attached.

Fields in the integration

If you want a complete overview of the fields in the integration, you can see it in the fields in the list you have connected the integration to.

Lists –> ⁝ –> Edit list. Scroll down to the bottom and see all the custom fields that are on the list and that you have mapped as part of the integration. The integration creates Postal number, Customer ID, Customer type, User group.

NOTE! The rest of the fields are in the tracking database 

It will be through Tracking that you can segment on e.g. last purchase date or have purchased for at least x kroner.

---