Skip to content

Update migrate-from-umarketingsuite.md #6633

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Nov 13, 2024
Merged

Update migrate-from-umarketingsuite.md #6633

Changes from 2 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
1a7b12d
Update migrate-from-umarketingsuite.md
Jette94 Nov 7, 2024
3778524
Update 13/umbraco-engage/upgrading/migrate-from-umarketingsuite.md
Jette94 Nov 7, 2024
ccd1955
Fix the ordered list
sofietoft Nov 8, 2024
178c40e
Update migrate-from-umarketingsuite.md
Jette94 Nov 8, 2024
6b22204
Update 13/umbraco-engage/upgrading/migrate-from-umarketingsuite.md
Jette94 Nov 8, 2024
81f8969
Update migrate-from-umarketingsuite.md
Jette94 Nov 13, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 14 additions & 6 deletions 13/umbraco-engage/upgrading/migrate-from-umarketingsuite.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,10 @@ The result should look like this:

If any of these checks return a failure, please resolve the issue before proceeding with the migration.

{% hint style="info" %}
If you do not use Umbraco Commerce or Umbraco Forms, the list of results will be shorter.
{% endhint %}

## Step 3: Replace NuGet packages and dependencies

In this second step, you will replace all existing uMarketingSuite dependencies with Umbraco Engage dependencies.
Expand Down Expand Up @@ -123,11 +127,11 @@ Based on the [Key Changes](migrate-from-umarketingsuite.md#key-changes) below up

Please find below an overview of the changes to the default scripts in a uMarketingSuite installation:

* All scripts & Asset Paths containing the `uMarketingSuite` keyword are renamed to:
* All scripts & Asset Paths containing the `uMarketingSuite` keyword will need to be renamed to:
* `Assets/Umbraco.Engage/Scripts/umbracoEngage.analytics.js`
* `Assets/Umbraco.Engage/Scripts/umbracoEngage.ga4-bridge.js`
* `Assets/Umbraco.Engage/Scripts/umbracoEngage.blockerdetection.js`
* The Cockpit Partial View has been moved to:
* The Cockpit Partial View has been moved, and needs to be changed to:
Copy link
Contributor

@sofietoft sofietoft Nov 7, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure about this one.
Do you need to move the files yourself, or do they need to be renamed or changed? 🤔

Copy link
Contributor Author

@Jette94 Jette94 Nov 7, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

By replacing the uMarketingSuite Cockpit with Engage, the location will change - therefor you will need to change the path of the cockpit in the template :D

Copy link
Contributor

@sofietoft sofietoft Nov 8, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Alright! And which template is this exactly?
Just wondering if we should make that clearer, as currently it sounds like something needs to be moved to change a path 😅

Copy link
Contributor Author

@Jette94 Jette94 Nov 8, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's the template for the page setup! If set up in a master template, that would be it. It needs to be in the bottom of the tag

Copy link
Contributor

@sofietoft sofietoft Nov 12, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Alright. Should we do something like this instead then:

"The Cockpit partial view has been moved, and any references should be changed to:"

*  `Partials/Umbraco.Engage/Cockpit`
* If you are tracking custom events please make sure to update the calls to the send event method:
* `ums("send", "event", "<Category name>", "<Action>", "<Label>")`
Expand Down Expand Up @@ -253,12 +257,12 @@ Run this script to migrate all the Umbraco data.

## Step 6: Finalize the migration

1. Delete any `obj`/`bin` folders in your projects to ensure a clean build.
2. Recompile all projects and ensure all dependencies are restored correctly.
3. Contact Umbraco Support for a license key.
1. Delete any `obj`/`bin` folders in your projects to ensure a clean build.
3. Recompile all projects and ensure all dependencies are restored correctly.
4. Contact Umbraco Support for a license key.
1. Look for the speech bubble in the bottom right corner of your screen at [umbraco.com](https://umbraco.com).
2. Click it, and you can open a new support request.
4. Add your new Umbraco Engage [license](../installation/licensing.md) key to the `appSettings.json` file:
5. Add your new Umbraco Engage [license](../installation/licensing.md) key to the `appSettings.json` file:

```json
"Umbraco": {
Expand Down Expand Up @@ -330,6 +334,10 @@ Repeat the steps below for each environment that needs to be migrated.
* Go to Engage -> Settings -> Configuration in the backoffice and click the Regenerate button. Depending on the number of page views in the database this could take a while.
9. Use the [Troubleshooting Installs](../installation/troubleshooting-installs.md) guide to verify that everything works as expected.

{% hint style="info" %}
If the site is hosted on Umbraco Cloud, stopping and starting the site is not necessary.
{% endhint %}

### **Custom firewall changes**

If the `/umbraco/umarketingsuite/` path was previously allowed, this needs to change to `/umbraco/engage/`.
Expand Down
Loading