Skip to content

Commit 3c64f17

Browse files
authored
Merge pull request #4407 from segmentio/sarahrudy-patch-6
Remove Manual Upgrade and Automatic Migration AJS
2 parents 1602db0 + 7f5d671 commit 3c64f17

File tree

1 file changed

+3
-21
lines changed

1 file changed

+3
-21
lines changed

src/connections/sources/catalog/libraries/website/javascript/upgrade-to-ajs2.md

Lines changed: 3 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -6,33 +6,15 @@ strat: ajs
66
Analytics.js 2.0 is fully backward compatible with Analytics.js Classic when you use the default Segment snippet in a standard implementation. To upgrade your sources, follow the manual upgrade steps below, or see the schedule for automatic migration. As with all upgrades, Segment recommends that you start development on a non-production source to test the upgrade process and outcome, prior to upgrading your production sources.
77

88
> warning "Deprecation of Analytics.js Classic"
9-
> Analytics.js Classic was deprecated on February 28, 2023. At this time, Segment is upgrading all sources not yet upgraded to [Analytics.js 2.0](/docs/connections/sources/catalog/libraries/website/javascript/). The upgrade process will complete for all users by the end of March 2023.
10-
11-
## Manual upgrade
12-
13-
To upgrade a source to Analytics.js 2.0:
14-
15-
1. In your Segment workspace, open the **Connections** page.
16-
2. Open the JavaScript source you will upgrade.
17-
3. On the **Settings** tab, open the **Analytics.js** category.
18-
4. Enable the flag for Analytics 2.0.
19-
5. Within 5 minutes, the source receives Analytics.js 2.0. No code or tag changes required.
20-
6. Open the Debugger to ensure that events are flowing as expected.
21-
22-
> info ""
23-
> If you set `'Segment.io:' false` in the integrations object, Analytics.js 2.0 drops the event before it reaches the Source Debugger.
24-
25-
## Automatic migration
26-
27-
On February 28, 2023, all Analytics.js Classic sources will automatically upgrade to Analytics.js 2.0.
9+
> Analytics.js Classic was deprecated on February 28, 2023. As of March 2023, Segment upgraded all sources to [Analytics.js 2.0](/docs/connections/sources/catalog/libraries/website/javascript/).
2810
2911
## Revert to Analytics.js Classic
3012

31-
Once a source moves to Analytics.js 2.0, you can follow the steps above in [Manual migration](#manual-migration) to roll back to Analytics.js Classic.
13+
It is no longer possible to revert to Analytics.js Classic. If you are experiencing technical issues after the automatic upgrade to Analytics.js 2.0, please see below for cases that may require additional intervention. If you are still having issues after reading through the section below, please reach out to the Segment support team.
3214

3315
## Cases that require additional intervention
3416

35-
In some cases, upgrading to Analytics.js 2.0 requires manual effort beyond enabling the Analytics.js 2.0 toggle.
17+
In some cases, upgrading to Analytics.js 2.0 may require some additional intervention. This only applies to customers who are experiencing these specific issues and do not apply to all customers. In most cases, upgrading to Analytics.js 2.0 should not cause technical issues.
3618

3719
### Using in-domain instrumentation CDN aliasing
3820

0 commit comments

Comments
 (0)