Skip to content

Commit e9512e9

Browse files
committed
DOC-187 add migration article
1 parent 8d0d398 commit e9512e9

File tree

2 files changed

+36
-0
lines changed

2 files changed

+36
-0
lines changed

src/_data/sidenav/strat.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -93,6 +93,8 @@ sections:
9393
title: Analytics.js (Javascript) Source
9494
- path: /connections/sources/catalog/libraries/website/javascript/ajs-classic
9595
title: Analytics.js Classic
96+
- path: connections/sources/catalog/libraries/website/javascript/migrate-to-ajs2
97+
title: Migrate to Analytics.js 2.0
9698
- path: /connections/sources/catalog/libraries/website/javascript/supported-browsers
9799
title: Analytics.js supported browsers
98100
- path: /connections/sources/catalog/libraries/website/javascript/quickstart
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
title: Migrate to A.js 2.0
3+
strat: ajs
4+
---
5+
6+
Analytics.js 2.0 is fully backward compatible with Analytics.js Classic. To migrate your sources, follow the manual upgrade steps below, or see the schedule for automatic migration.
7+
8+
## Manual migration
9+
10+
To migrate a source to Analytics.js 2.0:
11+
12+
1. In your Segment workspace, open the **Connections** page.
13+
2. Open the Javascript source you will migrate.
14+
3. On the **Settings** tab, open the **Analytics.js** category.
15+
4. Enable the flag for Analytics 2.0.
16+
5. Within 5 minutes, the source receives Analytics.js 2.0. No code or tag changes required.
17+
6. Open the Debugger to ensure that events are flowing as expected.
18+
19+
## Automatic migration
20+
21+
Analytics.js sources will migrate to Analytics.js 2.0 on the date below, according to the account tier. On the date listed, Segment will migrate all Analytics.js sources within the associated account tier.
22+
23+
| Segment Plan | Upgrade Date |
24+
|--------------| -------------|
25+
| Free | June 15, 2021|
26+
| Team | July 6, 2021 |
27+
| Business | Q3, 2021 |
28+
29+
> info ""
30+
> The plans and dates listed above are subject to change.
31+
32+
## Revert to Analytics.js Classic
33+
34+
Once a source moves to Analytics.js 2.0, you can follow the steps above in [Manual migration](#manual-migration) back to roll back to Analytics.js Classic.

0 commit comments

Comments
 (0)