AdTech Integration Guides

AdTech Integration Guides

  • App (SDK)
  • App (Somquery)
  • Desktop
  • CTV

›CMP Implementation

Getting Started

  • Introduction

Integration Guide

  • InStream (Video Ad)

CMP Implementation

  • Introduction
  • Provide user consent

Testing & QA

  • Introduction
  • Frequent Bugs

Introduction

Somquery is compatible with the IAB TCF (https://iabeurope.eu/tcf-2-0/). If you have implemented a Consent Management Platform (CMP) compatible with this standard, our technical components will automatically react to the consent string modified by the CMP and act accordingly. If you don't support the IAB TCF yet, you can provide us the users consent via the General opt-out toggle. The following describes these two different ways how consent can be provided.

Note: Combination of CMP with IAB TCF and General opt-out toggle is not allowed. Choose one of these two options.

CMP with IAB TCF

The consent can be provided via IAB TCF and Uncertified Vendors Flag. In addition to the TC String, Somquery requires a toggle that signals users’ consents for the non-TCF vendors on the SOM Vendor List (the “Uncertified Vendors Toggle”).

SettingValue
For all non-TCF vendors on the SOM Vendor List, the user has given consent for all purposes, special purposes, features and special features unrestrictedly.0
For one or more non-TCF vendors on the SOM Vendor List, the user has not given consent for all purposes, special purposes, features and special features unrestrictedly.1

General opt-out

If you don't have a CMP with IAB TCF yet, you can provide us the users consent via the General opt-out toggle. Integrate a global opt-out for personalized ads e.g. by integrating a toggle and persisting the setting. The value of the toggle has to be used to decide when and how user realated data must or must not be passed to our ad server.

Note: Please make sure that the toggle is easily accesible by the user. If you integrate it in the same view as the vendor list, you might integrate it at the top of the list to avoid forcing the user to scroll through the whole list to alter his settings.

The user consent will also be needed to be directly passed as an integer value which will be described in more detail below.

Toggle values that need to be passed:

SettingValue
Personalized ads are allowed0
Personalized ads are not allowed1

Note: Please note that "0" value means personalized ads are allowed, as the official key is NPA (Non personalized ads), meaning force non personalized ads.

Nugg.Ad

If user has opted out of personalized ads do not pass any Nugg.ad values anymore and do not perform any further Nugg.ad prediction calls. Reset the stored values to the fallback value configured in the ad configuration JSON (or bt=0 for tag based integrations).

← InStream (Video Ad)Provide user consent →
  • CMP with IAB TCF
  • General opt-out
  • Nugg.Ad
AdTech Integration Guides
Guides
AppDesktopCTV
More
GitHub
Contact

SevenOne Media GmbH
Medienallee 4
85774 Unterföhring

71.adtechnology@gmail.com
SevenOne Media - Wir bewegen Marken
Copyright © 2023 SevenOne Media GmbH