Skip to content

Document Go Core ID list opt-in and file download override #4067

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
trentusus wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

Document Go Core ID list opt-in and file download override #4067

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 10 additions & 4 deletions snippets/server-core/go/_options.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,12 +44,16 @@
When set to true, the SDK will wait until user agent parsing data is fully loaded during initialization. This may slow down by ~1 second startup but ensures that parsing of the user's userAgent string into fields like browserName, browserVersion, systemName, systemVersion, and appVersion is ready before any evaluations.
</ResponseField>

<ResponseField name="EnableIdLists" type="boolean" default="true">
Enables downloading ID lists; set to false to skip ID list syncing.
<ResponseField name="EnableIdLists" type="boolean" default="false">
Required to be `true` when using segments with more than 1000 IDs. See [ID List segments](/segments/add-id-list).
</ResponseField>

<ResponseField name="IdListsUrl" type="string">
Custom URL for fetching ID lists.
Custom URL for fetching the ID list manifest.
</ResponseField>

<ResponseField name="DownloadIdListFileApi" type="string">
Custom base URL for downloading individual ID list files. Use this with `IdListsUrl` when routing ID list traffic through your own proxy or endpoint.
</ResponseField>

<ResponseField name="IdListsSyncIntervalMs" type="number">
Expand Down Expand Up @@ -90,7 +94,7 @@

### Proxy and Custom Network Routing

The Go Server Core SDK currently documents endpoint overrides rather than a dedicated outbound proxy config. Use `WithSpecsUrl(...)`, `WithLogEventUrl(...)`, and `WithIdListsUrl(...)` to route Statsig network calls through your own endpoints or proxy layer.
The Go Server Core SDK currently documents endpoint overrides rather than a dedicated outbound proxy config. Use `WithSpecsUrl(...)`, `WithLogEventUrl(...)`, `WithIdListsUrl(...)`, and `WithDownloadIdListFileApi(...)` to route Statsig network calls through your own endpoints or proxy layer.

---

Expand All @@ -114,6 +118,8 @@ options, err := statsig.NewOptionsBuilder().
WithDisableUserAgentParsing(true).
WithWaitForCountryLookupInit(false).
WithEnableIdLists(true).
WithIdListsUrl("https://example.com/id-list-manifest").
WithDownloadIdListFileApi("https://example.com/id-list-files").
WithIdListsSyncIntervalMs(60000).
WithInitTimeoutMs(3000).
WithFallbackToStatsigApi(false).
Expand Down