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
Within settings, you can configure headers such as OT-Country-Code
to force a regional-specific experience.
You can enable the UI Assist feature by turning on the UI Assist in the Settings.
You can change between a CTV or Mobile experience within the settings section.
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 4 days ago