Skip to main content
This guide walks you through the complete Innkeepr setup. Follow these steps to enable audience signals and conversion signals for your engagement stack.

Overview

A complete installation includes four steps:
  1. Install Innkeepr.js – Add the tracking script to your site
  2. Track Conversions – Capture purchase events with revenue data
  3. Identify Users – Connect user emails for advanced audience features
  4. Connect Platforms – Link your ad accounts and analytics
Timeline: Most installations are completed within 60 minutes.

Step 1: Install Innkeepr.js

Innkeepr.js automatically captures page views and provides methods for tracking conversions and identifying users. Set up a JavaScript connection under Connections in the Innkeepr app to get your tracking snippet. Install via Tag Manager (Recommended)
  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. Save and publish
Install Directly (Alternative) Paste the snippet into the <head> section of your website, before other scripts. Verify Installation Once installed, open your website and check the Event Debugger in the Innkeepr app:
  1. Navigate to Events
  2. You should see page events appearing in real-time

Step 2: Track Conversions

Conversion tracking is essential for enabling audience and conversion signals. The track method captures key user actions along with their properties. Basic Conversion Tracking Fire a track call when a user completes a purchase or other conversion event:
javascript
Required Properties Recommended Properties Tag Manager Implementation
  1. Create a new Custom HTML tag in Google Tag Manager
  2. Add the track call with dynamic variables from your data layer:
html
  1. Set the trigger to fire on your purchase confirmation page or transaction event
Important: The revenue property is required for Conversion Signals. Without it, incrementality-weighted conversion values cannot be calculated. Additional Events Track other meaningful user actions to improve audience quality:
javascript
Note: Some connections (e.g., Shopify) automatically implement track calls for standard e-commerce events. Check the Connections Catalog before implementing manually.

Step 3: Identify Users

The identify method connects user actions to known identities. This enables Value-Based Audiences on Meta and improves cross-device tracking. Basic User Identification Fire an identify call when a user completes a purchase or logs in:
javascript
Required Traits for Value-Based Audiences Or: Tag Manager Implementation
  1. Create a new Custom HTML tag in Google Tag Manager
  2. Add the identify call with variables from your data layer:
html
Or with hashed email:
html
  1. Set the trigger to fire on purchase confirmation (same as your conversion tracking trigger)
Additional Traits Include additional traits to enrich user profiles:
javascript
Important: The email or email_sha256 trait is required for Value-Based Audiences on Meta and Custom Audiences on TikTok. Without it, audience matching relies solely on pixel-based identification.
Learn More

Step 4: Connect Platforms

Connect your advertising platforms and analytics to enable audience syncing and conversion signals. Required Connections Navigate to Connections > Add Connection and connect the following: Each platform has its own connection setup (authentication, account selection, tracking parameters) — follow the connection-specific guide for the exact steps. Note: Connect all ad accounts where you plan to use Innkeepr audiences or conversion signals.

Next Steps

Once your installation is validated, you’re ready to create your first signals:
  1. Create an Objective – Define the business outcome your signals optimize for
  2. Create Signals – Build audience or conversion signals for that objective
Learn More