Library configuration

In this topic, you will work on deploying the Personalization library on your channel and then configuring the zones of the channel.

📘

Important

As a best practice, any updates to Personalization library should first be validated in a non-production environment before upgrading the production website.

Prerequisites

Ensure that you have:

  • Registered Acoustic Personalization endpoints in Acoustic Exchange and Exchange Capture.
  • Registered your analytics library in Acoustic Exchange and Exchange Capture.
  • Configured your analytics library to interact with Acoustic Exchange.

Now that you have completed the prerequisites, let's deploy the Personalization library.

Step 1. Identify your channel type

The first step to installing the Personalization library is to identify your channel (website) type. Acoustic Personalization currently supports the following types of channels:

  • Multi-Page applications (MPA)
  • Angular JavaScript Single-Page Application (Angular SPA)
  • React JavaScript Single-Page Application (React SPA)

The installation process differs based on the channel type.

MPAAngular SPA and React SPA
Deploy Personalization library in Acoustic Exchange CaptureDownload and install the Personalization library from the Acoustic Artifactory
Specify the Personalization library version in Acoustic Exchange CaptureSpecify the Personalization library version during installation
Configure the zones using code snippets specific to MPAConfigure the zones using code snippets specific to Angular SPA or React SPA

Step 2. Choose the library version

Check out Library versions topic for a list of supported versions and tips for selecting the best version for you. If you are configuring Acoustic Personalization for the first time, it is recommended that you deploy the Stable version of the library.

Step 3. Configure the library

Library configuration consists of deploying the Library and then configuring the channel zones by adding the personalization script.
Based on your channel type (MPA or SPA), choose the relevant topic from the following section for detailed instructions.

For MPA

  1. Deploy the library for MPA
  2. Configure the zones of MPA

For SPA

  1. Install the library for SPA
  2. Configure the zones of your Angular SPA channel or React SPA channel.

Acoustic Personalization can now interact with your channel to display the personalized content.

Next steps

After you complete these steps, the zones of your channel are ready to display the personalized content. Your marketing team can now begin creating the required personalization rules or create product recommendations strategies!

In addition, you can also set up the additional features described in the Developer workflow.