Overview
A complete installation includes four steps:- Install Innkeepr.js – Add the tracking script to your site
- Track Conversions – Capture purchase events with revenue data
- Identify Users – Connect user emails for advanced audience features
- Connect Platforms – Link your ad accounts and analytics
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)- Open Google Tag Manager (or your preferred tag manager)
- Create a new Custom HTML tag
- Paste the Innkeepr.js snippet
- Set the trigger to All Pages
- Save and publish
<head> section of your website, before other scripts.
Verify Installation
Once installed, open your website and check the Event Debugger in the Innkeepr app:
- Navigate to Events
- You should see
pageevents 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 atrack call when a user completes a purchase or other conversion event:
javascript
Recommended Properties
Tag Manager Implementation
- Create a new Custom HTML tag in Google Tag Manager
- Add the track call with dynamic variables from your data layer:
html
- Set the trigger to fire on your purchase confirmation page or transaction event
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
Learn More
Step 3: Identify Users
Theidentify 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
Or:
Tag Manager Implementation
- Create a new Custom HTML tag in Google Tag Manager
- Add the identify call with variables from your data layer:
html
html
- Set the trigger to fire on purchase confirmation (same as your conversion tracking trigger)
javascript
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.
Learn More
Next Steps
Once your installation is validated, you’re ready to create your first signals:- Create an Objective – Define the business outcome your signals optimize for
- Create Signals – Build audience or conversion signals for that objective
Learn More