Missing Data Layer Variables
Why It Matters
A GTM tag does not read the dataLayer directly. It reads variables that are bound to dataLayer paths through the User-Defined Variables panel. If a conversion tag references {{DLV - ecommerce.value}} but no variable with that name exists in the container (it was renamed, deleted, or the reference is misspelled), the tag has no defined source for the value and the conversion goes out without it. Google Ads still counts the conversion, but falls back to the default value set on the conversion action (Google's setup asks for "a default value to use when one isn't provided"), or records no value if there is none. Smart Bidding then optimises against a flat value, treating a $1,000 order like a $10 order. The damage adds up because the failure is silent: nothing in the tag firing or the Preview-mode summary surfaces "this variable resolved to empty." The user finds out months later when reported ROAS diverges from the e-commerce backend by an unexplainable factor.
How To Fix It
In GTM, open Workspace → Variables → User-Defined Variables.
For every field used by a conversion or analytics tag.
ecommerce.value,ecommerce.currency,ecommerce.transaction_id, and any user-data field. Create a Data Layer Variable with the matching Data Layer Variable Name (case-sensitive, dot-separated path).Set Data Layer Version to Version 2 for any nested ecommerce path.
Open each conversion tag and reference the variables via
{{DLV - …}}syntax instead of literal values.In Preview mode, complete a test conversion and inspect each variable in the Variables tab at the exact event step the tag fires on. Every variable should resolve to a non-empty value before publish.
Example
Variable: DLV - ecommerce.value
Data Layer Variable Name: ecommerce.value
Data Layer Version: Version 2
Used by: Google Ads purchase conversion valueGTM tags in this container that reference dataLayer fields without corresponding Data Layer Variables. Google's Tag Manager Data Layer Variable documentation, tags must read dataLayer values through explicitly-configured Data Layer Variables; unresolved references evaluate to empty strings at runtime. The effect is that conversion tags fire with no value, currency, or transaction ID, breaking value-based bidding and revenue reporting. Fix: create Data Layer Variables for every dataLayer path used by conversion tags and verify resolution in GTM Preview. Source: support.google.com/tagmanager/answer/6164391.
Drop this paragraph into your client deliverable. Sources back to the canonical platform documentation linked below.