Track Privacy Sandbox browser data with the web trackers

note

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
Available on unpkg	unpkg

Note: The links to the CDNs above are pinned to a specific version at the time of writing. Check the plugin's GitHub releases for newer versions, and update the pinned version when you upgrade.

javascript

window.snowplow('addPlugin',
  "https://cdn.jsdelivr.net/npm/@snowplow/browser-plugin-privacy-sandbox@4.10.2/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.