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/custom-proxy.md
+8-4Lines changed: 8 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ strat: ajs
6
6
7
7
Custom domains allow you to proxy Analytics.js and proxy all tracking event requests through your domain.
8
8
9
-
## Custom Proxy Prerequisites
9
+
## Custom Proxy prerequisites
10
10
11
11
To set up a custom domain, you need:
12
12
@@ -31,9 +31,9 @@ You need to set up two important parts, regardless of the CDN provider you use:
31
31
> info ""
32
32
> Segment only has the ability to enable the proxy setting for the Web (Analytics.js) source. Details for mobile source proxies are in the [Analytics for iOS](/docs/connections/sources/catalog/libraries/mobile/ios/#proxy-https-calls) and [Analytics for Android](/docs/connections/sources/catalog/libraries/mobile/android/#proxying-http-calls) documentation. It is not currently possible to set up a proxy for server sources using the Segment UI.
33
33
34
-
## Custom Proxy Set up
34
+
## Custom Proxy setup
35
35
36
-
There are 2 options you can choose from when you set up your custom domain proxy.
36
+
There are two options you can choose from when you set up your custom domain proxy.
37
37
1.[CloudFront](#custom-proxy-cloudfront)
38
38
2.[Custom CDN or API proxy](#custom-cdn--api-proxy)
39
39
@@ -60,8 +60,12 @@ A Segment Customer Success team member will respond that they have enabled this
60
60
61
61
62
62
## Custom CDN / API Proxy
63
+
63
64
Follow these instructions after setting up a proxy such as [CloudFront](#custom-proxy-cloudfront). Choose between the [snippet instructions](#snippet-instructions) or the [npm instructions](#npm-instructions).
64
65
66
+
> info ""
67
+
> If you've followed the instructions above to have a Segment team member enable the apiHost settings in the UI, you can skip the instructions in this section.
68
+
65
69
### Snippet instructions
66
70
If you're a snippet user, you need to modify the [analytics snippet](/docs/getting-started/02-simple-install/#step-1-copy-the-snippet) that's inside your `<head>`.
67
71
@@ -172,5 +176,5 @@ To add a CNAME record to your DNS settings:
172
176
173
177
Follow the instructions at [Using Analytics.js as an NPM Package](https://github.com/segmentio/analytics-next/tree/master/packages/browser#-using-as-an-npm-package), to host Analytics.js and eliminate the requirement of downloading it from the CDN file during every page load. This enables you to self-host/import the library itself.
174
178
175
-
> warning "Keep in mind"
179
+
> warning ""
176
180
> Segment does not recommend self-hosting, as it requires that you configure integration settings individually and manually redeploy Analytics.js when there are changes to your settings. When you enable third-party libraries in device-mode, Segment loads them, which defeats the purpose of self-hosting.
0 commit comments