Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
46 commits
Select commit Hold shift + click to select a range
127c192
create reference page and link to sidebar
eiman-eltigani-ttd Sep 30, 2025
f2c4177
consilidate sample site reference file
eiman-eltigani-ttd Sep 30, 2025
3959fbd
update formatting and note at bottom of page
eiman-eltigani-ttd Sep 30, 2025
66268bf
update links and bullet wording
eiman-eltigani-ttd Sep 30, 2025
684588f
add section summary beneath each header
eiman-eltigani-ttd Sep 30, 2025
b99af21
update word
eiman-eltigani-ttd Sep 30, 2025
d40f626
update title and decription
eiman-eltigani-ttd Sep 30, 2025
2cc2261
Merge branch 'main' into eee-UID2-5805-create-sample-sites-reference-…
eiman-eltigani-ttd Sep 30, 2025
070f7a1
revert formatting changes in sidebars.js
eiman-eltigani-ttd Sep 30, 2025
86024c8
update header
eiman-eltigani-ttd Sep 30, 2025
6d0ff25
update language in description
eiman-eltigani-ttd Sep 30, 2025
3812582
restore formatting on sidebars.js
eiman-eltigani-ttd Sep 30, 2025
56f5086
update web integrations section with feedback
eiman-eltigani-ttd Sep 30, 2025
d14e76b
remaining feedback on use cases and wording
eiman-eltigani-ttd Sep 30, 2025
a566adb
replace doc references with url links
eiman-eltigani-ttd Sep 30, 2025
3859c83
romove word Publisher in site names for ocnsistentcy
eiman-eltigani-ttd Sep 30, 2025
1c7c559
update site name for cstg sample site
eiman-eltigani-ttd Sep 30, 2025
634a2d3
word cleanup throughout page
eiman-eltigani-ttd Oct 1, 2025
8c0f4f3
update link for consistency
eiman-eltigani-ttd Oct 1, 2025
eaeed59
remove publisher reference in web integrations summary
eiman-eltigani-ttd Oct 1, 2025
0a26a2e
update broken link at bottom of page
eiman-eltigani-ttd Oct 1, 2025
df18acd
update location of file in sidebar and rename
eiman-eltigani-ttd Oct 1, 2025
6ffc51f
update intros to be complete sentences
eiman-eltigani-ttd Oct 1, 2025
3fd1ce0
create japenese version of sample reference file
eiman-eltigani-ttd Oct 1, 2025
f1718a4
update use case wording for some sites
eiman-eltigani-ttd Oct 2, 2025
fa910a5
include sample sites reference in appropiate participant tabs
eiman-eltigani-ttd Oct 2, 2025
34eac8b
update sample site reference in summary guide page
eiman-eltigani-ttd Oct 2, 2025
6525894
update headers with info under
eiman-eltigani-ttd Oct 2, 2025
efcc9df
clarify somme intros better
eiman-eltigani-ttd Oct 2, 2025
59ca4e3
fix broken link again
eiman-eltigani-ttd Oct 2, 2025
cf38562
update sidebar title and yaml title properly
eiman-eltigani-ttd Oct 2, 2025
66d91ea
update web integrations intro summary to be more accurate
eiman-eltigani-ttd Oct 2, 2025
f92cb0b
replace javascript sdk to sdk for javascript throughout file
eiman-eltigani-ttd Oct 2, 2025
edba4f1
make prebid less redundant/plural plus minor grammar updates
eiman-eltigani-ttd Oct 2, 2025
ba1ae88
remove code styling from repo links
eiman-eltigani-ttd Oct 3, 2025
560d323
remove capitalization in sample sites
eiman-eltigani-ttd Oct 3, 2025
4a19d86
update all links to match site title
eiman-eltigani-ttd Oct 3, 2025
d71bd99
update utility section
eiman-eltigani-ttd Oct 3, 2025
c1bc577
update heading levels and doc url paths
eiman-eltigani-ttd Oct 6, 2025
1b51c75
make sure all destination file links are correct
eiman-eltigani-ttd Oct 6, 2025
697e54b
remove hyphen in server side
eiman-eltigani-ttd Oct 6, 2025
c42e4b2
copy most recent version for japanese translation
eiman-eltigani-ttd Oct 6, 2025
fe6d5a0
add section into/header for prebid.js for consistency
eiman-eltigani-ttd Oct 6, 2025
6f278b2
make sample site reference page available across all tabs
eiman-eltigani-ttd Oct 6, 2025
700db28
update link for different providers and revert doc links to external
eiman-eltigani-ttd Oct 6, 2025
ff6b9a8
remove edits in summary-guides transflation version
eiman-eltigani-ttd Oct 6, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/guides/summary-guides.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,8 @@ Publisher integrations fall into the following main categories:
- [Prebid Integrations](#prebid-integrations)
- [Google Ad Manager Integrations](#google-ad-manager-integrations)

To explore live, working examples of UID2 implementations with source code, see [UID2 Integration Samples](../ref-info/integration-sample-sites.md).

### Web Integrations

The following documentation resources are available for publisher web integrations.
Expand Down
105 changes: 105 additions & 0 deletions docs/ref-info/integration-sample-sites.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
---
title: Integration Samples and Tools
description: Overview and reference for all UID2 sample site examples.
hide_table_of_contents: false
---

import Link from '@docusaurus/Link';

# Integration Samples and Tools

This page lists all official UID2 sample implementations highlighting common integration use cases, along with links to live demo sites, source code, and related documentation. Use this page to quickly identify which sample matches your needs and explore working examples.

## Web Integrations

This section summarizes the sample integrations available for integrating UID2 directly into websites. For integration options by participant type, see [Publisher Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web) or [Advertiser/Data Provider Integration Overview](https://unifiedid.com/docs/guides/integration-advertiser-dataprovider-overview).

### Client-Side Integration Using UID2 SDK for JavaScript

This sample is for publishers who prefer a fully client-side integration using the [SDK for JavaScript Reference Guide](https://unifiedid.com/docs/sdks/sdk-ref-javascript) to generate and manage tokens directly in the browser. This approach is ideal for fast prototyping with minimal back-end requirements.

- Site: [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK](https://cstg-integ.uidapi.com/)
- Code: [uid2-web-integrations/examples/cstg](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg)
- Doc: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side)

### Client-Server Integration Using UID2 SDK for JavaScript

This sample is for publishers who want more control over UID2 token creation (handled on your servers), while using the SDK for JavaScript on the client side to manage and refresh tokens in the browser.

- Site: [UID2 SDK Integration Example](https://example-jssdk-integ.uidapi.com/)
- Code: [uid2-web-integrations/examples/js-sdk](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk)
- Doc: [Client-Server Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-server)

### UID2 Server-Only (Server-Side)

This sample is for publishers who want all UID2 operations to occur on the server side, offering maximum control, security, and flexibility without relying on a client-side SDK.

- Site: [Server-Only UID2 Integration Example](https://example-srvonly-integ.uidapi.com/login)
- Code: [uid2-examples/publisher/server_only](https://github.com/IABTechLab/uid2-examples/tree/main/publisher/server_only)
- Doc: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side)

## Prebid.js Integrations

This section includes a sample page for generating UID2 tokens to be passed by Prebid.js in the RTB bidstream. For details, see [UID2 Integration Overview for Prebid](https://unifiedid.com/docs/guides/integration-prebid).

### Client-Side Integration with Prebid.js
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added a section summary and individual sample header here to match the format of the other sections even though there is just one sample site

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK.


This sample is for publishers who want to generate UID2 tokens on the client side and pass them into header bidding auctions using Prebid.js.

- Site: [UID2 Prebid.js Client-Side Integration Example](https://unifiedid.com/examples/cstg-prebid-example/)
- Code: [uid2docs/static/examples/cstg-prebid-example](https://github.com/IABTechLab/uid2docs/tree/main/static/examples/cstg-prebid-example)
- Doc: [UID2 Client-Side Integration Guide for Prebid.js](https://unifiedid.com/docs/guides/integration-prebid-client-side)

## Google Secure Signals Integrations

This section includes sample pages for passing UID2 identity data to Google's advertising systems through their Secure Signals feature. For details, see [Google Ad Manager Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss).

### Client-Side Secure Signals

This sample is for publishers who want a purely client-side integration with GAM Secure Signals.

- Site: [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK, Secure Signals](https://secure-signals-client-side-integ.uidapi.com/)
- Code: [uid2-web-integrations/examples/google-secure-signals-integration/client_side](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/client_side)
- Doc: [Google Ad Manager Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss)

### React Client-Side Secure Signals

This sample is for publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture.

- Site: [UID2 React Client-Side Integration Example with Google Secure Signals](https://secure-signals-react-integ.uidapi.com/)
- Code: [uid2-web-integrations/examples/google-secure-signals-integration/react_client_side](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/react_client_side)
- Doc: [Google Ad Manager Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss)

### Server-Side Secure Signals

This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security.

- Site: [Server-Side UID2 Integration Example with Google Secure Signals](https://secure-signals-server-side-integ.uidapi.com/login)
- Code: [uid2-web-integrations/examples/google-secure-signals-integration/server_side](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/server_side)
- Doc: [Google Ad Manager Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss)
- Additional site domains:
- [https://secure-signals-srvonly-integ.uidapi.com](https://secure-signals-srvonly-integ.uidapi.com)
- [https://esp-srvonly-integ.uidapi.com](https://esp-srvonly-integ.uidapi.com)

### Client-Server Secure Signals

This sample is for publishers who want a hybrid approach with token generation on the server and client-side logic for secure signals.

- Site: [Example for Client-Server UID2 SDK Integration with Google Secure Signals](https://secure-signals-client-server-integ.uidapi.com/)
- Code: [uid2-web-integrations/examples/google-secure-signals-integration/with_sdk_v3](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3)
- Doc: [Google Ad Manager Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss)
- Additional site domains:
- [https://secure-signals-jssdk-integ.uidapi.com](https://secure-signals-jssdk-integ.uidapi.com)
- [https://esp-jssdk-integ.uidapi.com](https://esp-jssdk-integ.uidapi.com)

## UID2 Hashing Tool

This tool is for developers or clients validating data preparation, such as hashing and normalization of emails before token requests. The tool is available at the following links:

- Site: [UID2 Hashing Tool](https://unifiedid.com/examples/hashing-tool/)
- Code: [uid2docs/static/examples/hashing-tool](https://github.com/IABTechLab/uid2docs/tree/main/static/examples/hashing-tool)
- Doc: [Normalization and Encoding](https://unifiedid.com/docs/getting-started/gs-normalization-encoding)

:::note
The sample sites in this file highlight some common integrations, but do not represent all available UID2 integration options. For a summary of all the integration options available, see [UID2 Integration Guides: Summary](https://unifiedid.com/docs/guides/summary-guides).
:::
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
---
title: Integration Samples and Tools
description: Overview and reference for all UID2 sample site examples.
hide_table_of_contents: false
---

import Link from '@docusaurus/Link';

# Integration Samples and Tools

This page lists all official UID2 sample implementations highlighting common integration use cases, along with links to live demo sites, source code, and related documentation. Use this page to quickly identify which sample matches your needs and explore working examples.

## Web Integrations

This section summarizes the sample integrations available for publishers who want to integrate UID2 directly into their websites. For a full summary of integration options for websites, see [Publisher Web Integration Overview](../guides/integration-options-publisher-web).

### Client-Side Integration Using UID2 SDK for JavaScript

This sample is for publishers who prefer a fully client-side integration using the [SDK for JavaScript Reference Guide](../sdks/sdk-ref-javascript) to generate and manage tokens directly in the browser. This approach is ideal for fast prototyping with minimal back-end requirements.

- Site: [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK](https://cstg-integ.uidapi.com/)
- Code: [uid2-web-integrations/examples/cstg](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg)
- Doc: [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side)

### Client-Server Integration Using UID2 SDK for JavaScript

This sample is for publishers who want more control over UID2 token creation (handled on your servers), while using the SDK for JavaScript on the client side to manage and refresh tokens in the browser.

- Site: [UID2 SDK Integration Example](https://example-jssdk-integ.uidapi.com/)
- Code: [uid2-web-integrations/examples/js-sdk](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk)
- Doc: [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server)

### UID2 Server-Only (Server-Side)

This sample is for publishers who want all UID2 operations to occur on the server side, offering maximum control, security, and flexibility without relying on a client-side SDK.

- Site: [Server-Only UID2 Integration Example](https://example-srvonly-integ.uidapi.com/login)
- Code: [uid2-examples/publisher/server_only](https://github.com/IABTechLab/uid2-examples/tree/main/publisher/server_only)
- Doc: [Publisher Integration Guide, Server-Side](../guides/integration-publisher-server-side)

## Prebid.js Integrations

This section includes a sample page for generating UID2 tokens to be passed by Prebid.js in the RTB bidstream. For details, see [UID2 Integration Overview for Prebid](../guides/integration-prebid).

### Client-Side Integration with Prebid.js

This sample is for publishers who want to generate UID2 tokens on the client side and pass them into header bidding auctions using Prebid.js.

- Site: [UID2 Prebid.js Client-Side Integration Example](https://unifiedid.com/examples/cstg-prebid-example/)
- Code: [uid2docs/static/examples/cstg-prebid-example](https://github.com/IABTechLab/uid2docs/tree/main/static/examples/cstg-prebid-example)
- Doc: [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side)

## Google Secure Signals Integrations

This section includes sample pages for passing UID2 identity data to Google's advertising systems through their Secure Signals feature. For details, see [Google Ad Manager Secure Signals Integration Guide](../guides/integration-google-ss).

### Client-Side Secure Signals

This sample is for publishers who want a purely client-side integration with GAM Secure Signals.

- Site: [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK, Secure Signals](https://secure-signals-client-side-integ.uidapi.com/)
- Code: [uid2-web-integrations/examples/google-secure-signals-integration/client_side](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/client_side)
- Doc: [Google Ad Manager Secure Signals Integration Guide](../guides/integration-google-ss)

### React Client-Side Secure Signals

This sample is for publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture.

- Site: [UID2 React Client-Side Integration Example with Google Secure Signals](https://secure-signals-react-integ.uidapi.com/)
- Code: [uid2-web-integrations/examples/google-secure-signals-integration/react_client_side](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/react_client_side)
- Doc: [Google Ad Manager Secure Signals Integration Guide](../guides/integration-google-ss)

### Server-Side Secure Signals

This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security.

- Site: [Server-Side UID2 Integration Example with Google Secure Signals](https://secure-signals-server-side-integ.uidapi.com/login)
- Code: [uid2-web-integrations/examples/google-secure-signals-integration/server_side](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/server_side)
- Doc: [Google Ad Manager Secure Signals Integration Guide](../guides/integration-google-ss)
- Additional site domains:
- [https://secure-signals-srvonly-integ.uidapi.com](https://secure-signals-srvonly-integ.uidapi.com)
- [https://esp-srvonly-integ.uidapi.com](https://esp-srvonly-integ.uidapi.com)

### Client-Server Secure Signals

This sample is for publishers who want a hybrid approach with token generation on the server and client-side logic for secure signals.

- Site: [Example for Client-Server UID2 SDK Integration with Google Secure Signals](https://secure-signals-client-server-integ.uidapi.com/)
- Code: [uid2-web-integrations/examples/google-secure-signals-integration/with_sdk_v3](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3)
- Doc: [Google Ad Manager Secure Signals Integration Guide](../guides/integration-google-ss)
- Additional site domains:
- [https://secure-signals-jssdk-integ.uidapi.com](https://secure-signals-jssdk-integ.uidapi.com)
- [https://esp-jssdk-integ.uidapi.com](https://esp-jssdk-integ.uidapi.com)

## UID2 Hashing Tool

This tool is for developers or clients validating data preparation, such as hashing and normalization of emails before token requests. The tool is available at the following links:

- Site: [UID2 Hashing Tool](https://unifiedid.com/examples/hashing-tool/)
- Code: [uid2Docs/static/examples/hashing-tool](https://github.com/IABTechLab/uid2docs/tree/main/static/examples/hashing-tool)
- Doc: [Normalization and Encoding](../getting-started/gs-normalization-encoding)

:::note
The sample sites in this file highlight some common integrations, but do not represent all available UID2 integration options. For a summary of all the integration options available, see [UID2 Integration Guides: Summary](../guides/summary-guides).
:::
3 changes: 2 additions & 1 deletion sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ function removeItems(sidebar, ...remove) {
if (!remove.includes(item.label)) {
const {items, ...rest} = item;
const keepItems = removeItems(items, ...remove);
if (keepItems?.length > 0) result.push({...rest, items: keepItems});
if (keepItems?.length > 0 || rest.link) result.push({...rest, items: keepItems});
}
}
}
Expand Down Expand Up @@ -381,6 +381,7 @@ const fullSidebar = [
'getting-started/gs-opt-out',
'ref-info/ref-operators-public-private',
'ref-info/ref-integration-approaches',
'ref-info/integration-sample-sites',
'ref-info/ref-tokens',
'ref-info/ref-how-uid-is-created',
'ref-info/ref-server-side-token-generation',
Expand Down