Skip to content

Commit 623f56f

Browse files
committed
Mods to UID2 GSS doc re three implementation approaches (from SW)
1 parent c0c64c3 commit 623f56f

File tree

1 file changed

+22
-3
lines changed

1 file changed

+22
-3
lines changed

docs/guides/integration-google-ss.md

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,11 @@ window.googletag.cmd.push(function () {
8282
});
8383
```
8484

85+
There are three integration options for Google Secure Signals publisher integration with UID2:
86+
- [Server-Side Integration](#server-side-integration)
87+
- [SDK for JavaScript Client-Server Integration](#sdk-for-javascript-client-server-integration)
88+
- [SDK for JavaScript Client-Side Integration](#sdk-for-javascript-client-side-integration)
89+
8590
### Server-Side Integration
8691

8792
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.
@@ -102,6 +107,16 @@ For details, see [Publisher Integration Guide, Server-Side](integration-publishe
102107

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

110+
### SDK for JavaScript Client-Server Integration
111+
112+
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.
113+
114+
This script is hosted on CDN, and GPT automatically loads it with the secure signals feature.
115+
116+
For details, see [Client-Server Integration Guide for JavaScript](integration-javascript-client-server.md).
117+
118+
A sample implementation is also available for integration using the SDK for JavaScript. See [Sample Implementations](#sample-implementations).
119+
105120
### SDK for JavaScript Client-Side Integration
106121

107122
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.
@@ -110,19 +125,23 @@ This script is hosted on CDN, and GPT automatically loads it with the secure sig
110125

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

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

115130
## Sample Implementations
116131

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

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

141+
<!-- - Client-Side UID2 SDK Integration Example (TO COME):
142+
- [Sample implementation](https://secure-signals-jssdk-integ.uidapi.com/)
143+
- [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3) -->
144+
126145
Each sample implementation has its own instructions.
127146

128147
## Troubleshooting

0 commit comments

Comments
 (0)