Spotler Activate integration (formerly Squeezely)

Squeezely is now Spotler Activate. It is therefore possible that Squeezely is still visible in some places, while Spotler Activate is also mentioned in other places.

You can connect to your Spotler Activate platform by using a Spotler App with REST API. You can find the Spotler App under the tab Spotlight in Apps in your Spotler Activate account. 

Fill in the REST API Key and Secret from your Spotler Mail+ account to make the connection. 

2023-02-22_10h24_14.png

Connecting works as follows: 

squeezely-software.jpg

As shown in the image above, there is a variety of possibilities to use the connection for, such as: 

Syncing contacts

Initial full sync

As soon as you synchronize between Spotler Mail+ and Spotler Activate, all contacts will be imported from Spotler Mail+ to Spotler Activate, and vice versa. This means that all contacts from your Spotler Activate account will be synced to Spotler Mail+. 

 

Contacts are updated automatically

New or modified contacts are updated automatically. This ensures that the right permission field is updated in Spotler Mail+ when Spotler Activate receives an opt-in status for a certain profile. 

The integration also ensures that modified contacts in Spotler Mail+ are updated in Spotler Activate on a daily basis, such as unsubscriptions at permission level. You can create up to three different permission folders between Spotler Activate and Spotler Mail+. If new contacts are added by imports, subscriptions or integrations with other platforms, these contacts will be collected and processed by Spotler Activate automatically as well. These contacts will subsequently be given a unique ID in Spotler Mail+. 

Standard mapping of contact fields 

The following relevant contact fields are synchronized between both systems by default: 

✔️ ExternalContactId (unique ID from Spotler Activate)
✔️ Email address
✔️ Hashed email address (SHA-256)
✔️ Phone number
✔️ First name
✔️ Last name
✔️ Gender
✔️ Date of birth
✔️ Postal code 
✔️ Town/city
✔️ Customer Phase
✔️ Favorite Brand
✔️ Fav. Category 1
✔️ Fav. Category 2
✔️ Fav. Category 3
✔️ Last purchase date
✔️ Last visit date
✔️ Permission(s)

Is it possible to map extra contact fields? 

If you have custom fields in Spotler Activate that you want to keep in sync with Spotler Mail+, such as someone's favorite color, you have to make sure that this field exists in Spotler Mail+ as well. Make sure to use the same name given to the synced profile field in Spotler Mail+ to avoid any confusion. 

Then, you can connect these fields in Spotler Activate. As a user you can set up which field has to be mapped to another. In your Spotler Activate account, go to Apps > Spotler. Syncing works both ways when you map a Spotler Activate field to a Spotler Mail+ field. 

What is the hashed email address (SHA-256) used for? 
The hashed email address (SHA-256) can be used to identify customers that visit your website by clicking a link in an email. You can easily add this feature to all of your links within Spotler Mail+. Go to Settings > Integrations > Webanalytics. Select Extra Parameters and change the status to Active

change_status_extra_parameters.png

Next, click on Edit under Extra parameters. 

edit_scherm_parameters.png

Now you can set up the parameters in the pop-up. 

edit_scherm_parameters.png

Give Parameter 1 a name and the value: email hash. From that moment onwards, a hashed email address will be added to all of your links. 

Syncing audiences 

You have a lot of data at your disposal in Spotler Activate. Think of website behavior, order history, personal preferences and possibly even data from other systems. Based on this data, you can create specific segments that are called audiences. 

Syncing an audience

When creating an audience in Spotler Activate, click on the Spotler channel, Next, click on Save audience. This audience will be synced immediately and updated daily. If contacts are added or dropped as a result, it will be updated automatically in Spotler Mail+ as well. 

How can automatic audience sync be switched off?
If you don't want to sync an audience to Spotler Mail+, you can turn this feature off by clicking on the Spotler logo in the audience edit screen in Spotler Activate. You can turn it on again in the same screen
Is it possible to delete Spotler Mail+ audiences indirectly from your Spotler Activate account? 
It is not possible to delete audiences stored in Spotler Mail+ from your Spotler Activate account. You will have to delete these manually. 

Syncing products  

Initial full sync

As soon as you've made an integration between a Spotler Mail+ account and Spotler Activate, all products are synced from Spotler Activate automatically.

Products are updated automatically

New or updated products are updated automatically in Spotler Mail+. It gives you the possibility to trigger automations with relevant products in the receiver's email, such as abandoned shopping cart automations. 

When an automation is triggered by Spotler Activate, so called 'automationfields' will refer to the right products (ID's) that are placed in a 'productlistblock'. Products are synced from Spotler Activate even if you've already added products from an eCommerce platform. The reason for this being that Spotler Activate doesn't know what product ID's are from other platforms. These products have a visible=false status so that they can be shown in triggered automation emails without showing 'double' products when creating regular newsletters. 

Standard mapping of product fields

The following relevant contact fields are synced from Spotler Activate by default: 

✔️ ExternalProductId (unique ID from Spotler Activate)
✔️ Productname
✔️ Price
✔️ Link (to the product page)
✔️ Image (in 2 different sizes)
✔️ SKU
✔️ Language

Is it possible to map extra product fields? 

You can also sync shows, services, holiday homes and more from Spotler Activate to Spotler Mail+. It doesn't necessarily have to be a physical product from a web shop. You also have the option to add extra custom product features next to the standardized mapped product fields. 

Is it possible to sync orders (or bookings) between Spotler Activate and Spotler Mail+?
It's not standard to sync orders (or bookings) from Spotler Activate to Spotler Mail+, but it is possible. There's no added value in most cases because you can sync audiences and journeys directly from Spotler Activate. This is the better option, because then you can combine it with website behavior and other data. 

Triggering automations

You can trigger automations in Spotler Mail+ from the Journey Builder in Spotler Activate. Make sure to give the trigger a logical name in Spotler Mail+, because this name will appear in Spotler Activate's Journey Builder

Squeezely_journey_02.png

When the automation is triggered, the profile of the person in question will be updated in Spotler Mail+ by using the most recent values as registered in Spotler Activate. 

Using dynamic content from Spotler Activate for personalization

You can show dynamic content from Spotler Activate in triggered email messages. You will need automationfields - placeholders in the email message in Spotler Mail+. When you set up a Spotler Mail+ automation through a journey in Spotler Activate, you can see which automationfields are enclosed in the email in order to personalize it. Just make sure the name of the placeholder matches exactly. 

➡️ Read more on how to use automationfields for dynamic content

Personalizing using relevant products from Spotler Activate

An automationfield can also be of the 'PRODUCTLIST' type. In that case, you can select a 'Product Set' to be shown in the email sent from the automation. 'Last viewed products' for example. Spotler Activate will send the ID's of the right products in the email when an automation is triggered. Spotler Mail+ will then ensure that these ID's will be converted into product blocks. It's important to name the placeholder of your message in Spotler Mail+ 'productlist'. This way, you can show one 'Product Set' in the email. 

➡️ Read more on how to sync products

Personal product recommendations

It is possible to place a recommendation block in your email. This block can retrieve personal recommendations from a CDP like Spotler Activate. Personal recommendations  that apply to the receiver are retrieved the moment the email is sent. The great thing about this is that you can use this feature in triggered emails, even if weren't started in Spotler Activate. You also have the option of placing multiple 'Product Sets' in the email. The only requirement is for your template to have a personal recommendations block. 

➡️ Read more about personal product recommendations

Retrieving forms

If you're using Spotler Mail+ forms (or surveys) for marketing purposes, you can automatically send the data entered in the form to Spotler Activate. You will need to set up a POST request on the form (or survey) in Spotler Mail+. Copy a 'Webhook URL' from your Spotler Activate account under Apps > Spotler. In Spotler Mail+ you will have to specify which questions from the form you want to send to Spotler Activate through the POST.  Use the exact name of the (custom) field in Spotler Activate where you want to send the value in question to. 

➡️ Read more about setting up a POST request

Measuring email clicks 

Contacts that click on a link in an email sent from Spotler Mail+ can be recognized by Spotler Activate. Make sure the unique contact ID from Spotler Activate is enclosed by default in every trackable link. 

Set it up in your Spotler Mail+ account as follows: go to Settings > Integrations > Webanalytics. Select Extra Parameters and change the status to Active


change_status_extra_parameters.png

Next, click on Edit under Extra parameters. 

edit_scherm_parameters.png

Now you can set up the parameters in the pop-up. 

edit_scherm_parameters.png

Fill in email hash as the name in Parameter 1. The value is the unique externalContactId from Spotler Activate. The trackingscript from Spotler Activate placed on the website is now able to register who landed on your website by clicking in the email. 

Connecting multiple merchants 

When you're using Spotler Activate 'merchants', we advise you to link a separate Spotler Mail+ account per merchant. If you don't, new contacts will automatically be added to all Spotler Activate merchants. Seeing as you've chosen to use various merchants, this is something you probably want to avoid.