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
+11-9Lines changed: 11 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,39 +16,41 @@ To upgrade a source to Analytics.js 2.0:
16
16
5. Within 5 minutes, the source receives Analytics.js 2.0. No code or tag changes required.
17
17
6. Open the Debugger to ensure that events are flowing as expected.
18
18
19
+
> info ""
20
+
> If you set `'Segment.io:' false' in the integrations object, Analytics.js 2.0 drops the event before it reaches the Source Debugger.
21
+
19
22
## Automatic migration
20
23
21
24
Analytics.js sources will upgrade to Analytics.js 2.0 on the date below, according to the account tier. On the date listed, Segment will upgrade all Analytics.js sources within the associated account tier.
22
25
23
26
| Segment Plan | Upgrade Date |
24
27
|--------------| -------------|
25
28
| Free | June 15, 2021|
26
-
| Team | July 6, 2021 |
29
+
| Team | July 6, 2021 |
27
30
| Business | TBD |
28
31
29
32
> info ""
30
33
> The plans and dates listed above are subject to change.
31
34
32
35
## Revert to Analytics.js Classic
33
36
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.
37
+
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.
35
38
36
39
## Cases that require additional intervention
37
40
38
41
In some cases, upgrading to Analytics.js 2.0 requires manual effort beyond enabling the Analytics.js 2.0 toggle.
39
42
40
-
### When using in-domain instrumentation CDN aliasing
41
-
42
-
If the source you intend to upgrade uses the in-domain instrumentation as well as a custom "Alias for analytics.js", then you should update the AJS snippet to the latest version (4.15.3) or higher) before you toggle on Analytics.js 2.0.
43
+
### Using in-domain instrumentation CDN aliasing
43
44
45
+
If the source you intend to upgrade uses the in-domain instrumentation as well as a custom "Alias for analytics.js", then you should update the AJS snippet to the latest version (4.15.3 or higher) before you toggle on Analytics.js 2.0.
44
46
45
-
### When relying on Analytics.js Classic's `ajs_anonymous_id` cookie format
47
+
### Relying on Analytics.js Classic's `ajs_anonymous_id` cookie format
46
48
47
49
Analytics.js 2.0 removes inbuilt quotes from cookie values, resulting in a different format for the `ajs_anonymous_id` value when compared to Analytics.js Classic. Though you can retrieve cookie values with [standard supported functions](/docs/connections/sources/catalog/libraries/website/javascript/identity/#retrieve-the-anonymous-id), you'll need to configure your environment to accept the new format if your implementation relies on accessing the cookie value directly.
48
50
49
-
### When using a strict content security policy on the page
51
+
### Using a strict content security policy on the page
50
52
51
-
Analytics.js 2.0 asynchronously loads different pieces of the library as needed. If the source you're upgrading uses a strict Content Security Policy (CSP) that allows JavaScript to be downloaded from specific locations, then you need to update the CSP to account for all the pieces used for Analytics.js 2.0. Therefore, beyond allowing the main analytics.min.js script, you should allow the following paths in your CSP:
53
+
Analytics.js 2.0 asynchronously loads different pieces of the library as needed. If the source you're upgrading uses a strict Content Security Policy (CSP) that allows JavaScript to be downloaded from specific locations, then you need to update the CSP to account for all the pieces used for Analytics.js 2.0. Therefore, beyond allowing the main analytics.min.js script, you should allow the following paths in your CSP:
0 commit comments