CMP Debugging console

Adapex offers our clients a CMP debugging console that works with our custom header bidder wrapper.

CMP and wrapper interaction explained

The wrapper interaction with a CMP is very similar to the interaction GAM has with a CMP. Before each auction initiates (not when the wrapper is loaded or at different points), the wrapper will look for the CMP (both TCF 2.0 and US Privacy). If one or both are detected, it will enable the prebid consent module, which means it will wait for the CMP to retrieve consent before proceeding with the auction.

As a side note: If you run a CMP on countries/regions that do not require a CMP, the wrapper will still wait for the CMP to instruct it that it doesn’t require any consent.

If there is no CMP detected, the auction will run normally.

Important things:

  • The CMP must be IAB compliant and TCF 2.0 (1.0 and 1.1 is no longer supported and was never supported by GAM)
  • The CMP must be loaded before the wrapper’s auction initiates (later exemplified)
  • Currently there’s no individual purpose enforcement, consent for any purpose will start the auction

How the CMP console works

To enable the console, put this at the end of the URL: ?magma=true, and the console will pop up in the top-left corner.

There are 2 modalities for consent frameworks:

  1. US Privacy (the one for California)
  2. TCF 2.0 (for GDPR)

The console will run two types of checks: first it detects if the above CMPs exist, then it checks if the CMPs work correctly.

IAB US Privacy CMP

Does it exist on site?

If this CMP exists on site, we see this message: “Prebid detected an IAB US Privacy CMP”.

If it is not implemented, we see: “Prebid DID NOT detect an IAB US Privacy CMP”. We can also see this message when the CMP is implemented, but it is slow and has not yet loaded at the time of the check. This is not optimal, we should make the CMP load before the wrapper if you always want to be compliant.

Does it work correctly?

If it has consent, we see this message: “Interaction with IAB US Privacy CMP successful”. There might be an additional information such as: “IAB US Privacy CMP does not apply for this region”.

If it doesn’t have consent, it means that it either doesn’t have it yet (e.g. the privacy pop up is still open), or the user is not from California (according to the CMP provider). The message is “interaction with IAB US Privacy CMP failed”. To test this we need to use a California VPN (incognito).

TCF 2.0

Does it exist on site?

If this CMP exists on site, we see this message: “Prebid detected an IAB TCF 2.0 CMP”.

If it is not implemented, we see: “Prebid DID NOT detect an IAB TCF 2.0 CMP”. We can also see this message when the CMP is implemented, but it is slow and has not yet loaded at the time of the check. Another case is when a site uses TCF 1.0 version, which is not supported anymore. 

Does it work correctly?

If it has consent, we see this message: “Interaction with IAB TCF 2.0 CMP successful”. There might be an additional information such as: “CPM API Response: GDPR Applied: true Status: cmpusshown” and “Status: useractioncomplete”.

 

Some live examples:

On all examples the ad refreshes every 30s.

In the 3rd example you can see that the first time the CMP is not detected (since the CMP is loaded after 3 seconds), so the auction goes normally. The second auction the CMP was loaded and the wrapper detects it:

Reporting on CMP

We have set some key values for reporting. If you wish to dig deeper, please request a CMP report from your account manager.

 

Satisfied Clients

For years, Adapex has been our trusted partner — their experts are always there for us and feel like a part of our team. I have confidence that their techniques and products will keep our revenues growing strong. Highly recommend!

Dominick Miserandino Former CEO, Inquisitr.com
Working with Debra and her team has helped our monetization strategy tremendously.  We have a great relationship with Adapex, working together to maximize monetization, identify new incremental revenue opportunities and improve overall ad performance.  Adapex is very easy to work with, responsive and proactive…their technical team is always ready to work with our development team to ensure seamless integration.

We couldn’t find a better partner to work with.

Oren Vardy Co-Founder & Portfolio Manager, Landoc Holdings LTD

We’ve been working with Adapex for a while and they consistently offer great support and present new opportunities to generate more revenue every month.

Sebastien Rozen Co-Founder and CEO, Viewdeos

The entire Adapex team has quickly become key players in our overall revenue optimization strategy. They’re fast, responsive, proactive, and most importantly good at what they do. I am beyond happy I made the decision to make the change to Adapex.

Asad Meah CEO & Founder, Awaken the Greatness Within

“Adapex more than doubled our programmatic revenue year-over-year. This fact speaks for itself; what I would like to call out is the exceptional level of attention and support that they provide to their clients. It would be a true challenge to find a more responsive or knowledgeable team anywhere in the industry.”

Allen Weiss Senior Developer, Sweety High