> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paraminternationalltd.com/llms.txt
> Use this file to discover all available pages before exploring further.
# SDK Initialization
> Install and initialize the Twinalyze JavaScript Analytics SDK.
export const DownloadWorker = () => {
const [downloading, setDownloading] = useState(false);
const workerUrl = "https://raw.githubusercontent.com/jenilmoradiyatwinnet/docs/main/images/twinalyze-fcm-sw.js";
const handleDownload = async () => {
try {
setDownloading(true);
const response = await fetch(workerUrl, {
cache: "no-store"
});
if (!response.ok) {
throw new Error("Worker file could not be downloaded.");
}
const blob = await response.blob();
const fileUrl = URL.createObjectURL(blob);
const link = document.createElement("a");
link.href = fileUrl;
link.download = "twinalyze-fcm-sw.js";
document.body.appendChild(link);
link.click();
link.remove();
URL.revokeObjectURL(fileUrl);
} catch (error) {
console.error("[Twinalyze] Download failed:", error);
window.open(workerUrl, "_blank", "noopener,noreferrer");
} finally {
setDownloading(false);
}
};
return ;
};
Install the Twinalyze JavaScript Analytics SDK and initialize it once when your website or application starts.
## Add the SDK dependency
Choose your preferred installation method.
```bash npm theme={null}
npm install @twinalyze/web-analytics
```
```html CDN theme={null}
```
## Initialize the SDK
Add this Javascript sdk script to your code and your SDK is ready to send events.
```javascript npm theme={null}
import TwinalyzeAnalytics from "@twinalyze/web-analytics";
TwinalyzeAnalytics.init({
apiKey: "YOUR_API_KEY",
secretKey: "YOUR_SECRET_KEY",
});
```
```html CDN theme={null}
```
Replace `YOUR_API_KEY` and `YOUR_SECRET_KEY` with the credentials available in your Twinalyze project.
Initialize the SDK only once. After initialization, Twinalyze creates the device and session identifiers and starts collecting supported website events.
## Enable Firebase Cloud Messaging
The complete configuration allows you to manage sessions, automatic event tracking, site search, file downloads, and Firebase Cloud Messaging.
```javascript npm theme={null}
import TwinalyzeAnalytics from "@twinalyze/web-analytics";
TwinalyzeAnalytics.init({
apiKey: "YOUR_API_KEY",
secretKey: "YOUR_SECRET_KEY",
fcm: {
enabled: true,
configUrl: "/twinalyze-fcm-sw.js",
serviceWorkerPath: "/twinalyze-fcm-sw.js",
},
});
```
```html CDN theme={null}
```
To enable web push notifications, create the following service worker file:
```text theme={null}
public/twinalyze-fcm-sw.js
```
The final file must be publicly available at:
```text theme={null}
https://your-domain.com/twinalyze-fcm-sw.js
```
To enable web push notifications, download the Twinalyze Firebase service worker file.
Twinalyze FCM Service Worker
Download the worker file and add your Firebase configuration.
twinalyze-fcm-sw\.js
Place this file in your application's public root directory.
## Request notification permission
Notification permission must be requested after a user action, such as clicking an **Enable Notifications** button.
Call the function from a button:
```html theme={null}
```
```javascript theme={null}
async function enableNotifications() {
if (!("Notification" in window)) {
console.log("Notifications are not supported.");
return;
}
const permission =await Notification.requestPermission();
if (permission === "granted") {
console.log("Notification permission granted."
);
}
if (permission === "denied") {
console.log( "Notification permission denied."
);
}
}
```
FCM works only when the browser supports notifications, FCM is enabled, the service worker is publicly available, and notification permission is granted.