OKO Digital

The ad optimisation people

  • Home
  • Publisher Solutions
    • Website Monetization
    • Header Bidding
    • AdX – Google Ad Exchange
    • App Ad Monetization
    • WordPress Monetization
  • About us
    • OKO & the OKO team
    • Careers
  • Blog
    • Latest blog posts
    • Ad Blocking
    • Ad Exchange (AdX)
    • Ad Optimisation
    • Ad Performance & Page Speed
    • Ad Publishing Landscape
    • AdSense
    • DoubleClick For Publishers (DFP)
    • Exchange Bidding
    • Google Ad Manager
    • Google Certified Publishing Partners
    • Header Bidding
    • Privacy & GDPR
    • Program Policy
    • Open Bidding
    • Traffic
  • Contact

Privacy and GDPR . 15th October 2020

How to troubleshoot TCF v2.0 Google integration issue 1.1 and 2.1a

Troubleshooting the most common TCF v2.0 Google integration issues

The deadline for the IAB’s Transparency and Consent Framework (TCF) v2.0 was on August 15, 2020 which means that Google now fully supports the Framework. Many publishers that use Google Ad Manager are experiencing integration issues and as such are receiving error messages about their setup.

In this article, we aim to help publishers find and troubleshoot the most common error codes.

A quick rundown on TCF v2.0 so far

The most recent version of TCF was announced in August 2019, after obtaining input from stakeholders and applying that feedback to the revised version. TCF v2.0 aims to address the concerns of v1.0 highlighted by legislators, advertisers and user groups. The deadline for TCF v2.0 implementation was on August 15, 2020 which is when support for v1.0 was switched off. Consent strings then became invalid after September 30, 2020, which meant that publishers had up until this date to upgrade to TCF v2.0 or use another method for obtaining consent.

Google had already promised to support TCF v2.0 and so began by gradually reading and passing Transparency Consent (TC) strings for a proportion of ad requests and ramping up to reach 100% before the deadline of August 15. In order to give publishers time to manage errors and misconfiguration related to TCF v2.0, Google has given a 90 day grace period to publishers already using TCF v2.0 to resolve any errors. This means that after November 13th 2020, ads will not be able to serve if they do not comply with consent.

Common TCF v2.0 Google implementation errors

At OKO, we’ve found that by far the most common Google integration issues affecting publishers are 1.1 errors and 2.1a errors.

You can find implementation errors in Google Ad Manager by viewing the TCF error report in Google Ad Manager by navigating to Admin > EU User Consent > Download TCF Error Report.

TCF Error Report

“IAB TCF v2.0 errors detected. Download the TCF error report and go to ‘Learn more’ for guidance on how to fix”

How to troubleshoot TCF v2.0 Google implementation error 1.1

What is error 1.1?

Error 1.1 occurs when Google, as a vendor, is not allowed under consent or legitimate interest. This issue can result in dropped and unfilled ad requests which can have a negative impact on your ad revenue. As such, they do not receive a grace period.

What causes error 1.1?

Error 1.1 occurs when Google cannot detect signals of consent or legitimate interest. This can either be caused by users intentionally rejecting Google as a vendor or a result of an outdated Consent Management Platform (CMP) configuration, which does not present users with the option to accept Google as a vendor.

How to solve error 1.1

In order to solve error 1.1, there are three steps you’ll need to address:

  1. Confirm whether the user intentionally rejected Google as a vendor.
  2. Check for any CMP implementation errors. If you’re using Quantcast Choice, you’ll need to check that Google is displayed as a vendor in the CMP on the global vendor list and check that it is not blocked. If it is not blocked, then you’ll need to block and unblock any vendor to force the CMP to display again to all users and register a transparency consent (TC) string for Google.
  3. Check for any publisher restrictions. Publisher restrictions are a new feature introduced to version 2.0 of the Framework that allow publishers to signal restrictions on how vendors may process personal data.

How to troubleshoot TCF v2.0 Google implementation error 2.1a

What is error 2.1a?

Error 2.1a occurs when the tag or Software Development Kit (SDK) is not receiving a TC string due to CMP status being stub, loading or error. For 60 days from August 15, 2020, publishers will be able to fix any misconfiguration issues without impacting their monetization. If the issue is not solved between October 14, 2020 and November 13, 2020, non-personalised ads will be served regardless of existing personalised and non-personalised ad settings. After November 13, 2020 ad requests will not be filled.

What causes error 2.1a?

The most common cause of error 2.1a is ad requests being made before the user provides or rejects consent. This error occurs when working with Google as a vendor because most TCF vendors check themselves whether the TC string is available before requesting an ad so that they can determine if they have a legal basis to process personal data.

However, Google does not check for the TC string first and instead expects the publisher to make sure the TC string is available via the CMP before requesting ads. Therefore, if an ad is requested before a TC string is made available, this results in error 2.1a.

How to solve error 2.1a

Error 2.1a can be solved by adding conditional logic to ensure that the TC string is made available before an ad is called.

The following snippet leverages the TCF v2.0 API and GPT API to only execute the GAM auction once consent has been ascertained from the CMP. Please use it for illustrative purposes as a base to suit your particular needs:

//TCF API listener code - add after TCF 2.0 compatible CMP initialization code has executed
window.__tcfapi('addEventListener', 2, function(tcData, listenerSuccess) {
if (listenerSuccess) {
// check the eventstatus
if (tcData.eventStatus === 'useractioncomplete' ||
tcData.eventStatus === 'tcloaded') {

if(!tcData.gdprApplies){
//GDPR does not apply to this user so start GAM auction
googletag.cmd.push(function () {
googletag.pubads().refresh();
});
return;
}

// Deal with parsing tcData for IAB Vendor consents
//Deal with personalized/non-personalized Google ads based on this document: https://support.google.com/admanager/answer/9805023?hl=en
if ((tcData.vendor.consents[755] || tcData.vendor.legitimateInterests[755])
&& (tcData.purpose.consents[1] && tcData.purpose.consents[3] && tcData.purpose.consents[4]
&& tcData.purpose.legitimateInterests[2] && tcData.purpose.legitimateInterests[7] && tcData.purpose.legitimateInterests[9] && tcData.purpose.legitimateInterests[10])) {

//consent signals sufficient for personalized ads
//set personalized ads and then run the GAM auction
googletag.cmd.push(function () {
googletag.pubads().setRequestNonPersonalizedAds(0);
googletag.pubads().refresh();
});
} else if((tcData.vendor.consents[755] || tcData.vendor.legitimateInterests[755])
&& (tcData.purpose.consents[1]
&& tcData.purpose.legitimateInterests[2] && tcData.purpose.legitimateInterests[7] && tcData.purpose.legitimateInterests[9] && tcData.purpose.legitimateInterests[10])) {

//consent signals NOT sufficient for personalized ads
//set non-personalized ads and then run the GAM auction
googletag.cmd.push(function () {
googletag.pubads().setRequestNonPersonalizedAds(1);
googletag.pubads().refresh();
});
}
}
}
});

Privacy and GDPR . Tips

About Abbey Colville

SEARCH

TOPICS

  • Ad Blocking
  • Ad Exchange (AdX)
  • Ad Optimisation
  • Ad Performance & Page Speed
  • Ad Publishing Landscape
  • AdSense
  • DoubleClick For Publishers (DFP)
  • Exchange Bidding
  • Google Ad Manager
  • Google Certified Publishing Partners
  • Header Bidding
  • Open Bidding
  • Privacy & GDPR
  • Program Policy
  • Traffic

Could the ads on your site be earning more?

Find out how OKO help publishers earn more from their ads.

LEARN MORE
Insticator

OKO Digital, The Cake Shed, Manor Farm, Manor Road, Hayling Island, Hampshire, PO11 0QW

Google Certified Publisher Partner Logo

OKO is a registered trademark and trading style of OKO Digital Limited. Registered in England company number 03867231. © OKO Digital Limited 1996-2018. All Rights Reserved.

  • Privacy Policy
  • Cookie Policy
Manage Cookie Consent
We use cookies to optimise our website and our service.
Functional Always active
The technical storage or access is strictly necessary for the legitimate purpose of enabling the use of a specific service explicitly requested by the subscriber or user, or for the sole purpose of carrying out the transmission of a communication over an electronic communications network.
Preferences
The technical storage or access is necessary for the legitimate purpose of storing preferences that are not requested by the subscriber or user.
Statistics
The technical storage or access that is used exclusively for statistical purposes. The technical storage or access that is used exclusively for anonymous statistical purposes. Without a subpoena, voluntary compliance on the part of your Internet Service Provider, or additional records from a third party, information stored or retrieved for this purpose alone cannot usually be used to identify you.
Marketing
The technical storage or access is required to create user profiles to send advertising, or to track the user on a website or across several websites for similar marketing purposes.
Manage options Manage services Manage vendors Read more about these purposes
View preferences
{title} {title} {title}