Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
8173cbb
update sample sites with new titles and update htmls to match
Oct 22, 2025
d5aec5e
update server only example in seperate folder
Oct 22, 2025
f36cc0e
update all readmes to match correct title
Oct 22, 2025
d655981
keep error title for error pages
Oct 22, 2025
29d86cf
update html titles to be unique for multiple html docs
Oct 22, 2025
f160ef5
fix inconsistencies in titles
Oct 22, 2025
5e4a388
hypenate multiple html pages instead
Oct 22, 2025
cc97b74
update multiple html header tags and move server-side sample page to …
Oct 23, 2025
8f80102
update outdated title and links to source code in readme and intro/he…
Oct 23, 2025
7c86cf5
update links for client server intro
Oct 23, 2025
61dcb59
remove trailing spaces in docker compose file
Oct 23, 2025
6737231
add back original space
Oct 23, 2025
2360838
remove publisher/server_only commits
Oct 23, 2025
a1414f5
fix broken link in server side web integration site
Oct 23, 2025
91c4e69
update link in intro.html in client server
Oct 23, 2025
7cd4d06
revert docker command changes in client server google readme
Oct 23, 2025
9b0061e
forgot to revert single change
Oct 23, 2025
0f5889c
revert docker changes in client side readme google secure
Oct 23, 2025
f657ced
revert remaining docker command changes
Oct 23, 2025
5ee8a7e
fix broken link in server side copy not original
Oct 23, 2025
f456cef
add client side as example to server side read mes
Oct 23, 2025
3c7ceaf
remove spelling mistake
Oct 23, 2025
1919211
update to make read me links open in new tab insted of file path
Oct 23, 2025
1fa2055
fix link in client server javascript sdk
Oct 23, 2025
6e06357
lower case a capital letter
Oct 23, 2025
bbfac5f
use more relevant link in client server google into
Oct 23, 2025
144024c
Remove extra period
Oct 23, 2025
5d84827
update google secure link with additional hashtag
Oct 23, 2025
0f1a9b1
clean up remaining edits
Oct 23, 2025
3d0dd53
clarify link and veriabe for secure signals server side into
Oct 23, 2025
f77a0ea
update to correct client server doc link in intro page for google secure
Oct 23, 2025
3b62744
update external links to relative links in readmes
Oct 23, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions docker-compose.yml
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,17 @@ services:
env_file:
- .env

# server-side integration (no SDK)
server-side:
build:
context: .
dockerfile: web-integrations/server-side/Dockerfile
ports:
- "3033:3033"
container_name: server-side
env_file:
- .env

# secure signals integrations
google-secure-signals-client-server:
build:
Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# UID2 SDK Secure Signals Integration Example
# Client-Server UID2 SDK Integration Example with Google Secure Signals

This example demonstrates how a content publisher who is working with [Google Interactive Media Ads(IMA) SDKs](https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side) can use [Google Secure Signal](https://support.google.com/admanager/answer/10488752) and the [UID2 SDK for JavaScript](https://unifiedid.com/docs/sdks/sdk-ref-javascript) to share UID2 directly with bidders, in an implementation that uses this SDK.

For an example application without using the UID2 SDK, see [Server-Side UID2 Integration Example](../server_side/README.md).
For an example application without using the UID2 SDK, see [Server-Side UID2 Integration Example with Google Secure Signals](../server-side/README.md).

> NOTE: Although the server side of the example application is implemented in JavaScript using node.js, it is not a requirement. You can use any technology of your choice and refer to the example application for an illustration of the functionality that needs to be implemented.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html>
<head>
<meta charset="UTF-8" />
<title>Error</title>
<title>Error - Client-Server UID2 SDK Integration Example with Google Secure Signals</title>
<link rel="stylesheet" type="text/css" href="/stylesheets/app.css" />
<link rel="shortcut icon" href="/images/favicon.png" />
</head>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html>
<head>
<meta charset="UTF-8" />
<title>UID2 Publisher Server-Side Integration Example</title>
<title>Client-Server UID2 SDK Integration Example with Google Secure Signals</title>
<link rel="stylesheet" type="text/css" href="/stylesheets/app.css" />
<link rel="stylesheet" type="text/css" href="/stylesheets/style.css" />
<link rel="shortcut icon" href="/images/favicon.png" />
Expand Down
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
<h1>Example for Client-Server UID2 SDK Integration with Google Secure Signals</h1>
<h1>Client-Server UID2 SDK Integration Example with Google Secure Signals</h1>
<p class="intro">
This example demonstrates how a content publisher can use the UID2 services and the
<a href="https://unifiedid.com/docs/guides/integration-javascript-client-server"
<a href="https://unifiedid.com/docs/sdks/sdk-ref-javascript"
>UID2 SDK for JavaScript</a
>
to implement the
<a
href="https://unifiedid.com/docs/guides/integration-google-ss#sdk-for-javascript-client-side-integration"
href="https://unifiedid.com/docs/guides/integration-google-ss#sdk-for-javascript-client-server-integration"
>client-server UID2 integration with Secure Signals</a
>. [<a
href="https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3"
href="https://github.com/IABTechLab/uid2-examples/tree/main/web-integrations/google-secure-signals/client-server"
>Source Code</a
>]
</p>
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html>
<head>
<meta charset="UTF-8" />
<title>Example for Client-Server UID2 SDK Integration with Google Secure Signals</title>
<title>Login - Client-Server UID2 SDK Integration Example with Google Secure Signals</title>
<link rel="stylesheet" type="text/css" href="/stylesheets/app.css" />
<link rel="shortcut icon" href="/images/favicon.png" />
<script async src="https://cdn.integ.uidapi.com/uid2SecureSignal.js"></script>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html>
<head>
<meta charset="UTF-8" />
<title>Example for Client-Server UID2 SDK Integration with Google Secure Signals</title>
<title>Opted Out - Client-Server UID2 SDK Integration Example with Google Secure Signals</title>
<link rel="stylesheet" type="text/css" href="/stylesheets/app.css" />
<link rel="shortcut icon" href="/images/favicon.png" />
</head>
Expand Down
4 changes: 2 additions & 2 deletions web-integrations/google-secure-signals/client-side/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# UID2 Client-Side Secure Signals Integration Example
# Client-Side UID2 SDK Integration Example with Google Secure Signals

This example demonstrates how a content publisher who is working with [Google Interactive Media Ads(IMA) SDKs](https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side) can use [Google Secure Signal](https://support.google.com/admanager/answer/10488752) and the [UID2 SDK for JavaScript](https://unifiedid.com/docs/sdks/sdk-ref-javascript) to share UID2 directly with bidders, in an implementation that uses this JS SDK on the client side.

Expand All @@ -17,7 +17,7 @@ If needed, to close the application, terminate the docker container or use the `

## Test the Example Application

The example application illustrates the steps documented in the [Google Ad Manager Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss). For an overview of the high-level workflow for establishing UID2 identity, API reference, and explanation of the UID2 cookie format, see [UID2 SDK for JavaScript](https://unifiedid.com/docs/sdks/client-side-identity).
The example application illustrates the steps documented in the [Google Ad Manager Secure Signals Integration Guide](https://unifiedid.com/docs/guides/integration-google-ss). For an overview of the high-level workflow for establishing UID2 identity, API reference, and explanation of the UID2 cookie format, see [UID2 SDK for JavaScript](https://unifiedid.com/docs/sdks/sdk-ref-javascript).

The following table outlines and annotates the steps you may take to test and explore the example application.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html>
<head>
<meta charset="UTF-8" />
<title>UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK, Secure Signals</title>
<title>Client-Side UID2 SDK Integration Example with Google Secure Signals</title>
<link rel="stylesheet" type="text/css" href="/styles/ads.css" />
<link rel="stylesheet" type="text/css" href="/styles/app.css" />
<link rel="shortcut icon" href="images/favicon.png" />
Expand All @@ -12,7 +12,7 @@
</script>
</head>
<body>
<h1>UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK, Secure Signals</h1>
<h1>Client-Side UID2 SDK Integration Example with Google Secure Signals</h1>
<p>
This example demonstrates how a content publisher can follow the
<a href="https://unifiedid.com/docs/guides/integration-javascript-client-side">Client-Side Integration Guide for JavaScript</a> to implement UID2 integration and generate UID2 tokens.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# UID2 React Secure Signals Integration Example
# React Client-Side UID2 SDK Integration Example with Google Secure Signals

This example demonstrates how a content publisher who is working with [Google Interactive Media Ads(IMA) SDKs](https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side) can use [Google Secure Signal](https://support.google.com/admanager/answer/10488752) and the [UID2 SDK for JavaScript](https://unifiedid.com/docs/sdks/sdk-ref-javascript) to share UID2 directly with bidders, in an implementation that uses this JS SDK on the client side in a React App.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
</head>
<link rel="manifest" href="%PUBLIC_URL%/manifest.json" />

<title>UID2 Publisher Client-Side React Integration Example</title>
<title>React Client-Side UID2 SDK Integration Example with Google Secure Signals</title>
</head>
<body>
<noscript>You need to enable JavaScript to run this app.</noscript>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -312,8 +312,7 @@ const SecureSignalsApp = () => {
return (
<div>
<h1>
UID2 Publisher Client-Side Integration Example using React, UID2 JavaScript SDK, Secure
Signals
React Client-Side UID2 SDK Integration Example with Google Secure Signals
</h1>
<p>
This example demonstrates how a content publisher can follow the{' '}
Expand Down
4 changes: 2 additions & 2 deletions web-integrations/google-secure-signals/server-side/README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Server-Side UID2 Secure Signals Integration Example
# Server-Side UID2 Integration Example with Google Secure Signals

This example demonstrates how a content publisher who is working with [Google Interactive Media Ads(IMA) SDKs](https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side) can use [Google Secure Signal](https://support.google.com/admanager/answer/10488752) to share UID2 directly with bidders, in a server-side implementation of UID2.

For an example application using the [UID2 SDK for JavaScript](https://unifiedid.com/docs/sdks/sdk-ref-javascript), see [Server-Side Integration Example, UID2 JavaScript SDK](../with_sdk_v3/README.md).
For an example application using the [UID2 SDK for JavaScript](https://unifiedid.com/docs/sdks/sdk-ref-javascript), see [Client-Server UID2 SDK Integration Example with Google Secure Signals](../client-server/README.md) or [Client-Side UID2 SDK Integration Example with Google Secure Signals](../client-side/README.md).

> NOTE: Although the server side of the example application is implemented in JavaScript using node.js, it is not a requirement. You can use any technology of your choice and refer to the example application for an illustration of the functionality that needs to be implemented.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<html>
<head>
<title>IMA HTML5 Simple Demo</title>
<title>Video Ad - Server-Side UID2 Integration Example with Google Secure Signals</title>
<link rel="stylesheet" type="text/css" href="stylesheets/style.css">
</head>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,16 +29,14 @@
<h1>Server-Side UID2 Integration Example with Google Secure Signals</h1>
<p class="intro">
This example demonstrates how a content publisher can use the UID2 services to implement the
<a href="https://unifiedid.com/docs/guides/integration-google-ss#server-side-integration"
>Server-Side Integration.</a
>. [<a
href="https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/server_side"
<a href="https://unifiedid.com/docs/guides/integration-google-ss#server-side-integration">server-side UID2 integration workflow with Secure Signals</a>. [<a
href="https://github.com/IABTechLab/uid2-examples/tree/main/web-integrations/google-secure-signals/server-side"
>Source Code</a
>]
<br />
<br />
This assumes that the publisher has implemented
<a href="https://unifiedid.com/docs/guides/integration-google-ss">Server-Side integration</a>
<a href="https://unifiedid.com/docs/guides/integration-publisher-server-side">UID2 Server-Side integration</a>
on the backend and is able to pass the resulting UID2 identity response to the front end.
</p>
</body>
Expand Down
8 changes: 4 additions & 4 deletions web-integrations/javascript-sdk/client-server/README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# UID2 SDK Integration Example
# Client-Server UID2 Integration Example using JavaScript SDK

[This example](https://example-jssdk-integ.uidapi.com/) demonstrates how a content publisher can use the [UID2 services](https://unifiedid.com/docs/intro) and the [UID2 SDK for JavaScript](https://unifiedid.com/docs/sdks/client-side-identity) to implement the [standard UID2 integration workflow](https://unifiedid.com/docs/guides/publisher-client-side).
[This example](https://example-jssdk-integ.uidapi.com/) demonstrates how a content publisher can use the [UID2 services](https://unifiedid.com/docs/intro) and the [UID2 SDK for JavaScript](https://unifiedid.com/docs/sdks/sdk-ref-javascript) to implement the [client-server UID2 integration workflow](https://unifiedid.com/docs/guides/integration-javascript-client-server).

For an example application without using the UID2 SDK, see [Server-Only UID2 Integration Example](https://github.com/IABTechLab/uid2-examples/tree/main/publisher/server_only/README.md).
For an example application without using the UID2 SDK, see [Server-Side UID2 Integration Example](../../server-side/README.md).

> NOTE: While the server side of the example application is implemented in JavaScript using node.js, it is not
> a requirement. You can use any technology of your choice and refer to the example application for illustration of the functionality that needs to be implemented.
Expand Down Expand Up @@ -60,4 +60,4 @@ The following table outlines and annotates the steps you may take to test and ex
| 3 | Click the **Back to the main page** link. | On the updated application main page, note the newly populated **UID2 Advertising Token** value. The [page view](views/index.html) calls the [init() function](https://unifiedid.com/docs/sdks/client-side-identity#initopts-object-void) again, but this time without passing an explicit identity. Instead, the identity is loaded from the first-party cookie. |
| 4 | (Optional) Right-click the main page to inspect the source code. | When the UID2 SDK initialization is complete, the SDK invokes the passed [callback function](https://unifiedid.com/docs/sdks/client-side-identity#callback-function) (`onUid2IdentityUpdated()` in this example).</br>IMPORTANT: The callback updates the page elements with the state of UID2 identity: this is the place where you should define your logic for initiating targeted advertising. |
| 5 | Keep the application main page open or refresh it after awhile and note the UID2 identity state, updated counter, and login information values. | In the background, the UID2 SDK continuously validates whether the advertising token is up-to-date and refreshes it automatically when needed. If the refresh succeeds, the user opts out, or the refresh token expires, the callback function is invoked and the UI elements are updated with the current state of the UID2 identity. For details, see [Workflow States and Transitions](https://unifiedid.com/docs/sdks/client-side-identity#workflow-states-and-transitions) and [Background Token Auto-Refresh](https://unifiedid.com/docs/sdks/client-side-identity#background-token-auto-refresh). |
| 6 | To exit the application, click **Clear UID2**. | This event calls the [UID2 SDK `disconnect()` function](https://unifiedid.com/docs/sdks/client-side-identity#disconnect-void), which clears the UID2 session and the first-party cookie. This call also makes the [UID2 SDK `isLoginRequired()` function](https://unifiedid.com/docs/sdks/client-side-identity#isloginrequired-boolean) return `true`, which presents the user with the login form again.<br/> NOTE: The page displays the **Clear UID2** button as long as the user identity is valid and refreshable within the integration test environment. |
| 6 | To exit the application, click **Clear UID2**. | This event calls the [UID2 SDK `disconnect()` function](https://unifiedid.com/docs/sdks/client-side-identity#disconnect-void), which clears the UID2 session and the first-party cookie. This call also makes the [UID2 SDK `isLoginRequired()` function](https://unifiedid.com/docs/sdks/client-side-identity#isloginrequired-boolean) return `true`, which presents the user with the login form again.<br/> NOTE: The page displays the **Clear UID2** button as long as the user identity is valid and refreshable within the integration test environment. |
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html>
<head>
<meta charset="UTF-8" />
<title>Error</title>
<title>Error - Client-Server UID2 Integration Example using JavaScript SDK</title>
<link rel="stylesheet" type="text/css" href="/stylesheets/app.css" />
<link rel="shortcut icon" href="/images/favicon.png" />
</head>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html>
<head>
<meta charset="UTF-8" />
<title>UID2 Publisher Standard Integration Example</title>
<title>Client-Server UID2 Integration Example using JavaScript SDK</title>
<link rel="stylesheet" type="text/css" href="/stylesheets/app.css" />
<link rel="shortcut icon" href="/images/favicon.png" />
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
Expand Down
10 changes: 5 additions & 5 deletions web-integrations/javascript-sdk/client-server/views/intro.html
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
<h1>UID2 SDK Integration Example</h1>
<h1>Client-Server UID2 Integration Example using JavaScript SDK</h1>
<p class="intro">
This example demonstrates how a content publisher can use the UID2 services and the
<a href="https://unifiedid.com/docs/guides/integration-javascript-client-server"
<a href="https://unifiedid.com/docs/sdks/sdk-ref-javascript"
>UID2 SDK for JavaScript</a
>
(UID2 SDK) to implement the
<a href="https://unifiedid.com/docs/guides/publisher-client-side"
>standard UID2 integration workflow</a
>. [<a href="https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/js-sdk"
<a href="https://unifiedid.com/docs/guides/integration-javascript-client-server"
>client-server UID2 integration workflow</a
>. [<a href="https://github.com/IABTechLab/uid2-examples/tree/main/web-integrations/javascript-sdk/client-server"
>Source Code</a
>]
</p>
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html>
<head>
<meta charset="UTF-8" />
<title>UID2 Publisher Standard Integration Example Login Result</title>
<title>Login - Client-Server UID2 Integration Example using JavaScript SDK</title>
<link rel="stylesheet" type="text/css" href="/stylesheets/app.css" />
<link rel="shortcut icon" href="/images/favicon.png" />
<script src="https://cdn.integ.uidapi.com/uid2-sdk-4.0.1.js"></script>
Expand Down
2 changes: 1 addition & 1 deletion web-integrations/javascript-sdk/client-side/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# UID2 JavaScript SDK Client-Side Integration Example
# Client-Side UID2 Integration Example using JavaScript SDK

This example demonstrates how a content publisher can follow the [Client-Side Integration Guide for JavaScript](https://unifiedid.com/docs/guides/integration-javascript-client-side) to implement UID2 integration and generate UID2 tokens.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html lang="en">
<head>
<meta charset="utf-8" />
<title>UID2 Publisher Client-Side Integration Example using UID2 JavaScript SDK</title>
<title>Client-Side UID2 Integration Example using JavaScript SDK</title>
</head>
<body>
<iframe src="/index.html" width="1000" height="800"></iframe>
Expand Down
Loading