Skip to content

Commit 5200e73

Browse files
committed
[netlify-build]
1 parent 6945502 commit 5200e73

File tree

1 file changed

+11
-9
lines changed

1 file changed

+11
-9
lines changed

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

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -16,39 +16,41 @@ To upgrade a source to Analytics.js 2.0:
1616
5. Within 5 minutes, the source receives Analytics.js 2.0. No code or tag changes required.
1717
6. Open the Debugger to ensure that events are flowing as expected.
1818

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+
1922
## Automatic migration
2023

2124
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.
2225

2326
| Segment Plan | Upgrade Date |
2427
|--------------| -------------|
2528
| Free | June 15, 2021|
26-
| Team | July 6, 2021 |
29+
| Team | July 6, 2021 |
2730
| Business | TBD |
2831

2932
> info ""
3033
> The plans and dates listed above are subject to change.
3134
3235
## Revert to Analytics.js Classic
3336

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.
3538

3639
## Cases that require additional intervention
3740

3841
In some cases, upgrading to Analytics.js 2.0 requires manual effort beyond enabling the Analytics.js 2.0 toggle.
3942

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
4344

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.
4446

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
4648

4749
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.
4850

49-
### When using a strict content security policy on the page
51+
### Using a strict content security policy on the page
5052

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:
5254
- `https://cdn.segment.com/v1/projects/<WRITE_KEY>/settings`
53-
- `https://cdn.segment.com/analytics-next/bundles/*`
55+
- `https://cdn.segment.com/analytics-next/bundles/*`
5456
- `https://cdn.segment.com/next-integrations/integrations/*`

0 commit comments

Comments
 (0)