Introduction
The CMP API solution was designed to help support web-based CTV platforms currently not supported by the CTV SDK. As the name entails, CMP functions will be computed on the server and the response handed back to the client. This was done in an effort to improve performance for web-based CTV platforms as some of these lower end devices have limited storage and computing power. Today, this is a headless solution and you will be responsible for creating the User Interface (UI) for the banner and preference center.
The following technical docs outline the steps needed to implement this solution in your app:
- Persisting Consent
- Get Banner UI
- Get Preference Center UI
- Get Vendor List UI
- Save and Log Consent
- Implementation Guidance
UI Assist App
To help you understand how to build the UI of your CMP, we have created a UI Assist Application for developers that shows where each UI element is found in each API response.
This application is meant to help understand how the API responses relate to the UI. It is not designed to have the full functionality of a CTV or mobile application, thus it will not save consent or create consent strings.
How to use the application
macOS (Intel and Silicon)
- Download the application here.
- Run Application
NOTE:
For macOS, you may need to run the following command in order to be able to launch the application:
xattr -c <path/to/application.app>
Example:
xattr -c ~/Downloads/OneTrust-CMP-Simulator.app
Reference: "XYZ Is Damaged and Can’t Be Opened. You … - Apple Community
Windows OS
- Download the application here.
- Run Application
Linux OS
- Download the application here.
- Run Application
Configuring the application
You can load your configuration into the application to display the configured text and branding by leveraging the Settings icon in the top right and adding your Application ID into the header OT-App-Id
To view location specific configurations, specify the country and/or region with OT-Country-Code
and/or OT-Region-Code
.
You can enable the UI Assist feature by turning on the UI Assist in the Settings. You also can change between a CTV or Mobile experience within the settings section.
Currently, the only way to access the Preference Center UI is through the Banner UI. If your geolocation rule has Show Banner
disabled, no UI will appear in the app at all. In this case, add OT-Force-Fetch: true
into the Settings page to force the banner to appear. You can then access the Preference Center UI from here.
FAQ
- Can I use this solution for mobile apps as well?
This initial phase was primarily designed to support CTV devices. While you may use the API solution for mobile apps, some features like App Tracking Transparency configs are not supported yet. Support for mobile apps will be fully built out in future iterations/releases.
Updated 19 days ago