Track Privacy Sandbox browser data with the web trackers

warning

Privacy Sandbox has been deprecated by Google. This plugin remains available but the underlying browser API may no longer be supported.

The plugin allows for adding Privacy Sandbox Topics API data to your Snowplow tracking. To learn more about Privacy Sandbox visit the official website.

note

Some of the APIs and data will not be available by default in all users. This is commonly due to these APIs being dependent on browser support, user privacy preferences, browser feature-flags or ad-blocking software. The plugin will not modify or request access explicitly to any of these features if not available by default.

note

The plugin is available since version 3.14 of the tracker.

The Privacy Sandbox entity is automatically tracked once configured.

Install plugin

JavaScript (tag)

Tracker Distribution	Included
sp.js	❌
sp.lite.js	❌

Download:

Download from GitHub Releases (Recommended)	Github Releases (plugins.umd.zip)
Available on jsDelivr	jsDelivr (latest)
Available on unpkg	unpkg (latest)

Note: The links to the CDNs above point to the current latest version. You should pin to a specific version when integrating this plugin on your website if you are using a third party CDN in production.

javascript

window.snowplow('addPlugin',
  "https://cdn.jsdelivr.net/npm/@snowplow/browser-plugin-privacy-sandbox@latest/dist/index.umd.min.js",
  ["snowplowPrivacySandbox", "PrivacySandboxPlugin"]
);

Browser (npm)

• npm install @snowplow/browser-plugin-privacy-sandbox
• yarn add @snowplow/browser-plugin-privacy-sandbox
• pnpm add @snowplow/browser-plugin-privacy-sandbox

javascript

import { newTracker, trackPageView } from '@snowplow/browser-tracker';
import { PrivacySandboxPlugin } from '@snowplow/browser-plugin-privacy-sandbox';

newTracker('sp1', '{{collector_url}}', {
   appId: 'my-app-id',
   plugins: [ PrivacySandboxPlugin() ],
});

Context entity

Adding this plugin will automatically capture this entity.