IABTechLab / cmp

15 stars 19 forks source link

CMP Integration Testing Tool #47

Open hbruce27 opened 6 years ago

hbruce27 commented 6 years ago

Summary: The format of the consent cookie is pretty obfuscated, which makes testing difficult. We need a thin tool to turn the cookie into some human readable format so that our partners can test their CMP implementation by comparing inputs and outputs.

Acceptance Criteria: As a partner (advertiser/publisher), I should have access to a CMP integration testing tool As a partner, I should be able to feed a consent cookie into the testing tool, and get returned the "contents" of that cookie in a human readable format. (specifically, what type(s) of consent have been given, and to which data partners)

Details: The UI for this should be simple, but clean enough to share with external teams. "IAB Tech Lab Transparency and Consent Framework Cookie and Vendor List v1.1" can be found here: https://docs.google.com/document/d/1UmarlyN3mwDZOcECil996vPjmE9Xds-FoLGhzC4xySY/edit "IAB Consent String and Vendor List Format: Transparency & Consent Framework" can be found here: https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/Consent%20string%20and%20vendor%20list%20formats%20v1.1%20Final.md

SupahNickie commented 6 years ago

The decoding logic can be found in https://github.com/digi-trust/cmp/blob/master/src/lib/cookie/cookie.js and https://github.com/digi-trust/cmp/blob/master/src/lib/cookie/cookieutils.js . The useful call you can make to the CMP to read the cookie's data after it has loaded is window.__cmp('getVendorConsents'), which returns a Promise.

Please feel free to ask any further questions!