Setting up Web Push Notification

To enable you to use push notification in your Actito multi-channel strategy, Actito is directly integrated with our Notificare platform, a push notifications solution recently acquired by Actito.

This section will walk you through the instructions you need to follow to set-up the Web push notification channel (on your website).

info

If you only have a mobile-based application, please follow the App push set-up guide.

If you want to deploy the push channel on both your website and your app, you need to follow both guides. The set-up can be in parallel or done one after the other.

Smartphone users may browse the mobile version of your website. As long as it is done through a web browser and not an app, this count as the Web channel.

There are 3 steps:

• Step #1: Setting up the platform(s) configuration

• Step #2: Setting up your website

• Step #3: Setting the prompt to get subscriptions

Step #1: Setting up the platform(s) configuration

To begin with the Push channel, Actito needs to configure the channel to correctly send push notification through Notificare.

This is done by the Actito team but requires your input.

What Actito needs for the configuration

The following material must be provided by you to the Actito team.

Logo

Web push subscription prompts are displayed with a small logo of your brand (like in the example below): we need to define this image in your configuration.

The logo must follow these specifications:

• .png
• 256px/256px

Root domains

• The list of root domains (websites) of the same brand where one can subscribe to push notifications

Languages of the subscription prompt

• The language(s) in which your website is available, so we can translate the subscription prompt.

If you come from another push provider

If possible, we recommend keeping the same VAPID credentials: public key and private key
Please provide them to the Actito team (in the Transfer Box of your license) and follow the migration guide.

What Actito gives you

SDK Configuration Files for the web will be dropped in the Transfer Box of your Actito license.

Actito will notify when the platform has been configured successfully, to you can move on to step 2.

Step #2 : Setting up your website

The technical set-up can be summed up in the following steps:

1. Retrieve the SDK

Log in to your Actito license and go the transfer box app. You will be able to retrieve the right Software Development Kit (SDK), uploaded by the Actito team according to the type of platform.

2. Implement the SDK

You can now follow the Implementation, Device registration and Remote Notifications sections of the implementation guide (with the help of the samples and of the troubleshooting guide if required):

Implementation	Troubleshooting	Resources
HTML implementation	HTML troubleshooting	HTML samples

tip

The Configuration file referenced in the "Implementation" section is the SDK file that you retrieved from the transfer box.

As not every website will use all the features offered by the push channel, the SDK is flexible and you can choose which modules are implemented (see the features supported below).

The minimum functions must be implemented:

• Device registration
• Register as a user
• Requesting permission
• Receiving Notifications

note

The following features are supported in the Actito push notifications module:

Device Registration

• Register as a user
• Override Device Language

Remote Notifications

• Requesting Permission
• Enabling Notifications
• Disabling remote notifications
• Receiving Notifications

We are not supporting the Server Key (legacy) section and the google maps feature.

3. Assign an end-customer ID to a subscribed device

Goal

By registering an end-customer ID to the subscribed device, Actito will be able to connect the device to an existing profile into Actito and build a single view around the profile.

The end-customer ID will be defined by your system (ex: your CRM).

The assignation of the end-customer ID to a device will occur when a profile opts in for push notifications and is known to your system (ex: logged into your site), as long as you have properly configured the "Register as a user" function.

The same end-customer ID must be available in the Actito profile table, to be able to connect the profiles across the 3 systems.

Therefore, to choose the proper end-customer ID:

• The data must be available as a key in Actito thanks to the data synchronization between your system and Actito.
• The data must be available on your website (through logging into a client space).

Please use an attribute which is already defined as unique on your Actito profile table.

info

If you need to add a new unique attribute, this is possible, but be careful because it could have impacts on your data synchronization process between your system and Actito. Ask your Integration Data Expert if necessary.

Step #3: Setting up the prompt to get subscriptions

For web push notifications, we provide a pre-defined prompt with a dialog pop-in. By default, the dialog pop-in will be English. To add more language, please ask us to translate the pop-in. According to the localization of the device, the language of the prompt will be adapted.

The prompt is displayed after 2 secondes following the page view. By default, the prompt will retry every 48 hours if permissions are denied. If you want to change the retry value, please communicate the value of your choice to Actito teams.

info

Alternatively, you can also to manually enable remote notifications, namely to develop your own prompt and integrate it in your website. In such case, you are responsible for overseeing the on-boarding user interface and the entire associated process (Technical implementation needed on your website)

Please inform Actito if you want to create the prompt yourself.

Profile reach

Only profiles who visited the website after the setting is done can be targeted by Actito campaigns.

For Web push notifications, the following browser versions are supported:

Browser	Windows	macOS	Android	iOS
Chrome	YES	YES	YES	NO
Firefox	YES	YES	YES	NO
Safari	N/A	YES¹	N/A	YES²
Opera	YES	YES	YES	NO
Internet Explorer	NO	N/A	N/A	N/A
Microsoft Edge	YES³	N/A	YES	NO
Yandex	YES	YES	YES	NO
Samsung Browser	N/A	N/A	YES	N/A
UC Browser	NO	NO	YES	NO

¹ Available in OS X v10.9 and up as Safari Website Push and as Web Push since macOS 13 and Safari 16.0
² Available in Mobile Safari since iOS/iPadOS 16.4 but only when web app is added to the home screen
³ Available in Edge 17 and up