Glue Attributes Reference

This comprehensive reference covers all attributes captured and managed by DataGlue, including their storage locations, purposes, and practical usage examples.

Attribute Overview

DataGlue captures and manages visitor attributes using a consistent glue_ prefix for easy identification. All attributes are stored across multiple storage mechanisms for redundancy and accessibility.

Storage Strategy

localStorage
sessionStorage
Cookies

Persistent storage - Survives browser restarts

User identification data
Attribution history
First-visit information
Geolocation data

User Identification Attributes

`glue_user_id`

string

required

Unique identifier for each visitor using UUID v7 format

Storage: localStorage, cookies (365 days) Auto-generated: Yes, on first visit Example: 01234567-89ab-cdef-0123-456789abcdef

// Access user ID
const userId = window.glue.storage.get('glue_user_id');
console.log('Visitor ID:', userId);

`glue_user_firstseen`

string

required

ISO timestamp recording when the user first visited the site

Storage: localStorage Auto-generated: Yes, on first visit only Example: 2024-01-15T10:30:00.000Z

`glue_session_start`

string

required

ISO timestamp recording when the current session started

Storage: sessionStorage Auto-generated: Yes, updates on each page load Example: 2024-01-15T14:20:00.000Z

Attribution Tracking Attributes

DataGlue captures both initial and last-touch attribution for comprehensive tracking.

First vs Last Touch: DataGlue preserves both the first touchpoint (how they originally found you) and the last touchpoint (what brought them back) for accurate attribution.

UTM Parameters

`glue_initial_utm_source` / `glue_last_utm_source`

string

Tracks traffic source (google, facebook, newsletter, etc.)

Storage: localStorage, cookies (365 days) Examples: google, facebook, newsletter, linkedin

<!-- Form integration -->
<input type="hidden" glue="glue_initial_utm_source" name="first_touch_source" />
<input type="hidden" glue="glue_last_utm_source" name="last_touch_source" />

`glue_initial_utm_medium` / `glue_last_utm_medium`

string

Tracks marketing medium (cpc, email, social, etc.)

Storage: localStorage, cookies (365 days) Examples: cpc, email, social, organic

`glue_initial_utm_campaign` / `glue_last_utm_campaign`

string

Tracks campaign name

Storage: localStorage, cookies (365 days) Examples: summer_sale, product_launch, retargeting_q1

`glue_initial_utm_term` / `glue_last_utm_term`

string

Tracks search keywords or ad targeting

Storage: localStorage, cookies (365 days) Examples: data analytics, tracking software, crm integration

`glue_initial_utm_content` / `glue_last_utm_content`

string

Tracks content variation or A/B test version

Storage: localStorage, cookies (365 days) Examples: header_cta, sidebar_ad, banner_v2

`glue_initial_utm_id` / `glue_last_utm_id`

string

Unique campaign identifier for advanced tracking

Storage: localStorage, cookies (365 days) Examples: camp_12345, promo_summer_2024

Platform-Specific Attribution

Facebook Click ID

string

Facebook click identifier for ad attribution

Storage: localStorage, cookies (365 days) Example: IwAR0Kg4h2k3j5l6m7n8o9p0q1r2s3t4u5v6w7x8y9z

Google Click ID

string

Google Ads click identifier for conversion tracking

Storage: localStorage, cookies (365 days) Example: CjwKCAjw_b-WBhAb123Example

TikTok Tracking ID

string

TikTok tracking identifier for ad attribution

Storage: localStorage, cookies (365 days) Example: tt_abc123def456

Session Tracking Attributes

URL Tracking

Current URL
Previous URL
Landing Page
Referrer Domain

`glue_url_current`

string

Current page URL

Storage: sessionStorage Auto-generated: Yes, updates on each page load Example: https://example.com/product/details

`glue_url_last`

string

Previous page URL (referrer)

Storage: sessionStorage Auto-generated: Yes, if referrer exists Example: https://google.com/search?q=example

`glue_url_first`

string

First landing page URL on the domain

Storage: localStorage Auto-generated: Yes, stored only once Example: https://example.com/landing-page

`glue_user_referrer`

string

Domain of the referring site

Storage: localStorage Auto-generated: Yes, if referrer exists and not set Example: google.com, facebook.com, linkedin.com

Browser Information

`glue_user_browser`

object

Browser detection results in JSON format

Storage: sessionStorage Auto-generated: Yes Example:

{
  "browser": "Chrome",
  "version": "120",
  "os": "macOS",
  "device": "desktop"
}

Form Data Attributes

Personal Information

First Name
Last Name
Email
Mobile

`glue_fname`

string

First name from forms or URL parameters

Storage: localStorage, sessionStorage, cookies (30 days) Sources: URL params (?fname=John), form inputs, manual API calls

<input type="text" glue="glue_fname" placeholder="First Name" />

`glue_lname`

string

Last name from forms or URL parameters

Storage: localStorage, sessionStorage, cookies (30 days) Sources: URL params (?lname=Doe), form inputs, manual API calls

`glue_email`

string

Email address from forms or URL parameters

Storage: localStorage, sessionStorage, cookies (30 days) Sources: URL params (?email=john@example.com), form inputs, manual API calls

<input type="email" glue="email" placeholder="Email Address" />
<!-- Note: Can use 'email' or 'glue_email' as glue attribute -->

`glue_mobile`

string

Phone number from forms or URL parameters

Storage: localStorage, sessionStorage, cookies (30 days) Sources: URL params (?mobile=+1234567890), form inputs, manual API calls

<input type="tel" glue="mobile" placeholder="Phone Number" />

Special Parameters

Calendly Integration

string

Calendly meeting or scheduling parameter

Storage: localStorage, sessionStorage, cookies (30 days) Example: scheduled, completed, cancelled

<!-- Automatically captured from URL -->
<!-- example.com/?calendly=scheduled -->

Third-Party Integration Attributes

TikTok Attribution

DataGlue automatically captures TikTok attribution data from sessionStorage:

App Info
Session Index
Session ID

`glue_tt_appInfo`

string

TikTok application information

Source: TikTok sessionStorage (tt_appInfo) Storage: localStorage, sessionStorage, cookies (30 days)

`glue_tt_pixel_session_index`

string

TikTok pixel session tracking index

Source: TikTok sessionStorage (tt_pixel_session_index) Storage: localStorage, sessionStorage, cookies (30 days)

`glue_tt_sessionId`

string

TikTok session identifier

Source: TikTok sessionStorage (tt_sessionId) Storage: localStorage, sessionStorage, cookies (30 days)

Facebook Attribution

DataGlue automatically captures Facebook attribution data from cookies:

Browser Pixel
Click ID

`glue_fb_fbp`

string

Facebook browser pixel identifier

Source: Facebook cookie (_fbp) Storage: localStorage, sessionStorage, cookies (30 days) Example: fb.1.1640995200000.1234567890

`glue_fb_fbc`

string

Facebook click identifier

Source: Facebook cookie (_fbc) Storage: localStorage, sessionStorage, cookies (30 days) Example: fb.1.1640995200000.AbCdEf123456

Geolocation Attributes

`glue_user_geolocation`

string

IP-based geolocation data in formatted string

Storage: localStorage Source: geojs.io API (asynchronous) Format: {country_code} | {country} | {city} | {latitude}, {longitude} Example: US | United States | New York | 40.7128, -74.0060

Geolocation data is fetched asynchronously and may not be immediately available on the first page load.

// Check if geolocation data is available
const geoData = window.glue.storage.get('glue_user_geolocation');
if (geoData) {
    const [countryCode, country, city, coords] = geoData.split(' | ');
    console.log('User location:', { countryCode, country, city, coords });
}

Element Selectors & Form Integration

DataGlue uses sophisticated selector patterns to find and populate elements:

Selector Patterns

Direct Glue Prefix
Contains Pattern
Field Pattern
Glue Attribute
Data Attribute

<!-- Direct glue_ prefix in ID -->
<input id="glue_email" />
<input id="glue_fname" />
<input id="glue_user_id" />

<!-- Contains _glue_ pattern -->
<input id="contact_glue_email" />
<input class="_glue_fname" />
<input name="billing_glue_phone" />

<!-- Field pattern -->
<div class="field_email">Content</div>
<div class="field_glue_fname">
    <input /> <!-- Will be populated -->
</div>

<!-- Direct glue attribute -->
<input glue="email" />
<input glue="glue_fname" />
<div glue="utm_source">Content</div>

<!-- Data field reference -->
<div data-field-reference="email">
    <input /> <!-- Will be populated -->
</div>

Fillout Form Integration

For Fillout forms, DataGlue automatically adds data attributes:

<!-- Before DataGlue -->
<div data-fillout-id="abc123"></div>

<!-- After DataGlue processing -->
<div data-fillout-id="abc123"
     data-glue_user_id="01234567-89ab-cdef-0123-456789abcdef"
     data-glue_email="john@example.com"
     data-glue_fname="John"
     data-glue_initial_utm_source="linkedin"
     data-glue_last_utm_campaign="summer_sale"
     data-custom_param="newsletter_signup"
     data-utm_medium="cpc">
</div>

Valid Prefixes for Fillout

Glue Attributes
UTM Parameters
Query Parameters

All attributes starting with glue_ are automatically added:

data-glue_user_id
data-glue_email
data-glue_fname
etc.

All UTM parameters are added with data-utm_ prefix:

data-utm_source
data-utm_campaign
data-utm_medium
etc.

All URL query parameters are added as data attributes:

?custom_param=value → data-custom_param="value"
?lead_source=webinar → data-lead_source="webinar"

API Usage Examples

Reading Attributes

// Get specific attribute
const userEmail = window.glue.storage.get('glue_email');
const utmSource = window.glue.storage.get('glue_initial_utm_source');

// Check if attribute exists
if (userEmail) {
    console.log('User email:', userEmail);
}

// Get complete visitor context
const context = window.glue.getVisitorContext();
console.log('Complete context:', context);

// Get attribution data only
const attribution = window.glue.getAttribution();
console.log('Attribution:', attribution);

// Get all glue attributes
const allGlueData = Object.keys(localStorage)
    .filter(key => key.startsWith('glue_'))
    .reduce((acc, key) => {
        acc[key] = localStorage.getItem(key);
        return acc;
    }, {});

console.log('All DataGlue attributes:', allGlueData);

Setting Attributes

// Set with localStorage only
window.glue.storage.set('glue_custom_attr', 'value');

// Set with cookie expiration (30 days)
window.glue.storage.set('glue_user_tier', 'premium', 30);

// Manual attribution setting
window.glue.setAttribution({
    utm_source: 'manual_override',
    utm_campaign: 'special_promotion'
});

// Set multiple attributes
const userData = {
    'glue_company': 'Acme Corp',
    'glue_title': 'Marketing Manager',
    'glue_industry': 'Technology'
};

Object.entries(userData).forEach(([key, value]) => {
    window.glue.storage.set(key, value, 30);
});

Clearing Attributes

// Clear specific attribute
window.glue.storage.remove('glue_custom_attr');

// Clear all DataGlue storage
window.glue.storage.clear();

// Clear only UTM data
Object.keys(localStorage)
    .filter(key => key.includes('utm_'))
    .forEach(key => localStorage.removeItem(key));

Browser Compatibility

Storage APIs
Modern APIs

Feature	Chrome	Firefox	Safari	Edge	IE11
localStorage	✅	✅	✅	✅	✅
sessionStorage	✅	✅	✅	✅	✅
Cookies	✅	✅	✅	✅	✅

Feature	Chrome	Firefox	Safari	Edge	IE11
URL SearchParams	✅	✅	✅	✅	❌*
UUID v7	✅	✅	✅	✅	❌*
Geolocation API	✅	✅	✅	✅	✅
CSS.escape()	✅	✅	✅	✅	❌*

Best Practices

Naming Convention: Use descriptive names for custom attributes and maintain the glue_ prefix for consistency.

Data Privacy: Ensure compliance with privacy regulations when collecting personal information. DataGlue respects doNotTrack browser settings.

Recommended Patterns

Consistent Prefixing: Always use glue_ prefix for custom attributes
Descriptive Names: Use clear, meaningful names like glue_lead_source instead of glue_ls
Appropriate Expiration: Set reasonable cookie expiration times based on data sensitivity
Graceful Fallbacks: Always check if data exists before using it

Security Considerations

DataGlue automatically sanitizes stored values to prevent XSS
No sensitive data is stored without explicit configuration
All data is stored client-side unless explicitly sent to servers
Uses CSS.escape() to safely handle special characters in selectors

​Attribute Overview

​Storage Strategy

​User Identification Attributes

​glue_user_id

​glue_user_firstseen

​glue_session_start

​Attribution Tracking Attributes

​UTM Parameters

​glue_initial_utm_source / glue_last_utm_source

​glue_initial_utm_medium / glue_last_utm_medium

​glue_initial_utm_campaign / glue_last_utm_campaign

​glue_initial_utm_term / glue_last_utm_term

​glue_initial_utm_content / glue_last_utm_content

​glue_initial_utm_id / glue_last_utm_id

​Platform-Specific Attribution

​Facebook Click ID

​Google Click ID

​TikTok Tracking ID

​Session Tracking Attributes

​URL Tracking

​glue_url_current

​glue_url_last

​glue_url_first

​glue_user_referrer

​Browser Information

​glue_user_browser

​Form Data Attributes

​Personal Information

​glue_fname

​glue_lname

​glue_email

​glue_mobile

​Special Parameters

​Calendly Integration

​Third-Party Integration Attributes

​TikTok Attribution

​glue_tt_appInfo

​glue_tt_pixel_session_index

​glue_tt_sessionId

​Facebook Attribution

​glue_fb_fbp

​glue_fb_fbc

​Geolocation Attributes

​glue_user_geolocation

​Element Selectors & Form Integration

​Selector Patterns

​Fillout Form Integration

​Valid Prefixes for Fillout

​API Usage Examples

​Reading Attributes

​Setting Attributes

​Clearing Attributes

​Browser Compatibility

​Best Practices

​Recommended Patterns

​Security Considerations

Attribute Overview

Storage Strategy

User Identification Attributes

`glue_user_id`

`glue_user_firstseen`

`glue_session_start`

Attribution Tracking Attributes

UTM Parameters

`glue_initial_utm_source` / `glue_last_utm_source`

`glue_initial_utm_medium` / `glue_last_utm_medium`

`glue_initial_utm_campaign` / `glue_last_utm_campaign`

`glue_initial_utm_term` / `glue_last_utm_term`

`glue_initial_utm_content` / `glue_last_utm_content`

`glue_initial_utm_id` / `glue_last_utm_id`

Platform-Specific Attribution

Facebook Click ID

Google Click ID

TikTok Tracking ID

Session Tracking Attributes

URL Tracking

`glue_url_current`

`glue_url_last`

`glue_url_first`

`glue_user_referrer`

Browser Information

`glue_user_browser`

Form Data Attributes

Personal Information

`glue_fname`

`glue_lname`

`glue_email`

`glue_mobile`

Special Parameters

Calendly Integration

Third-Party Integration Attributes

TikTok Attribution

`glue_tt_appInfo`

`glue_tt_pixel_session_index`

`glue_tt_sessionId`

Facebook Attribution

`glue_fb_fbp`

`glue_fb_fbc`

Geolocation Attributes

`glue_user_geolocation`

Element Selectors & Form Integration

Selector Patterns

Fillout Form Integration

Valid Prefixes for Fillout

API Usage Examples

Reading Attributes

Setting Attributes

Clearing Attributes

Browser Compatibility

Best Practices

Recommended Patterns

Security Considerations