Floodlight (gtag.js) Tag Setup Guide | Client-Side Tags

Tag tips

Activate the conversion API before beginning. For more information, see Google: Create a Google tag for a new Floodlight conversion action.
Supports the ecommerce extension for:
- Order ID (_corder)
- Order Total (_ctotal)
- List of Product IDs (_cprod)
- List of Quantities (_cquan)
- List of Prices (_cprice)
Use mappings to:
- Set up event triggers
- Dynamically override standard config values
- Dynamically override ecommerce extension values
Pass custom event parameters by mapping to “DoubleClick Custom Parameters” and replacing myvar with your custom variable name.
If you do not need a Session ID while using a list, set SessionID to an empty space or empty string.
For additional information, see the Google: Floodlight documentation.

Tag configuration

Navigate to the Tag Marketplace to add a new tag. Read the Tag Overview article for general instructions on how to add a tag.

When adding the tag, configure the following settings:

Advertiser ID
- A single or comma separated list of advertiser identifiers that are the source of the Floodlight activity, or example, DC-123456789.
Group Tag String
- A single or comma-separated list of group tag strings.
- Must match the number of Advertiser IDs.
Activity Tag String
- A single or comma-separated list of activity tag strings.
- Must match the number of Advertiser IDs.
Counting Method
- A single or comma-separated list of counting methods.
- Must match the number of Advertiser IDs.
Auto Fire Purchase Event
- Fires purchase event when an Order ID is present.
- If counting method is not set it will be set to transactions.
Allow Custom Scripts
- Enables Dynamic tags to integrate third-party tools for tracking website activity.
Global Object
- This value is the name of the Global Object used for the event queue.
- If not specified, gtag is used.
- Not required for most implementations.
Data Layer Name
- By default, the data layer initiated and referenced by the global site tag is named dataLayer.
- Rename the data layer only if your project requires a separate name.
Cross-Tracking Domains
- A comma-separated list of domains to use with Cross-Domain Tracking (setAllowLinker).
- This value should be the top-level domain, for example, tealiumiq.com.

Data mappings

Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For instructions on how to map a variable to a tag destination, see data mappings.

The available categories are:

Standard

Setting	Description
Advertiser ID `advertiser_id`	Required String/Array One or more Advertiser IDs separated by commas. For example, `DC-12345678` Data will be sent to all IDs. Case-sensitive
Group Tag String `activity_group`	Required String/Array One or more group tag strings separated by commas. Must match the length of Advertiser ID. Case-sensitive
Activity Tag String `activity`	Required String/Array One or more activity tag strings separated by commas. Must match the length of Advertiser ID. Case-sensitive
Counting Method `counting_method`	Required String/Array One or more counting method names separated by commas. Must match the length of Advertiser ID. Converts to lowercase.
Session ID `session_id`	String/Array Map none, one, or a set of values matching the length of Advertiser ID. Place blanks where not needed.
Event Name `event_name`	The name of the current event.
Auto Fire Purchase Event `fire_purchase`	Values are `True` or `False`. Fires purchase event when an Order ID is present. If counting method is not set, it will be set to transactions.
Allow Custom Scripts `custom_scripts`	Values are `True` or `False`. The default value is `True`. Enables Dynamic tags to integrate third-party tools for tracking website activity. Use to override the configuration value<./li>
Cross-Tracking Domains `cross_track_domains`	A comma-separated list of domains to use with Cross-Domain Tracking.
Match ID `dc_custom_params.match_id`	A unique advertiser-created identifier (passed via Floodlight) that you can sync with Google to attribute offline conversions. This value is case sensitive, limited to 100 characters, and contains only letters (`a-z` or `A-Z`), numbers (`0-9`), underscores (`_`), hyphens (`-`), and periods (`.`).
Ordinal `dc_custom_params.ord`	A unique random number that acts as a cachebuster to prevent the browser from loading ad images and clickthrough URLs from cache. When you use the SA360 Enhanced Conversion connector in conjunction with the Floodlight tag, we recommend that you map `tealium_random` for non-purchase conversions.

Events

Map to these destinations for triggering specific events on a page.

Use the following steps to trigger an event:

Select the tealium_event variable.
Click + Add Mapping.
In the left sidebar, click Event.
In the Trigger field, enter the value of the variable being mapped.
Select Conversion or Purchase from the drop-down list.
Click + Add.
- To map additional variables, repeat Steps 4, 5, and 6.
Click Done.

The event triggers when the supplied value is found in the data layer.

Destination Name	Description
conversion `conversion`	Map to trigger sending a conversion type event. Conversion events are not sent by default. Use the `standard`, `unique` or `per_session` counting method for this event.
purchase `purchase`	Map to trigger sending a purchase type event. Purchase events are sent automatically when an order ID is present. Use the `transactions` or `items_sold` counting method with this event.

E-Commerce

As the Floodlight (gtag.js) tag is e-commerce enabled, it will automatically use the default E-Commerce extension mappings. Manually mapping in this category is generally not needed unless you want to override any extension mappings to your desired e-commerce variable is not offered in the extension.

Destination Name	Description
Order ID `order_id`	Overrides `_corder`.
Order Total `order_total`	Overrides `_ctotal`.
List of IDs `product_id`	Array Overrides `_cprod`.
List of Quantities `product_quantity`	Array Overrides `_cquan`. Accepts a single number override or an array of values.
List of Prices `product_unit_price`	Array Overrides `_cprice`.

Custom

Destination Name	Description
DoubleClick Custom Parameters `dc_custom_params.myvar`	Use to send custom parameters as part of the `dc_custom_params` object. Replace `myvar` with the name of your parameter.
Custom Variable 1 `custom.u1`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u1`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 2 `custom.u2`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u2`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 3 `custom.u3`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u3`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 4 `custom.u4`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u4`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 5 `custom.u5`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u5`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 6 `custom.u6`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u6`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 7 `custom.u7`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u7`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 8 `custom.u8`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u8`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 9 `custom.u9`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u9`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 10 `custom.u10`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u10`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 11 `custom.u11`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u11`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 12 `custom.u12`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u12`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 13 `custom.u13`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u13`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 14 `custom.u14`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u14`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 15 `custom.u15`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u15`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 16 `custom.u16`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u16`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 17 `custom.u17`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u17`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 18 `custom.u18`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u18`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 19 `custom.u19`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u19`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 20 `custom.u20`	Use this custom parameter to add custom metrics and dimensions. Associate with the custom Floodlight variable `u20`. Defaults to dimension or metric name if not provided in mapping.
Custom Variable 21+ `custom.u#`	Use this custom parameter to add custom metrics and dimensions beyond 20 (not supported in Floodlight Search). Associate with the custom Floodlight variable `u#`. Replace the `#` sign in mapping with the desired number.

Variable	Description
Enable TCF Support `tag_enable_tcf_support`	Values are `true` or `false`.

Enhanced Conversions

Variable	Type	Description
`user_data.email`	String	Email Address
`user_data.phone_number`	String	Phone Number
`user_data.address.first_name`	String	First Name
`user_data.address.last_name`	String	Last Name
`user_data.address.street`	String	Street Address
`user_data.address.city`	String	City
`user_data.address.region`	String	Region
`user_data.address.postal_code`	String	Postal Code
`user_data.address.country`	String	Country