Upgrading from Personalization 3 to Personalization 4¶

Switching to Personalization 4¶

To migrate your account to use Personalization 4, complete the following steps:

1. 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.

2. Sign in to Personalization.

3. Navigate to Configure > Customer sites.

4. In the Customer Site Detail section, ensure each Site ID has a value for the URL field.

5. Contact Acquia Support to request to switch to Personalization 4. Support will activate the new version.

6. Sign in to your Drupal website, and then navigate to Configure > Personalization.

7. In the Personalization Credential section:

   • Change the Assets URL value to: builder.lift.acquia.com.
   • Copy the following Decision API URL depending on your region:
     • North America (US-East-1): https://us-east-1-decisionapi.lift.acquia.com
     • Europe (EU-Central-1): https://eu-central-1.lift.acquia.com
     • Asia/Pacific (AP-Southeast-2): https://ap-southeast-2-decisionapi.lift.acquia.com

8. Click Save.

Migrating the content¶

Migrate some or all your content using the following procedure:

1. Review your existing websites to ensure your rules have unique names.

2. In Personalization, click Migrate. The Migrate: Select Migration Type dialog box displays.

3. Select a migration type:

   • Entire account
   • Specific site(s)
   • Specific rule(s)

4. Click Next.

5. Follow the appropriate instructions for your migration type:

   Entire account

   Specific site(s) and Rule(s)

   The Migrate: Entire Account dialog box displays. To migrate your account, click Migrate.

   The Migrate: Specific site(s) screen displays.

   1. Use the filter and select a check box to choose a specific website.

   2. Click Next.

   3. 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.

   4. Click Migrate.

   5. 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.

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.

Downgrading to Personalization 3¶

If you must return to Personalization 3, use this procedure to change the Assets URL.

1. Sign in to your Drupal website, and then navigate to Configure > Personalization.
2. In the Personalization Credential section:
   • Change the Assets URL value to: https://lift3assets.lift.acquia.com/stable.
3. Click Save.

These procedures will remove the Personalization 4 features.