Skip to content

Mods to UID2 GSS doc re three implementation approaches (from SW) #815

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
genwhittTTD merged 1 commit into from
Jan 30, 2025
Merged

Mods to UID2 GSS doc re three implementation approaches (from SW) #815

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
25 changes: 22 additions & 3 deletions docs/guides/integration-google-ss.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,11 @@ window.googletag.cmd.push(function () {
});
```

There are three integration options for Google Secure Signals publisher integration with UID2:
- [Server-Side Integration](#server-side-integration)
- [SDK for JavaScript Client-Server Integration](#sdk-for-javascript-client-server-integration)
- [SDK for JavaScript Client-Side Integration](#sdk-for-javascript-client-side-integration)

### Server-Side Integration

So that it can share encrypted signals, the hosted auto-loaded secure signals script must be able to make an asynchronous call to the `window.getUid2AdvertisingToken` function and, in response, receive `advertising_token` as a string.
Expand All @@ -102,6 +107,16 @@ For details, see [Publisher Integration Guide, Server-Side](integration-publishe

A sample implementation is also available for server-side integration. See [Sample Implementations](#sample-implementations).

### SDK for JavaScript Client-Server Integration

If you're using the SDK for JavaScript version 3.0.0 or later, the UID2 secure signals script uses the `getAdvertisingTokenAsync` function provided in the SDK to get the fresh advertising token, and then pushes the token to Google Ad Manager.

This script is hosted on CDN, and GPT automatically loads it with the secure signals feature.

For details, see [Client-Server Integration Guide for JavaScript](integration-javascript-client-server.md).

A sample implementation is also available for integration using the SDK for JavaScript. See [Sample Implementations](#sample-implementations).

### SDK for JavaScript Client-Side Integration

If you're using the SDK for JavaScript version 3.0.0 or later, the UID2 secure signals script uses the `getAdvertisingTokenAsync` function provided in the SDK to get the fresh advertising token, and then pushes the token to Google Ad Manager.
Expand All @@ -110,19 +125,23 @@ This script is hosted on CDN, and GPT automatically loads it with the secure sig

For details, see [Client-Side Integration Guide for JavaScript](integration-javascript-client-side.md).

A sample implementation is also available for integration using the SDK for JavaScript. See [Sample Implementations](#sample-implementations).
<!-- A sample implementation is also available for integration using the SDK for JavaScript. See [Sample Implementations](#sample-implementations). [sample integration to come Jan 2025-->

## Sample Implementations

The following sample implementations are available to illustrate how to integrate with the Google Ad Manager secure signals feature:

- Server-Side UID2 SDK Integration Example:
- Server-Side UID2 SDK Integration Example with Google Secure Signals:
- [Sample implementation](https://secure-signals-srvonly-integ.uidapi.com/)
- [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/server_only)
- [Code repository](https://github.com/IABTechLab/uid2-examples/blob/main/publisher/server_only/README.md)
- Client-Server UID2 SDK Integration Example:
- [Sample implementation](https://secure-signals-jssdk-integ.uidapi.com/)
- [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3)

<!-- - Client-Side UID2 SDK Integration Example (TO COME):
- [Sample implementation](https://secure-signals-jssdk-integ.uidapi.com/)
- [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3) -->

Each sample implementation has its own instructions.

## Troubleshooting
Expand Down