𝐎𝐁𝐉𝐄𝐂𝐓 Smart Generator - Object — GTM Variable Template for GTM

VARIABLES › GTM

𝐎𝐁𝐉𝐄𝐂𝐓 Smart Generator - Object CORE GTM

Direct (.tpl)

Generates an object with fixed and conditional properties based on conditions.

---

When to Use This

GTM Utilities

Access GTM-specific APIs: dataLayer, debug mode, container settings.

Type Conversion

Safely convert between data types — strings, numbers, booleans, arrays, objects.

---

Examples

Overwrite fixed properties▶ Try

INPUT

Source Object: {name: 'John', age: 30}
Source Properties Handling: false
Add fixed property (or from variable): true
ffp: [
Add conditional property (or from variable): false
Add Rule-Based Properties: false

OUTPUT

{name: 'John', age: 25, type: 'user'}

Conditional properties added▶ Try

INPUT

Source Object: {name: 'Product'}
Source Properties Handling: false
Add fixed property (or from variable): false
Add conditional property (or from variable): true
con: true
fcp: [
Add Rule-Based Properties: false

OUTPUT

{name: 'Product', category: 'checkout', tracked: true}

---

GTM Configuration

This is what you'll see when you open this variable in Google Tag Manager. Hover the icons for details.

𝐎𝐁𝐉𝐄𝐂𝐓 Smart Generator - Object

Read-Only Try Live

OBJECT ⬇

Source Object

💾 The source object to start from.

Use the checkboxes below to add additional properties.

Source Properties Handling

🔧 Choose whether to keep properties from the source object.

• Keep: Start with source object, add/overwrite with new properties
• Remove: Start with empty object, only include new properties added below

Keep source propertiesRemove source properties

Add fixed property (or from variable)

✓ Include properties that are always added to the object, regardless of conditions.

Add conditional property (or from variable)

✓ Include properties that are only added when a global condition is true.

Add Rule-Based Properties

✓ Include properties where each property has its own individual condition.

newProp

------------------------------------------------------- Add Fixed Property ⬇ --------------------------------------------------------

💾 Define properties with static values that will always be added to the resulting object.

Supported formats:
  ✓ Property name: Any valid object key
  ✓ Value: Static value or GTM variable

Property (Target Object)Value

⊖

⊖

Add Row

conProp

--------------------------------------------------- Add Conditional Property ⬇---------------------------------------------------

Condition

🔍 Enter a condition expression. If this evaluates to true, all properties below will be added to the object.

Example: {{Page Type}} === "checkout"

💾 Properties that will be added only if the global condition above evaluates to true.

All properties in this table share the same condition.

Value

⊖

⊖

Add Row

rulProp

-------------------------------------------------- Add Rule-Based Properties ⬇-------------------------------------------------

💾 Each property has its own condition. A property is added only if its specific condition evaluates to true.

Properties are evaluated independently - multiple properties can be added if their conditions are met.

Property (Target Object)ValueCondition

⊖

⊖

Add Row

Property Access

Setter Function (optional)

⚙️ Optional function to customize how values are assigned: (obj, key, value) => {...}

Default behavior: obj[key] = value (shallow assignment).

Use this for:
  • Deep path assignment (e.g., obj.user.name = value)
  • Validation before setting
  • Custom assignment logic

Result Handling

Output Function (optional)

⚙️ Optional function to transform the final object before returning it (e.g., obj => JSON.stringify(obj), obj => Object.freeze(obj)). Useful for chaining transformations on the output.

Source Object object

💡 Type any text to see the result update live

🎯 Using special value — click input to type instead

Test with:

Falsy undefined null "" empty 0 false NaN

Truthy true 42 "hello" {} empty [] empty {a:1} [1,2,3]

Add fixed property (or from variable)

Add conditional property (or from variable)

Add Rule-Based Properties

🔗 Result Handling — Chain Variables

Chain apply-mode variables to the output. Each variable receives the result of the previous one.

getType()

+ Chain another variable

---

Related Variables

Same category: GTM

→ document.title → estimateReadingTime → gaEcommerceEventList → gaLeadGenerationEventList → getCookieValue → getDataLayerByEvent → getDataLayerCurrent → getDataLayerValue → getGaMeasurementIds → getLocalStorage → getRootDomain! → gtmIsDebugMode → gtmIsPreviewMode → hasLocalStorageKey → isGrantedAdPersonalization → isGrantedAdStorage → isGrantedAdUserData → isGrantedAnalyticsStorage → isGrantedFunctionalityStorage → isGrantedPersonalizationStorage → isGrantedSecurityStorage → 𝐀𝐑𝐑𝐀𝐘 From Indexed Values Generator - Array → 𝐀𝐑𝐑𝐀𝐘 From Values Generator - Array → 𝐂𝐎𝐌𝐌𝐀𝐍𝐃 𝐓𝐀𝐁𝐋𝐄 Lazy Generator (Advanced) - Object → 𝐎𝐁𝐉𝐄𝐂𝐓 From Arrays Generator - Object → 𝐎𝐁𝐉𝐄𝐂𝐓 Transformer Generator (Advanced) - Object

---

Under the Hood

📜 View Implementation Code

/**
 * Transforms an object by adding fixed values, conditional properties, and rule-based properties.
 * 
 * @param {Object} data.src - Source object to transform.
 * @param {boolean} data.rul - Whether to preserve existing properties (true = don't overwrite, false = allow overwrite).
 * @param {boolean} data.afp - Whether to include fixed properties.
 * @param {Array<{key: string, val: any}>} data.ffp - Fixed properties to add.
 * @param {boolean} data.acp - Whether to include conditional properties.
 * @param {boolean} data.con - Global condition result.
 * @param {Array<{key: string, val: any}>} data.fcp - Conditional properties (added if condition is true).
 * @param {boolean} data.arb - Whether to include rule-based properties.
 * @param {Array<{key: string, val: any, con: boolean}>} data.rbp - Rule-based properties (each added if its condition is true).
 * @param {Function} [data.set] - Optional custom setter (defaults to shallow assignment).
 * @param {Function|string} [data.out] - Optional output handler.
 * 
 * @returns {Object} Transformed object.
 *
 * @framework ggLowCodeGTMKit
 */
const getType = require('getType');
const sourceObj = getType(data.src) === 'object' && data.src || {};
const overwrite = !data.rul; 

const setShallow = (obj, key, value, allowOverwrite) => {
    if (allowOverwrite || !obj.hasOwnProperty(key)) {
        obj[key] = value;
    }
};
const setter = typeof data.set === 'function' ? data.set : setShallow;

const assignFromPairs = (targetObj, keyValuePairs, setterFn, allowOverwrite) => {
    keyValuePairs.forEach(pair => {
        setterFn(targetObj, pair.key, pair.val, allowOverwrite);
    });
    return targetObj;
};

const fromFixed = data.afp ? (data.ffp || []) : [];
const fromCondition = data.acp && data.con ? (data.fcp || []) : [];
const fromRules = data.arb ? (data.rbp || []).filter(item => item.con) : [];
const finalPairs = fromFixed.concat(fromCondition, fromRules);

const result = assignFromPairs(sourceObj, finalPairs, setter, overwrite);

const safeFunction = fn => typeof fn === 'function' ? fn : x => x;
const out = safeFunction(data.out);

return out(result);

🧪 View Test Scenarios (9 tests)

✅ '[example] Overwrite fixed properties'
✅ Fixed properties with keep source - should not overwrite existing properties
✅ '[example] Conditional properties added'
✅ Conditional properties with false condition - should not add conditional properties
✅ Rule-based properties with mixed conditions - should only add where condition is true
✅ Combination of all property types with overwrite - should merge all applicable properties
✅ Empty source object - should only contain added properties
✅ No properties added - should return source object unchanged
✅ Custom setter function - should use custom logic for assignment