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

VARIABLES › GTM

𝐎𝐁𝐉𝐄𝐂𝐓 From Arrays Generator - Object CORE GTM

Direct (.tpl)

Maps two arrays or comma-separated strings into an object. Uses the keys array length as reference — missing values become undefined and extra values are ignored.

---

When to Use This

GTM Utilities

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

---

Examples

Pair keys and values▶ Try

INPUT

keys: ['name', 'age', 'city']
vals: ['John', 30, 'Paris']
Separator (optional): undefined
Output Function (optional): undefined

OUTPUT

John

Custom separator▶ Try

INPUT

keys: name|age|city
vals: John|30|Paris
Separator (optional): |
Output Function (optional): undefined

OUTPUT

John

---

GTM Configuration

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

𝐎𝐁𝐉𝐄𝐂𝐓 From Arrays Generator - Object

Read-Only Try Live

Keys (Property Names)

🔑 Array of property names or comma-separated string.

Accepted formats:
• Array: ['name', 'age', 'city']
• String: name,age,city
• Variable: {{Key Array Variable}}

Notes:
• Empty keys are skipped
• Duplicate keys: last value wins
• Special characters allowed: user.name, user-id

Examples:
• name,email,phone
• ['firstName', 'lastName', 'age']
• {{Form Field Names}}

Values

💾 Array of values or comma-separated string.

Accepted formats:
• Array: ['John', 30, 'Paris']
• String: John,30,Paris
• Variable: {{Value Array Variable}}

Notes:
• Values matched to keys by position
• Missing values → undefined
• Extra values → ignored

Examples:
• John Doe,john@example.com,555-1234
• ['Alice', 'alice@test.com', '555-5678']
• {{Form Field Values}}

Options

Separator (optional)

✂️ Character(s) used to split strings into arrays.

Only applies when keys or vals are strings (not arrays).

Default: , (comma)

Examples:
• , → Comma (default)
• | → Pipe
• ; → Semicolon
• ; → Semicolon with space
• → Tab character

💡 For arrays, this parameter is ignored.

Result Handling

Output Function (optional)

⚙️ Optional function to transform the final object before returning it.

Examples:
• obj => JSON.stringify(obj) → Convert to JSON string
• obj => Object.keys(obj).length → Count properties
• obj => ({...obj, timestamp: Date.now()}) → Add timestamp
• obj => Object.entries(obj) → Convert to array of pairs

Useful for post-processing or format conversion.

Keys (Property Names) string

💡 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]

Values string

🔗 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 → 𝐎𝐁𝐉𝐄𝐂𝐓 Smart Generator - Object → 𝐎𝐁𝐉𝐄𝐂𝐓 Transformer Generator (Advanced) - Object

---

Under the Hood

📜 View Implementation Code

/**
 * Maps two arrays into an object, using keys array length as reference.
 * If a value is missing, assigns undefined. Extra values are ignored.
 *
 * Direct-mode only
 * @param {Array|string} data.keys - Array of property names, or comma-separated string
 * @param {Array|string} data.vals - Array of values, or comma-separated string
 * @param {string} [data.sep] - Separator for string splitting (default: ',')
 * @param {Function} [data.out] - Optional function to transform the final object
 *
 * @returns {Object} Object with keys and corresponding values (undefined if missing)
 *
 * @framework ggLowCodeGTMKit
 */
const getType = require('getType');
const safeFunction = fn => typeof fn === 'function' ? fn : x => x;
const out = safeFunction(data.out);

const separator = data.sep || ',';

// Convert to arrays if strings
const keysInput = data.keys;
const valsInput = data.vals;

const arrKeys = getType(keysInput) === 'array'
    ? keysInput 
    : (typeof keysInput === 'string' ? keysInput.split(separator) : []);

const arrValues =  getType(valsInput) === 'array'
    ? valsInput 
    : (typeof valsInput === 'string' ? valsInput.split(separator) : []);

// Build object
const result = {};
for (let i = 0; i < arrKeys.length; i++) {
    const key = arrKeys[i];
    // Skip empty keys
    if (key !== '' && key != null) {
        result[key] = i < arrValues.length ? arrValues[i] : undefined;
    }
}

return out(result);

🧪 View Test Scenarios (10 tests)

✅ '[example] Pair keys and values'
✅ String input with default separator
✅ '[example] Custom separator'
✅ Missing values - assigns undefined
✅ Extra values - ignored
✅ Empty key is skipped
✅ Null key is skipped
✅ Mix of array and string
✅ Special characters in keys
✅ Empty values array