2024 release notes

These release notes list all new features and updates that have been made to The Trade Desk solutions for sellers in 2024.

Integration best practices guide

November 26, 2024

To boost your authentication rates with OpenPass, we've created an integration best practices guide based on early user experience feedback. It will help you avoid common pitfalls and optimize your setup.

OpenPass account management portal

August 2, 2024

Introducing the self-serve OpenPass Account Management portal, which provides your organization with end-to-end services for integration, application management, and data monitoring. To help manage your OpenPass implementations, use this guide to navigate the portal’s features.

Roku TV quickstart

May 6, 2024

The Roku TV quickstart guide is now available for integrating OpenPass directly with your Roku channel.

Error code reference

May 3, 2024

To facilitate troubleshooting and resolving API errors, the OpenPass documentation now includes Error code reference. It lists common error codes and recommends possible solutions to get your integration working again.

Passport.js quickstart

April 26, 2024

Configure OpenPass as an authentication provider using Passport.js with OpenID Connect.

JavaScript device auth grant quickstart

April 17, 2024

The JavaScript device auth grant quickstart guide is now available. It is designed for devices with limited input capabilities such as smart TVs, game consoles, and Internet of Things (IoT) devices. By following this guide, you can create an OpenPass client to integrate with your device and implement single sign-on (SSO) for the open internet.

Filtering proposals by external deal IDs

April 9, 2024

You can now retrieve proposals and filter them by external deal IDs. Just list the IDs you want to filter results by in the ExternalDealIdFilter string array, and the matching proposals will be returned with all of their associated deals. For details, see POST /proposal/query.

JavaScript QuickAuth quickstart

March 13, 2024

The JavaScript QuickAuth quickstart guide is now available. It allows you to render a QuickAuth sign-in form directly within a web page for a more seamless and integrated user experience. With QuickAuth, users who are already signed in to OpenPass on their device can seamlessly authenticate to your website or app with a single click.

DOOH object in The Trade Desk Standard Adapter

March 12, 2024

The Trade Desk Standard Adapter has been updated to include the dooh object for ad-supported content displayed on Digital Out-Of-Home (DOOH) screens. For details, see DOOH object.

Amazon Cognito integration quickstart

February 28, 2024

The Amazon Cognito integration quickstart guide is now available for integrating OpenPass with Amazon Cognito to securely authenticate users with other services that support OIDC-identity providers.

Auth0 integration quickstart

February 28, 2024

The Auth0 integration quickstart guide is now available for integrating OpenPass with Okta's Auth0 to securely authenticate users and connect them to an OAuth2 authorization server.

Google Cloud Platform integration quickstart

February 28, 2024

The Google Cloud Platform integration quickstart guide is now available for integrating OpenPass with Google Cloud Identity and Firebase to securely authenticate users. This activates the OpenPass connection for your application in your Google Cloud Platform domain, enabling organizations to quickly onboard and use OpenPass as an identity solution option.

Impression win notifications

February 6, 2024

Brush up on bid winning workflows and find out how you can ensure that no impressions are lost when you use our standard adapter. For details, see Impression win notifications.

iOS Quickstart

January 26, 2024

The iOS quickstart guide is now available for integrating OpenPass directly with your iOS, iPadOS, or tvOS application.

Next.js quickstart

January 26, 2024

The Next.js quickstart guide is now available for configuring OpenPass as an authentication provider using the NextAuth.js plugin for the Next.js web framework.

Updated JavaScript SDK

January 26, 2024

To improve the user and branding experience, we've released version 4 of our JavaScript SDK, which offers new design and styling options. You can install it from the OpenPass CDN or NPM.

This SDK has the following new features and major updates, including breaking changes if you decide to upgrade.

Sign-in button styling options

The Sign In with OpenPass button now has many styling options to ensure the right look and feel for your website, including the following:

Size
Additional width
Shape and variants
Text option
Theme

The SDK automatically renders the button through a programmatic JavaScript call or HTML API. For more information, see the following pages.

Name	Description
API reference guide	A full list of Sign In with OpenPass button options and parameter names.
Sign-in button samples	A visual reference of many of the styling options rendered.

Inline sign-in form

The new openPassClient.renderInlineSignInForm method can render an inline sign-in form in an iframe within a web page. This option differs from the standard OpenPass sign-in form by placing the organization's logo and display name on the first lines of the sign-in form, not next to the OpenPass brand.

For a full list of inline sign-in form options and parameter names, see the API reference guide.

Sign in response.originating uri property

The SignInResponse type returned from the openPassClient.handleAuthenticationRedirect method and popup-success callbacks now contains a property called originatingUri. This is the originating window URI the user was on when the authentication flow was initiated. It can be used to redirect users back to the original page they came from when handling redirect callbacks.

For details on SignInResponse parameters, see the API reference guide.

Breaking changes

Here's what you need to know about the latest code modifications if you are upgrading to this new version. There is no requirement to upgrade, and we have no plans to deprecate older versions.

Change Type	Affected Area	Change Description	Notes
Parameter name change	`openPassClient.renderSignInButton` options in the JavaScript API	`textType` to `text`	The HTML API continues to use the parameter name `data-text`.
Default value change	`Sign-In` button size	`x-large` to `large`	Applies to both JavaScript and HTML APIs.
Behavior change	This behavior applies to the following methods: `openPassClient.signInWithPopup` `openPassClient.renderSignInButton` `openPassClient.renderInlineSignInForm`	The `options.redirectUri` parameter is now optional when using the popup flow.	The redirect URI was defaulting to the current page URI, which sometimes caused authentication failures because the current page was often missing from the configuration for valid redirect URIs. If the redirect URI is provided and the popup window fails to open, the popup flow will fall back to the redirect mode. If not, an `SdkError` error will be given to help with troubleshooting.

To install the SDK and use the new features and options, see the JavaScript quickstart guides. If you need implementation examples, see the OpenPass Sample Sites repository in GitHub.

Co-branding guidelines

January 8, 2024

To make the user experience consistent and enjoyable, we're happy to provide you OpenPass co-branding guidelines. This page includes a ZIP file with SVG logos and other web assets.