From 49577f16f806c84a07046a55d780e9a1c5d4db28 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Wed, 22 Oct 2025 13:51:43 -0600 Subject: [PATCH 1/2] update sample site titles and headers --- docs/ref-info/integration-sample-sites.md | 47 ++++++++++++----------- 1 file changed, 24 insertions(+), 23 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index 72a7cb322..fa6699a2d 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -8,33 +8,33 @@ 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. +This page lists all official UID2 sample implementations highlighting common integrations for websites, along with links to live demo sites, source codes, and references. Use this page to quickly identify which sample matches your needs and explore working examples. -## Web Integrations +## Web SDK 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 +### 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/) +- Site: [Client‑Side UID2 Integration Example using 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 +### 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/) +- Site: [Client‑Server UID2 Integration Example using JavaScript SDK](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) +### Server‑Side Integration (No Client SDK) -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. +This sample is for publishers who want all UID2 operations (token generation + identity management) to occur on the server side, offering maximum control and security by not exposing operator keys or logic in the browser. -- Site: [Server-Only UID2 Integration Example](https://example-srvonly-integ.uidapi.com/login) +- Site: [Server-Side 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) @@ -46,7 +46,7 @@ This section includes a sample page for generating UID2 tokens to be passed by P 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/) +- Site: [Client‑Side UID2 SDK Integration Example with Prebid.js](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) @@ -58,7 +58,7 @@ This section includes sample pages for passing UID2 identity data to Google's ad 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/) +- Site: [Client‑Side UID2 SDK Integration Example with Google 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) @@ -66,31 +66,32 @@ This sample is for publishers who want a purely client-side integration with GAM 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/) +- Site: [React Client-Side UID2 SDK 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) +### 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: [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) + ### 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) +- Site: [Server-Side UID2 SDK 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 From 8ea4d4001f78c3b80711ce60f6d617d0c312c073 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Wed, 22 Oct 2025 14:35:11 -0600 Subject: [PATCH 2/2] clean up headers and revert descriptions --- docs/ref-info/integration-sample-sites.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index fa6699a2d..3121460fa 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -8,9 +8,9 @@ import Link from '@docusaurus/Link'; # Integration Samples and Tools -This page lists all official UID2 sample implementations highlighting common integrations for websites, along with links to live demo sites, source codes, and references. Use this page to quickly identify which sample matches your needs and explore working examples. +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 SDK Integrations +## 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). @@ -30,9 +30,9 @@ This sample is for publishers who want more control over UID2 token creation (ha - 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) -### Server‑Side Integration (No Client SDK) +### Server‑Side Integration for UID2 -This sample is for publishers who want all UID2 operations (token generation + identity management) to occur on the server side, offering maximum control and security by not exposing operator keys or logic in the browser. +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-Side 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) @@ -85,7 +85,7 @@ This sample is for publishers who want a hybrid approach with token generation o This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security. -- Site: [Server-Side UID2 SDK Integration Example with Google Secure Signals](https://secure-signals-server-side-integ.uidapi.com/login) +- 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: