Upgrading from Personalization 3 to Personalization 4 is a one-time process handled from the central application screen.
During the migration process, slots and rules migrate to the updated format. You can choose which slots and rules to migrate:
To migrate your account to use Personalization 4, complete the following steps:
Ensure the most recent version of the Personalization module is installed and enabled.
Note
This module update is required. If your website has the incorrect version of the module, your upgrade may fail or have other issues.
Navigate to Configure > Customer sites.
In the Customer Site Detail section, ensure each Site ID has a value for the URL field.
Contact Acquia Support to request to switch to Personalization 4. Support will activate the new version.
Sign in to your Drupal website, and then navigate to Configure > Personalization.
In the Personalization Credential section:
builder.lift.acquia.com
.Click Save.
After the saving Assets URL, you can confirm your website is
running Personalization 4 by navigating to any front-page of your website.
With your browser tools open, look for a /decide
network request. If you
see /decide
and not /decide-js
, your website has switched to
Personalization 4.
When your website is using Personalization 4, you can start to create campaigns.
Migrate some or all your content using the following procedure:
Review your existing websites to ensure your rules have unique names.
In Personalization, click Migrate. The Migrate: Select Migration Type dialog box displays.
Select a migration type:
Click Next.
Follow the appropriate instructions for your migration type:
The Migrate: Entire Account dialog box displays. To migrate your account, click Migrate.
The Migrate: Specific site(s) screen displays.
Use the filter and select a check box to choose a specific website.
Click Next.
Select the check box for one or more rules and slots to migrate. Alternately, you may select All, Published, or None.
Note
When selecting Specific rule(s) to migrate, archived rules do not display.
Click Migrate.
A confirmation dialog box displays. Click Confirm migration.
Note
If you have selected a website and some rules and then change the website, the rule selections are cleared. This prevents accidental migration of rules.
The Migrate: Pending dialog box displays. When migration is complete, the Migrate: Success dialog box displays. If the migration fails, the Migrate: Failure dialog box displays. Contact Acquia Support for help.
Note
You can’t close the migration dialog box by either pressing Esc
or
clicking Back in your browser. This behavior prevents unintentional closing
which could cause potential migration problems.
The preceding steps complete the migration process. You are now ready to add new rules, or create campaigns on your Personalization-enabled website.
You may return to the Personalization dashboard at any time to perform other migrations, or click the link in the migration dialog box.
If you must return to Personalization 3, use this procedure to change the Assets URL.
https://lift3assets.lift.acquia.com/stable
.These procedures will remove the Personalization 4 features.