From 127c1923d0ebf71aaee499d9d4196b3ca04e4a47 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 10:10:25 -0600 Subject: [PATCH 01/45] create reference page and link to sidebar --- docs/guides/integration-sample-sites.md | 11 + docs/snippets/_sample-sites-reference.mdx | 100 +++ sidebars.js | 857 +++++++++++----------- 3 files changed, 539 insertions(+), 429 deletions(-) create mode 100644 docs/guides/integration-sample-sites.md create mode 100644 docs/snippets/_sample-sites-reference.mdx diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md new file mode 100644 index 000000000..f7d483c48 --- /dev/null +++ b/docs/guides/integration-sample-sites.md @@ -0,0 +1,11 @@ +--- +title: UID2 Sample Sites Reference +description: Overview and reference for all UID2 sample site integrations. +hide_table_of_contents: false +--- + +import SampleSitesReference from '../snippets/_sample-sites-reference.mdx'; + +# UID2 Sample Sites + + \ No newline at end of file diff --git a/docs/snippets/_sample-sites-reference.mdx b/docs/snippets/_sample-sites-reference.mdx new file mode 100644 index 000000000..6f81e86b8 --- /dev/null +++ b/docs/snippets/_sample-sites-reference.mdx @@ -0,0 +1,100 @@ +import Link from '@docusaurus/Link'; + + +This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and the primary use cases each serves. Use this page to quickly find, compare, and switch between sample integrations that match your setup. + +--- + +### Client-Side and JavaScript Integrations + +#### UID2 CSTG with JavaScript SDK + +- [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK](https://uid2-pub-cstg-js-integ.uidapi.com) +- Code: `uid2-web-integrations/examples/cstg` +- Docs: [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) +- Use Case: For publishers who want a purely client-side integration with consent gating (CSTG). Best for fast prototyping or when minimal server infrastructure is available. + +#### UID2 Client-Server JS SDK (no CSTG) + +- [UID2 Publisher Standard Integration Example](https://uid2-pub-js-integ.uidapi.com) +- Code: `uid2-web-integrations/examples/js-sdk` +- Docs: [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) +- Use Case: For publishers who already have a backend and want token generation centralized server-side, while still running UID2 logic on the client. + +#### UID2 Server-Only (Server-Side) + +- [UID2 Publisher Server-Only Integration Example](https://uid2-pub-srvonly-integ.uidapi.com) +- Code: `uid2-examples/publisher/server_only` +- Docs: [Publisher Integration Guide, Server-Side](../guides/integration-publisher-server-side.md) +- Use Case: For publishers who want all UID2 logic handled server-side (no client SDK). Good for environments with strict client limitations or security requirements. + + +--- + +### Prebid Integrations + +#### UID2 CSTG with Prebid.js + +- [UID2 Prebid.js Client-Side Integration Example](https://uid2-prebid-cstg-integ.uidapi.com) +- Code: `uid2docs/static/examples/cstg-prebid-example` +- Docs: [Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) +- Use Case: For publishers using Prebid header bidding who want client-side token generation with consent gating. + + +--- + +### Google Secure Signals Integrations + +#### Client-Side Secure Signals + +- [UID2 Publisher Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-integ.uidapi.com) +- Code: `uid2-web-integrations/examples/google-secure-signals-integration/client_side` +- Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) +- Use Case: For publishers who want front-end only integration with GAM Secure Signals. + +#### React Client-Side Secure Signals + +- [UID2 Publisher Client-Side React Integration Example](https://secure-signals-react-integ.uidapi.com) +- Code: `uid2-web-integrations/examples/google-secure-signals-integration/react_client_side` +- Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) +- Use Case: For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. + +#### Server-Side Secure Signals + +- [Server-Side UID2 Integration Example with Google Secure Signals](https://secure-signals-srvonly-integ.uidapi.com) +- Code: `uid2-web-integrations/examples/google-secure-signals-integration/server_side` +- Docs: [Secure Signals Sample Implementation](../guides/integration-google-ss.md) +- Additional Domains: + - `secure-signals-srvonly-integ.uidapi.com` + - `esp-srvonly-integ.uidapi.com` +- Use Case: For publishers who want all Secure Signals logic server-side for better control and security. + +#### Hybrid Client-Server Secure Signals (JS SDK v3) + +- [UID2 Publisher Hybrid Integration Example (Server + JS SDK + Secure Signals)](https://secure-signals-jssdk-integ.uidapi.com) +- Code: `uid2-web-integrations/examples/google-secure-signals-integration/with_sdk_v3` +- Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) +- Additional Domains: + - `secure-signals-jssdk-integ.uidapi.com` + - `esp-jssdk-integ.uidapi.com` +- Use Case: For publishers who want a hybrid approach (token generation on the server, client SDK logic for secure signals). + +--- + +### Utilities + +#### UID2 Hashing Tool + +- [UID2 Hashing Tool](https://uid2-hashing-tool.uidapi.com) +- Code: `uid2docs/static/examples/hashing-tool` +- Docs: [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) +- Use Case: For developers or clients validating data preparation, such as hashing and normalization of emails before token requests. + +--- + +:::tip +For additional integration examples, see: +- [Publisher Web Integration Overview](../guides/integration-options-publisher-web.md) +- [Prebid Integration Overview](../guides/integration-prebid.md) +- [Google Ad Manager Secure Signals Guide](../guides/integration-google-ss.md) +::: \ No newline at end of file diff --git a/sidebars.js b/sidebars.js index 637ae41a6..d4af74094 100644 --- a/sidebars.js +++ b/sidebars.js @@ -1,17 +1,17 @@ function removeItems(sidebar, ...remove) { const result = []; for (let item of sidebar) { - if (typeof item === 'string') - { - if (!remove.includes(item)) result.push({ - type: 'ref', id: item - }); - } - else { + if (typeof item === "string") { + if (!remove.includes(item)) + result.push({ + type: "ref", + id: item, + }); + } else { if (!remove.includes(item.label)) { - const {items, ...rest} = item; + const { items, ...rest } = item; const keepItems = removeItems(items, ...remove); - if (keepItems?.length > 0) result.push({...rest, items: keepItems}); + if (keepItems?.length > 0) result.push({ ...rest, items: keepItems }); } } } @@ -19,510 +19,509 @@ function removeItems(sidebar, ...remove) { } const fullSidebar = [ - { - type: 'category', - label: 'Overview', + type: "category", + label: "Overview", link: { - type: 'doc', - id: 'intro', + type: "doc", + id: "intro", }, collapsed: false, items: [ - 'ref-info/uid-identifier-types', - 'ref-info/uid-components', - 'ref-info/uid-workflows', + "ref-info/uid-identifier-types", + "ref-info/uid-components", + "ref-info/uid-workflows", ], }, - - { - type: 'category', - label: 'UID2 Participants', - link: { - type: 'doc', - id: 'overviews/participants-overview', - }, - collapsed: true, - items: [ - 'overviews/overview-publishers', - 'overviews/overview-advertisers', - 'overviews/overview-dsps', - 'overviews/overview-data-providers', - ], + + { + type: "category", + label: "UID2 Participants", + link: { + type: "doc", + id: "overviews/participants-overview", }, - + collapsed: true, + items: [ + "overviews/overview-publishers", + "overviews/overview-advertisers", + "overviews/overview-dsps", + "overviews/overview-data-providers", + ], + }, - { - type: 'category', - label: 'Getting Started', - link: { - type: 'generated-index', - }, - collapsed: true, - items: [ - 'getting-started/gs-account-setup', - 'getting-started/gs-credentials', - 'getting-started/gs-permissions', - 'getting-started/gs-faqs', - 'getting-started/gs-sharing', - ], + { + type: "category", + label: "Getting Started", + link: { + type: "generated-index", }, + collapsed: true, + items: [ + "getting-started/gs-account-setup", + "getting-started/gs-credentials", + "getting-started/gs-permissions", + "getting-started/gs-faqs", + "getting-started/gs-sharing", + ], + }, - { - type: 'category', - label: 'UID2 Portal', - link: { - type: 'generated-index', - }, - collapsed: true, - items: [ - 'portal/portal-overview', - 'portal/portal-getting-started', - 'portal/sharing-permissions', - 'portal/api-keys', - 'portal/client-side-integration', - 'portal/participant-info', - 'portal/team-members', - 'portal/email-contacts', - 'portal/audit-trail', - ], + { + type: "category", + label: "UID2 Portal", + link: { + type: "generated-index", }, + collapsed: true, + items: [ + "portal/portal-overview", + "portal/portal-getting-started", + "portal/sharing-permissions", + "portal/api-keys", + "portal/client-side-integration", + "portal/participant-info", + "portal/team-members", + "portal/email-contacts", + "portal/audit-trail", + ], + }, - { - type: 'category', - label: 'Integration Guides', - link: { - type: 'doc', - id: 'guides/summary-guides', - }, - collapsed: false, + { + type: "category", + label: "Integration Guides", + link: { + type: "doc", + id: "guides/summary-guides", + }, + collapsed: false, - items: [ - { - type: 'category', - label: 'Publisher Integrations', - link: { - type: 'doc', - id: 'guides/integration-options-publisher-all', + items: [ + { + type: "category", + label: "Publisher Integrations", + link: { + type: "doc", + id: "guides/integration-options-publisher-all", }, - collapsed: true, + collapsed: true, - items: [ - { - type: 'category', - label: 'Web', - link: { - type: 'doc', - id: 'guides/integration-options-publisher-web', - }, - collapsed: true, - items: [ - { - type: 'category', - label: 'Prebid', - link: { - type: 'doc', - id: 'guides/integration-prebid', - }, - collapsed: true, - items: [ - 'guides/integration-prebid-client-side', - 'guides/integration-prebid-client-server', - ], + items: [ + { + type: "category", + label: "Web", + link: { + type: "doc", + id: "guides/integration-options-publisher-web", + }, + collapsed: true, + items: [ + { + type: "category", + label: "Prebid", + link: { + type: "doc", + id: "guides/integration-prebid", }, + collapsed: true, + items: [ + "guides/integration-prebid-client-side", + "guides/integration-prebid-client-server", + ], + }, { - type: 'category', - label: 'JavaScript', + type: "category", + label: "JavaScript", link: { - type: 'doc', - id: 'guides/integration-javascript', + type: "doc", + id: "guides/integration-javascript", }, collapsed: true, items: [ - 'guides/integration-javascript-client-side', - 'guides/integration-javascript-client-server', + "guides/integration-javascript-client-side", + "guides/integration-javascript-client-server", ], }, - 'guides/integration-publisher-server-side', - 'guides/integration-google-ss', + "guides/integration-publisher-server-side", + "guides/integration-google-ss", ], }, { - type: 'category', - label: 'Mobile', + type: "category", + label: "Mobile", link: { - type: 'doc', - id: 'guides/integration-mobile-overview', + type: "doc", + id: "guides/integration-mobile-overview", }, collapsed: true, items: [ - 'guides/integration-mobile-client-side', - 'guides/integration-mobile-client-server', - 'guides/integration-mobile-server-side', + "guides/integration-mobile-client-side", + "guides/integration-mobile-client-server", + "guides/integration-mobile-server-side", ], }, - 'guides/integration-ctv-guide', + "guides/integration-ctv-guide", { - type: 'category', - label: 'Prebid', + type: "category", + label: "Prebid", link: { - type: 'doc', - id: 'guides/integration-prebid', + type: "doc", + id: "guides/integration-prebid", }, collapsed: true, items: [ - 'guides/integration-prebid-client-side', - 'guides/integration-prebid-client-server', - 'guides/integration-prebid-mobile-summary', + "guides/integration-prebid-client-side", + "guides/integration-prebid-client-server", + "guides/integration-prebid-mobile-summary", ], }, { - type: 'category', - label: 'Google Ad Manager', + type: "category", + label: "Google Ad Manager", link: { - type: 'generated-index', + type: "generated-index", }, collapsed: true, items: [ - 'guides/integration-google-ss', - 'guides/mobile-plugin-gma-android', - 'guides/mobile-plugin-gma-ios', - 'guides/mobile-plugin-ima-android', - 'guides/mobile-plugin-ima-ios', + "guides/integration-google-ss", + "guides/mobile-plugin-gma-android", + "guides/mobile-plugin-gma-ios", + "guides/mobile-plugin-ima-android", + "guides/mobile-plugin-ima-ios", ], }, - 'guides/integration-liveramp-tips', - + "guides/integration-liveramp-tips", ], }, - -{ - type: 'category', - label: 'Advertiser/Data Provider Integrations', - link: { - type: 'generated-index', - }, - collapsed: true, - - items: [ - { - type: 'category', - label: 'Integration Overview', - link: { - type: 'doc', - id: 'guides/integration-advertiser-dataprovider-overview', - }, - collapsed: true, - items: [ - { - type: 'category', - label: 'Snowflake', - link: { - type: 'doc', - id: 'guides/integration-snowflake', - }, - collapsed: true, - items: [ - 'guides/integration-snowflake-previous', - ], + { + type: "category", + label: "Advertiser/Data Provider Integrations", + link: { + type: "generated-index", }, + collapsed: true, - 'guides/integration-aws-entity-resolution', - 'guides/integration-advertiser-dataprovider-endpoints', - ], - }, + items: [ + { + type: "category", + label: "Integration Overview", + link: { + type: "doc", + id: "guides/integration-advertiser-dataprovider-overview", + }, + collapsed: true, + items: [ + { + type: "category", + label: "Snowflake", + link: { + type: "doc", + id: "guides/integration-snowflake", + }, + collapsed: true, + items: ["guides/integration-snowflake-previous"], + }, - 'guides/integration-javascript-client-side', + "guides/integration-aws-entity-resolution", + "guides/integration-advertiser-dataprovider-endpoints", + ], + }, -], -}, + "guides/integration-javascript-client-side", + ], + }, - { - type: 'category', - label: 'DSP Integrations', - link: { - type: 'generated-index', - }, - collapsed: true, - items: [ - 'guides/dsp-guide', - 'guides/integration-dsp-no-sdk', - ], + { + type: "category", + label: "DSP Integrations", + link: { + type: "generated-index", }, + collapsed: true, + items: ["guides/dsp-guide", "guides/integration-dsp-no-sdk"], + }, - { - type: 'category', - label: 'Private Operator Integrations', - link: { - type: 'doc', - id: 'guides/integration-options-private-operator', - }, - collapsed: true, - items: [ - 'guides/operator-guide-aws-marketplace', - 'guides/operator-private-gcp-confidential-space', - 'guides/operator-guide-azure-enclave', - 'guides/operator-guide-aks-enclave', - ], + { + type: "category", + label: "Private Operator Integrations", + link: { + type: "doc", + id: "guides/integration-options-private-operator", }, - ], - }, - - { - type: 'category', - label: 'SDKs', - link: { - type: 'doc', - id: 'sdks/summary-sdks', + collapsed: true, + items: [ + "guides/operator-guide-aws-marketplace", + "guides/operator-private-gcp-confidential-space", + "guides/operator-guide-azure-enclave", + "guides/operator-guide-aks-enclave", + ], }, - collapsed: true, - items: [ - { - type: 'category', - label: 'SDK for JavaScript', - link: { - type: 'doc', - id: 'sdks/sdk-ref-javascript', - }, - collapsed: true, - items: [ - 'sdks/sdk-ref-javascript-v3', - ], + { + type: "category", + label: "UID2 Sample Sites", + link: { + type: "doc", + id: "guides/integration-sample-sites", }, + items: [], // ← required even if empty! + }, + ], + }, - 'sdks/sdk-ref-java', - 'sdks/sdk-ref-python', - 'sdks/sdk-ref-csharp-dotnet', - 'sdks/sdk-ref-cplusplus', - 'sdks/sdk-ref-android', - 'sdks/sdk-ref-ios', - ], + { + type: "category", + label: "SDKs", + link: { + type: "doc", + id: "sdks/summary-sdks", }, - - { - type: 'category', - label: 'Endpoints (v2)', - link: { - type: 'doc', - id: 'endpoints/summary-endpoints', + collapsed: true, + items: [ + { + type: "category", + label: "SDK for JavaScript", + link: { + type: "doc", + id: "sdks/sdk-ref-javascript", + }, + collapsed: true, + items: ["sdks/sdk-ref-javascript-v3"], }, - collapsed: true, - items: [ - 'endpoints/post-token-generate', - 'endpoints/post-token-validate', - 'endpoints/post-token-refresh', - 'endpoints/post-identity-buckets', - 'endpoints/post-identity-map', - 'endpoints/post-optout-status', - ], - }, - { - type: 'category', - label: 'UID2 Sharing', - link: { - type: 'generated-index', - }, - collapsed: false, - items: [ - 'sharing/sharing-overview', - 'sharing/sharing-security', - 'sharing/sharing-use-cases', - { - type: 'category', - label: 'Tokenized Sharing', - link: { - type: 'generated-index', - }, - collapsed: true, - items: [ - 'sharing/sharing-tokenized-overview', - 'sharing/sharing-tokenized-from-data-bid-stream', - 'sharing/sharing-tokenized-from-data-pixel', - 'sharing/sharing-tokenized-from-raw', - ], - }, - 'sharing/sharing-raw', - 'sharing/sharing-best-practices', - ], + "sdks/sdk-ref-java", + "sdks/sdk-ref-python", + "sdks/sdk-ref-csharp-dotnet", + "sdks/sdk-ref-cplusplus", + "sdks/sdk-ref-android", + "sdks/sdk-ref-ios", + ], + }, + + { + type: "category", + label: "Endpoints (v2)", + link: { + type: "doc", + id: "endpoints/summary-endpoints", }, + collapsed: true, + items: [ + "endpoints/post-token-generate", + "endpoints/post-token-validate", + "endpoints/post-token-refresh", + "endpoints/post-identity-buckets", + "endpoints/post-identity-map", + "endpoints/post-optout-status", + ], + }, - { - type: 'category', - label: 'Reference Information', - link: { - type: 'generated-index', - }, - collapsed: true, - items: [ - 'getting-started/gs-auth', - 'getting-started/gs-environments', - 'getting-started/gs-encryption-decryption', - 'getting-started/gs-normalization-encoding', - 'getting-started/gs-opt-out', - 'ref-info/ref-operators-public-private', - 'ref-info/ref-integration-approaches', - 'ref-info/ref-tokens', - 'ref-info/ref-how-uid-is-created', - 'ref-info/ref-server-side-token-generation', - 'ref-info/ref-integration-sso-providers', - ], + { + type: "category", + label: "UID2 Sharing", + link: { + type: "generated-index", }, + collapsed: false, + items: [ + "sharing/sharing-overview", + "sharing/sharing-security", + "sharing/sharing-use-cases", + { + type: "category", + label: "Tokenized Sharing", + link: { + type: "generated-index", + }, + collapsed: true, + items: [ + "sharing/sharing-tokenized-overview", + "sharing/sharing-tokenized-from-data-bid-stream", + "sharing/sharing-tokenized-from-data-pixel", + "sharing/sharing-tokenized-from-raw", + ], + }, + "sharing/sharing-raw", + "sharing/sharing-best-practices", + ], + }, - 'ref-info/glossary-uid', - 'ref-info/updates-doc', - ]; + { + type: "category", + label: "Reference Information", + link: { + type: "generated-index", + }, + collapsed: true, + items: [ + "getting-started/gs-auth", + "getting-started/gs-environments", + "getting-started/gs-encryption-decryption", + "getting-started/gs-normalization-encoding", + "getting-started/gs-opt-out", + "ref-info/ref-operators-public-private", + "ref-info/ref-integration-approaches", + "ref-info/ref-tokens", + "ref-info/ref-how-uid-is-created", + "ref-info/ref-server-side-token-generation", + "ref-info/ref-integration-sso-providers", + ], + }, + "ref-info/glossary-uid", + "ref-info/updates-doc", +]; const sidebars = { docs: fullSidebar, - sidebarPublishers: removeItems(fullSidebar, - 'overviews/overview-advertisers', - 'overviews/overview-dsps', - 'overviews/overview-data-providers', - 'Advertiser/Data Provider Integrations', - 'guides/integration-advertiser-dataprovider-overview', - 'guides/integration-snowflake', - 'guides/integration-snowflake-previous', - 'guides/integration-aws-entity-resolution', - 'guides/advertiser-dataprovider-endpoints', - 'DSP Integrations', - 'guides/dsp-guide', - 'endpoints/post-identity-buckets', - 'endpoints/post-identity-map', - 'endpoints/post-optout-status' + sidebarPublishers: removeItems( + fullSidebar, + "overviews/overview-advertisers", + "overviews/overview-dsps", + "overviews/overview-data-providers", + "Advertiser/Data Provider Integrations", + "guides/integration-advertiser-dataprovider-overview", + "guides/integration-snowflake", + "guides/integration-snowflake-previous", + "guides/integration-aws-entity-resolution", + "guides/advertiser-dataprovider-endpoints", + "DSP Integrations", + "guides/dsp-guide", + "endpoints/post-identity-buckets", + "endpoints/post-identity-map", + "endpoints/post-optout-status", ), - sidebarAdvertisers: removeItems(fullSidebar, - 'overviews/overview-publishers', - 'overviews/overview-dsps', - 'overviews/overview-data-providers', - 'Publisher Integrations', - 'Web', - 'guides/integration-options-publisher-all', - 'guides/integration-options-publisher-web', - 'Prebid', - 'guides/integration-prebid', - 'guides/integration-prebid-client-side', - 'guides/integration-prebid-client-server', - 'JavaScript', - 'guides/integration-javascript', - 'guides/integration-javascript-client-server', - 'Server-Only', - 'guides/integration-publisher-server-side', - 'GAM Secure Signals', - 'guides/integration-google-ss', - 'Mobile', - 'guides/sdk-ref-android', - 'guides/sdk-ref-ios', - 'Prebid', - 'guides/integration-prebid', - 'guides/integration-prebid-client-side', - 'guides/integration-prebid-client-server', - 'Google Ad Manager', - 'guides/integration-google-ss', - 'guides/mobile-plugin-gma-android', - 'guides/mobile-plugin-gma-ios', - 'guides/mobile-plugin-ima-android', - 'guides/mobile-plugin-ima-ios', - 'DSP Integrations', - 'guides/dsp-guide', - 'endpoints/post-token-generate', - 'endpoints/post-token-validate', - 'endpoints/post-token-refresh', - 'sharing/sharing-bid-stream' - ), - - sidebarDSPs: removeItems(fullSidebar, - 'overviews/overview-publishers', - 'overviews/overview-advertisers', - 'overviews/overview-data-providers', - 'Publisher Integrations', - 'Web', - 'guides/integration-options-publisher-all', - 'guides/integration-options-publisher-web', - 'Prebid', - 'guides/integration-prebid', - 'guides/integration-prebid-client-side', - 'guides/integration-prebid-client-server', - 'JavaScript', - 'guides/integration-javascript', - 'guides/integration-javascript-client-side', - 'guides/integration-javascript-client-server', - 'Server-Only', - 'guides/integration-publisher-server-side', - 'GAM Secure Signals', - 'guides/integration-google-ss', - 'Mobile', - 'guides/sdk-ref-android', - 'guides/sdk-ref-ios', - 'Prebid', - 'guides/integration-prebid', - 'guides/integration-prebid-client-side', - 'guides/integration-prebid-client-server', - 'Google Ad Manager', - 'guides/integration-google-ss', - 'guides/mobile-plugin-gma-android', - 'guides/mobile-plugin-gma-ios', - 'guides/mobile-plugin-ima-android', - 'guides/mobile-plugin-ima-ios', - 'Advertiser/Data Provider Integrations', - 'guides/integration-advertiser-dataprovider-overview', - 'guides/integration-snowflake', - 'guides/integration-snowflake-previous', - 'guides/integration-aws-entity-resolution', - 'guides/advertiser-dataprovider-endpoints', - 'sharing/sharing-bid-stream' - ), + sidebarAdvertisers: removeItems( + fullSidebar, + "overviews/overview-publishers", + "overviews/overview-dsps", + "overviews/overview-data-providers", + "Publisher Integrations", + "Web", + "guides/integration-options-publisher-all", + "guides/integration-options-publisher-web", + "Prebid", + "guides/integration-prebid", + "guides/integration-prebid-client-side", + "guides/integration-prebid-client-server", + "JavaScript", + "guides/integration-javascript", + "guides/integration-javascript-client-server", + "Server-Only", + "guides/integration-publisher-server-side", + "GAM Secure Signals", + "guides/integration-google-ss", + "Mobile", + "guides/sdk-ref-android", + "guides/sdk-ref-ios", + "Prebid", + "guides/integration-prebid", + "guides/integration-prebid-client-side", + "guides/integration-prebid-client-server", + "Google Ad Manager", + "guides/integration-google-ss", + "guides/mobile-plugin-gma-android", + "guides/mobile-plugin-gma-ios", + "guides/mobile-plugin-ima-android", + "guides/mobile-plugin-ima-ios", + "DSP Integrations", + "guides/dsp-guide", + "endpoints/post-token-generate", + "endpoints/post-token-validate", + "endpoints/post-token-refresh", + "sharing/sharing-bid-stream", + ), - sidebarDataProviders: removeItems(fullSidebar, - 'overviews/overview-publishers', - 'overviews/overview-advertisers', - 'overviews/overview-dsps', - 'Publisher Integrations', - 'Web', - 'guides/integration-options-publisher-all', - 'guides/integration-options-publisher-web', - 'Prebid', - 'guides/integration-prebid', - 'guides/integration-prebid-client-side', - 'guides/integration-prebid-client-server', - 'JavaScript', - 'guides/integration-javascript', - 'guides/integration-javascript-client-server', - 'Server-Only', - 'guides/integration-publisher-server-side', - 'GAM Secure Signals', - 'guides/integration-google-ss', - 'Mobile', - 'guides/sdk-ref-android', - 'guides/sdk-ref-ios', - 'Prebid', - 'guides/integration-prebid', - 'guides/integration-prebid-client-side', - 'guides/integration-prebid-client-server', - 'Google Ad Manager', - 'guides/integration-google-ss', - 'guides/mobile-plugin-gma-android', - 'guides/mobile-plugin-gma-ios', - 'guides/mobile-plugin-ima-android', - 'guides/mobile-plugin-ima-ios', - 'DSP Integrations', - 'guides/dsp-guide', - 'endpoints/post-token-generate', - 'endpoints/post-token-validate', - 'endpoints/post-token-refresh', - 'sharing/sharing-bid-stream' + sidebarDSPs: removeItems( + fullSidebar, + "overviews/overview-publishers", + "overviews/overview-advertisers", + "overviews/overview-data-providers", + "Publisher Integrations", + "Web", + "guides/integration-options-publisher-all", + "guides/integration-options-publisher-web", + "Prebid", + "guides/integration-prebid", + "guides/integration-prebid-client-side", + "guides/integration-prebid-client-server", + "JavaScript", + "guides/integration-javascript", + "guides/integration-javascript-client-side", + "guides/integration-javascript-client-server", + "Server-Only", + "guides/integration-publisher-server-side", + "GAM Secure Signals", + "guides/integration-google-ss", + "Mobile", + "guides/sdk-ref-android", + "guides/sdk-ref-ios", + "Prebid", + "guides/integration-prebid", + "guides/integration-prebid-client-side", + "guides/integration-prebid-client-server", + "Google Ad Manager", + "guides/integration-google-ss", + "guides/mobile-plugin-gma-android", + "guides/mobile-plugin-gma-ios", + "guides/mobile-plugin-ima-android", + "guides/mobile-plugin-ima-ios", + "Advertiser/Data Provider Integrations", + "guides/integration-advertiser-dataprovider-overview", + "guides/integration-snowflake", + "guides/integration-snowflake-previous", + "guides/integration-aws-entity-resolution", + "guides/advertiser-dataprovider-endpoints", + "sharing/sharing-bid-stream", ), + sidebarDataProviders: removeItems( + fullSidebar, + "overviews/overview-publishers", + "overviews/overview-advertisers", + "overviews/overview-dsps", + "Publisher Integrations", + "Web", + "guides/integration-options-publisher-all", + "guides/integration-options-publisher-web", + "Prebid", + "guides/integration-prebid", + "guides/integration-prebid-client-side", + "guides/integration-prebid-client-server", + "JavaScript", + "guides/integration-javascript", + "guides/integration-javascript-client-server", + "Server-Only", + "guides/integration-publisher-server-side", + "GAM Secure Signals", + "guides/integration-google-ss", + "Mobile", + "guides/sdk-ref-android", + "guides/sdk-ref-ios", + "Prebid", + "guides/integration-prebid", + "guides/integration-prebid-client-side", + "guides/integration-prebid-client-server", + "Google Ad Manager", + "guides/integration-google-ss", + "guides/mobile-plugin-gma-android", + "guides/mobile-plugin-gma-ios", + "guides/mobile-plugin-ima-android", + "guides/mobile-plugin-ima-ios", + "DSP Integrations", + "guides/dsp-guide", + "endpoints/post-token-generate", + "endpoints/post-token-validate", + "endpoints/post-token-refresh", + "sharing/sharing-bid-stream", + ), }; module.exports = sidebars; From f2c41770b408e52ea247ee3ab5dc3eb69872cfb4 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 10:21:15 -0600 Subject: [PATCH 02/45] consilidate sample site reference file --- docs/guides/integration-sample-sites.md | 99 ++++++++++++++++++++- docs/snippets/_sample-sites-reference.mdx | 100 ---------------------- 2 files changed, 97 insertions(+), 102 deletions(-) delete mode 100644 docs/snippets/_sample-sites-reference.mdx diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index f7d483c48..076dbbca5 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -4,8 +4,103 @@ description: Overview and reference for all UID2 sample site integrations. hide_table_of_contents: false --- -import SampleSitesReference from '../snippets/_sample-sites-reference.mdx'; +import Link from '@docusaurus/Link'; # UID2 Sample Sites - \ No newline at end of file +This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and the primary use cases each serves. Use this page to quickly find, compare, and switch between sample integrations that match your setup. + +--- + +### Client-Side and JavaScript Integrations + +#### UID2 CSTG with JavaScript SDK + +- **Sample Site:** [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK](https://uid2-pub-cstg-js-integ.uidapi.com) +- **Code:** [`uid2-web-integrations/examples/cstg`](#) +- **Docs:** [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) +- **Use Case:** For publishers who want a purely client-side integration with consent gating (CSTG). Best for fast prototyping or when minimal server infrastructure is available. + +#### UID2 Client-Server JS SDK (no CSTG) + +- **Sample Site:** [UID2 Publisher Standard Integration Example](https://uid2-pub-js-integ.uidapi.com) +- **Code:** [`uid2-web-integrations/examples/js-sdk`](#) +- **Docs:** [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) +- **Use Case:** For publishers who already have a backend and want token generation centralized server-side, while still running UID2 logic on the client. + +#### UID2 Server-Only (Server-Side) + +- **Sample Site:** [UID2 Publisher Server-Only Integration Example](https://uid2-pub-srvonly-integ.uidapi.com) +- **Code:** [`uid2-examples/publisher/server_only`](#) +- **Docs:** [Publisher Integration Guide, Server-Side](../guides/integration-publisher-server-side.md) +- **Use Case:** For publishers who want all UID2 logic handled server-side (no client SDK). Good for environments with strict client limitations or security requirements. + +--- + +### Prebid Integrations + +#### UID2 CSTG with Prebid.js + +- **Sample Site:** [UID2 Prebid.js Client-Side Integration Example](https://uid2-prebid-cstg-integ.uidapi.com) +- **Code:** [`uid2docs/static/examples/cstg-prebid-example`](#) +- **Docs:** [Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) +- **Use Case:** For publishers using Prebid header bidding who want client-side token generation with consent gating. + +--- + +### Google Secure Signals Integrations + +#### Client-Side Secure Signals + +- **Sample Site:** [UID2 Publisher Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-integ.uidapi.com) +- **Code:** [`uid2-web-integrations/examples/google-secure-signals-integration/client_side`](#) +- **Docs:** [Secure Signals Integration Guide](../guides/integration-google-ss.md) +- **Use Case:** For publishers who want front-end only integration with GAM Secure Signals. + +#### React Client-Side Secure Signals + +- **Sample Site:** [UID2 Publisher Client-Side React Integration Example](https://secure-signals-react-integ.uidapi.com) +- **Code:** [`uid2-web-integrations/examples/google-secure-signals-integration/react_client_side`](#) +- **Docs:** [Secure Signals Integration Guide](../guides/integration-google-ss.md) +- **Use Case:** For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. + +#### Server-Side Secure Signals + +- **Sample Site:** [Server-Side UID2 Integration Example with Google Secure Signals](https://secure-signals-srvonly-integ.uidapi.com) +- **Code:** [`uid2-web-integrations/examples/google-secure-signals-integration/server_side`](#) +- **Docs:** [Secure Signals Sample Implementation](../guides/integration-google-ss.md) +- **Additional Domains:** + - `secure-signals-srvonly-integ.uidapi.com` + - `esp-srvonly-integ.uidapi.com` +- **Use Case:** For publishers who want all Secure Signals logic server-side for better control and security. + +#### Hybrid Client-Server Secure Signals (JS SDK v3) + +- **Sample Site:** [UID2 Publisher Hybrid Integration Example (Server + JS SDK + Secure Signals)](https://secure-signals-jssdk-integ.uidapi.com) +- **Code:** [`uid2-web-integrations/examples/google-secure-signals-integration/with_sdk_v3`](#) +- **Docs:** [Secure Signals Integration Guide](../guides/integration-google-ss.md) +- **Additional Domains:** + - `secure-signals-jssdk-integ.uidapi.com` + - `esp-jssdk-integ.uidapi.com` +- **Use Case:** For publishers who want a hybrid approach (token generation on the server, client SDK logic for secure signals). + +--- + +### Utilities + +#### UID2 Hashing Tool + +- **Sample Site:** [UID2 Hashing Tool](https://uid2-hashing-tool.uidapi.com) +- **Code:** [`uid2docs/static/examples/hashing-tool`](#) +- **Docs:** [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) +- **Use Case:** For developers or clients validating data preparation, such as hashing and normalization of emails before token requests. + +--- + +:::tip +For additional integration examples, see: + +- [Publisher Web Integration Overview](../guides/integration-options-publisher-web.md) +- [Prebid Integration Overview](../guides/integration-prebid.md) +- [Google Ad Manager Secure Signals Guide](../guides/integration-google-ss.md) + ::: diff --git a/docs/snippets/_sample-sites-reference.mdx b/docs/snippets/_sample-sites-reference.mdx deleted file mode 100644 index 6f81e86b8..000000000 --- a/docs/snippets/_sample-sites-reference.mdx +++ /dev/null @@ -1,100 +0,0 @@ -import Link from '@docusaurus/Link'; - - -This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and the primary use cases each serves. Use this page to quickly find, compare, and switch between sample integrations that match your setup. - ---- - -### Client-Side and JavaScript Integrations - -#### UID2 CSTG with JavaScript SDK - -- [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK](https://uid2-pub-cstg-js-integ.uidapi.com) -- Code: `uid2-web-integrations/examples/cstg` -- Docs: [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) -- Use Case: For publishers who want a purely client-side integration with consent gating (CSTG). Best for fast prototyping or when minimal server infrastructure is available. - -#### UID2 Client-Server JS SDK (no CSTG) - -- [UID2 Publisher Standard Integration Example](https://uid2-pub-js-integ.uidapi.com) -- Code: `uid2-web-integrations/examples/js-sdk` -- Docs: [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) -- Use Case: For publishers who already have a backend and want token generation centralized server-side, while still running UID2 logic on the client. - -#### UID2 Server-Only (Server-Side) - -- [UID2 Publisher Server-Only Integration Example](https://uid2-pub-srvonly-integ.uidapi.com) -- Code: `uid2-examples/publisher/server_only` -- Docs: [Publisher Integration Guide, Server-Side](../guides/integration-publisher-server-side.md) -- Use Case: For publishers who want all UID2 logic handled server-side (no client SDK). Good for environments with strict client limitations or security requirements. - - ---- - -### Prebid Integrations - -#### UID2 CSTG with Prebid.js - -- [UID2 Prebid.js Client-Side Integration Example](https://uid2-prebid-cstg-integ.uidapi.com) -- Code: `uid2docs/static/examples/cstg-prebid-example` -- Docs: [Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) -- Use Case: For publishers using Prebid header bidding who want client-side token generation with consent gating. - - ---- - -### Google Secure Signals Integrations - -#### Client-Side Secure Signals - -- [UID2 Publisher Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-integ.uidapi.com) -- Code: `uid2-web-integrations/examples/google-secure-signals-integration/client_side` -- Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) -- Use Case: For publishers who want front-end only integration with GAM Secure Signals. - -#### React Client-Side Secure Signals - -- [UID2 Publisher Client-Side React Integration Example](https://secure-signals-react-integ.uidapi.com) -- Code: `uid2-web-integrations/examples/google-secure-signals-integration/react_client_side` -- Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) -- Use Case: For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. - -#### Server-Side Secure Signals - -- [Server-Side UID2 Integration Example with Google Secure Signals](https://secure-signals-srvonly-integ.uidapi.com) -- Code: `uid2-web-integrations/examples/google-secure-signals-integration/server_side` -- Docs: [Secure Signals Sample Implementation](../guides/integration-google-ss.md) -- Additional Domains: - - `secure-signals-srvonly-integ.uidapi.com` - - `esp-srvonly-integ.uidapi.com` -- Use Case: For publishers who want all Secure Signals logic server-side for better control and security. - -#### Hybrid Client-Server Secure Signals (JS SDK v3) - -- [UID2 Publisher Hybrid Integration Example (Server + JS SDK + Secure Signals)](https://secure-signals-jssdk-integ.uidapi.com) -- Code: `uid2-web-integrations/examples/google-secure-signals-integration/with_sdk_v3` -- Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) -- Additional Domains: - - `secure-signals-jssdk-integ.uidapi.com` - - `esp-jssdk-integ.uidapi.com` -- Use Case: For publishers who want a hybrid approach (token generation on the server, client SDK logic for secure signals). - ---- - -### Utilities - -#### UID2 Hashing Tool - -- [UID2 Hashing Tool](https://uid2-hashing-tool.uidapi.com) -- Code: `uid2docs/static/examples/hashing-tool` -- Docs: [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) -- Use Case: For developers or clients validating data preparation, such as hashing and normalization of emails before token requests. - ---- - -:::tip -For additional integration examples, see: -- [Publisher Web Integration Overview](../guides/integration-options-publisher-web.md) -- [Prebid Integration Overview](../guides/integration-prebid.md) -- [Google Ad Manager Secure Signals Guide](../guides/integration-google-ss.md) -::: \ No newline at end of file From 3959fbd1708ed5fa9261fc6a03d434fb5e453ed2 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 10:29:28 -0600 Subject: [PATCH 03/45] update formatting and note at bottom of page --- docs/guides/integration-sample-sites.md | 82 +++++++++++++------------ sidebars.js | 2 +- 2 files changed, 43 insertions(+), 41 deletions(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index 076dbbca5..5ab93860e 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -16,24 +16,24 @@ This page lists all official UID2 sample implementations, with links to code, li #### UID2 CSTG with JavaScript SDK -- **Sample Site:** [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK](https://uid2-pub-cstg-js-integ.uidapi.com) -- **Code:** [`uid2-web-integrations/examples/cstg`](#) -- **Docs:** [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) -- **Use Case:** For publishers who want a purely client-side integration with consent gating (CSTG). Best for fast prototyping or when minimal server infrastructure is available. +- Sample Site: [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK](https://uid2-pub-cstg-js-integ.uidapi.com) +- Code: [`uid2-web-integrations/examples/cstg`](#) +- Docs: [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) +- Use Case: For publishers who want a purely client-side integration with consent gating (CSTG). Best for fast prototyping or when minimal server infrastructure is available. #### UID2 Client-Server JS SDK (no CSTG) -- **Sample Site:** [UID2 Publisher Standard Integration Example](https://uid2-pub-js-integ.uidapi.com) -- **Code:** [`uid2-web-integrations/examples/js-sdk`](#) -- **Docs:** [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) -- **Use Case:** For publishers who already have a backend and want token generation centralized server-side, while still running UID2 logic on the client. +- Sample Site: [UID2 Publisher Standard Integration Example](https://uid2-pub-js-integ.uidapi.com) +- Code: [`uid2-web-integrations/examples/js-sdk`](#) +- Docs: [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) +- Use Case: For publishers who already have a backend and want token generation centralized server-side, while still running UID2 logic on the client. #### UID2 Server-Only (Server-Side) -- **Sample Site:** [UID2 Publisher Server-Only Integration Example](https://uid2-pub-srvonly-integ.uidapi.com) -- **Code:** [`uid2-examples/publisher/server_only`](#) -- **Docs:** [Publisher Integration Guide, Server-Side](../guides/integration-publisher-server-side.md) -- **Use Case:** For publishers who want all UID2 logic handled server-side (no client SDK). Good for environments with strict client limitations or security requirements. +- Sample Site: [UID2 Publisher Server-Only Integration Example](https://uid2-pub-srvonly-integ.uidapi.com) +- Code: [`uid2-examples/publisher/server_only`](#) +- Docs: [Publisher Integration Guide, Server-Side](../guides/integration-publisher-server-side.md) +- Use Case: For publishers who want all UID2 logic handled server-side (no client SDK). Good for environments with strict client limitations or security requirements. --- @@ -41,10 +41,10 @@ This page lists all official UID2 sample implementations, with links to code, li #### UID2 CSTG with Prebid.js -- **Sample Site:** [UID2 Prebid.js Client-Side Integration Example](https://uid2-prebid-cstg-integ.uidapi.com) -- **Code:** [`uid2docs/static/examples/cstg-prebid-example`](#) -- **Docs:** [Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) -- **Use Case:** For publishers using Prebid header bidding who want client-side token generation with consent gating. +- Sample Site: [UID2 Prebid.js Client-Side Integration Example](https://uid2-prebid-cstg-integ.uidapi.com) +- Code: [`uid2docs/static/examples/cstg-prebid-example`](#) +- Docs: [Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) +- Use Case: For publishers using Prebid header bidding who want client-side token generation with consent gating. --- @@ -52,37 +52,37 @@ This page lists all official UID2 sample implementations, with links to code, li #### Client-Side Secure Signals -- **Sample Site:** [UID2 Publisher Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-integ.uidapi.com) -- **Code:** [`uid2-web-integrations/examples/google-secure-signals-integration/client_side`](#) -- **Docs:** [Secure Signals Integration Guide](../guides/integration-google-ss.md) -- **Use Case:** For publishers who want front-end only integration with GAM Secure Signals. +- Sample Site: [UID2 Publisher Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-integ.uidapi.com) +- Code: [`uid2-web-integrations/examples/google-secure-signals-integration/client_side`](#) +- Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) +- Use Case: For publishers who want front-end only integration with GAM Secure Signals. #### React Client-Side Secure Signals -- **Sample Site:** [UID2 Publisher Client-Side React Integration Example](https://secure-signals-react-integ.uidapi.com) -- **Code:** [`uid2-web-integrations/examples/google-secure-signals-integration/react_client_side`](#) -- **Docs:** [Secure Signals Integration Guide](../guides/integration-google-ss.md) -- **Use Case:** For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. +- Sample Site: [UID2 Publisher Client-Side React Integration Example](https://secure-signals-react-integ.uidapi.com) +- Code: [`uid2-web-integrations/examples/google-secure-signals-integration/react_client_side`](#) +- Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) +- Use Case: For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. #### Server-Side Secure Signals -- **Sample Site:** [Server-Side UID2 Integration Example with Google Secure Signals](https://secure-signals-srvonly-integ.uidapi.com) -- **Code:** [`uid2-web-integrations/examples/google-secure-signals-integration/server_side`](#) -- **Docs:** [Secure Signals Sample Implementation](../guides/integration-google-ss.md) -- **Additional Domains:** +- Sample Site: [Server-Side UID2 Integration Example with Google Secure Signals](https://secure-signals-srvonly-integ.uidapi.com) +- Code: [`uid2-web-integrations/examples/google-secure-signals-integration/server_side`](#) +- Docs: [Secure Signals Sample Implementation](../guides/integration-google-ss.md) +- Additional Domains: - `secure-signals-srvonly-integ.uidapi.com` - `esp-srvonly-integ.uidapi.com` -- **Use Case:** For publishers who want all Secure Signals logic server-side for better control and security. +- Use Case: For publishers who want all Secure Signals logic server-side for better control and security. #### Hybrid Client-Server Secure Signals (JS SDK v3) -- **Sample Site:** [UID2 Publisher Hybrid Integration Example (Server + JS SDK + Secure Signals)](https://secure-signals-jssdk-integ.uidapi.com) -- **Code:** [`uid2-web-integrations/examples/google-secure-signals-integration/with_sdk_v3`](#) -- **Docs:** [Secure Signals Integration Guide](../guides/integration-google-ss.md) -- **Additional Domains:** +- Sample Site: [UID2 Publisher Hybrid Integration Example (Server + JS SDK + Secure Signals)](https://secure-signals-jssdk-integ.uidapi.com) +- Code: [`uid2-web-integrations/examples/google-secure-signals-integration/with_sdk_v3`](#) +- Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) +- Additional Domains: - `secure-signals-jssdk-integ.uidapi.com` - `esp-jssdk-integ.uidapi.com` -- **Use Case:** For publishers who want a hybrid approach (token generation on the server, client SDK logic for secure signals). +- Use Case: For publishers who want a hybrid approach (token generation on the server, client SDK logic for secure signals). --- @@ -90,15 +90,17 @@ This page lists all official UID2 sample implementations, with links to code, li #### UID2 Hashing Tool -- **Sample Site:** [UID2 Hashing Tool](https://uid2-hashing-tool.uidapi.com) -- **Code:** [`uid2docs/static/examples/hashing-tool`](#) -- **Docs:** [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) -- **Use Case:** For developers or clients validating data preparation, such as hashing and normalization of emails before token requests. +- Sample Site: [UID2 Hashing Tool](https://uid2-hashing-tool.uidapi.com) +- Code: [`uid2docs/static/examples/hashing-tool`](#) +- Docs: [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) +- Use Case: For developers or clients validating data preparation, such as hashing and normalization of emails before token requests. --- -:::tip -For additional integration examples, see: +:::note +The sample sites above highlight some common integrations, but do not represent all available UID2 integration options. + +For the full list of supported integration types, see: - [Publisher Web Integration Overview](../guides/integration-options-publisher-web.md) - [Prebid Integration Overview](../guides/integration-prebid.md) diff --git a/sidebars.js b/sidebars.js index d4af74094..159bbbe8c 100644 --- a/sidebars.js +++ b/sidebars.js @@ -270,7 +270,7 @@ const fullSidebar = [ type: "doc", id: "guides/integration-sample-sites", }, - items: [], // ← required even if empty! + items: [], }, ], }, From 66268bfcdf1c77d74065c73f6696e3c45163429a Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 11:00:05 -0600 Subject: [PATCH 04/45] update links and bullet wording --- docs/guides/integration-sample-sites.md | 44 ++++++++++++------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index 5ab93860e..c86a409be 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -1,12 +1,12 @@ --- -title: UID2 Sample Sites Reference -description: Overview and reference for all UID2 sample site integrations. +title: UID2 Sites Reference +description: Overview and reference for all UID2 Site integrations. hide_table_of_contents: false --- import Link from '@docusaurus/Link'; -# UID2 Sample Sites +# UID2 Sites This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and the primary use cases each serves. Use this page to quickly find, compare, and switch between sample integrations that match your setup. @@ -16,22 +16,22 @@ This page lists all official UID2 sample implementations, with links to code, li #### UID2 CSTG with JavaScript SDK -- Sample Site: [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK](https://uid2-pub-cstg-js-integ.uidapi.com) -- Code: [`uid2-web-integrations/examples/cstg`](#) +- 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) - Docs: [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) - Use Case: For publishers who want a purely client-side integration with consent gating (CSTG). Best for fast prototyping or when minimal server infrastructure is available. #### UID2 Client-Server JS SDK (no CSTG) -- Sample Site: [UID2 Publisher Standard Integration Example](https://uid2-pub-js-integ.uidapi.com) -- Code: [`uid2-web-integrations/examples/js-sdk`](#) +- Site: [UID2 Publisher Standard 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) - Docs: [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) - Use Case: For publishers who already have a backend and want token generation centralized server-side, while still running UID2 logic on the client. #### UID2 Server-Only (Server-Side) -- Sample Site: [UID2 Publisher Server-Only Integration Example](https://uid2-pub-srvonly-integ.uidapi.com) -- Code: [`uid2-examples/publisher/server_only`](#) +- Site: [UID2 Publisher Server-Only 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) - Docs: [Publisher Integration Guide, Server-Side](../guides/integration-publisher-server-side.md) - Use Case: For publishers who want all UID2 logic handled server-side (no client SDK). Good for environments with strict client limitations or security requirements. @@ -41,8 +41,8 @@ This page lists all official UID2 sample implementations, with links to code, li #### UID2 CSTG with Prebid.js -- Sample Site: [UID2 Prebid.js Client-Side Integration Example](https://uid2-prebid-cstg-integ.uidapi.com) -- Code: [`uid2docs/static/examples/cstg-prebid-example`](#) +- 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) - Docs: [Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) - Use Case: For publishers using Prebid header bidding who want client-side token generation with consent gating. @@ -52,22 +52,22 @@ This page lists all official UID2 sample implementations, with links to code, li #### Client-Side Secure Signals -- Sample Site: [UID2 Publisher Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-integ.uidapi.com) -- Code: [`uid2-web-integrations/examples/google-secure-signals-integration/client_side`](#) +- Site: [UID2 Publisher Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-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) - Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) - Use Case: For publishers who want front-end only integration with GAM Secure Signals. #### React Client-Side Secure Signals -- Sample Site: [UID2 Publisher Client-Side React Integration Example](https://secure-signals-react-integ.uidapi.com) -- Code: [`uid2-web-integrations/examples/google-secure-signals-integration/react_client_side`](#) +- Site: [UID2 Publisher Client-Side React Integration Example](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) - Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) - Use Case: For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. #### Server-Side Secure Signals -- Sample Site: [Server-Side UID2 Integration Example with Google Secure Signals](https://secure-signals-srvonly-integ.uidapi.com) -- Code: [`uid2-web-integrations/examples/google-secure-signals-integration/server_side`](#) +- 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) - Docs: [Secure Signals Sample Implementation](../guides/integration-google-ss.md) - Additional Domains: - `secure-signals-srvonly-integ.uidapi.com` @@ -76,8 +76,8 @@ This page lists all official UID2 sample implementations, with links to code, li #### Hybrid Client-Server Secure Signals (JS SDK v3) -- Sample Site: [UID2 Publisher Hybrid Integration Example (Server + JS SDK + Secure Signals)](https://secure-signals-jssdk-integ.uidapi.com) -- Code: [`uid2-web-integrations/examples/google-secure-signals-integration/with_sdk_v3`](#) +- Site: [UID2 Publisher Hybrid Integration Example (Server + JS SDK + Secure Signals)](https://secure-signals-client-server-integ.uidapi.com/) +- Code: [`uid2-web-integrations/examples/google-secure-signals-integration/with_sdk_v3`](https://secure-signals-client-server-integ.uidapi.com/) - Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) - Additional Domains: - `secure-signals-jssdk-integ.uidapi.com` @@ -90,15 +90,15 @@ This page lists all official UID2 sample implementations, with links to code, li #### UID2 Hashing Tool -- Sample Site: [UID2 Hashing Tool](https://uid2-hashing-tool.uidapi.com) -- Code: [`uid2docs/static/examples/hashing-tool`](#) +- 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) - Docs: [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) - Use Case: For developers or clients validating data preparation, such as hashing and normalization of emails before token requests. --- :::note -The sample sites above highlight some common integrations, but do not represent all available UID2 integration options. +The Sites above highlight some common integrations, but do not represent all available UID2 integration options. For the full list of supported integration types, see: From 684588f12c8bc5656dfa1f2d4c7a6c211218b2df Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 12:03:19 -0600 Subject: [PATCH 05/45] add section summary beneath each header --- docs/guides/integration-sample-sites.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index c86a409be..2ec28ce0b 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -12,7 +12,9 @@ This page lists all official UID2 sample implementations, with links to code, li --- -### Client-Side and JavaScript Integrations +### Web Integrations + +Sample implementations for publishers integrating UID2 directly into their websites using JavaScript or server-side logic. For more details, see [Publisher Web Integration Overview](../guides/integration-options-publisher-web.md). #### UID2 CSTG with JavaScript SDK @@ -39,6 +41,8 @@ This page lists all official UID2 sample implementations, with links to code, li ### Prebid Integrations +Sample implementations for adding UID2 support to Prebid.js header bidding setups. For more details, see [Prebid Integration Overview](../guides/integration-prebid.md). + #### UID2 CSTG with Prebid.js - Site: [UID2 Prebid.js Client-Side Integration Example](https://unifiedid.com/examples/cstg-prebid-example/) @@ -50,6 +54,8 @@ This page lists all official UID2 sample implementations, with links to code, li ### Google Secure Signals Integrations +Sample implementations for passing UID2 tokens to Google Ad Manager via Secure Signals. For more details, see [Google Ad Manager Secure Signals Guide](../guides/integration-google-ss.md). + #### Client-Side Secure Signals - Site: [UID2 Publisher Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-integ.uidapi.com) @@ -98,11 +104,5 @@ This page lists all official UID2 sample implementations, with links to code, li --- :::note -The Sites above highlight some common integrations, but do not represent all available UID2 integration options. - -For the full list of supported integration types, see: - -- [Publisher Web Integration Overview](../guides/integration-options-publisher-web.md) -- [Prebid Integration Overview](../guides/integration-prebid.md) -- [Google Ad Manager Secure Signals Guide](../guides/integration-google-ss.md) - ::: +The Sample Sites above 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 Overview](../guides/integration-guides-summary.md). +::: From b99af21193734a3deedd567d2ff371e2db5b12eb Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 12:09:00 -0600 Subject: [PATCH 06/45] update word --- docs/guides/integration-sample-sites.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index 2ec28ce0b..6a694e419 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -14,7 +14,7 @@ This page lists all official UID2 sample implementations, with links to code, li ### Web Integrations -Sample implementations for publishers integrating UID2 directly into their websites using JavaScript or server-side logic. For more details, see [Publisher Web Integration Overview](../guides/integration-options-publisher-web.md). +Sample pages for publishers integrating UID2 directly into their websites using JavaScript or server-side logic. For more details, see [Publisher Web Integration Overview](../guides/integration-options-publisher-web.md). #### UID2 CSTG with JavaScript SDK @@ -41,7 +41,7 @@ Sample implementations for publishers integrating UID2 directly into their websi ### Prebid Integrations -Sample implementations for adding UID2 support to Prebid.js header bidding setups. For more details, see [Prebid Integration Overview](../guides/integration-prebid.md). +Sample pages for adding UID2 support to Prebid.js header bidding setups. For more details, see [Prebid Integration Overview](../guides/integration-prebid.md). #### UID2 CSTG with Prebid.js @@ -54,7 +54,7 @@ Sample implementations for adding UID2 support to Prebid.js header bidding setup ### Google Secure Signals Integrations -Sample implementations for passing UID2 tokens to Google Ad Manager via Secure Signals. For more details, see [Google Ad Manager Secure Signals Guide](../guides/integration-google-ss.md). +Sample pages for passing UID2 tokens to Google Ad Manager via Secure Signals. For more details, see [Google Ad Manager Secure Signals Guide](../guides/integration-google-ss.md). #### Client-Side Secure Signals From d40f626cc762c94f3244532e5946c3ab0bbefd41 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 12:12:47 -0600 Subject: [PATCH 07/45] update title and decription --- docs/guides/integration-sample-sites.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index 6a694e419..05e20d41e 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -1,6 +1,6 @@ --- -title: UID2 Sites Reference -description: Overview and reference for all UID2 Site integrations. +title: UID2 Sample Sites Reference +description: Overview and reference for all UID2 Sample Site examples. hide_table_of_contents: false --- From 070f7a109fef7b0d35703851a452050e2592f20c Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 13:25:24 -0600 Subject: [PATCH 08/45] revert formatting changes in sidebars.js --- sidebars.js | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/sidebars.js b/sidebars.js index 11fa06e4d..01ecfbe99 100644 --- a/sidebars.js +++ b/sidebars.js @@ -380,6 +380,7 @@ const fullSidebar = [ "ref-info/ref-how-uid-is-created", "ref-info/ref-server-side-token-generation", "ref-info/ref-integration-sso-providers", + "ref-info/deprecation-schedule", ], }, @@ -405,6 +406,7 @@ const sidebars = { "guides/dsp-guide", "endpoints/post-identity-buckets", "endpoints/post-identity-map", + "endpoints/post-identity-map-v2", "endpoints/post-optout-status", ), @@ -486,7 +488,7 @@ const sidebars = { "Advertiser/Data Provider Integrations", "guides/integration-advertiser-dataprovider-overview", "guides/integration-snowflake", - "guides/integration-snowflake-previous", + "guides/integration-snowflake-integration-snowflake-previous", "guides/integration-aws-entity-resolution", "guides/advertiser-dataprovider-endpoints", "sharing/sharing-bid-stream", From 86024c861f173edc446b6a04fc7aeee153640295 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 13:26:24 -0600 Subject: [PATCH 09/45] update header --- docs/guides/integration-sample-sites.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index 05e20d41e..0819f7aff 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -6,7 +6,7 @@ hide_table_of_contents: false import Link from '@docusaurus/Link'; -# UID2 Sites +# UID2 Sample Sites This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and the primary use cases each serves. Use this page to quickly find, compare, and switch between sample integrations that match your setup. From 6d0ff257e2471a69c033ada402d40e4e7e99252a Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 13:27:18 -0600 Subject: [PATCH 10/45] update language in description --- docs/guides/integration-sample-sites.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index 0819f7aff..4a6875c4c 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -8,7 +8,7 @@ import Link from '@docusaurus/Link'; # UID2 Sample Sites -This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and the primary use cases each serves. Use this page to quickly find, compare, and switch between sample integrations that match your setup. +This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and common use cases. Use this page to quickly find, compare, and switch between sample integrations that match your setup. --- From 38125829a5a023c33c19fe37f9dacccc13cf0a89 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 13:32:22 -0600 Subject: [PATCH 11/45] restore formatting on sidebars.js --- sidebars.js | 876 ++++++++++++++++++++++++++-------------------------- 1 file changed, 444 insertions(+), 432 deletions(-) diff --git a/sidebars.js b/sidebars.js index 01ecfbe99..13584ee35 100644 --- a/sidebars.js +++ b/sidebars.js @@ -1,17 +1,17 @@ function removeItems(sidebar, ...remove) { const result = []; for (let item of sidebar) { - if (typeof item === "string") { - if (!remove.includes(item)) - result.push({ - type: "ref", - id: item, - }); - } else { + if (typeof item === 'string') + { + if (!remove.includes(item)) result.push({ + type: 'ref', id: item + }); + } + else { if (!remove.includes(item.label)) { - const { items, ...rest } = item; + const {items, ...rest} = item; const keepItems = removeItems(items, ...remove); - if (keepItems?.length > 0) result.push({ ...rest, items: keepItems }); + if (keepItems?.length > 0) result.push({...rest, items: keepItems}); } } } @@ -19,251 +19,260 @@ function removeItems(sidebar, ...remove) { } const fullSidebar = [ + { - type: "category", - label: "Overview", + type: 'category', + label: 'Overview', link: { - type: "doc", - id: "intro", + type: 'doc', + id: 'intro', }, collapsed: false, items: [ - "ref-info/uid-identifier-types", - "ref-info/uid-components", - "ref-info/uid-workflows", + 'ref-info/uid-identifier-types', + 'ref-info/uid-components', + 'ref-info/uid-workflows', ], }, - - { - type: "category", - label: "UID2 Participants", - link: { - type: "doc", - id: "overviews/participants-overview", + + { + type: 'category', + label: 'UID2 Participants', + link: { + type: 'doc', + id: 'overviews/participants-overview', + }, + collapsed: true, + items: [ + 'overviews/overview-publishers', + 'overviews/overview-advertisers', + 'overviews/overview-dsps', + 'overviews/overview-data-providers', + ], }, - collapsed: true, - items: [ - "overviews/overview-publishers", - "overviews/overview-advertisers", - "overviews/overview-dsps", - "overviews/overview-data-providers", - ], - }, + - { - type: "category", - label: "Getting Started", - link: { - type: "generated-index", + { + type: 'category', + label: 'Getting Started', + link: { + type: 'generated-index', + }, + collapsed: true, + items: [ + 'getting-started/gs-account-setup', + 'getting-started/gs-credentials', + 'getting-started/gs-permissions', + 'getting-started/gs-faqs', + 'getting-started/gs-sharing', + ], }, - collapsed: true, - items: [ - "getting-started/gs-account-setup", - "getting-started/gs-credentials", - "getting-started/gs-permissions", - "getting-started/gs-faqs", - "getting-started/gs-sharing", - ], - }, - { - type: "category", - label: "UID2 Portal", - link: { - type: "generated-index", + { + type: 'category', + label: 'UID2 Portal', + link: { + type: 'generated-index', + }, + collapsed: true, + items: [ + 'portal/portal-overview', + 'portal/portal-getting-started', + 'portal/sharing-permissions', + 'portal/api-keys', + 'portal/client-side-integration', + 'portal/participant-info', + 'portal/team-members', + 'portal/email-contacts', + 'portal/audit-trail', + ], }, - collapsed: true, - items: [ - "portal/portal-overview", - "portal/portal-getting-started", - "portal/sharing-permissions", - "portal/api-keys", - "portal/client-side-integration", - "portal/participant-info", - "portal/team-members", - "portal/email-contacts", - "portal/audit-trail", - ], - }, - { - type: "category", - label: "Integration Guides", - link: { - type: "doc", - id: "guides/summary-guides", - }, - collapsed: false, + { + type: 'category', + label: 'Integration Guides', + link: { + type: 'doc', + id: 'guides/summary-guides', + }, + collapsed: false, - items: [ - { - type: "category", - label: "Publisher Integrations", - link: { - type: "doc", - id: "guides/integration-options-publisher-all", + items: [ + { + type: 'category', + label: 'Publisher Integrations', + link: { + type: 'doc', + id: 'guides/integration-options-publisher-all', }, - collapsed: true, + collapsed: true, - items: [ - { - type: "category", - label: "Web", - link: { - type: "doc", - id: "guides/integration-options-publisher-web", - }, - collapsed: true, - items: [ - { - type: "category", - label: "Prebid", - link: { - type: "doc", - id: "guides/integration-prebid", - }, - collapsed: true, - items: [ - "guides/integration-prebid-client-side", - "guides/integration-prebid-client-server", - ], + items: [ + { + type: 'category', + label: 'Web', + link: { + type: 'doc', + id: 'guides/integration-options-publisher-web', }, + collapsed: true, + items: [ + { + type: 'category', + label: 'Prebid', + link: { + type: 'doc', + id: 'guides/integration-prebid', + }, + collapsed: true, + items: [ + 'guides/integration-prebid-client-side', + 'guides/integration-prebid-client-server', + ], + }, { - type: "category", - label: "JavaScript", + type: 'category', + label: 'JavaScript', link: { - type: "doc", - id: "guides/integration-javascript", + type: 'doc', + id: 'guides/integration-javascript', }, collapsed: true, items: [ - "guides/integration-javascript-client-side", - "guides/integration-javascript-client-server", + 'guides/integration-javascript-client-side', + 'guides/integration-javascript-client-server', ], }, - "guides/integration-publisher-server-side", - "guides/integration-google-ss", + 'guides/integration-publisher-server-side', + 'guides/integration-google-ss', ], }, { - type: "category", - label: "Mobile", + type: 'category', + label: 'Mobile', link: { - type: "doc", - id: "guides/integration-mobile-overview", + type: 'doc', + id: 'guides/integration-mobile-overview', }, collapsed: true, items: [ - "guides/integration-mobile-client-side", - "guides/integration-mobile-client-server", - "guides/integration-mobile-server-side", + 'guides/integration-mobile-client-side', + 'guides/integration-mobile-client-server', + 'guides/integration-mobile-server-side', ], }, - "guides/integration-ctv-guide", + 'guides/integration-ctv-guide', { - type: "category", - label: "Prebid", + type: 'category', + label: 'Prebid', link: { - type: "doc", - id: "guides/integration-prebid", + type: 'doc', + id: 'guides/integration-prebid', }, collapsed: true, items: [ - "guides/integration-prebid-client-side", - "guides/integration-prebid-client-server", - "guides/integration-prebid-mobile-summary", + 'guides/integration-prebid-client-side', + 'guides/integration-prebid-client-server', + 'guides/integration-prebid-mobile-summary', ], }, { - type: "category", - label: "Google Ad Manager", + type: 'category', + label: 'Google Ad Manager', link: { - type: "generated-index", + type: 'generated-index', }, collapsed: true, items: [ - "guides/integration-google-ss", - "guides/mobile-plugin-gma-android", - "guides/mobile-plugin-gma-ios", - "guides/mobile-plugin-ima-android", - "guides/mobile-plugin-ima-ios", + 'guides/integration-google-ss', + 'guides/mobile-plugin-gma-android', + 'guides/mobile-plugin-gma-ios', + 'guides/mobile-plugin-ima-android', + 'guides/mobile-plugin-ima-ios', ], }, - "guides/integration-liveramp-tips", + 'guides/integration-liveramp-tips', + ], }, - { - type: "category", - label: "Advertiser/Data Provider Integrations", - link: { - type: "generated-index", - }, - collapsed: true, - items: [ - { - type: "category", - label: "Integration Overview", - link: { - type: "doc", - id: "guides/integration-advertiser-dataprovider-overview", - }, - collapsed: true, - items: [ - { - type: "category", - label: "Snowflake", - link: { - type: "doc", - id: "guides/integration-snowflake", - }, - collapsed: true, - items: ["guides/integration-snowflake-previous"], - }, +{ + type: 'category', + label: 'Advertiser/Data Provider Integrations', + link: { + type: 'generated-index', + }, + collapsed: true, - "guides/integration-aws-entity-resolution", - "guides/integration-advertiser-dataprovider-endpoints", - ], + items: [ + { + type: 'category', + label: 'Integration Overview', + link: { + type: 'doc', + id: 'guides/integration-advertiser-dataprovider-overview', + }, + collapsed: true, + items: [ + { + type: 'category', + label: 'Snowflake', + link: { + type: 'doc', + id: 'guides/integration-snowflake', }, + collapsed: true, + items: [ + 'guides/integration-snowflake-previous', + ], + }, - "guides/integration-javascript-client-side", - ], - }, + 'guides/integration-aws-entity-resolution', + 'guides/integration-advertiser-dataprovider-endpoints', + ], + }, - { - type: "category", - label: "DSP Integrations", - link: { - type: "generated-index", - }, - collapsed: true, - items: ["guides/dsp-guide", "guides/integration-dsp-no-sdk"], - }, + 'guides/integration-javascript-client-side', - { - type: "category", - label: "Private Operator Integrations", - link: { - type: "doc", - id: "guides/integration-options-private-operator", +], +}, + + { + type: 'category', + label: 'DSP Integrations', + link: { + type: 'generated-index', + }, + collapsed: true, + items: [ + 'guides/dsp-guide', + 'guides/integration-dsp-no-sdk', + ], }, - collapsed: true, - items: [ - "guides/operator-guide-aws-marketplace", - "guides/operator-private-gcp-confidential-space", - "guides/operator-guide-azure-enclave", - "guides/operator-guide-aks-enclave", - ], - }, - { + { + type: 'category', + label: 'Private Operator Integrations', + link: { + type: 'doc', + id: 'guides/integration-options-private-operator', + }, + collapsed: true, + items: [ + 'guides/operator-guide-aws-marketplace', + 'guides/operator-private-gcp-confidential-space', + 'guides/operator-guide-azure-enclave', + 'guides/operator-guide-aks-enclave', + ], + }, + { type: "category", label: "UID2 Sample Sites", link: { @@ -272,267 +281,270 @@ const fullSidebar = [ }, items: [], }, - ], - }, - - { - type: "category", - label: "SDKs", - link: { - type: "doc", - id: "sdks/summary-sdks", + ], }, - collapsed: true, - items: [ - { - type: "category", - label: "SDK for JavaScript", - link: { - type: "doc", - id: "sdks/sdk-ref-javascript", - }, - collapsed: true, - items: ["sdks/sdk-ref-javascript-v3"], - }, - "sdks/sdk-ref-java", - "sdks/sdk-ref-python", - "sdks/sdk-ref-csharp-dotnet", - "sdks/sdk-ref-cplusplus", - "sdks/sdk-ref-android", - "sdks/sdk-ref-ios", - ], - }, + { + type: 'category', + label: 'SDKs', + link: { + type: 'doc', + id: 'sdks/summary-sdks', + }, + collapsed: true, + items: [ - { - type: "category", - label: "Endpoints", - link: { - type: "doc", - id: "endpoints/summary-endpoints", - }, - collapsed: false, - items: [ - "endpoints/post-token-generate", - "endpoints/post-token-validate", - "endpoints/post-token-refresh", - "endpoints/post-identity-buckets", - { - type: "category", - label: "POST /identity/map", - link: { - type: "doc", - id: "endpoints/post-identity-map", + { + type: 'category', + label: 'SDK for JavaScript', + link: { + type: 'doc', + id: 'sdks/sdk-ref-javascript', + }, + collapsed: true, + items: [ + 'sdks/sdk-ref-javascript-v3', + ], }, - collapsed: true, - items: ["endpoints/post-identity-map-v2"], - }, - "endpoints/post-optout-status", - ], - }, - { - type: "category", - label: "UID2 Sharing", - link: { - type: "generated-index", + 'sdks/sdk-ref-java', + 'sdks/sdk-ref-python', + 'sdks/sdk-ref-csharp-dotnet', + 'sdks/sdk-ref-cplusplus', + 'sdks/sdk-ref-android', + 'sdks/sdk-ref-ios', + ], }, - collapsed: false, - items: [ - "sharing/sharing-overview", - "sharing/sharing-security", - "sharing/sharing-use-cases", - { - type: "category", - label: "Tokenized Sharing", - link: { - type: "generated-index", + + { + type: 'category', + label: 'Endpoints', + link: { + type: 'doc', + id: 'endpoints/summary-endpoints', + }, + collapsed: false, + items: [ + 'endpoints/post-token-generate', + 'endpoints/post-token-validate', + 'endpoints/post-token-refresh', + 'endpoints/post-identity-buckets', + { + type: 'category', + label: 'POST /identity/map', + link: { + type: 'doc', + id: 'endpoints/post-identity-map', + }, + collapsed: true, + items: [ + 'endpoints/post-identity-map-v2', + ], }, - collapsed: true, - items: [ - "sharing/sharing-tokenized-overview", - "sharing/sharing-tokenized-from-data-bid-stream", - "sharing/sharing-tokenized-from-data-pixel", - "sharing/sharing-tokenized-from-raw", - ], + 'endpoints/post-optout-status', + ], + }, + + { + type: 'category', + label: 'UID2 Sharing', + link: { + type: 'generated-index', }, - "sharing/sharing-raw", - "sharing/sharing-best-practices", - ], - }, + collapsed: false, + items: [ + 'sharing/sharing-overview', + 'sharing/sharing-security', + 'sharing/sharing-use-cases', + { + type: 'category', + label: 'Tokenized Sharing', + link: { + type: 'generated-index', + }, + collapsed: true, + items: [ + 'sharing/sharing-tokenized-overview', + 'sharing/sharing-tokenized-from-data-bid-stream', + 'sharing/sharing-tokenized-from-data-pixel', + 'sharing/sharing-tokenized-from-raw', + ], + }, + 'sharing/sharing-raw', + 'sharing/sharing-best-practices', + ], + }, - { - type: "category", - label: "Reference Information", - link: { - type: "generated-index", + { + type: 'category', + label: 'Reference Information', + link: { + type: 'generated-index', + }, + collapsed: true, + items: [ + 'getting-started/gs-auth', + 'getting-started/gs-environments', + 'getting-started/gs-encryption-decryption', + 'getting-started/gs-normalization-encoding', + 'getting-started/gs-opt-out', + 'ref-info/ref-operators-public-private', + 'ref-info/ref-integration-approaches', + 'ref-info/ref-tokens', + 'ref-info/ref-how-uid-is-created', + 'ref-info/ref-server-side-token-generation', + 'ref-info/ref-integration-sso-providers', + 'ref-info/deprecation-schedule', + ], }, - collapsed: true, - items: [ - "getting-started/gs-auth", - "getting-started/gs-environments", - "getting-started/gs-encryption-decryption", - "getting-started/gs-normalization-encoding", - "getting-started/gs-opt-out", - "ref-info/ref-operators-public-private", - "ref-info/ref-integration-approaches", - "ref-info/ref-tokens", - "ref-info/ref-how-uid-is-created", - "ref-info/ref-server-side-token-generation", - "ref-info/ref-integration-sso-providers", - "ref-info/deprecation-schedule", - ], - }, - "ref-info/glossary-uid", - "ref-info/updates-doc", -]; + 'ref-info/glossary-uid', + 'ref-info/updates-doc', + ]; + const sidebars = { docs: fullSidebar, - sidebarPublishers: removeItems( - fullSidebar, - "overviews/overview-advertisers", - "overviews/overview-dsps", - "overviews/overview-data-providers", - "Advertiser/Data Provider Integrations", - "guides/integration-advertiser-dataprovider-overview", - "guides/integration-snowflake", - "guides/integration-snowflake-previous", - "guides/integration-aws-entity-resolution", - "guides/advertiser-dataprovider-endpoints", - "DSP Integrations", - "guides/dsp-guide", - "endpoints/post-identity-buckets", - "endpoints/post-identity-map", - "endpoints/post-identity-map-v2", - "endpoints/post-optout-status", + sidebarPublishers: removeItems(fullSidebar, + 'overviews/overview-advertisers', + 'overviews/overview-dsps', + 'overviews/overview-data-providers', + 'Advertiser/Data Provider Integrations', + 'guides/integration-advertiser-dataprovider-overview', + 'guides/integration-snowflake', + 'guides/integration-snowflake-previous', + 'guides/integration-aws-entity-resolution', + 'guides/advertiser-dataprovider-endpoints', + 'DSP Integrations', + 'guides/dsp-guide', + 'endpoints/post-identity-buckets', + 'endpoints/post-identity-map', + 'endpoints/post-identity-map-v2', + 'endpoints/post-optout-status' ), - sidebarAdvertisers: removeItems( - fullSidebar, - "overviews/overview-publishers", - "overviews/overview-dsps", - "overviews/overview-data-providers", - "Publisher Integrations", - "Web", - "guides/integration-options-publisher-all", - "guides/integration-options-publisher-web", - "Prebid", - "guides/integration-prebid", - "guides/integration-prebid-client-side", - "guides/integration-prebid-client-server", - "JavaScript", - "guides/integration-javascript", - "guides/integration-javascript-client-server", - "Server-Only", - "guides/integration-publisher-server-side", - "GAM Secure Signals", - "guides/integration-google-ss", - "Mobile", - "guides/sdk-ref-android", - "guides/sdk-ref-ios", - "Prebid", - "guides/integration-prebid", - "guides/integration-prebid-client-side", - "guides/integration-prebid-client-server", - "Google Ad Manager", - "guides/integration-google-ss", - "guides/mobile-plugin-gma-android", - "guides/mobile-plugin-gma-ios", - "guides/mobile-plugin-ima-android", - "guides/mobile-plugin-ima-ios", - "DSP Integrations", - "guides/dsp-guide", - "endpoints/post-token-generate", - "endpoints/post-token-validate", - "endpoints/post-token-refresh", - "sharing/sharing-bid-stream", - ), + sidebarAdvertisers: removeItems(fullSidebar, + 'overviews/overview-publishers', + 'overviews/overview-dsps', + 'overviews/overview-data-providers', + 'Publisher Integrations', + 'Web', + 'guides/integration-options-publisher-all', + 'guides/integration-options-publisher-web', + 'Prebid', + 'guides/integration-prebid', + 'guides/integration-prebid-client-side', + 'guides/integration-prebid-client-server', + 'JavaScript', + 'guides/integration-javascript', + 'guides/integration-javascript-client-server', + 'Server-Only', + 'guides/integration-publisher-server-side', + 'GAM Secure Signals', + 'guides/integration-google-ss', + 'Mobile', + 'guides/sdk-ref-android', + 'guides/sdk-ref-ios', + 'Prebid', + 'guides/integration-prebid', + 'guides/integration-prebid-client-side', + 'guides/integration-prebid-client-server', + 'Google Ad Manager', + 'guides/integration-google-ss', + 'guides/mobile-plugin-gma-android', + 'guides/mobile-plugin-gma-ios', + 'guides/mobile-plugin-ima-android', + 'guides/mobile-plugin-ima-ios', + 'DSP Integrations', + 'guides/dsp-guide', + 'endpoints/post-token-generate', + 'endpoints/post-token-validate', + 'endpoints/post-token-refresh', + 'sharing/sharing-bid-stream' + ), - sidebarDSPs: removeItems( - fullSidebar, - "overviews/overview-publishers", - "overviews/overview-advertisers", - "overviews/overview-data-providers", - "Publisher Integrations", - "Web", - "guides/integration-options-publisher-all", - "guides/integration-options-publisher-web", - "Prebid", - "guides/integration-prebid", - "guides/integration-prebid-client-side", - "guides/integration-prebid-client-server", - "JavaScript", - "guides/integration-javascript", - "guides/integration-javascript-client-side", - "guides/integration-javascript-client-server", - "Server-Only", - "guides/integration-publisher-server-side", - "GAM Secure Signals", - "guides/integration-google-ss", - "Mobile", - "guides/sdk-ref-android", - "guides/sdk-ref-ios", - "Prebid", - "guides/integration-prebid", - "guides/integration-prebid-client-side", - "guides/integration-prebid-client-server", - "Google Ad Manager", - "guides/integration-google-ss", - "guides/mobile-plugin-gma-android", - "guides/mobile-plugin-gma-ios", - "guides/mobile-plugin-ima-android", - "guides/mobile-plugin-ima-ios", - "Advertiser/Data Provider Integrations", - "guides/integration-advertiser-dataprovider-overview", - "guides/integration-snowflake", - "guides/integration-snowflake-integration-snowflake-previous", - "guides/integration-aws-entity-resolution", - "guides/advertiser-dataprovider-endpoints", - "sharing/sharing-bid-stream", - ), + sidebarDSPs: removeItems(fullSidebar, + 'overviews/overview-publishers', + 'overviews/overview-advertisers', + 'overviews/overview-data-providers', + 'Publisher Integrations', + 'Web', + 'guides/integration-options-publisher-all', + 'guides/integration-options-publisher-web', + 'Prebid', + 'guides/integration-prebid', + 'guides/integration-prebid-client-side', + 'guides/integration-prebid-client-server', + 'JavaScript', + 'guides/integration-javascript', + 'guides/integration-javascript-client-side', + 'guides/integration-javascript-client-server', + 'Server-Only', + 'guides/integration-publisher-server-side', + 'GAM Secure Signals', + 'guides/integration-google-ss', + 'Mobile', + 'guides/sdk-ref-android', + 'guides/sdk-ref-ios', + 'Prebid', + 'guides/integration-prebid', + 'guides/integration-prebid-client-side', + 'guides/integration-prebid-client-server', + 'Google Ad Manager', + 'guides/integration-google-ss', + 'guides/mobile-plugin-gma-android', + 'guides/mobile-plugin-gma-ios', + 'guides/mobile-plugin-ima-android', + 'guides/mobile-plugin-ima-ios', + 'Advertiser/Data Provider Integrations', + 'guides/integration-advertiser-dataprovider-overview', + 'guides/integration-snowflake', + 'guides/integration-snowflake-integration-snowflake-previous', + 'guides/integration-aws-entity-resolution', + 'guides/advertiser-dataprovider-endpoints', + 'sharing/sharing-bid-stream' + ), - sidebarDataProviders: removeItems( - fullSidebar, - "overviews/overview-publishers", - "overviews/overview-advertisers", - "overviews/overview-dsps", - "Publisher Integrations", - "Web", - "guides/integration-options-publisher-all", - "guides/integration-options-publisher-web", - "Prebid", - "guides/integration-prebid", - "guides/integration-prebid-client-side", - "guides/integration-prebid-client-server", - "JavaScript", - "guides/integration-javascript", - "guides/integration-javascript-client-server", - "Server-Only", - "guides/integration-publisher-server-side", - "GAM Secure Signals", - "guides/integration-google-ss", - "Mobile", - "guides/sdk-ref-android", - "guides/sdk-ref-ios", - "Prebid", - "guides/integration-prebid", - "guides/integration-prebid-client-side", - "guides/integration-prebid-client-server", - "Google Ad Manager", - "guides/integration-google-ss", - "guides/mobile-plugin-gma-android", - "guides/mobile-plugin-gma-ios", - "guides/mobile-plugin-ima-android", - "guides/mobile-plugin-ima-ios", - "DSP Integrations", - "guides/dsp-guide", - "endpoints/post-token-generate", - "endpoints/post-token-validate", - "endpoints/post-token-refresh", - "sharing/sharing-bid-stream", + sidebarDataProviders: removeItems(fullSidebar, + 'overviews/overview-publishers', + 'overviews/overview-advertisers', + 'overviews/overview-dsps', + 'Publisher Integrations', + 'Web', + 'guides/integration-options-publisher-all', + 'guides/integration-options-publisher-web', + 'Prebid', + 'guides/integration-prebid', + 'guides/integration-prebid-client-side', + 'guides/integration-prebid-client-server', + 'JavaScript', + 'guides/integration-javascript', + 'guides/integration-javascript-client-server', + 'Server-Only', + 'guides/integration-publisher-server-side', + 'GAM Secure Signals', + 'guides/integration-google-ss', + 'Mobile', + 'guides/sdk-ref-android', + 'guides/sdk-ref-ios', + 'Prebid', + 'guides/integration-prebid', + 'guides/integration-prebid-client-side', + 'guides/integration-prebid-client-server', + 'Google Ad Manager', + 'guides/integration-google-ss', + 'guides/mobile-plugin-gma-android', + 'guides/mobile-plugin-gma-ios', + 'guides/mobile-plugin-ima-android', + 'guides/mobile-plugin-ima-ios', + 'DSP Integrations', + 'guides/dsp-guide', + 'endpoints/post-token-generate', + 'endpoints/post-token-validate', + 'endpoints/post-token-refresh', + 'sharing/sharing-bid-stream' ), + }; module.exports = sidebars; From 56f5086c24874c07508b28d93c71b73f88adde9e Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 15:33:37 -0600 Subject: [PATCH 12/45] update web integrations section with feedback --- docs/guides/integration-sample-sites.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index 4a6875c4c..db7f7ee1a 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -8,7 +8,7 @@ import Link from '@docusaurus/Link'; # UID2 Sample Sites -This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and common use cases. Use this page to quickly find, compare, and switch between sample integrations that match your setup. +This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and common use cases. Use this page to quickly find, compare, and switch between sample integrations that may match your setup. --- @@ -16,19 +16,19 @@ This page lists all official UID2 sample implementations, with links to code, li Sample pages for publishers integrating UID2 directly into their websites using JavaScript or server-side logic. For more details, see [Publisher Web Integration Overview](../guides/integration-options-publisher-web.md). -#### UID2 CSTG with JavaScript SDK +#### Client-Side Integration using UID2 JavaScript SDK -- Site: [UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK](https://cstg-integ.uidapi.com/) +- Site: [UID2 CSTG with JS SDK Example](https://cstg-integ.uidapi.com/) - Code: [`uid2-web-integrations/examples/cstg`](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) - Docs: [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) -- Use Case: For publishers who want a purely client-side integration with consent gating (CSTG). Best for fast prototyping or when minimal server infrastructure is available. +- Use Case: For publishers who want to generate UID2 tokens directly in the browser using the JavaScript SDK (Client-Side Token Generation). Best for fast prototyping and minimal effort. -#### UID2 Client-Server JS SDK (no CSTG) +#### Client-Server Integration using UID2 JavaScript SDK -- Site: [UID2 Publisher Standard Integration Example](https://example-jssdk-integ.uidapi.com/) +- Site: [UID2 Client-Server 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) - Docs: [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) -- Use Case: For publishers who already have a backend and want token generation centralized server-side, while still running UID2 logic on the client. +- Use Case: For publishers who want token generation centralized server-side requiring additional backend configuration, while still passing and refreshing tokens on the client side. #### UID2 Server-Only (Server-Side) From d14e76ba89478af8fe3d373508d7c75a2f4ff757 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 15:49:11 -0600 Subject: [PATCH 13/45] remaining feedback on use cases and wording --- docs/guides/integration-sample-sites.md | 28 ++++++++++++------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index db7f7ee1a..5a52a5f18 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -39,7 +39,7 @@ Sample pages for publishers integrating UID2 directly into their websites using --- -### Prebid Integrations +### Prebid.js Integrations Sample pages for adding UID2 support to Prebid.js header bidding setups. For more details, see [Prebid Integration Overview](../guides/integration-prebid.md). @@ -48,24 +48,24 @@ Sample pages for adding UID2 support to Prebid.js header bidding setups. For mor - 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) - Docs: [Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) -- Use Case: For publishers using Prebid header bidding who want client-side token generation with consent gating. +- Use Case: For publishers using Prebid header bidding who want to generate UID2 tokens using client-side token generation to be passed by Prebid. --- ### Google Secure Signals Integrations -Sample pages for passing UID2 tokens to Google Ad Manager via Secure Signals. For more details, see [Google Ad Manager Secure Signals Guide](../guides/integration-google-ss.md). +Sample pages for passing UID2 tokens to Google Ad Manager (GAM) via Secure Signals. For more details, see [Google Ad Manager Secure Signals Guide](../guides/integration-google-ss.md). #### Client-Side Secure Signals - Site: [UID2 Publisher Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-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) - Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) -- Use Case: For publishers who want front-end only integration with GAM Secure Signals. +- Use Case: For publishers who want a purely client-side integration with GAM Secure Signals. #### React Client-Side Secure Signals -- Site: [UID2 Publisher Client-Side React Integration Example](https://secure-signals-react-integ.uidapi.com/) +- Site: [UID2 Publisher React Client-Side Integration Example](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) - Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) - Use Case: For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. @@ -75,20 +75,20 @@ Sample pages for passing UID2 tokens to Google Ad Manager via Secure Signals. Fo - 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) - Docs: [Secure Signals Sample Implementation](../guides/integration-google-ss.md) -- Additional Domains: - - `secure-signals-srvonly-integ.uidapi.com` - - `esp-srvonly-integ.uidapi.com` +- 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) - Use Case: For publishers who want all Secure Signals logic server-side for better control and security. -#### Hybrid Client-Server Secure Signals (JS SDK v3) +#### Client-Server Secure Signals (JS SDK v3) -- Site: [UID2 Publisher Hybrid Integration Example (Server + JS SDK + Secure Signals)](https://secure-signals-client-server-integ.uidapi.com/) -- Code: [`uid2-web-integrations/examples/google-secure-signals-integration/with_sdk_v3`](https://secure-signals-client-server-integ.uidapi.com/) +- Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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) - Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) - Additional Domains: - - `secure-signals-jssdk-integ.uidapi.com` - - `esp-jssdk-integ.uidapi.com` -- Use Case: For publishers who want a hybrid approach (token generation on the server, client SDK logic for secure signals). + - [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) +- Use Case: For publishers who want a hybrid approach (token generation on the server, client-side logic for secure signals). --- From a566adbc276f2067f8a5a7864d138e0c835cc96d Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 16:15:40 -0600 Subject: [PATCH 14/45] replace doc references with url links --- docs/guides/integration-sample-sites.md | 28 ++++++++++++------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index 5a52a5f18..c5c1557f6 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -14,67 +14,67 @@ This page lists all official UID2 sample implementations, with links to code, li ### Web Integrations -Sample pages for publishers integrating UID2 directly into their websites using JavaScript or server-side logic. For more details, see [Publisher Web Integration Overview](../guides/integration-options-publisher-web.md). +Sample pages for publishers integrating UID2 directly into their websites using JavaScript or server-side logic. For more details, see [Publisher Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). #### Client-Side Integration using UID2 JavaScript SDK - Site: [UID2 CSTG with JS SDK Example](https://cstg-integ.uidapi.com/) - Code: [`uid2-web-integrations/examples/cstg`](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) -- Docs: [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md) +- Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) - Use Case: For publishers who want to generate UID2 tokens directly in the browser using the JavaScript SDK (Client-Side Token Generation). Best for fast prototyping and minimal effort. #### Client-Server Integration using UID2 JavaScript SDK - Site: [UID2 Client-Server 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) -- Docs: [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md) +- Docs: [Client-Server Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-server) - Use Case: For publishers who want token generation centralized server-side requiring additional backend configuration, while still passing and refreshing tokens on the client side. #### UID2 Server-Only (Server-Side) - Site: [UID2 Publisher Server-Only 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) -- Docs: [Publisher Integration Guide, Server-Side](../guides/integration-publisher-server-side.md) +- Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) - Use Case: For publishers who want all UID2 logic handled server-side (no client SDK). Good for environments with strict client limitations or security requirements. --- ### Prebid.js Integrations -Sample pages for adding UID2 support to Prebid.js header bidding setups. For more details, see [Prebid Integration Overview](../guides/integration-prebid.md). +Sample pages for adding UID2 support to Prebid.js header bidding setups. For more details, see [Prebid Integration Overview](https://unifiedid.com/docs/guides/integration-prebid). #### UID2 CSTG with 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) -- Docs: [Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md) +- Docs: [Client-Side Integration Guide for Prebid.js](https://unifiedid.com/docs/guides/integration-prebid-client-side) - Use Case: For publishers using Prebid header bidding who want to generate UID2 tokens using client-side token generation to be passed by Prebid. --- ### Google Secure Signals Integrations -Sample pages for passing UID2 tokens to Google Ad Manager (GAM) via Secure Signals. For more details, see [Google Ad Manager Secure Signals Guide](../guides/integration-google-ss.md). +Sample pages for passing UID2 tokens to Google Ad Manager (GAM) via Secure Signals. For more details, see [Google Ad Manager Secure Signals Guide](https://unifiedid.com/docs/guides/integration-google-ss). #### Client-Side Secure Signals - Site: [UID2 Publisher Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-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) -- Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) +- Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) - Use Case: For publishers who want a purely client-side integration with GAM Secure Signals. #### React Client-Side Secure Signals - Site: [UID2 Publisher React Client-Side Integration Example](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) -- Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) +- Docs: [Secure Signals Sample Implementation](https://unifiedid.com/docs/guides/integration-google-ss#sample-implementations) - Use Case: For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. #### Server-Side Secure Signals - 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) -- Docs: [Secure Signals Sample Implementation](../guides/integration-google-ss.md) +- Docs: [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) @@ -84,8 +84,8 @@ Sample pages for passing UID2 tokens to Google Ad Manager (GAM) via Secure Signa - Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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) -- Docs: [Secure Signals Integration Guide](../guides/integration-google-ss.md) -- Additional Domains: +- Docs: [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) - Use Case: For publishers who want a hybrid approach (token generation on the server, client-side logic for secure signals). @@ -98,11 +98,11 @@ Sample pages for passing UID2 tokens to Google Ad Manager (GAM) via Secure Signa - 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) -- Docs: [Normalization and Encoding](../getting-started/gs-normalization-encoding.md) +- Docs: [Normalization and Encoding](https://unifiedid.com/docs/getting-started/gs-normalization-encoding) - Use Case: For developers or clients validating data preparation, such as hashing and normalization of emails before token requests. --- :::note -The Sample Sites above 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 Overview](../guides/integration-guides-summary.md). +The Sample Sites above 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 Overview](https://unifiedid.com/docs/uid2/guides/integration-guides-summary). ::: From 3859c8348f5ba5ee079e1b74bcad30ce85ae671c Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 16:20:45 -0600 Subject: [PATCH 15/45] romove word Publisher in site names for ocnsistentcy --- docs/guides/integration-sample-sites.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index c5c1557f6..b83caa70e 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -21,7 +21,7 @@ Sample pages for publishers integrating UID2 directly into their websites using - Site: [UID2 CSTG with JS SDK Example](https://cstg-integ.uidapi.com/) - Code: [`uid2-web-integrations/examples/cstg`](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) - Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) -- Use Case: For publishers who want to generate UID2 tokens directly in the browser using the JavaScript SDK (Client-Side Token Generation). Best for fast prototyping and minimal effort. +- Use Case: For publishers who want want a purely client-side integration on their website to generate UID2 tokens directly in the browser using the JavaScript SDK (Client-Side Token Generation). Best for fast prototyping and minimal effort. #### Client-Server Integration using UID2 JavaScript SDK @@ -32,7 +32,7 @@ Sample pages for publishers integrating UID2 directly into their websites using #### UID2 Server-Only (Server-Side) -- Site: [UID2 Publisher Server-Only Integration Example](https://example-srvonly-integ.uidapi.com/login) +- Site: [UID2 Server-Only 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) - Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) - Use Case: For publishers who want all UID2 logic handled server-side (no client SDK). Good for environments with strict client limitations or security requirements. @@ -58,21 +58,21 @@ Sample pages for passing UID2 tokens to Google Ad Manager (GAM) via Secure Signa #### Client-Side Secure Signals -- Site: [UID2 Publisher Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-integ.uidapi.com) +- Site: [UID2 Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) - Use Case: For publishers who want a purely client-side integration with GAM Secure Signals. #### React Client-Side Secure Signals -- Site: [UID2 Publisher React Client-Side Integration Example](https://secure-signals-react-integ.uidapi.com/) +- 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) - Docs: [Secure Signals Sample Implementation](https://unifiedid.com/docs/guides/integration-google-ss#sample-implementations) - Use Case: For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. #### Server-Side Secure Signals -- Site: [Server-Side UID2 Integration Example with Google Secure Signals](https://secure-signals-server-side-integ.uidapi.com/login) +- Site: [UID2 Server-Side 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) - Additional Site Domains: From 1c7c559c72167a75ce4f7a670c36045a1f9e5cf4 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Tue, 30 Sep 2025 16:30:30 -0600 Subject: [PATCH 16/45] update site name for cstg sample site --- docs/guides/integration-sample-sites.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index b83caa70e..d7ced658d 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -18,7 +18,7 @@ Sample pages for publishers integrating UID2 directly into their websites using #### Client-Side Integration using UID2 JavaScript SDK -- Site: [UID2 CSTG with JS SDK Example](https://cstg-integ.uidapi.com/) +- Site: [UID2 Client-Side with JS SDK Example](https://cstg-integ.uidapi.com/) - Code: [`uid2-web-integrations/examples/cstg`](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) - Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) - Use Case: For publishers who want want a purely client-side integration on their website to generate UID2 tokens directly in the browser using the JavaScript SDK (Client-Side Token Generation). Best for fast prototyping and minimal effort. From 634a2d3ba1a6188c748160894d94792cc7023247 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Wed, 1 Oct 2025 11:21:24 -0600 Subject: [PATCH 17/45] word cleanup throughout page --- docs/guides/integration-sample-sites.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index d7ced658d..8538ece6b 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -14,7 +14,7 @@ This page lists all official UID2 sample implementations, with links to code, li ### Web Integrations -Sample pages for publishers integrating UID2 directly into their websites using JavaScript or server-side logic. For more details, see [Publisher Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). +Sample pages for publishers integrating UID2 directly into their websites using JavaScript or server-side logic. For more details, see [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). #### Client-Side Integration using UID2 JavaScript SDK @@ -43,7 +43,7 @@ Sample pages for publishers integrating UID2 directly into their websites using Sample pages for adding UID2 support to Prebid.js header bidding setups. For more details, see [Prebid Integration Overview](https://unifiedid.com/docs/guides/integration-prebid). -#### UID2 CSTG with Prebid.js +#### UID2 Client-Side Integration with 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) @@ -78,9 +78,9 @@ Sample pages for passing UID2 tokens to Google Ad Manager (GAM) via Secure Signa - 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) -- Use Case: For publishers who want all Secure Signals logic server-side for better control and security. +- Use Case: For publishers who want all Secure Signals and UID2 logic server-side for better control and security. -#### Client-Server Secure Signals (JS SDK v3) +#### Client-Server Secure Signals - Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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) From 8c0f4f3ff6beab25c0c08d50b36e3a608a7b3bae Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Wed, 1 Oct 2025 11:25:19 -0600 Subject: [PATCH 18/45] update link for consistency --- docs/guides/integration-sample-sites.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index 8538ece6b..ad1b1a650 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -67,7 +67,7 @@ Sample pages for passing UID2 tokens to Google Ad Manager (GAM) via Secure Signa - 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) -- Docs: [Secure Signals Sample Implementation](https://unifiedid.com/docs/guides/integration-google-ss#sample-implementations) +- Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) - Use Case: For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. #### Server-Side Secure Signals From eaeed59a526c293919e72044bfeb5466c62b37fa Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Wed, 1 Oct 2025 11:34:51 -0600 Subject: [PATCH 19/45] remove publisher reference in web integrations summary --- docs/guides/integration-sample-sites.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index ad1b1a650..5e87303ce 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -14,7 +14,7 @@ This page lists all official UID2 sample implementations, with links to code, li ### Web Integrations -Sample pages for publishers integrating UID2 directly into their websites using JavaScript or server-side logic. For more details, see [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). +Sample pages demonstrating how organizations can integrate UID2 directly into their websites using JavaScript or server-side logic. For more details, see [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). #### Client-Side Integration using UID2 JavaScript SDK From 0a26a2e3c3bc14c7aa0a8aa6de9e61d35f5216fc Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Wed, 1 Oct 2025 11:57:12 -0600 Subject: [PATCH 20/45] update broken link at bottom of page --- docs/guides/integration-sample-sites.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/integration-sample-sites.md b/docs/guides/integration-sample-sites.md index 5e87303ce..2bdccf57a 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/guides/integration-sample-sites.md @@ -104,5 +104,5 @@ Sample pages for passing UID2 tokens to Google Ad Manager (GAM) via Secure Signa --- :::note -The Sample Sites above 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 Overview](https://unifiedid.com/docs/uid2/guides/integration-guides-summary). +The Sample Sites above 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 Overview](https://unifiedid.com/docs/guides/summary-guides). ::: From df18acd6477b16a4396037617b0759f7d7a2e8a8 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Wed, 1 Oct 2025 15:00:16 -0600 Subject: [PATCH 21/45] update location of file in sidebar and rename --- .../integration-sample-sites.md | 4 ++-- sidebars.js | 18 +++++++++--------- 2 files changed, 11 insertions(+), 11 deletions(-) rename docs/{guides => ref-info}/integration-sample-sites.md (99%) diff --git a/docs/guides/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md similarity index 99% rename from docs/guides/integration-sample-sites.md rename to docs/ref-info/integration-sample-sites.md index 2bdccf57a..35d130012 100644 --- a/docs/guides/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -1,12 +1,12 @@ --- -title: UID2 Sample Sites Reference +title: Sample Sites Reference description: Overview and reference for all UID2 Sample Site examples. hide_table_of_contents: false --- import Link from '@docusaurus/Link'; -# UID2 Sample Sites +# UID2 Integration Saamples This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and common use cases. Use this page to quickly find, compare, and switch between sample integrations that may match your setup. diff --git a/sidebars.js b/sidebars.js index 13584ee35..5ae46a772 100644 --- a/sidebars.js +++ b/sidebars.js @@ -272,15 +272,6 @@ const fullSidebar = [ 'guides/operator-guide-aks-enclave', ], }, - { - type: "category", - label: "UID2 Sample Sites", - link: { - type: "doc", - id: "guides/integration-sample-sites", - }, - items: [], - }, ], }, @@ -390,6 +381,15 @@ const fullSidebar = [ 'getting-started/gs-opt-out', 'ref-info/ref-operators-public-private', 'ref-info/ref-integration-approaches', + { + type: 'category', + label: 'Live UID2 Examples', + link: { + type: 'doc', + id: 'ref-info/integration-sample-sites', + }, + items: [], + }, 'ref-info/ref-tokens', 'ref-info/ref-how-uid-is-created', 'ref-info/ref-server-side-token-generation', From 6ffc51fd7f79db61d48405584c109e9e53e666f4 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Wed, 1 Oct 2025 16:14:14 -0600 Subject: [PATCH 22/45] update intros to be complete sentences --- docs/ref-info/integration-sample-sites.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index 35d130012..e1d70a767 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -1,12 +1,12 @@ --- title: Sample Sites Reference -description: Overview and reference for all UID2 Sample Site examples. +description: Overview and reference for all UID2 sample site examples. hide_table_of_contents: false --- import Link from '@docusaurus/Link'; -# UID2 Integration Saamples +# UID2 Integration Samples This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and common use cases. Use this page to quickly find, compare, and switch between sample integrations that may match your setup. @@ -14,34 +14,34 @@ This page lists all official UID2 sample implementations, with links to code, li ### Web Integrations -Sample pages demonstrating how organizations can integrate UID2 directly into their websites using JavaScript or server-side logic. For more details, see [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). +This section includes sample pages that demonstrate how organizations can integrate UID2 directly into their websites to generate and manage UID2 tokens used for targeted advertising. For details, see [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). -#### Client-Side Integration using UID2 JavaScript SDK +#### Client-Side Integration Using UID2 JavaScript SDK - Site: [UID2 Client-Side with JS SDK Example](https://cstg-integ.uidapi.com/) - Code: [`uid2-web-integrations/examples/cstg`](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) - Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) -- Use Case: For publishers who want want a purely client-side integration on their website to generate UID2 tokens directly in the browser using the JavaScript SDK (Client-Side Token Generation). Best for fast prototyping and minimal effort. +- Use Case: For publishers who prefer a fully client-side integration using the UID2 JavaScript SDK to generate and manage tokens directly in the browser. Ideal for fast prototyping with minimal backend requirements. -#### Client-Server Integration using UID2 JavaScript SDK +#### Client-Server Integration Using UID2 JavaScript SDK - Site: [UID2 Client-Server 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) - Docs: [Client-Server Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-server) -- Use Case: For publishers who want token generation centralized server-side requiring additional backend configuration, while still passing and refreshing tokens on the client side. +- Use Case: For publishers who want more control over UID2 token creation (handled on your servers), while using the JavaScript SDK on the client side to manage and refresh tokens in the browser. #### UID2 Server-Only (Server-Side) - Site: [UID2 Server-Only 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) - Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) -- Use Case: For publishers who want all UID2 logic handled server-side (no client SDK). Good for environments with strict client limitations or security requirements. +- Use Case: 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. --- ### Prebid.js Integrations -Sample pages for adding UID2 support to Prebid.js header bidding setups. For more details, see [Prebid Integration Overview](https://unifiedid.com/docs/guides/integration-prebid). +This section includes a sample implementation demonstrating how organizations can integrate with UID2 to generate tokens and pass UID2 identity data into header bidding auctions. For details, see [Prebid Integration Overview](https://unifiedid.com/docs/guides/integration-prebid). #### UID2 Client-Side Integration with Prebid.js @@ -54,7 +54,7 @@ Sample pages for adding UID2 support to Prebid.js header bidding setups. For mor ### Google Secure Signals Integrations -Sample pages for passing UID2 tokens to Google Ad Manager (GAM) via Secure Signals. For more details, see [Google Ad Manager Secure Signals Guide](https://unifiedid.com/docs/guides/integration-google-ss). +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 Guide](https://unifiedid.com/docs/guides/integration-google-ss). #### Client-Side Secure Signals @@ -80,7 +80,7 @@ Sample pages for passing UID2 tokens to Google Ad Manager (GAM) via Secure Signa - [https://esp-srvonly-integ.uidapi.com](https://esp-srvonly-integ.uidapi.com) - Use Case: For publishers who want all Secure Signals and UID2 logic server-side for better control and security. -#### Client-Server Secure Signals +#### Client-Server Secure Signals - Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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) From 3fd1ce0ef16d9e94dd516b24bf40f9a451384c44 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Wed, 1 Oct 2025 16:22:03 -0600 Subject: [PATCH 23/45] create japenese version of sample reference file --- .../ref-info/integration-sample-sites.md | 108 ++++++++++++++++++ 1 file changed, 108 insertions(+) create mode 100644 i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md new file mode 100644 index 000000000..e1d70a767 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -0,0 +1,108 @@ +--- +title: Sample Sites Reference +description: Overview and reference for all UID2 sample site examples. +hide_table_of_contents: false +--- + +import Link from '@docusaurus/Link'; + +# UID2 Integration Samples + +This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and common use cases. Use this page to quickly find, compare, and switch between sample integrations that may match your setup. + +--- + +### Web Integrations + +This section includes sample pages that demonstrate how organizations can integrate UID2 directly into their websites to generate and manage UID2 tokens used for targeted advertising. For details, see [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). + +#### Client-Side Integration Using UID2 JavaScript SDK + +- Site: [UID2 Client-Side with JS SDK Example](https://cstg-integ.uidapi.com/) +- Code: [`uid2-web-integrations/examples/cstg`](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) +- Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) +- Use Case: For publishers who prefer a fully client-side integration using the UID2 JavaScript SDK to generate and manage tokens directly in the browser. Ideal for fast prototyping with minimal backend requirements. + +#### Client-Server Integration Using UID2 JavaScript SDK + +- Site: [UID2 Client-Server 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) +- Docs: [Client-Server Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-server) +- Use Case: For publishers who want more control over UID2 token creation (handled on your servers), while using the JavaScript SDK on the client side to manage and refresh tokens in the browser. + +#### UID2 Server-Only (Server-Side) + +- Site: [UID2 Server-Only 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) +- Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) +- Use Case: 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. + +--- + +### Prebid.js Integrations + +This section includes a sample implementation demonstrating how organizations can integrate with UID2 to generate tokens and pass UID2 identity data into header bidding auctions. For details, see [Prebid Integration Overview](https://unifiedid.com/docs/guides/integration-prebid). + +#### UID2 Client-Side Integration with 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) +- Docs: [Client-Side Integration Guide for Prebid.js](https://unifiedid.com/docs/guides/integration-prebid-client-side) +- Use Case: For publishers using Prebid header bidding who want to generate UID2 tokens using client-side token generation to be passed by Prebid. + +--- + +### 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 Guide](https://unifiedid.com/docs/guides/integration-google-ss). + +#### Client-Side Secure Signals + +- Site: [UID2 Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-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) +- Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) +- Use Case: For publishers who want a purely client-side integration with GAM Secure Signals. + +#### React Client-Side Secure Signals + +- 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) +- Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) +- Use Case: For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. + +#### Server-Side Secure Signals + +- Site: [UID2 Server-Side 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) +- Docs: [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) +- Use Case: For publishers who want all Secure Signals and UID2 logic server-side for better control and security. + +#### Client-Server Secure Signals + +- Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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) +- Docs: [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) +- Use Case: For publishers who want a hybrid approach (token generation on the server, client-side logic for secure signals). + +--- + +### Utilities + +#### UID2 Hashing Tool + +- 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) +- Docs: [Normalization and Encoding](https://unifiedid.com/docs/getting-started/gs-normalization-encoding) +- Use Case: For developers or clients validating data preparation, such as hashing and normalization of emails before token requests. + +--- + +:::note +The Sample Sites above 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 Overview](https://unifiedid.com/docs/guides/summary-guides). +::: From f1718a444070363e37a2a327f7813850529b4daa Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Thu, 2 Oct 2025 10:16:13 -0600 Subject: [PATCH 24/45] update use case wording for some sites --- docs/ref-info/integration-sample-sites.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index e1d70a767..cb2ecf28d 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -48,7 +48,7 @@ This section includes a sample implementation demonstrating how organizations ca - 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) - Docs: [Client-Side Integration Guide for Prebid.js](https://unifiedid.com/docs/guides/integration-prebid-client-side) -- Use Case: For publishers using Prebid header bidding who want to generate UID2 tokens using client-side token generation to be passed by Prebid. +- Use Case: For publishers who want to generate UID2 tokens in the browser and pass them into header bidding auctions using Prebid. --- From fa910a5690e10a87cfa18604bccd5ae3246fe22d Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Thu, 2 Oct 2025 11:05:23 -0600 Subject: [PATCH 25/45] include sample sites reference in appropiate participant tabs --- sidebars.js | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/sidebars.js b/sidebars.js index 5ae46a772..c9774c00c 100644 --- a/sidebars.js +++ b/sidebars.js @@ -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}); } } } @@ -503,7 +503,8 @@ const sidebars = { 'guides/integration-snowflake-integration-snowflake-previous', 'guides/integration-aws-entity-resolution', 'guides/advertiser-dataprovider-endpoints', - 'sharing/sharing-bid-stream' + 'sharing/sharing-bid-stream', + 'Live UID2 Examples' ), sidebarDataProviders: removeItems(fullSidebar, From 34eac8b3f9bbcf4ac08103cab8b76207d49e34e8 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Thu, 2 Oct 2025 11:50:04 -0600 Subject: [PATCH 26/45] update sample site reference in summary guide page --- docs/guides/summary-guides.md | 2 ++ .../current/guides/summary-guides.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/docs/guides/summary-guides.md b/docs/guides/summary-guides.md index d4ffadd4c..4c2ca4727 100644 --- a/docs/guides/summary-guides.md +++ b/docs/guides/summary-guides.md @@ -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. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md index 8473476df..df7e1f643 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md @@ -31,6 +31,8 @@ import Link from '@docusaurus/Link'; - [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 パブリッシャーの Web インテグレーションには、以下のドキュメントリソースが利用できます。 From 65258945d699e10aa8b419e079925c5c4f9ee413 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Thu, 2 Oct 2025 12:08:38 -0600 Subject: [PATCH 27/45] update headers with info under --- docs/ref-info/integration-sample-sites.md | 39 +++++++++--------- .../ref-info/integration-sample-sites.md | 41 ++++++++++--------- 2 files changed, 41 insertions(+), 39 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index cb2ecf28d..0292a23d4 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -10,34 +10,33 @@ import Link from '@docusaurus/Link'; This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and common use cases. Use this page to quickly find, compare, and switch between sample integrations that may match your setup. ---- - ### Web Integrations This section includes sample pages that demonstrate how organizations can integrate UID2 directly into their websites to generate and manage UID2 tokens used for targeted advertising. For details, see [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). #### Client-Side Integration Using UID2 JavaScript SDK +This sample is for publishers who prefer a fully client-side integration using the UID2 JavaScript SDK to generate and manage tokens directly in the browser. This approach is ideal for fast prototyping with minimal back-end requirements. The sample integration is available at the following links: + - Site: [UID2 Client-Side with JS SDK Example](https://cstg-integ.uidapi.com/) - Code: [`uid2-web-integrations/examples/cstg`](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) - Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) -- Use Case: For publishers who prefer a fully client-side integration using the UID2 JavaScript SDK to generate and manage tokens directly in the browser. Ideal for fast prototyping with minimal backend requirements. #### Client-Server Integration Using UID2 JavaScript SDK +This sample is for publishers who want more control over UID2 token creation (handled on your servers), while using the JavaScript SDK on the client side to manage and refresh tokens in the browser. The sample integration is available at the following links: + - Site: [UID2 Client-Server 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) - Docs: [Client-Server Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-server) -- Use Case: For publishers who want more control over UID2 token creation (handled on your servers), while using the JavaScript SDK on the client side to manage and refresh tokens in the browser. #### 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. The sample integration is available at the following links: + - Site: [UID2 Server-Only 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) - Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) -- Use Case: 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. - ---- ### Prebid.js Integrations @@ -45,12 +44,11 @@ This section includes a sample implementation demonstrating how organizations ca #### UID2 Client-Side Integration with Prebid.js +This sample is for publishers using Prebid header bidding who want to generate UID2 tokens using client-side token generation to be passed by Prebid. The sample integration is available at the following links: + - 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) - Docs: [Client-Side Integration Guide for Prebid.js](https://unifiedid.com/docs/guides/integration-prebid-client-side) -- Use Case: For publishers who want to generate UID2 tokens in the browser and pass them into header bidding auctions using Prebid. - ---- ### Google Secure Signals Integrations @@ -58,50 +56,53 @@ This section includes sample pages for passing UID2 identity data to Google's ad #### Client-Side Secure Signals +This sample is for publishers who want a purely client-side integration with GAM Secure Signals. The sample integration is available at the following links: + - Site: [UID2 Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) -- Use Case: For publishers who want a purely client-side integration with GAM Secure Signals. #### 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. The sample integration is available at the following links: + - 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) -- Use Case: For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. #### Server-Side Secure Signals +This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security. The sample integration is available at the following links: + - Site: [UID2 Server-Side 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) - Docs: [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) -- Use Case: For publishers who want all Secure Signals and UID2 logic server-side for better control and security. #### 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. The sample integration is available at the following links: + - Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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) - Docs: [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) -- Use Case: For publishers who want a hybrid approach (token generation on the server, client-side logic for secure signals). - ---- ### Utilities +This section includes useful tools for working with UID2. + #### 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) - Docs: [Normalization and Encoding](https://unifiedid.com/docs/getting-started/gs-normalization-encoding) -- Use Case: For developers or clients validating data preparation, such as hashing and normalization of emails before token requests. - ---- :::note The Sample Sites above 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 Overview](https://unifiedid.com/docs/guides/summary-guides). diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index e1d70a767..b89f0c38b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -1,6 +1,6 @@ --- title: Sample Sites Reference -description: Overview and reference for all UID2 sample site examples. +description: Overview and reference for all UID2 Sample Site examples. hide_table_of_contents: false --- @@ -10,34 +10,33 @@ import Link from '@docusaurus/Link'; This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and common use cases. Use this page to quickly find, compare, and switch between sample integrations that may match your setup. ---- - ### Web Integrations This section includes sample pages that demonstrate how organizations can integrate UID2 directly into their websites to generate and manage UID2 tokens used for targeted advertising. For details, see [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). #### Client-Side Integration Using UID2 JavaScript SDK +This sample is for publishers who prefer a fully client-side integration using the UID2 JavaScript SDK to generate and manage tokens directly in the browser. This approach is ideal for fast prototyping with minimal back-end requirements. The sample integration is available at the following links: + - Site: [UID2 Client-Side with JS SDK Example](https://cstg-integ.uidapi.com/) - Code: [`uid2-web-integrations/examples/cstg`](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) - Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) -- Use Case: For publishers who prefer a fully client-side integration using the UID2 JavaScript SDK to generate and manage tokens directly in the browser. Ideal for fast prototyping with minimal backend requirements. #### Client-Server Integration Using UID2 JavaScript SDK +This sample is for publishers who want more control over UID2 token creation (handled on your servers), while using the JavaScript SDK on the client side to manage and refresh tokens in the browser. The sample integration is available at the following links: + - Site: [UID2 Client-Server 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) - Docs: [Client-Server Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-server) -- Use Case: For publishers who want more control over UID2 token creation (handled on your servers), while using the JavaScript SDK on the client side to manage and refresh tokens in the browser. #### 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. The sample integration is available at the following links: + - Site: [UID2 Server-Only 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) - Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) -- Use Case: 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. - ---- ### Prebid.js Integrations @@ -45,12 +44,11 @@ This section includes a sample implementation demonstrating how organizations ca #### UID2 Client-Side Integration with Prebid.js +This sample is for publishers using Prebid header bidding who want to generate UID2 tokens using client-side token generation to be passed by Prebid. The sample integration is available at the following links: + - 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) - Docs: [Client-Side Integration Guide for Prebid.js](https://unifiedid.com/docs/guides/integration-prebid-client-side) -- Use Case: For publishers using Prebid header bidding who want to generate UID2 tokens using client-side token generation to be passed by Prebid. - ---- ### Google Secure Signals Integrations @@ -58,50 +56,53 @@ This section includes sample pages for passing UID2 identity data to Google's ad #### Client-Side Secure Signals +This sample is for publishers who want a purely client-side integration with GAM Secure Signals. The sample integration is available at the following links: + - Site: [UID2 Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) -- Use Case: For publishers who want a purely client-side integration with GAM Secure Signals. #### 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. The sample integration is available at the following links: + - 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) -- Use Case: For publishers with React apps who want to integrate UID2 + Secure Signals directly into their component-based architecture. #### Server-Side Secure Signals +This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security. The sample integration is available at the following links: + - Site: [UID2 Server-Side 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) - Docs: [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) -- Use Case: For publishers who want all Secure Signals and UID2 logic server-side for better control and security. #### 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. The sample integration is available at the following links: + - Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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) - Docs: [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) -- Use Case: For publishers who want a hybrid approach (token generation on the server, client-side logic for secure signals). - ---- ### Utilities +This section includes useful tools for working with UID2. + #### 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) - Docs: [Normalization and Encoding](https://unifiedid.com/docs/getting-started/gs-normalization-encoding) -- Use Case: For developers or clients validating data preparation, such as hashing and normalization of emails before token requests. - ---- :::note The Sample Sites above 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 Overview](https://unifiedid.com/docs/guides/summary-guides). From efcc9dfa66e951bf775c60cdc3cf61882ec2419d Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Thu, 2 Oct 2025 12:12:38 -0600 Subject: [PATCH 28/45] clarify somme intros better --- docs/ref-info/integration-sample-sites.md | 6 +++--- .../current/ref-info/integration-sample-sites.md | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index 0292a23d4..3960807f8 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -8,11 +8,11 @@ import Link from '@docusaurus/Link'; # UID2 Integration Samples -This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and common use cases. Use this page to quickly find, compare, and switch between sample integrations that may match your setup. +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 includes sample pages that demonstrate how organizations can integrate UID2 directly into their websites to generate and manage UID2 tokens used for targeted advertising. For details, see [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). +This section demonstrates how organizations can integrate UID2 directly into their websites to generate and manage UID2 tokens used for targeted advertising. For details, see [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). #### Client-Side Integration Using UID2 JavaScript SDK @@ -44,7 +44,7 @@ This section includes a sample implementation demonstrating how organizations ca #### UID2 Client-Side Integration with Prebid.js -This sample is for publishers using Prebid header bidding who want to generate UID2 tokens using client-side token generation to be passed by Prebid. The sample integration is available at the following links: +This sample is for publishers using Prebid.js who want to generate UID2 tokens client-side and pass them into header bidding auctions. The sample integration is available at the following links: - 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) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index b89f0c38b..c46ff619f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -8,7 +8,7 @@ import Link from '@docusaurus/Link'; # UID2 Integration Samples -This page lists all official UID2 sample implementations, with links to code, live demo sites, related documentation, and common use cases. Use this page to quickly find, compare, and switch between sample integrations that may match your setup. +This page lists all official UID2 sample implementations. Each sample includes a description of the target audience and integration scenario, 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 @@ -44,7 +44,7 @@ This section includes a sample implementation demonstrating how organizations ca #### UID2 Client-Side Integration with Prebid.js -This sample is for publishers using Prebid header bidding who want to generate UID2 tokens using client-side token generation to be passed by Prebid. The sample integration is available at the following links: +This sample is for publishers using Prebid.js who want to generate UID2 tokens client-side and pass them into header bidding auctions. The sample integration is available at the following links: - 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) From 59ca4e37977d4b94dfd2f11b9eae9eb158cb6ea1 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Thu, 2 Oct 2025 15:26:34 -0600 Subject: [PATCH 29/45] fix broken link again --- docs/ref-info/integration-sample-sites.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index 3960807f8..e47347a98 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -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. The sample integration is available at the following links: -- Site: [UID2 Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-integ.uidapi.com) +- Site: [UID2 Client-Side Integration Example (JS 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) From cf3856267d1a3b5679f8b6543cf09d2cd0afc23e Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Thu, 2 Oct 2025 15:39:51 -0600 Subject: [PATCH 30/45] update sidebar title and yaml title properly --- docs/ref-info/integration-sample-sites.md | 4 ++-- .../current/ref-info/integration-sample-sites.md | 4 ++-- sidebars.js | 12 ++---------- 3 files changed, 6 insertions(+), 14 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index e47347a98..f726c5b77 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -1,12 +1,12 @@ --- -title: Sample Sites Reference +title: Integration Samples description: Overview and reference for all UID2 sample site examples. hide_table_of_contents: false --- import Link from '@docusaurus/Link'; -# UID2 Integration Samples +# Live UID2 Integration Samples 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. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index c46ff619f..6dfe362a3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -1,12 +1,12 @@ --- -title: Sample Sites Reference +title: Integration Samples description: Overview and reference for all UID2 Sample Site examples. hide_table_of_contents: false --- import Link from '@docusaurus/Link'; -# UID2 Integration Samples +# Live UID2 Integration Samples This page lists all official UID2 sample implementations. Each sample includes a description of the target audience and integration scenario, 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. diff --git a/sidebars.js b/sidebars.js index c9774c00c..d07c731d5 100644 --- a/sidebars.js +++ b/sidebars.js @@ -381,15 +381,7 @@ const fullSidebar = [ 'getting-started/gs-opt-out', 'ref-info/ref-operators-public-private', 'ref-info/ref-integration-approaches', - { - type: 'category', - label: 'Live UID2 Examples', - link: { - type: 'doc', - id: 'ref-info/integration-sample-sites', - }, - items: [], - }, + 'ref-info/integration-sample-sites', 'ref-info/ref-tokens', 'ref-info/ref-how-uid-is-created', 'ref-info/ref-server-side-token-generation', @@ -504,7 +496,7 @@ const sidebars = { 'guides/integration-aws-entity-resolution', 'guides/advertiser-dataprovider-endpoints', 'sharing/sharing-bid-stream', - 'Live UID2 Examples' + 'ref-info/integration-sample-sites' ), sidebarDataProviders: removeItems(fullSidebar, From 66d91ea52fe55a375237d915c880e5769170bab4 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Thu, 2 Oct 2025 15:53:51 -0600 Subject: [PATCH 31/45] update web integrations intro summary to be more accurate --- docs/ref-info/integration-sample-sites.md | 2 +- .../current/ref-info/integration-sample-sites.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index f726c5b77..b8cbd7c67 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -12,7 +12,7 @@ This page lists all official UID2 sample implementations highlighting common int ### Web Integrations -This section demonstrates how organizations can integrate UID2 directly into their websites to generate and manage UID2 tokens used for targeted advertising. For details, see [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). +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 [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). #### Client-Side Integration Using UID2 JavaScript SDK diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index 6dfe362a3..bcf489511 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -12,7 +12,7 @@ This page lists all official UID2 sample implementations. Each sample includes a ### Web Integrations -This section includes sample pages that demonstrate how organizations can integrate UID2 directly into their websites to generate and manage UID2 tokens used for targeted advertising. For details, see [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). +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 [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). #### Client-Side Integration Using UID2 JavaScript SDK From f92cb0b60c7c7872e1a55c29b315dc981cf2859d Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Thu, 2 Oct 2025 15:58:48 -0600 Subject: [PATCH 32/45] replace javascript sdk to sdk for javascript throughout file --- docs/ref-info/integration-sample-sites.md | 20 +++++++++---------- .../ref-info/integration-sample-sites.md | 20 +++++++++---------- 2 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index b8cbd7c67..db4fa852b 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -14,17 +14,17 @@ This page lists all official UID2 sample implementations highlighting common int 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 [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). -#### Client-Side Integration Using UID2 JavaScript SDK +#### Client-Side Integration Using UID2 SDK for JavaScript -This sample is for publishers who prefer a fully client-side integration using the UID2 JavaScript SDK to generate and manage tokens directly in the browser. This approach is ideal for fast prototyping with minimal back-end requirements. The sample integration is available at the following links: +This sample is for publishers who prefer a fully client-side integration using the [UID2 SDK for JavaScript](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 Client-Side with JS SDK Example](https://cstg-integ.uidapi.com/) - Code: [`uid2-web-integrations/examples/cstg`](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) - Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) -#### Client-Server Integration Using UID2 JavaScript SDK +#### 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 JavaScript SDK on the client side to manage and refresh tokens in the browser. The sample integration is available at the following links: +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 Client-Server 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) @@ -32,7 +32,7 @@ This sample is for publishers who want more control over UID2 token creation (ha #### 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. The sample integration is available at the following links: +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: [UID2 Server-Only 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) @@ -44,7 +44,7 @@ This section includes a sample implementation demonstrating how organizations ca #### UID2 Client-Side Integration with Prebid.js -This sample is for publishers using Prebid.js who want to generate UID2 tokens client-side and pass them into header bidding auctions. The sample integration is available at the following links: +This sample is for publishers using Prebid.js who want to generate UID2 tokens client-side and pass them into header bidding auctions. - 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) @@ -56,7 +56,7 @@ This section includes sample pages for passing UID2 identity data to Google's ad #### Client-Side Secure Signals -This sample is for publishers who want a purely client-side integration with GAM Secure Signals. The sample integration is available at the following links: +This sample is for publishers who want a purely client-side integration with GAM Secure Signals. - Site: [UID2 Client-Side Integration Example (JS 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) @@ -64,7 +64,7 @@ This sample is for publishers who want a purely client-side integration with GAM #### 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. The sample integration is available at the following links: +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) @@ -72,7 +72,7 @@ This sample is for publishers with React apps who want to integrate UID2 + Secur #### Server-Side Secure Signals -This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security. The sample integration is available at the following links: +This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security. - Site: [UID2 Server-Side 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) @@ -83,7 +83,7 @@ This sample is for publishers who want all Secure Signals and UID2 logic server- #### 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. The sample integration is available at the following links: +This sample is for publishers who want a hybrid approach with token generation on the server and client-side logic for secure signals. - Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index bcf489511..82e5ea390 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -14,17 +14,17 @@ This page lists all official UID2 sample implementations. Each sample includes a 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 [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). -#### Client-Side Integration Using UID2 JavaScript SDK +#### Client-Side Integration Using UID2 SDK for JavaScript -This sample is for publishers who prefer a fully client-side integration using the UID2 JavaScript SDK to generate and manage tokens directly in the browser. This approach is ideal for fast prototyping with minimal back-end requirements. The sample integration is available at the following links: +This sample is for publishers who prefer a fully client-side integration using the [UID2 SDK for JavaScript](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 Client-Side with JS SDK Example](https://cstg-integ.uidapi.com/) - Code: [`uid2-web-integrations/examples/cstg`](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) - Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) -#### Client-Server Integration Using UID2 JavaScript SDK +#### 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 JavaScript SDK on the client side to manage and refresh tokens in the browser. The sample integration is available at the following links: +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 Client-Server 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) @@ -32,7 +32,7 @@ This sample is for publishers who want more control over UID2 token creation (ha #### 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. The sample integration is available at the following links: +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: [UID2 Server-Only 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) @@ -44,7 +44,7 @@ This section includes a sample implementation demonstrating how organizations ca #### UID2 Client-Side Integration with Prebid.js -This sample is for publishers using Prebid.js who want to generate UID2 tokens client-side and pass them into header bidding auctions. The sample integration is available at the following links: +This sample is for publishers using Prebid.js who want to generate UID2 tokens client-side and pass them into header bidding auctions. - 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) @@ -56,7 +56,7 @@ This section includes sample pages for passing UID2 identity data to Google's ad #### Client-Side Secure Signals -This sample is for publishers who want a purely client-side integration with GAM Secure Signals. The sample integration is available at the following links: +This sample is for publishers who want a purely client-side integration with GAM Secure Signals. - Site: [UID2 Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-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) @@ -64,7 +64,7 @@ This sample is for publishers who want a purely client-side integration with GAM #### 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. The sample integration is available at the following links: +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) @@ -72,7 +72,7 @@ This sample is for publishers with React apps who want to integrate UID2 + Secur #### Server-Side Secure Signals -This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security. The sample integration is available at the following links: +This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security. - Site: [UID2 Server-Side 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) @@ -83,7 +83,7 @@ This sample is for publishers who want all Secure Signals and UID2 logic server- #### 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. The sample integration is available at the following links: +This sample is for publishers who want a hybrid approach with token generation on the server and client-side logic for secure signals. - Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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) From edba4f1c108dd6c7c8bfbf1447a946587ab251be Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Thu, 2 Oct 2025 16:05:34 -0600 Subject: [PATCH 33/45] make prebid less redundant/plural plus minor grammar updates --- docs/ref-info/integration-sample-sites.md | 12 ++++-------- .../current/ref-info/integration-sample-sites.md | 8 ++------ 2 files changed, 6 insertions(+), 14 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index db4fa852b..3654922e6 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -38,13 +38,9 @@ This sample is for publishers who want all UID2 operations to occur on the serve - Code: [`uid2-examples/publisher/server_only`](https://github.com/IABTechLab/uid2-examples/tree/main/publisher/server_only) - Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) -### Prebid.js Integrations +### Prebid.js Client-Side Integration -This section includes a sample implementation demonstrating how organizations can integrate with UID2 to generate tokens and pass UID2 identity data into header bidding auctions. For details, see [Prebid Integration Overview](https://unifiedid.com/docs/guides/integration-prebid). - -#### UID2 Client-Side Integration with Prebid.js - -This sample is for publishers using Prebid.js who want to generate UID2 tokens client-side and pass them into header bidding auctions. +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) @@ -77,7 +73,7 @@ This sample is for publishers who want all Secure Signals and UID2 logic server- - Site: [UID2 Server-Side 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) -- Additional Site Domains: +- 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) @@ -88,7 +84,7 @@ This sample is for publishers who want a hybrid approach with token generation o - Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) -- Additional Site Domains: +- 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) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index 82e5ea390..aeed45395 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -38,13 +38,9 @@ This sample is for publishers who want all UID2 operations to occur on the serve - Code: [`uid2-examples/publisher/server_only`](https://github.com/IABTechLab/uid2-examples/tree/main/publisher/server_only) - Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) -### Prebid.js Integrations +### Prebid.js Client-Side Integration -This section includes a sample implementation demonstrating how organizations can integrate with UID2 to generate tokens and pass UID2 identity data into header bidding auctions. For details, see [Prebid Integration Overview](https://unifiedid.com/docs/guides/integration-prebid). - -#### UID2 Client-Side Integration with Prebid.js - -This sample is for publishers using Prebid.js who want to generate UID2 tokens client-side and pass them into header bidding auctions. +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) From ba1ae88fe2b46e2abefa2702e925d0346b94ac47 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Fri, 3 Oct 2025 09:52:59 -0600 Subject: [PATCH 34/45] remove code styling from repo links --- docs/ref-info/integration-sample-sites.md | 20 +++++++++---------- .../ref-info/integration-sample-sites.md | 18 ++++++++--------- 2 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index 3654922e6..859122469 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -18,8 +18,8 @@ This section summarizes the sample integrations available for publishers who wan This sample is for publishers who prefer a fully client-side integration using the [UID2 SDK for JavaScript](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 Client-Side with JS SDK Example](https://cstg-integ.uidapi.com/) -- Code: [`uid2-web-integrations/examples/cstg`](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) +- 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) - Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) #### Client-Server Integration Using UID2 SDK for JavaScript @@ -27,7 +27,7 @@ This sample is for publishers who prefer a fully client-side integration using t 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 Client-Server 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) +- Code: [uid2-web-integrations/examples/js-sdk](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk) - Docs: [Client-Server Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-server) #### UID2 Server-Only (Server-Side) @@ -35,7 +35,7 @@ This sample is for publishers who want more control over UID2 token creation (ha 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: [UID2 Server-Only 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) +- Code: [uid2-examples/publisher/server_only](https://github.com/IABTechLab/uid2-examples/tree/main/publisher/server_only) - Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) ### Prebid.js Client-Side Integration @@ -43,7 +43,7 @@ This sample is for publishers who want all UID2 operations to occur on the serve 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) +- Code: [uid2docs/static/examples/cstg-prebid-example](https://github.com/IABTechLab/uid2docs/tree/main/static/examples/cstg-prebid-example) - Docs: [Client-Side Integration Guide for Prebid.js](https://unifiedid.com/docs/guides/integration-prebid-client-side) ### Google Secure Signals Integrations @@ -55,7 +55,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 Client-Side Integration Example (JS 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) +- 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) #### React Client-Side Secure Signals @@ -63,7 +63,7 @@ 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/) -- 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) +- 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) #### Server-Side Secure Signals @@ -71,7 +71,7 @@ This sample is for publishers with React apps who want to integrate UID2 + Secur This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security. - Site: [UID2 Server-Side 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) +- 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) - Docs: [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) @@ -82,7 +82,7 @@ This sample is for publishers who want all Secure Signals and UID2 logic server- This sample is for publishers who want a hybrid approach with token generation on the server and client-side logic for secure signals. - Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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) +- 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) - Docs: [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) @@ -97,7 +97,7 @@ This section includes useful tools for working with UID2. 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) +- Code: [uid2Docs/static/examples/hashing-tool](https://github.com/IABTechLab/uid2docs/tree/main/static/examples/hashing-tool) - Docs: [Normalization and Encoding](https://unifiedid.com/docs/getting-started/gs-normalization-encoding) :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index aeed45395..e7487a319 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -19,7 +19,7 @@ This section summarizes the sample integrations available for publishers who wan This sample is for publishers who prefer a fully client-side integration using the [UID2 SDK for JavaScript](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 Client-Side with JS SDK Example](https://cstg-integ.uidapi.com/) -- Code: [`uid2-web-integrations/examples/cstg`](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) +- Code: [uid2-web-integrations/examples/cstg](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) - Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) #### Client-Server Integration Using UID2 SDK for JavaScript @@ -27,7 +27,7 @@ This sample is for publishers who prefer a fully client-side integration using t 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 Client-Server 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) +- Code: [uid2-web-integrations/examples/js-sdk](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk) - Docs: [Client-Server Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-server) #### UID2 Server-Only (Server-Side) @@ -35,7 +35,7 @@ This sample is for publishers who want more control over UID2 token creation (ha 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: [UID2 Server-Only 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) +- Code: [uid2-examples/publisher/server_only](https://github.com/IABTechLab/uid2-examples/tree/main/publisher/server_only) - Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) ### Prebid.js Client-Side Integration @@ -43,7 +43,7 @@ This sample is for publishers who want all UID2 operations to occur on the serve 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) +- Code: [uid2docs/static/examples/cstg-prebid-example](https://github.com/IABTechLab/uid2docs/tree/main/static/examples/cstg-prebid-example) - Docs: [Client-Side Integration Guide for Prebid.js](https://unifiedid.com/docs/guides/integration-prebid-client-side) ### Google Secure Signals Integrations @@ -55,7 +55,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 Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-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) +- 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) #### React Client-Side Secure Signals @@ -63,7 +63,7 @@ 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/) -- 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) +- 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) #### Server-Side Secure Signals @@ -71,7 +71,7 @@ This sample is for publishers with React apps who want to integrate UID2 + Secur This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security. - Site: [UID2 Server-Side 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) +- 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) - Docs: [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) @@ -82,7 +82,7 @@ This sample is for publishers who want all Secure Signals and UID2 logic server- This sample is for publishers who want a hybrid approach with token generation on the server and client-side logic for secure signals. - Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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) +- 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) - Docs: [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) @@ -97,7 +97,7 @@ This section includes useful tools for working with UID2. 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) +- Code: [uid2Docs/static/examples/hashing-tool](https://github.com/IABTechLab/uid2docs/tree/main/static/examples/hashing-tool) - Docs: [Normalization and Encoding](https://unifiedid.com/docs/getting-started/gs-normalization-encoding) :::note From 560d323801390e4516ad713d307236f860dde8fd Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Fri, 3 Oct 2025 09:57:36 -0600 Subject: [PATCH 35/45] remove capitalization in sample sites --- docs/ref-info/integration-sample-sites.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index 859122469..03b9731c6 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -101,5 +101,5 @@ This tool is for developers or clients validating data preparation, such as hash - Docs: [Normalization and Encoding](https://unifiedid.com/docs/getting-started/gs-normalization-encoding) :::note -The Sample Sites above 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 Overview](https://unifiedid.com/docs/guides/summary-guides). +The sample sites above 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 Overview](https://unifiedid.com/docs/guides/summary-guides). ::: From 4a19d861c66caefeaf5337712b0733238dd2c426 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Fri, 3 Oct 2025 10:09:11 -0600 Subject: [PATCH 36/45] update all links to match site title --- 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 03b9731c6..29e187578 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -26,7 +26,7 @@ This sample is for publishers who prefer a fully client-side integration using t 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 Client-Server Integration Example](https://example-jssdk-integ.uidapi.com/) +- 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) - Docs: [Client-Server Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-server) @@ -34,7 +34,7 @@ This sample is for publishers who want more control over UID2 token creation (ha 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: [UID2 Server-Only Integration Example](https://example-srvonly-integ.uidapi.com/login) +- 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) - Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) @@ -54,7 +54,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 Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-side-integ.uidapi.com/) +- 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) @@ -70,7 +70,7 @@ This sample is for publishers with React apps who want to integrate UID2 + Secur This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security. -- Site: [UID2 Server-Side 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) - Additional site domains: @@ -81,7 +81,7 @@ This sample is for publishers who want all Secure Signals and UID2 logic server- This sample is for publishers who want a hybrid approach with token generation on the server and client-side logic for secure signals. -- Site: [UID2 Client-Server Integration Example (Server + JS SDK + Secure Signals)](https://secure-signals-client-server-integ.uidapi.com/) +- 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) - Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) - Additional site domains: From d71bd99e7053f6c99d5817ae83ea91a215270785 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Fri, 3 Oct 2025 10:16:20 -0600 Subject: [PATCH 37/45] update utility section --- docs/ref-info/integration-sample-sites.md | 12 ++++-------- .../current/ref-info/integration-sample-sites.md | 10 +++------- 2 files changed, 7 insertions(+), 15 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index 29e187578..68ae4ef52 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -1,12 +1,12 @@ --- -title: Integration Samples +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'; -# Live UID2 Integration Samples +# 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. @@ -88,11 +88,7 @@ This sample is for publishers who want a hybrid approach with token generation o - [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) -### Utilities - -This section includes useful tools for working with UID2. - -#### UID2 Hashing Tool +### 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: @@ -101,5 +97,5 @@ This tool is for developers or clients validating data preparation, such as hash - Docs: [Normalization and Encoding](https://unifiedid.com/docs/getting-started/gs-normalization-encoding) :::note -The sample sites above 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 Overview](https://unifiedid.com/docs/guides/summary-guides). +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 Overview](https://unifiedid.com/docs/guides/summary-guides). ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index e7487a319..3abf28439 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -1,12 +1,12 @@ --- -title: Integration Samples +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'; -# Live UID2 Integration Samples +# Integration Samples and Tools This page lists all official UID2 sample implementations. Each sample includes a description of the target audience and integration scenario, 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. @@ -88,11 +88,7 @@ This sample is for publishers who want a hybrid approach with token generation o - [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) -### Utilities - -This section includes useful tools for working with UID2. - -#### UID2 Hashing Tool +### 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: From c1bc5774d9d55cec4c1484fd45f1fefe2c4c12fa Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Mon, 6 Oct 2025 08:54:46 -0400 Subject: [PATCH 38/45] update heading levels and doc url paths --- docs/ref-info/integration-sample-sites.md | 48 +++++++++---------- .../ref-info/integration-sample-sites.md | 46 +++++++++--------- 2 files changed, 47 insertions(+), 47 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index 68ae4ef52..ecca897fb 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -10,92 +10,92 @@ import Link from '@docusaurus/Link'; 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 +## 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 [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). +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 +### Client-Side Integration Using UID2 SDK for JavaScript -This sample is for publishers who prefer a fully client-side integration using the [UID2 SDK for JavaScript](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. +This sample is for publishers who prefer a fully client-side integration using the [UID2 SDK for JavaScript](../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) -- Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) +- Doc: [Client-Side Integration Guide for JavaScript](../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/) - Code: [uid2-web-integrations/examples/js-sdk](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk) -- Docs: [Client-Server Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-server) +- Doc: [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server) -#### UID2 Server-Only (Server-Side) +### 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) -- Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) +- Doc: [Publisher Integration Guide, Server-Side](../guides/integration-publisher-server-side) -### Prebid.js Client-Side Integration +## Prebid.js Client-Side Integration 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) -- Docs: [Client-Side Integration Guide for Prebid.js](https://unifiedid.com/docs/guides/integration-prebid-client-side) +- Doc: [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side) -### Google Secure Signals Integrations +## 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 Guide](https://unifiedid.com/docs/guides/integration-google-ss). +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](../guides/integration-google-ss). -#### Client-Side Secure Signals +### 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) -- Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) +- Doc: [Google Ad Manager Secure Signals Integration](../guides/integration-google-ss) -#### React Client-Side Secure Signals +### 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) -- Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) +- Doc: [Google Ad Manager Secure Signals Integration](../guides/integration-google-ss) -#### Server-Side Secure Signals +### 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) -- Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) +- Doc: [Google Ad Manager Secure Signals Integration](../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 +### 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) -- Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) +- Doc: [Google Ad Manager Secure Signals Integration](../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 +## 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) -- Docs: [Normalization and Encoding](https://unifiedid.com/docs/getting-started/gs-normalization-encoding) +- 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 Overview](https://unifiedid.com/docs/guides/summary-guides). +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). ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index 3abf28439..2b221a823 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -10,91 +10,91 @@ import Link from '@docusaurus/Link'; This page lists all official UID2 sample implementations. Each sample includes a description of the target audience and integration scenario, 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 +## 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 [Web Integration Overview](https://unifiedid.com/docs/guides/integration-options-publisher-web). +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 +### Client-Side Integration Using UID2 SDK for JavaScript -This sample is for publishers who prefer a fully client-side integration using the [UID2 SDK for JavaScript](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. +This sample is for publishers who prefer a fully client-side integration using the [UID2 SDK for JavaScript](../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 Client-Side with JS SDK Example](https://cstg-integ.uidapi.com/) - Code: [uid2-web-integrations/examples/cstg](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) -- Docs: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) +- Doc: [Client-Side Integration Guide for JavaScript](../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 Client-Server 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) -- Docs: [Client-Server Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-server) +- Doc: [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server) -#### UID2 Server-Only (Server-Side) +### 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: [UID2 Server-Only 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) -- Docs: [Publisher Integration Guide, Server-Side](https://unifiedid.com/docs/guides/integration-publisher-server-side) +- Doc: [Publisher Integration Guide, Server-Side](../guides/integration-publisher-server-side) -### Prebid.js Client-Side Integration +## Prebid.js Client-Side Integration 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) -- Docs: [Client-Side Integration Guide for Prebid.js](https://unifiedid.com/docs/guides/integration-prebid-client-side) +- Doc: [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side) -### Google Secure Signals Integrations +## 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 Guide](https://unifiedid.com/docs/guides/integration-google-ss). +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](../guides/integration-google-ss). -#### Client-Side Secure Signals +### Client-Side Secure Signals This sample is for publishers who want a purely client-side integration with GAM Secure Signals. - Site: [UID2 Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-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) -- Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) +- Doc: [Google Ad Manager Secure Signals Integration](../guides/integration-google-ss) -#### React Client-Side Secure Signals +### 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) -- Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) +- Doc: [Google Ad Manager Secure Signals Integration](../guides/integration-google-ss) -#### Server-Side Secure Signals +### 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: [UID2 Server-Side 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) -- Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) +- Doc: [Google Ad Manager Secure Signals Integration](../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 +### 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: [UID2 Client-Server Integration Example (Server + JS SDK + 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) -- Docs: [Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) +- Doc: [Google Ad Manager Secure Signals Integration](../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 +## 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) -- Docs: [Normalization and Encoding](https://unifiedid.com/docs/getting-started/gs-normalization-encoding) +- Doc: [Normalization and Encoding](../getting-started/gs-normalization-encoding) :::note The Sample Sites above 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 Overview](https://unifiedid.com/docs/guides/summary-guides). From 1b51c75ecf0e8df4a3d817ad28e976a1fb9d369c Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Mon, 6 Oct 2025 09:03:27 -0400 Subject: [PATCH 39/45] make sure all destination file links are correct --- docs/ref-info/integration-sample-sites.md | 14 +++++++------- .../current/ref-info/integration-sample-sites.md | 14 +++++++------- 2 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index ecca897fb..aa156b67f 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -16,7 +16,7 @@ This section summarizes the sample integrations available for publishers who wan ### Client-Side Integration Using UID2 SDK for JavaScript -This sample is for publishers who prefer a fully client-side integration using the [UID2 SDK for JavaScript](../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. +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) @@ -48,7 +48,7 @@ This sample is for publishers who want to generate UID2 tokens on the client sid ## 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](../guides/integration-google-ss). +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 @@ -56,7 +56,7 @@ This sample is for publishers who want a purely client-side integration with GAM - 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](../guides/integration-google-ss) +- Doc: [Google Ad Manager Secure Signals Integration Guide](../guides/integration-google-ss) ### React Client-Side Secure Signals @@ -64,7 +64,7 @@ This sample is for publishers with React apps who want to integrate UID2 + Secur - 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](../guides/integration-google-ss) +- Doc: [Google Ad Manager Secure Signals Integration Guide](../guides/integration-google-ss) ### Server-Side Secure Signals @@ -72,7 +72,7 @@ This sample is for publishers who want all Secure Signals and UID2 logic server- - 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](../guides/integration-google-ss) +- 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) @@ -83,7 +83,7 @@ This sample is for publishers who want a hybrid approach with token generation o - 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](../guides/integration-google-ss) +- 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) @@ -97,5 +97,5 @@ This tool is for developers or clients validating data preparation, such as hash - 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](https://unifiedid.com/docs/guides/summary-guides). +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). ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index 2b221a823..6ad63c87a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -16,7 +16,7 @@ This section summarizes the sample integrations available for publishers who wan ### Client-Side Integration Using UID2 SDK for JavaScript -This sample is for publishers who prefer a fully client-side integration using the [UID2 SDK for JavaScript](../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. +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 Client-Side with JS SDK Example](https://cstg-integ.uidapi.com/) - Code: [uid2-web-integrations/examples/cstg](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg) @@ -48,7 +48,7 @@ This sample is for publishers who want to generate UID2 tokens on the client sid ## 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](../guides/integration-google-ss). +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 @@ -56,7 +56,7 @@ This sample is for publishers who want a purely client-side integration with GAM - Site: [UID2 Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-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](../guides/integration-google-ss) +- Doc: [Google Ad Manager Secure Signals Integration Guide](../guides/integration-google-ss) ### React Client-Side Secure Signals @@ -64,7 +64,7 @@ This sample is for publishers with React apps who want to integrate UID2 + Secur - 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](../guides/integration-google-ss) +- Doc: [Google Ad Manager Secure Signals Integration Guide](../guides/integration-google-ss) ### Server-Side Secure Signals @@ -72,7 +72,7 @@ This sample is for publishers who want all Secure Signals and UID2 logic server- - Site: [UID2 Server-Side 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](../guides/integration-google-ss) +- 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) @@ -83,7 +83,7 @@ This sample is for publishers who want a hybrid approach with token generation o - Site: [UID2 Client-Server Integration Example (Server + JS SDK + 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](../guides/integration-google-ss) +- 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) @@ -97,5 +97,5 @@ This tool is for developers or clients validating data preparation, such as hash - Doc: [Normalization and Encoding](../getting-started/gs-normalization-encoding) :::note -The Sample Sites above 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 Overview](https://unifiedid.com/docs/guides/summary-guides). +The Sample Sites above 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). ::: From 697e54b174088896b57bc3d79d46cf7d6701f994 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Mon, 6 Oct 2025 09:04:41 -0400 Subject: [PATCH 40/45] remove hyphen in server side --- docs/ref-info/integration-sample-sites.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index aa156b67f..7c90600a2 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -32,7 +32,7 @@ This sample is for publishers who want more control over UID2 token creation (ha ### 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. +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) From c42e4b2dbd0e9db28034a62d92534e34118bdc1e Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Mon, 6 Oct 2025 09:08:55 -0400 Subject: [PATCH 41/45] copy most recent version for japanese translation --- .../ref-info/integration-sample-sites.md | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index 6ad63c87a..7c90600a2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -1,6 +1,6 @@ --- title: Integration Samples and Tools -description: Overview and reference for all UID2 Sample Site examples. +description: Overview and reference for all UID2 sample site examples. hide_table_of_contents: false --- @@ -8,7 +8,7 @@ import Link from '@docusaurus/Link'; # Integration Samples and Tools -This page lists all official UID2 sample implementations. Each sample includes a description of the target audience and integration scenario, 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 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 @@ -18,7 +18,7 @@ This section summarizes the sample integrations available for publishers who wan 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 Client-Side with JS SDK Example](https://cstg-integ.uidapi.com/) +- 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) @@ -26,15 +26,15 @@ This sample is for publishers who prefer a fully client-side integration using t 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 Client-Server Integration Example](https://example-jssdk-integ.uidapi.com/) +- 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. +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: [UID2 Server-Only Integration Example](https://example-srvonly-integ.uidapi.com/login) +- 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) @@ -54,7 +54,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 Client-Side Integration Example (JS SDK + Secure Signals)](https://secure-signals-client-integ.uidapi.com) +- 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) @@ -70,10 +70,10 @@ This sample is for publishers with React apps who want to integrate UID2 + Secur This sample is for publishers who want all Secure Signals and UID2 logic server-side for better control and security. -- Site: [UID2 Server-Side 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](../guides/integration-google-ss) -- Additional Site Domains: +- 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) @@ -81,10 +81,10 @@ This sample is for publishers who want all Secure Signals and UID2 logic server- This sample is for publishers who want a hybrid approach with token generation on the server and client-side logic for secure signals. -- Site: [UID2 Client-Server Integration Example (Server + JS SDK + Secure Signals)](https://secure-signals-client-server-integ.uidapi.com/) +- 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: +- 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) @@ -97,5 +97,5 @@ This tool is for developers or clients validating data preparation, such as hash - Doc: [Normalization and Encoding](../getting-started/gs-normalization-encoding) :::note -The Sample Sites above 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). +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). ::: From fe6d5a0ec2fecd52060f311bd609cd25e24ffc1e Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Mon, 6 Oct 2025 10:25:30 -0400 Subject: [PATCH 42/45] add section into/header for prebid.js for consistency --- docs/ref-info/integration-sample-sites.md | 6 +++++- .../current/ref-info/integration-sample-sites.md | 6 +++++- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index 7c90600a2..3d20d810a 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -38,7 +38,11 @@ This sample is for publishers who want all UID2 operations to occur on the serve - 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 Client-Side Integration +## 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. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md index 7c90600a2..3d20d810a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ref-info/integration-sample-sites.md @@ -38,7 +38,11 @@ This sample is for publishers who want all UID2 operations to occur on the serve - 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 Client-Side Integration +## 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. From 6f278b223f173663d7b30f804c9f23ab9d6acbd8 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Mon, 6 Oct 2025 10:35:30 -0400 Subject: [PATCH 43/45] make sample site reference page available across all tabs --- sidebars.js | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/sidebars.js b/sidebars.js index d07c731d5..59535b29c 100644 --- a/sidebars.js +++ b/sidebars.js @@ -495,8 +495,7 @@ const sidebars = { 'guides/integration-snowflake-integration-snowflake-previous', 'guides/integration-aws-entity-resolution', 'guides/advertiser-dataprovider-endpoints', - 'sharing/sharing-bid-stream', - 'ref-info/integration-sample-sites' + 'sharing/sharing-bid-stream' ), sidebarDataProviders: removeItems(fullSidebar, From 700db2862a448608d6e4b89d6d094d286c6cb3e8 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Mon, 6 Oct 2025 17:33:10 -0400 Subject: [PATCH 44/45] update link for different providers and revert doc links to external --- docs/ref-info/integration-sample-sites.md | 30 +++++++++++------------ 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/ref-info/integration-sample-sites.md b/docs/ref-info/integration-sample-sites.md index 3d20d810a..72a7cb322 100644 --- a/docs/ref-info/integration-sample-sites.md +++ b/docs/ref-info/integration-sample-sites.md @@ -12,15 +12,15 @@ This page lists all official UID2 sample implementations highlighting common int ## 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). +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](../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. +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](../guides/integration-javascript-client-side) +- Doc: [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) ### Client-Server Integration Using UID2 SDK for JavaScript @@ -28,7 +28,7 @@ This sample is for publishers who want more control over UID2 token creation (ha - 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) +- Doc: [Client-Server Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-server) ### UID2 Server-Only (Server-Side) @@ -36,11 +36,11 @@ This sample is for publishers who want all UID2 operations to occur on the serve - 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) +- 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](../guides/integration-prebid). +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 @@ -48,11 +48,11 @@ This sample is for publishers who want to generate UID2 tokens on the client sid - 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) +- 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](../guides/integration-google-ss). +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 @@ -60,7 +60,7 @@ This sample is for publishers who want a purely client-side integration with GAM - 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) +- Doc: [Google Ad Manager Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) ### React Client-Side Secure Signals @@ -68,7 +68,7 @@ This sample is for publishers with React apps who want to integrate UID2 + Secur - 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) +- Doc: [Google Ad Manager Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss) ### Server-Side Secure Signals @@ -76,7 +76,7 @@ This sample is for publishers who want all Secure Signals and UID2 logic server- - 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) +- 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) @@ -87,7 +87,7 @@ This sample is for publishers who want a hybrid approach with token generation o - 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) +- 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) @@ -97,9 +97,9 @@ This sample is for publishers who want a hybrid approach with token generation o 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) +- 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](../guides/summary-guides). +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). ::: From ff6b9a86141a9d2137e50e921132a973185d2ff1 Mon Sep 17 00:00:00 2001 From: Eiman Eltigani Date: Mon, 6 Oct 2025 17:59:07 -0400 Subject: [PATCH 45/45] remove edits in summary-guides transflation version --- .../current/guides/summary-guides.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md index df7e1f643..8473476df 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/summary-guides.md @@ -31,8 +31,6 @@ import Link from '@docusaurus/Link'; - [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 パブリッシャーの Web インテグレーションには、以下のドキュメントリソースが利用できます。