A Basic Installation

​

Overview

1. Subdomain Setup – Enable first-party tracking for better data coverage
2. Install Innkeepr.js – Add the tracking script to your site
3. Track Conversions – Capture purchase events with revenue data
4. Identify Users – Connect user emails for advanced audience features
5. Connect Platforms – Link your ad accounts and analytics

​

Step 1: Subdomain Setup (Recommended)

1. Access your domain’s DNS settings (typically in your hosting provider or domain registrar)
2. Create a new CNAME record:
   • Subdomain: innkeepr (or your preferred name)
   • Target: cdn.innkeepr.ai
3. Save the DNS record and wait for propagation (usually 5-30 minutes)

​

Step 2: Install Innkeepr.js

1. Navigate to Sources in the Innkeepr app
2. Click Add Source
3. Select JavaScript from the source catalog
4. Enter your Innkeepr URI
5. Copy the tracking snippet

1. Open Google Tag Manager (or your preferred tag manager)
2. Create a new Custom HTML tag
3. Paste the Innkeepr.js snippet
4. Set the trigger to All Pages
5. If you configured a custom subdomain in Step 1, update the script URL to use your subdomain
6. Save and publish

1. Navigate to Events
2. You should see page events appearing in real-time

​

Step 3: Track Conversions

Innkeepr.track('Order Completed', {
  revenue: 99.95,
  order_id: 'ORD-12345',
  currency: 'EUR'
});

1. Create a new Custom HTML tag in Google Tag Manager
2. Add the track call with dynamic variables from your data layer:

Innkeepr.track('Order Completed', {
  revenue: {{DL - Order Total}},
  order_id: {{DL - Order ID}},
  currency: {{DL - Currency}}
});

3. Set the trigger to fire on your purchase confirmation page or transaction event

// Product viewed
Innkeepr.track('Product Viewed', {
  product_id: 'SKU-789',
  category: 'Shoes',
  price: 129.00
});

// Added to cart
Innkeepr.track('Product Added', {
  product_id: 'SKU-789',
  quantity: 1,
  price: 129.00
});

​

Step 4: Identify Users

Innkeepr.identify('user_12345', {
  email: 'customer@example.com'
});

1. Create a new Custom HTML tag in Google Tag Manager
2. Add the identify call with variables from your data layer:

Innkeepr.identify('user_12345', {
  email: 'customer@example.com'
});

Innkeepr.identify({{DL - User ID}}, {
  email_sha256: {{DL - Customer Email SHA256}}
});

3. Set the trigger to fire on purchase confirmation (same as your conversion tracking trigger)

Innkeepr.identify('user_12345', {
  email: 'customer@example.com',
  name: 'Maria Schmidt',
  created_at: '2024-01-15',
  lifetime_value: 450.00,
  customer_type: 'returning'
});

​

Step 5: Connect Platforms

1. Select Google Analytics 4 from the source catalog
2. Authenticate with your Google account
3. Select the GA4 property for your website
4. Grant the required permissions

1. Select Google Ads from the source catalog
2. Authenticate with your Google account
3. Select the ad account(s) you want to connect
4. Grant the required permissions
5. Enter your Dynamic URL Parameter that carries the Google Campaign ID (e.g., google_campaign_id={campaignid})

1. Select Facebook Ads from the source catalog
2. Authenticate with your Facebook account 3.Select the ad account and pixel you want to connect
3. Grant the required permissions
4. Enter your Dynamic URL Parameter that carries the Meta Ad ID (e.g., meta_ad_id={{ad.id}})

​

Validation Checklist

• page events are flowing (from Innkeepr.js)
• Checkout Completed (or your conversion event) appears with revenue property
• identify calls appear with email or email_sha256 trait

• Innkeepr.js shows as Active
• Google Analytics 4 shows as Active
• Google Ads shows as Active
• Meta Ads shows as Active

• Verify the Innkeepr.js snippet is installed correctly
• Check browser console for JavaScript errors
• Confirm the tag fires on the correct pages/triggers

• Verify your data layer contains the order value
• Check that the variable mapping in Tag Manager is correct

• Verify your data layer contains the customer email
• Check privacy/consent settings aren’t blocking the data

​

Next Steps

1. Create an Audience – Build seed, retargeting, or exclusion audiences
2. Enable Conversion Signals – Stream incrementality-weighted conversions to your ad platforms
3. Set Up Platform-Specific Configurations – Follow the detailed guides for Meta and Google