Skip to content

Commit 3ef95c3

Browse files
authored
Merge pull request #5286 from segmentio/ashton-huxtable-patch-2
Add note to configure UI or code option not both
2 parents 2204261 + 1aac7b6 commit 3ef95c3

File tree

1 file changed

+8
-4
lines changed
  • src/connections/sources/catalog/libraries/website/javascript

1 file changed

+8
-4
lines changed

src/connections/sources/catalog/libraries/website/javascript/custom-proxy.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ strat: ajs
66

77
Custom domains allow you to proxy Analytics.js and proxy all tracking event requests through your domain.
88

9-
## Custom Proxy Prerequisites
9+
## Custom Proxy prerequisites
1010

1111
To set up a custom domain, you need:
1212

@@ -31,9 +31,9 @@ You need to set up two important parts, regardless of the CDN provider you use:
3131
> info ""
3232
> 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.
3333
34-
## Custom Proxy Set up
34+
## Custom Proxy setup
3535

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.
3737
1. [CloudFront](#custom-proxy-cloudfront)
3838
2. [Custom CDN or API proxy](#custom-cdn--api-proxy)
3939

@@ -60,8 +60,12 @@ A Segment Customer Success team member will respond that they have enabled this
6060
6161

6262
## Custom CDN / API Proxy
63+
6364
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).
6465

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+
6569
### Snippet instructions
6670
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>`.
6771

@@ -172,5 +176,5 @@ To add a CNAME record to your DNS settings:
172176

173177
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.
174178

175-
> warning "Keep in mind"
179+
> warning ""
176180
> 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

Comments
 (0)