> ## Documentation Index
> Fetch the complete documentation index at: https://playerzero.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Script Tag Setup Guide
> This guide walks you through setting up the PlayerZero SDK using a script tag to start monitoring and improving your frontend applications.
## Prerequisites
* Access to your project’s frontend codebase.
* Your PlayerZero [API Key](https://playerzero.ai/current-org/settings/projects/current-project/api-tokens).
## Step-by-Step Instructions
### 1. Add the PlayerZero Script
Paste this inside your `` or just before the closing `` tag. Replace `YOUR_WEBSDK_TOKEN` with your API key; the placeholder URL will not load if opened directly in a browser.
```javascript theme={null}
```
### 2. Identify the User (Recommended)
Once the user is authenticated or known:
```javascript theme={null}
```
***
### Example Implementations
#### Single Page Application (SPA) Setup
Once PlayerZero has been initialized, the below snippet demonstrates how to call the playerzero.identify method and capture user details in PlayerZero.
```javascript theme={null}
const userId = "userId";
const metadata = {
name: "",
email: "",
group: "", // Optional
};
if (window.playerzero) {
window.playerzero.identify(userId, metadata);
} else {
window.addEventListener(
"playerzero_ready",
() => { window.playerzero.identify(userId, metadata) },
{ once: true }
);
}
```
#### Server Side Rendered (SSR) Setup
Once PlayerZero has been initialized, the below snippet demonstrates how to call the playerzero.identify method and capture user details in PlayerZero.
```javascript theme={null}
const userId = "";
const metadata = {
name: "",
email: "",
group: "", // optional
};
const setCookie = (traceId) => {
document.cookie = `pz-traceid=${traceId}; Path=/;`;
};
if (window.playerzero) {
// PlayerZero has loaded
window.playerzero.identify(userId, metadata);
window.playerzero.onTraceChange(setCookie);
} else {
// Wait for PlayerZero to load
window.addEventListener(
"playerzero_ready",
() => {
window.playerzero.identify(userId, metadata);
window.playerzero.onTraceChange(setCookie);
},
{ once: true }
);
}
```
## Next Steps
Once the SDK is installed and initialized, you can visit the [Users page](https://playerzero.ai/current-org/current-project/users) in PlayerZero to see live user sessions being captured.
If you want to control where PlayerZero is active, visit the [Domain Settings](/developer-guide/configuration-guides/capturing-user-sessions/domain-settings) guide to configure domain-level access and environment-specific behavior.
Want to extend your integration further? Explore the [Advanced SDK Usage](/developer-guide/configuration-guides/capturing-user-sessions/advanced-usage) guide to unlock features like custom event tracking, devtools links, and user metadata enhancements.