Privacy Sandbox tracking
The plugin allows for adding Privacy Sandbox related data to your Snowplow tracking. To learn more about the Privacy Sandbox you can visit the official website. As more and more APIs become available or further refined, we will be upgrading the plugin with more capabilities and options as more APIs are added to the Privacy Sandbox.
We currently support the Topics API.
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.
The plugin is available since version 3.14 of the tracker.
The Privacy Sandbox context entity is automatically tracked once configured.
Install pluginβ
- JavaScript (tag)
- Browser (npm)
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.
window.snowplow('addPlugin',
"https://cdn.jsdelivr.net/npm/@snowplow/browser-plugin-privacy-sandbox@3/dist/index.umd.min.js",
["snowplowPrivacySandbox", "PrivacySandboxPlugin"]
);
npm install @snowplow/browser-plugin-privacy-sandbox@3
yarn add @snowplow/browser-plugin-privacy-sandbox@3
pnpm add @snowplow/browser-plugin-privacy-sandbox@3
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 context entity.