Integration with the IAB Transparency & Consent Framework

IAB Europe maintains the Transparency & Consent Framework (TCF) so you can send consent states to ads vendors, such as Google. Google’s integration with TCF allows you to use IAB TCF directly or work with a CMP that uses IAB TCF to pass consent signals to Google.

This article explains how to integrate with the TCF v2.2 in Campaign Manager 360, Search Ads 360, and Display & Video 360 for Floodlight as well as placement and tracking tags. Click trackers aren't covered by IAB TCF.

How it works

Campaign Manager 360, Search Ads 360, and Display & Video 360 can read and interpret the TCF Transparency and Consent (TC) string for conversion tracking tags. CMPs can create TCF strings based on user choices to send consent signals to Campaign Manager 360, Search Ads 360, or Display & Video 360.

Integration with TCF v2.2 means that Campaign Manager 360, Search Ads 360, and Display & Video 360 will have the ability to read the TC string. Your associated tags adjust their behavior based on the contents of the TC string.

Keep in mind the following:

• Google as a vendor accepts TC strings using the TCF v2.2. Google will continue accepting TCF v2.1 strings, but encourage CMPs to follow IAB guidance on implementation milestones as the industry moves over to TCF v2.2.
• Campaign Manager 360 and Search Ads 360 share the same set of Floodlight tags. User permissions received in Campaign Manager 360 are inherited by Search Ads 360. Learn more about how Floodlight tags are shared.

Set up the Transparency Consent Framework

Google can receive or send the TC string through the TCF JavaScript API or TCF macros.

TCF JavaScript API

The CMP stores the TC string in a JavaScript variable, which the Google Tag then accesses and retrieves user permission details.

TCF macros

The IAB TCF supports the use of macros in creative tags to:

• Indicate where in the URL the TC string should be inserted and sent onwards.
• Identify which vendors are present.

Advertisers who wish to integrate with the IAB TCF should work with their pixel vendors to ensure they properly support the following macros:

• gdpr_consent=${GDPR_CONSENT_xxxxx}: The macro to receive the consent parameter, where xxxxx is the global vendor list ID (GVL ID) of the vendor that is receiving the TC strings.
• gdpr=${GDPR}: The macro to receive the GDPR status, where 1 indicates that GDPR applies and 0 indicates that it does not. This macro enables TCF treatment and must be sent together with gdpr_consent=${GDPR_CONSENT_xxxxx}. If gdpr=1 but gdpr_consent=${GDPR_CONSENT_xxxxx} is unset or missing, an ad may not be served or measured.
• addtl_consent=${ADDTL_CONSENT}: The macro to support vendors that are not on the IAB GVL, but on Google's Ad Tech Provider controls, where ADDTL_CONSENT is a dot-separated list of user-consented Google Ad Tech Provider (ATP) IDs. Learn more about Google’s Additional Consent technical specification.

Pass TCF signals to vendors

The TCF signals may also be passed to other vendors that may be included in your creatives or event tags. These signals may control which creatives are eligible to serve based on permissions the user has provided for vendors who are present in the creative and the application of Google’s policies. The TC string also allows users to opt out of being served personalized ads and from being added to audience lists.

Each vendor receiving the TC string has a unique global vendor list ID. For third-party ad tags and tracking pixels, advertisers will need to manually add their vendors’ GVL ID along with the new macro to their tags if they choose to adopt TCF. Campaign Manager 360, Search Ads 360, and Display & Video 360 will then replace the macro with the TC string so the vendor complies with the user’s preference and continues to pass the TCF user permission details.

Note: Macros implemented within raw creative assets such as HTML5 files and rich media creatives are not supported. If advertisers use these formats and would like to pass the TC string into their third-party calls made from the creative, they should include their own JavaScript code to check for a CMP and access the TCF API themselves.

In Campaign Manager 360, vendor macros are supported for the following:

• Event tags
• Floodlight dynamic tags
• Creative redirects 
• Custom creatives
• Online behavioral advertising (OBA) links
• INS tags

In Display & Video 360, vendor macros are supported for all creative types and fields where macros are generally supported.

Tag integration

Campaign Manager 360, Search Ads 360, and Display & Video 360 tags will support the passing of user permissions for advertisers who have implemented an IAB TCF registered CMP on their site.

Floodlight tags

Campaign Manager 360, Search Ads 360, and Display & Video 360 all use Floodlight tags for measuring conversions. Depending on how the advertiser’s Floodlight tags are implemented, they will need to do the following if they choose to adopt TCF:

• Legacy Floodlight tags (not implemented using the Google tag): Advertisers should add the new macro to all existing Floodlight tags on their site. Alternatively, they can re-download the Floodlight tags which will automatically include the new macro.
• Floodlight tags (implemented using the Google tag or Google Tag Manager): Advertisers can expect these tags to integrate with the TCF API and should follow the instructions of their CMP to ensure their tags are integrated correctly.  Advertisers using the Google tag or Google Tag Manager can enable TCF support by adding the following line of JavaScript to the global header portion of the tag: window ['gtag_enable_tcf_support'] = true;

  Example

   <script>

      window ['gtag_enable_tcf_support'] = true;

    </script>

   

  <!-- Google tag (gtag.js) -->

    <script async src="https://googletagmanager.com/gtag/js?id=FL-CONFIG_ID"></script>

    <script>

      window.dataLayer = window.dataLayer || [];

      function gtag(){dataLayer.push(arguments);}

      gtag('js', new Date());

   

      gtag('config','FL-CONFIG_ID');

    </script>

Placement and tracking tags

Only Campaign Manager 360 and Display & Video 360 use placement and tracking tags.

For placement and tracking tags, the publisher’s CMP is responsible for sending the TCF user permission details.

• Display & Video 360: When a tag is executed (or, “fired”) on a publisher’s site, the CMP will first send the TCF user permission details to the ad exchange and then to Display & Video 360. Display & Video 360 then replaces the macro in the tag with the TC string while Campaign Manager 360 serves the creative on the publisher’s site.

• Campaign Manager 360: The CMP will pass the TCF user permission details directly to Campaign Manager 360 placement tags if the TCF macro is present or automatically through the TCF API.

Depending on the tag, advertisers will need to do the following if they choose to adopt TCF:

• Google tag (INS coming soon): No action is required, the TCF user permission details will be automatically passed from the CMP through the TCF API.
• All other tags: Advertisers seeking to adopt TCF may add the new macro to all existing tags on their site. Alternatively, they can re-download these tags which will automatically include the new macro. Customers can add the TCF to their existing INS tags using the following example as a guide:

  Example

  <ins class='dcmads'

   style='display:inline-block;width:300px;height:250px'

   data-dcm-placement='N7480.1664088DOUBLECLICK.NETTEST/B8299600.114131924'

   data-dcm-rendering-mode='script' 

  data-dcm-gdpr-applies=’gdpr=${GDPR}’

  data-dcm-gdpr-consent='gdpr_consent=${GDPR_CONSENT_755}'

  data-dcm-addtl-consent=’addtl_consent=${ADDTL_CONSENT}’

   

   data-dcm-click-tracker='${CLICK_URL}'>

   <script src='https://googletagservices.com/dcm/dcmads.js'></script>

  </ins>

Product behavior with the TCF

Purposes

The TCF organizes data processing using "Purposes", each of which has a corresponding legal basis of Consent or Legitimate Interest. Campaign Manager 360, Display & Video 360, and Search Ads 360 tags will handle requests that contain the consent string in the following ways (where relevant):

_{* Google is flexibly registered for TCF purposes 2, 7, 9, and 10 and defaults to legitimate interest. Unless a publisher configures their CMP to restrict Google to consent for these purposes, Google will rely on legitimate interest where the CMP has established it with the user. Google is not flexibly registered for purposes 1, 3, and 4 and always requires consent for these purposes.}

The remaining TCF purposes are not used by Campaign Manager 360, Display and Video 360, and Search Ads 360 tags, but may be used by other Google products.

Considerations

• Google interprets gdpr=1 as signaling that TCF applies to an event. When the gdpr= parameter is set to 1 and the gdpr_consent= parameter is present in a Campaign Manager 360 placement tag, gdpr_consent= must contain a valid TC string. If it does not, an ad may not be served or measured. 
• If the TC string indicates that Google does not have purpose 1 consent for the request, replace ad.doubleclick.net with pagead2.googlesyndication.com in your tags. This applies to standard tags, iframe/JavaScript tags (excluding INS tags), pre-fetch tags (including video), tracking ad tags, and click tracker tags. 
• Unlike the above, Invalid addtl_consent values currently do not prevent ad serving.
• Google's policies also apply to TCF macros embedded in creatives that link to other vendors. If these macros are invalid, the creative will not be served if Google believes the TCF applies (i.e. the impression is called with gdpr=1). In this case, other eligible creative or the default creative will be served.