Web Integration Overview
As a publisher, there are many ways that you can integrate with EUID to generate identity tokens to be passed into the RTB bidstream in the context of your web pages.
On this page, you'll find a high-level overview of integration steps and integration options, with links to additional information for each option.
Key Integration Steps
At a high level, to integrate with EUID, you'll implement these three key activities:
There are many ways you can accomplish these key steps. Generally, the simplest and fastest implementation is a full client-side implementation using Prebid.js 8.21.0 or later.
Integration Options Summary
The following table summarizes the solutions available for each integration step.
To accomplish all steps, you can combine solutions. For example, you could use the SDK for JavaScript, client-side, to generate and refresh the token, and Google Ad Manager Secure Signals to pass the token to the bidstream.
| Integration Solution | Generate Token | Refresh Token | Pass Token to the Bidstream |
|---|---|---|---|
| Prebid.js client-side (8.42.0 or later) | ✅ | ✅ | ✅ |
| Prebid.js client-server (7.53.0 or later) | — | ✅ | ✅ |
| SDK for JavaScript, client-side | ✅ | ✅ | — |
| SDK for JavaScript, client-server | ✅ | ✅ | — |
| SDK for Java | ✅ | ✅ | — |
| SDK for Python | ✅ | ✅ | — |
| Direct integration (API endpoints) | ✅ | ✅ | — |
| Google Ad Manager Secure Signals | — | — | ✅ |
To choose your implementation and get started, follow these steps:
- Review the summary of options to generate an EUID token:
- Review the options to refresh the EUID token.
- Review the options to pass the token into the bidstream.
- Choose the option that's best for you, and then click through to the implementation documentation.
Generate the EUID Token
There are two main paths that you can choose to generate an EUID token—you can choose to initiate the EUID token generate request:
- On the client side (in the user's browser): see Client-Side Integration Options.
- On the server side: see Server-Side Integration Options.
Each option has different advantages. We recommend client-side integration using Prebid.js 8.21.0 or later as the easiest and fastest integration option.
For all integration options, you can choose to store the EUID token in local storage or cookie storage.
Client-Side Integration Options
Generating the EUID token on the client side has the following advantages:
- The code runs on the client side, on the consumer's web page, and no server-side coding is required.
- There is a Prebid.js integration that handles all functions for you—token generation, token refresh, and passing the token into the bidstream. If you use Prebid.js 8.21.0 or later, this is generally the simplest and fastest implementation option.
If you choose a client-side integration, you'll need to provide a list of your top-level domains, for security purposes, as part of account setup. For details, see Client-Side Web Integrations on the Account Setup page.
The following table summarizes the options for publishers who want to generate the EUID token on the client side, via the web page, with corresponding documentation resources.
| Option | Documentation |
|---|---|
| Prebid.js client-side implementation (8.21.0 or later) | EUID Client-Side Integration Guide for Prebid.js |
| SDK for JavaScript, client-side implementation | Client-Side Integration Guide for JavaScript |
Server-Side Integration Options
Generating the EUID token on the server side has the following advantages:
- You can keep your personal data entirely on the server side.
- If your development resources are back-end developers, you might prefer a server-side integration.
- For server-side Prebid.js integration, there is no requirement to update to the latest Prebid.js version, as long as your version is 7.53.0 or later.
The following table summarizes the options for publishers who want to generate the EUID token on the server side.
| Option | Documentation |
|---|---|
| SDK for JavaScript, client-server implementation | Client-Server Integration Guide for JavaScript |
| SDK for Java | - Publisher Integration Guide, Server-Side - SDK for Java |
| SDK for Python | - Publisher Integration Guide, Server-Side - SDK for Python |
| Direct integration (API endpoints) | Publisher Integration Guide, Server-Side |
Refresh the EUID Token
For security reasons, the EUID token has a limited life, but there is a built-in mechanism to refresh the token so that you can still use it.
When you get the token, it comes with a refresh token and a timestamp indicating how long the token is valid for. As long as you use the refresh token to generate a new EUID token before the current EUID token expires, you'll get a new EUID token and an updated refresh token each time. You can continue to refresh to keep the information valid.
The following table shows the integration options that support refreshing the EUID token.
| Option | Documentation |
|---|---|
| Prebid.js client-side implementation (8.21.0 or later) | EUID Client-Side Integration Guide for Prebid.js |
| Prebid.js client-server implementation (7.53.0 or later) | EUID Client-Server Integration Guide for Prebid.js |
| SDK for JavaScript, client-side implementation | Client-Side Integration Guide for JavaScript |
| SDK for JavaScript, client-server implementation | Client-Server Integration Guide for JavaScript |
| SDK for Java | - Publisher Integration Guide, Server-Side - SDK for Java |
| SDK for Python | - Publisher Integration Guide, Server-Side - SDK for Python |
| Direct integration (API endpoints) | Publisher Integration Guide, Server-Side |
Pass the Token Into the Bidstream
Publishers use EUIDs by encrypting personal data (email addresses or phone numbers) into EUID tokens and then sending the EUID tokens into the bidstream.
The following table shows integration options that support passing EUID tokens into the bidstream.
| Option | Documentation |
|---|---|
| Prebid.js client-side implementation (8.21.0 or later) | EUID Client-Side Integration Guide for Prebid.js |
| Prebid.js client-server implementation (7.53.0 or later) | EUID Client-Server Integration Guide for Prebid.js |
| Google Ad Manager Secure Signals | Google Ad Manager Secure Signals Integration Guide |
As long as you generate the token and keep it refreshed, you can also use other options for passing the EUID token into the bidstream.