Skip to main content

Aliases: How to set up and best practices

Setting a leaflet live on your website requires an Alias, which allows you to schedule multiple leaflets for automatic campaign visibility.

Updated over 3 months ago

📖 This guide explains:


What is an Alias?

In order to embed a Horizon leaflet on your website, a unique identifier is needed in the embed code.

A standard part of the embed code is the name of your account - but your account probably has more than one campaign or leaflet, so there has to be something extra in the embed code that points to a specific leaflet.

How do we make a unique identifier in the embed code?

You create an Alias.

An Alias adds an extra, unique piece of code to the embed code, which allows you to embed the right leaflet on your page, at the right time.

Here’s an example of an embed code:

<ip-embed experience="[ACCOUNT_NAME]/[ALIAS]"></ip-embed>

Please note that the embed code isn’t all that’s required to embed on your website. There are other scripts needed to load the leaflet via our API. Read more here.

How to set up an Alias

1. Click on ‘Aliases’ in the left side panel.

2. Click ‘+ Alias’ in the top right.

3. Give your Alias an internal name.

4. Add the slug, which will be the unique identifier.

5. Click ‘+ Add rule´.

6. Set the time the leaflet should be active from.

7. Set the time the leaflet should be active to.

8. Select the Campaign in which the leaflet is located.

9. Select the leaflet.

Finally, click 'Update'. You will then see the rule added. When you add the Alias to the embed code, that leaflet will be displayed during the selected time frame.

How to schedule multiple leaflets on a single Alias

By adding more than one Rule to an Alias, you can control which leaflets are displayed when, and for how long, without changing the embed code.

You can…

  • schedule your campaigns directly from Horizon

  • automatically change the leaflet displayed on your website

All without the need to update the script on your website.

So, once you’ve created the leaflet for the next period, you should create another rule.

1. Under the same Alias, click ‘+ Add rule´

2. Set the time the leaflet should be active from.

3. Set the time the leaflet should be active to.

4. Select the Campaign in which the leaflet is located.

5. Select the leaflet.

Finally, click 'Update', and you'll see there are now multiple rules for the Alias:

Remember to click 'Save'.

This process can be repeated for as many leaflets as you have created that should correspond to the given Alias at a certain time.

Best practices for Aliases

When creating a new leaflet

Add a Rule including that leaflet to the correct Alias immediately and schedule it for the time it should go live.

For example, a weekly leaflet for week 22 should go in the ‘Weekly leaflet’ Alias, or whatever corresponding nomenclature you use.

When to create a new Alias

Aliases should only be created for…

  • specific campaign types (seasonal, weekly, monthly etc.)

  • different purposes (Christmas, Black Friday, etc.)

  • embed locations (your home page, an affiliate page, etc.)

When you shouldn't create a new Alias

If you create a new Alias for each campaign and/or leaflet, you also create extra work for…

  • yourself in setting up the new Alias

  • your development team, who have to implement the new Alias embed code on your website.

Therefore, Aliases should not be created for every new campaign and/or leaflet you make, unless you have a very specific reason for doing so.

How to embed a leaflet on your website

When you have successfully created an Alias, and hopefully scheduled more than one leaflet under that Alias, you can move on to embedding the Horizon experience on your website.

To learn how to embed a Horizon leaflet, read more in our technical documentation.

Did this answer your question?