Self-host the browser Session Replay script

이 페이지는 아직 귀하의 언어로 번역되지 않았습니다. 현재 작업 중이므로 곧 다시 확인해 주십시오.

Serve the Session Replay SDK script from your own domain when your browser installation loads the SDK through a <script> tag. An npm installation bundled with your app doesn't need this step. Script hosting and proxying replay requests are independent tasks.

Self-host the SDK script

Self-hosting the SDK script applies to browser-based SDKs loaded through a <script> tag. If you install through npm and bundle the SDK yourself, skip to Proxy replay requests.

Get the SDK file

Option A: Download from Amplitude's CDN:

bash

# Session Replay Plugin (example version: 1.28.1)
curl -O https://cdn.amplitude.com/libs/plugin-session-replay-browser-1.28.1-min.js.gz

# Session Replay Standalone SDK (example version: 1.39.0)
curl -O https://cdn.amplitude.com/libs/session-replay-browser-1.39.0-min.js.gz

# Browser SDK (example version: 2.42.0 — only needed if also self-hosting analytics)
curl -O https://cdn.amplitude.com/libs/analytics-browser-2.42.0-min.js.gz

Option B: Pull from npm:

bash

pnpm pack @amplitude/plugin-session-replay-browser@1.28.1
# or
pnpm pack @amplitude/session-replay-browser@1.39.0

The pnpm pack command produces a .tgz tarball. Extract the tarball and locate the UMD bundle inside the package/lib/scripts/ directory, for example, plugin-session-replay-browser-1.28.1.umd.js. Serve that file from your own origin.

These examples pin SDK versions. To choose another version, refer to the plugin package or the standalone package on npm.

Serve the file

Host the file on your own CDN or static file server, then update your <script> tags:

html

<!-- Before -->
<script src="https://cdn.amplitude.com/libs/analytics-browser-2.42.0-min.js.gz"></script>
<script src="https://cdn.amplitude.com/libs/plugin-session-replay-browser-1.28.1-min.js.gz"></script>

<!-- After -->
<script src="https://assets.yourdomain.com/libs/analytics-browser-2.42.0-min.js.gz"></script>
<script src="https://assets.yourdomain.com/libs/plugin-session-replay-browser-1.28.1-min.js.gz"></script>

Cache TTL

If you plan to update the SDK version frequently, set a short cache TTL (1 to 5 minutes) on your file server. If you pin to a specific version and update manually, a longer TTL is fine.

Content Security Policy

If your app sets a Content Security Policy, replace https://cdn.amplitude.com in script-src with your file-serving domain. Keep blob: in worker-src, because the Session Replay web worker requires it. If you also proxy network requests, follow the proxy CSP configuration.

이 내용이 도움이 되었나요?