Overview
With recent changes across the web that affect conversion measurement, it’s important to make sure that your conversion tag implementation supports accurate counting on your site. Site-wide tagging - tagging that’s applied to every page of your site - is the best option to ensure accurate measurement of the performance of your online advertising.
We’re recommending that all customers move to site-wide tags. Display & Video 360 and Campaign Manager 360 customers that use these measurement solutions will see improvements in measurement coverage over the next few months.
There are two main options for measurement via site-wide tags:
Option 1: Install the Google tag (gtag.js) on your entire site
The Google tag is a site-wide web tagging library that works across Google’s site and conversion measurement products, including Google Ads, Google Analytics, Campaign Manager 360, Display & Video 360, and Search Ads 360. A Google tag is made up of two snippets of JavaScript: a global snippet and an event snippet. The global snippet is placed on all pages of your site, and the event snippet is placed on pages with events you’re tracking. A website administrator will need to pass values into certain fields in the Google tag.
Option 2: Use Google Tag Manager
Google Tag Manager is a tag management system that allows you to quickly and easily update tags and code snippets on your site.
Search Ads 360 customers can learn more about migrating to the Google tag here.
See the section below to learn more about our recommendations for how you should use these solutions based on your site’s current tag implementation.
Guidance for migrating based on your current implementation
Based on how you currently manage conversion tags, there are different options for you to implement site-wide measurement solutions. If you fall into multiple categories, you may need to use different tagging solutions for each one.
I use iframe or image tags directly on my site for desktop and mobile web
If you currently use iframe or image tags directly on your site for desktop and mobile web, we recommend retagging your website with the Google tag based on the instructions below. You can generate Google tags from Campaign Manager 360 or Display & Video 360 directly or via the Campaign Manager 360 API.
If you’re looking for a tag management solution, you can also use Google Tag Manager.
I currently use Google Tag Manager
I currently use the Google tag
If you already have a Google tag on your site that you set up for another Google product, you’ll need to:
- Update the global snippet section of the tag to include Google Marketing Platform account identifiers; and
- Follow the instructions below to replace your iframe or image tags with the event snippet section of the Google tag.
I use a third-party tag provider
I use Floodlight tags in a mobile app
I use Floodlight tags on Accelerated Mobile Pages (AMP)
Retag from iframe or image tags to the Google tag
Step 1: Identify where you have iframe or image tags on your site (Trafficker and website administrator)
The first step in retagging is to identify the pages on your site where you currently have iframe or image tags. If you need a starting point to identify these tags, you can run a basic Floodlight report:
- In Report Builder, select New Report > Floodlight > Basic.
- Name the report, and the report file that will be generated.
- Update the Date range to a single day and select a single Floodlight configuration so that the report can process easily.
- If you have a high Floodlight impression volume, we recommend that you also limit to a subset of Floodlight activities.
- Add the Conversion Referrer dimension.
- Run the report.
This report may not include every page that has a Floodlight tag, so work with your website administrator to do a comprehensive sweep of your site.
Step 2: Get Google tags for your Floodlight activities (Trafficker)
If you create Floodlight tags from Campaign Manager 360, you have a few options for updating the tag format for existing activities:
- Update a single activity:
- From an existing Floodlight activity, update the Tag format dropdown in the Identification section. Save your Floodlight activity.
- Update activities in bulk:
- From the Floodlight > Activities tab of an advertiser, select the activities you’d like to update. From the Tag format dropdown at the top of the page, select the new format you’d like to use.
If you use the Campaign Manager 360 API to generate tags, follow these steps:
- Set the
floodlightTagTypefield of theFloodlightActivityresource toGLOBAL_SITE_TAG. - Call the
generatetagmethod, which will return the response below. ThefloodlightActivityTagcontains the event snippet and theglobalSiteTagGlobalSnippetcontains the global snippet.
{
"kind": "dfareporting#floodlightActivitiesGenerateTagResponse",
"floodlightActivityTag": string,
"globalSiteTagGlobalSnippet": string
} Once you’ve generated your Google tags, send them to your website administrator to implement.
Step 3: Remove existing tags from your site and add the Google tag (website administrator)
We recommend removing existing tags and adding the Google tag at the same time to prevent losing conversion data.
At a high level, you'll:
- Add the global snippet to every page of your site.
- Remove iframe and image tags from the pages you've identified that have these tags.
- Add event snippets to pages with events you’re tracking. These should be the same pages that had iframe or image tags.
When you're removing existing tags, make sure that you remove the entire tag, including any comments, the <script> section, the <noscript> section, and any cache busters or other related code. Here’s an example of a complete tag to remove:
<!--
Start of DoubleClick Floodlight Tag: Please do not remove
Activity name of this tag: Name
URL of the webpage where the tag is expected to be placed: http://www.foo.com
This tag must be placed between the <body> and </body> tags, as close as possible to the opening tag.
Creation Date: 10/30/2017
-->
<script type="text/javascript">
var axel = Math.random() + "";
var a = axel * 10000000000000;
document.write('<img src="http://ad.doubleclick.net/ddm/activity/src=[floodlightConfigID];type=[activityGroupTagString];cat=[activityTagString];ord=' + a + '?" width="1" height="1" alt=""/>');
</script>
<noscript>
<img src="http://ad.doubleclick.net/ddm/activity/src=[floodlightConfigID];type=[activityGroupTagString];cat=[activityTagString];ord=1?" width="1" height="1" alt=""/>
</noscript>
<!-- End of DoubleClick Floodlight Tag: Please do not remove -->Step 4: Run a basic Floodlight report to check that your tags are set up correctly (Trafficker)
You’ll want to verify that your tags are correctly receiving impression volumes that you expect for your site. We recommend waiting at least 24 hours after you’ve implemented your tags to run this report. You can run a Floodlight impression report to check this:
- From Report Builder, select New Report > Floodlight > Floodlight impressions.
- Name the report, and the report file that will be generated.
- Choose a Date range containing visits to the page where Floodlight is implemented.
- Remove any campaign-specific dimensions.
- Choose a Floodlight ID and Floodlight Activity to verify.
- Run the report.
Step 5: Troubleshoot any issues with your tag implementation (Trafficker and website administrator)
If you run into any issues with your new tag implementation, there are several troubleshooting tools you can use:
- View Floodlight implementation alerts: Floodlight implementation alerts let you know if Campaign Manager 360 has detected one or more issues with a Floodlight tag implementation that could result in incorrect conversion reporting. Learn more
- Download Google Tag Assistant: This free Chrome extension runs diagnostics on your tags. Learn more
- Debug with Chrome Developer Tools: Use DevTools to analyze your Google tags. Learn more
Mapping iframe and image parameters with Google tag parameters
As you’re migrating from iframe or image tags to the Google tag, you’ll notice a difference in the parameters available in the Google tag. Here’s a mapping of iframe and image parameters to Google tag parameters to help you work with the new tag format. See this article for detailed information about passing data to parameters in the Google tag.
| Iframe / image tag parameter | Google tag parameters | Tag type and counting method |
|---|---|---|
src= |
Part of send_to |
All |
type= |
Part of send_to |
All |
cat= |
Part of send_to |
All |
u1=, u2=, etc. |
u1, u2, etc. |
All |
qty= |
quantity |
Sales - items sold |
cost= |
value |
Sales |
ord= |
See section below on cache busting. | All |
num= |
See section below on cache busting. | Counter - unique |
dc_lat= |
'dc_custom_params':{'dc_lat'} |
All |
dc_rdid= |
Not applicable since the Google tag isn’t available for apps. | All |
tag_for_child_directed_treatment |
'dc_custom_params':{'tag_for_child_directed_treatment'} |
All |
Cache busting in the Google tag
The Google tag handles cache busting automatically for you, so you don’t need to use the ord= or num= parameters with this tag. Even though you don’t need to populate cache busters, you’ll continue to see the same data available in reporting and attribution. Here’s more information about how cache busting was handled previously and how it works in the Google tag:
Counter tags
| Counting method | Iframe and image behavior | Google tag behavior | Data available in reporting / attribution |
|---|---|---|---|
| Standard | ord= was required to contain a random number to act as a cache buster. |
Cache busting is handled by the tag based on the counting method. You won’t see a field specific to cache busting that you need to populate in the tag. | You’ll continue to see a random number. |
| Unique | ord= was required to be set to 1. num= was required to contain a random number to act as a cache buster. |
Cache busting is handled by the tag based on the counting method. You won’t see a field specific to cache busting that you need to populate in the tag. | You’ll continue to see a value of 1. |
| Per session | Cache busting was not required because the tag fired once per session. ord= was the session ID. |
Use the session_id field. |
You’ll continue to see unique session IDs. |
Sales tags
| Counting method | Iframe and image behavior | Google tag behavior | Data available in reporting / attribution |
|---|---|---|---|
| Transactions | Cache busting was not required because the tag fired once per order. ord= was the order ID. |
Use the transaction_id field. |
You’ll continue to see unique transaction IDs. |
| Items sold | Cache busting was not required because the tag fired once per order. ord= was the order ID. |
Use the transaction_id field. |
You’ll continue to see unique transaction IDs. |