Skip to content

Commit

Permalink
Merge pull request #815 from IABTechLab/gwh-APIDOCS-2866-sample-impl-…
Browse files Browse the repository at this point in the history
…copy-mods-from-sw

Mods to UID2 GSS doc re three implementation approaches (from SW)
  • Loading branch information
genwhittTTD authored Jan 30, 2025
2 parents 8c47c8f + 623f56f commit 6a3d580
Showing 1 changed file with 22 additions and 3 deletions.
25 changes: 22 additions & 3 deletions docs/guides/integration-google-ss.md
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

0 comments on commit 6a3d580

Please sign in to comment.