You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/sources/catalog/libraries/website/javascript/upgrade-to-ajs2.md
+3-21Lines changed: 3 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,33 +6,15 @@ strat: ajs
6
6
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.
7
7
8
8
> 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/).
28
10
29
11
## Revert to Analytics.js Classic
30
12
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.
32
14
33
15
## Cases that require additional intervention
34
16
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.
0 commit comments