Skip to content

Commit 4f770ce

Browse files
committed
DOC-136 copy edit
1 parent 65865a4 commit 4f770ce

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

src/connections/sources/catalog/libraries/website/javascript/analytics-js-2.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,21 @@ Once enabled, after 5 minutes or less, the updated code is delivered.
4141

4242
To revert back to the previous version of Analytics.js, disable the Analytics 2.0 toggle on any source you've enabled it.
4343

44+
## Cases that require manual upgrade
45+
There are two cases where upgrading to Analytics.js 2.0 requires manual effort beyond enabling the Analytics.js 2.0 toggle.
46+
47+
### When using in-domain instrumentation CDN aliasing
48+
49+
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.13.2 or higher) before you toggle on Analytics.js 2.0.
50+
51+
### When using a strict content security policy on the page
52+
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:
54+
- `https://cdn.segment.com/v1/projects/<WRITE_KEY>/settings`
55+
- `https://cdn.segment.com/analytics-next/bundles/*`
56+
- `https://cdn.segment.com/next-integrations/integrations/*`
57+
58+
4459
## Open source libraries
4560

4661
Analytics.js 2.0 includes the following open source components:

0 commit comments

Comments
 (0)