Setup & Documentation

◈ Overview

Auraflow is a behavioural intelligence layer for e-commerce stores. It passively observes how visitors interact with your store, classifies each visitor into a buyer archetype, predicts purchase intent, and syncs that intelligence into the tools your team already uses — HubSpot, Klaviyo, Meta, and more.

What Auraflow does not do: It does not store personally identifiable information without consent, does not modify your storefront visually, and does not interfere with checkout. The tracker is a lightweight read-only observer.

Core concepts

Visitor — an anonymised session identity, built from non-invasive browser signals. No cookies required.
Archetype — a classification of buying behaviour: Impulse Buyer, Price Checker, Researcher, Comparison Shopper, or Hesitant Abandoner.
Intelligence — the combined readiness score, CLV estimate, top-interest product, and suggested playbook for each visitor.
Segment — a live audience built from archetype, intent, behaviour, and product rules. Syncs to Klaviyo and HubSpot in real time.
Flow — a triggered action sequence (email, webhook, tag) executed when a visitor matches a condition.

▶ Quick Start

You can have Auraflow collecting data in under five minutes.

Create your account at auraflow.ai/login — sign in with Google or email.
Install the tracker on your store — Shopify app install or manual script tag. See Install the Tracker below.
Verify data is flowing — visit your store in a new tab, then check the Auraflow dashboard. You should see a new visitor appear within 30 seconds.
Connect your first integration — go to Settings and connect HubSpot or Klaviyo. Visitor archetypes and segments will begin syncing immediately.
Build a segment — in the Act tab, create a segment for High Intent visitors and sync it to your Klaviyo list or HubSpot list to start your first targeted campaign.

✓ Auraflow begins classifying visitors as soon as the tracker fires. You don't need to configure anything before data starts collecting — connect integrations and build segments at your own pace.

■ Install the Tracker

The Auraflow tracker is a small JavaScript snippet that captures behavioural signals — scroll depth, hover patterns, session timing, product attention, and more. It runs entirely client-side and sends compressed signal batches to Auraflow servers at a configurable interval.

Option A — Shopify (recommended)

If your store runs on Shopify, install via the Shopify App Store. The app handles script injection automatically across all themes and respects Shopify's consent API.

Search for Auraflow in the Shopify App Store and click Install.
Approve the requested permissions. Auraflow requires read access to products and orders to match product attention data.
The tracker script is injected automatically. No theme edits required.
Your Auraflow dashboard will link to your Shopify store domain automatically.

Option B — Manual script tag

For headless storefronts, custom platforms, or any site where you control the HTML, paste the following snippet before the closing </body> tag. Replace YOUR_SHOP_DOMAIN with your store's domain.

<script
  src="https://cdn.auraflow.ai/tracker/v1/af-tracker.min.js"
  data-shop="YOUR_SHOP_DOMAIN"
  async>
</script>

ⓘ The tracker is loaded asynchronously and will not block page rendering. Average script weight is under 14 KB gzipped. Signal batches are sent every 30 seconds by default — this interval is configurable in Settings.

Verifying installation

Open your store in a browser, browse for 30–60 seconds, then check the Auraflow dashboard. A new visitor entry should appear in the Visitors panel. If nothing appears after two minutes:

Open browser DevTools → Network tab and filter for auraflow — confirm the script loaded and signal requests are firing.
Check that your data-shop value matches the domain in your Auraflow account settings.
Ensure no Content Security Policy is blocking the tracker domain.

Content Security Policy

If your store uses a strict CSP, add the following directives:

script-src 'self' https://cdn.auraflow.ai;
connect-src 'self' https://api.auraflow.ai;

■ HubSpot Pro+

The HubSpot integration syncs visitor archetypes, intent scores, top-interest products, and live segments directly into your HubSpot CRM. It also pulls email engagement data back into Auraflow to sharpen behavioural scoring over time.

Connecting via OAuth

In Auraflow, go to Settings → Integrations → HubSpot CRM Sync.
Click Connect HubSpot. You will be redirected to HubSpot's authorisation screen.
Select the HubSpot account you want to connect and click Connect app.
You are redirected back to Auraflow. The status badge will show Connected with your portal ID.

ⓘ You do not need an existing Auraflow account to install from the HubSpot Marketplace. The OAuth flow creates or links your account automatically on first install.

Custom properties created

On first sync, Auraflow creates the following custom contact properties in your HubSpot portal under the group Auraflow Intelligence:

Property name	Type	Description
auraflow_archetype	String	Buyer archetype classification (e.g. Researcher, Impulse Buyer)
auraflow_intent_score	Number	Purchase readiness 0–100
auraflow_confidence	Number	Model confidence in the archetype assignment 0–100
auraflow_top_product	String	Title of the product the visitor engaged with most
auraflow_top_product_price	Number	Price of the top interest product
auraflow_clv_30d	Number	Predicted customer lifetime value over 30 days
auraflow_segment	String	Current segment membership (most recent sync)
auraflow_playbook	String	Recommended engagement playbook for this visitor
auraflow_last_seen	Date	Timestamp of most recent tracked session
auraflow_sync_at	Date	Timestamp of last Auraflow → HubSpot sync

What syncs and when

Contact creation — Auraflow creates or updates a HubSpot contact when a visitor's email becomes known (e.g. form fill, Klaviyo match).
Property sync — archetype, score, product, CLV, and playbook are written on each classification update.
Segment membership — when a segment syncs, Auraflow adds matched contacts to the corresponding HubSpot list.
Email engagement pull — Auraflow reads HubSpot email open/click data daily and feeds it back into intent scoring.

Disconnecting

Go to Settings → HubSpot CRM Sync and click Disconnect. This revokes Auraflow's OAuth token. Existing contact properties in HubSpot are not deleted — only future syncs stop.

HubSpot AI Access (MCP)

Auraflow also supports a direct Private App connection for AI-assisted CRM actions — creating deals, tasks, notes, and enrolling contacts in workflows from within the Auraflow AI agent.

In HubSpot, go to Settings → Integrations → Private Apps and create a new private app named Auraflow MCP.
Grant the following scopes: crm.objects.contacts.read/write, crm.objects.deals.read/write, crm.objects.companies.read/write, crm.lists.read/write, timeline.
Copy the generated access token.
In Auraflow Settings, under HubSpot AI Access (MCP), paste the token and toggle the connection on.

■ Klaviyo All plans

The Klaviyo integration lets Auraflow sync segments as Klaviyo lists, tag profiles with archetype and intent data, and trigger Klaviyo flows based on real-time behavioural conditions.

Connecting

In Klaviyo, go to Account → Settings → API Keys and create a Private API Key with full access.
In Auraflow Settings, paste the key into the Klaviyo API Key field and save.
The status badge will confirm the connection. Auraflow will immediately pull your existing lists and segments.

Profile properties synced

Property	Description
AuraflowArchetype	Buyer classification
AuraflowIntentScore	Purchase readiness 0–100
AuraflowTopProduct	Highest-attention product title
AuraflowSegment	Current segment name
AuraflowCLV30d	30-day predicted value

Syncing a segment to Klaviyo

Build or open a segment in the Auraflow Act tab.
In the segment's Integrations panel, toggle Klaviyo on and select or create a target list.
Click Sync Now to push the current audience, or enable Auto-sync to keep the list updated continuously.

✓ Create an Auraflow segment for each stage of your funnel — High Intent, Price Sensitive, Cold/Nurture — and map each to a dedicated Klaviyo list. Use those lists as the entry point for your existing email flows.

■ Meta Ads Pro+

Connect your Meta Pixel to let Auraflow fire enriched custom events alongside standard pixel events. This sends archetype and intent data into Meta's events pipeline, improving Custom Audience quality and ROAS on retargeting campaigns.

Connecting

Find your Pixel ID in Meta Events Manager (it's a 15–16 digit number).
In Auraflow Settings, paste the Pixel ID into the Meta Pixel ID field and save.
Auraflow begins firing enriched events immediately. No changes needed in Meta.

Custom events fired

Event name	When
AuraflowArchetypeSet	When a visitor is classified for the first time in a session
AuraflowHighIntent	When intent score crosses the high-readiness threshold
AuraflowProductAttention	When a visitor spends significant time on a product

Each event carries archetype, intent_score, and top_product as custom data parameters, making them available as signals for Meta's ad delivery optimisation.

■ Google Analytics 4 Pro+

Link your GA4 property to push Auraflow behavioural events into your Analytics data stream. This enriches GA4 reports with archetype and intent dimensions and lets you build GA4 audiences based on buyer classification.

Connecting

In GA4, go to Admin → Data Streams, select your stream, and copy the Measurement ID (format: G-XXXXXXXXXX).
In Auraflow Settings, paste it into the GA4 Measurement ID field and save.

Events sent to GA4

Event	Parameters
auraflow_classify	archetype, confidence, intent_score
auraflow_product_attention	product_title, attention_score, hover_ms
auraflow_high_intent	archetype, intent_score, top_product

ⓘ GA4 custom dimensions for archetype and intent_score must be registered in your GA4 property before they appear in reports. Go to Admin → Custom Definitions → Custom Dimensions and add both as event-scoped dimensions.

■ Slack Pro+

Send real-time notifications to a Slack channel when a high-intent visitor is detected — useful for sales teams who want to act on warm leads the moment they appear.

Connecting

In Slack, go to Apps → Incoming Webhooks and create a webhook for your chosen channel.
Copy the webhook URL (format: https://hooks.slack.com/services/…).
In Auraflow Settings, paste it into the Slack Webhook URL field and save.

Auraflow will post a compact card to your channel whenever a visitor is classified as high-intent, including their archetype, intent score, top product, and a direct link to their profile in the Auraflow dashboard.

■ Custom Webhooks Pro+

Send visitor classification and segment events to any endpoint — your own backend, a Zapier webhook, Make.com, or any HTTP receiver.

Connecting

In Auraflow Settings, paste your endpoint URL into the Webhook URL field and save.
Auraflow sends a POST request with a JSON body on each classification event.

Payload structure

{
  "event": "visitor.classified",
  "timestamp": "2026-03-29T12:00:00Z",
  "shop_domain": "yourstore.myshopify.com",
  "visitor": {
    "id": "v_xxxxxxxx",
    "archetype": "Researcher",
    "intent_score": 74,
    "confidence": 81,
    "top_product": "Midnight Serum 30ml",
    "top_product_price": 89.00,
    "segment": "High Intent — Skincare",
    "playbook": "NURTURE:EDUCATE",
    "clv_30d": 142.50
  }
}

⚠ Webhooks are delivered once with no retry on failure. If your endpoint is unavailable, the event is dropped. Use a queue or serverless function if you need guaranteed delivery.

■ Segments

Segments are live audiences built from rules. They update automatically as visitor behaviour evolves and sync to Klaviyo, HubSpot, and Meta in real time.

Creating a segment

In the Act tab, click New Segment.
Add rules — combine archetype, intent score, product interest, behavioural signals, and date filters using AND/OR logic.
Click Preview to see the matched audience size and a sample of profiles.
Name the segment, connect integrations (Klaviyo list, HubSpot list), and save.

Example segments

Segment	Rule logic
Hot Leads	Intent score ≥ 70 AND archetype = Impulse Buyer
Price-Sensitive	Archetype = Price Checker AND pricing_attention ≥ 3
Research Phase	Archetype = Researcher AND sessions ≥ 2
At Risk	Last seen > 14 days AND intent score < 30
High CLV Prospects	CLV 30d ≥ 100 AND no purchase

■ Flows

Flows are multi-step automations triggered by a visitor event or segment entry. Each step can send an email via Klaviyo, post a webhook, tag a HubSpot contact, or add a wait delay.

Creating a flow

In the Act tab, click New Flow.
Choose a trigger — segment entry, archetype change, high-intent threshold, or manual.
Add steps using the visual builder. Available step types: Send Email (Klaviyo), Add to List, Tag Contact, Webhook, Wait.
Activate the flow. It will fire for all future trigger events.

ⓘ Free plan supports 1 flow with up to 3 steps. Pro and Growth plans are unlimited.

■ AI Workflows Pro+

AI Workflows let you describe a goal in plain language and let Auraflow's AI agent execute multi-step CRM actions on your behalf — creating deals, writing follow-up notes, building targeted lists, and more.

Creating an AI Workflow

In the Act tab, open the AI Workflows panel and click New Workflow.
Describe the goal in plain language — e.g. "Create a HubSpot deal for every visitor who scores above 70 and viewed the premium collection".
Review the generated action plan and approve it.
Enable the workflow. The AI agent will execute the plan automatically as matching visitors are detected.

AI Workflows have access to your connected integrations — HubSpot (via MCP), Klaviyo, and webhook endpoints. They operate within the permissions granted to each integration and log every action in the AI Action Log.

■ Settings Reference

Collection

Setting	Default	Description
Signal flush interval	30s	How often the tracker sends batched signals to Auraflow servers
Hover threshold	700ms	Minimum hover duration before a product interaction is recorded

Display

Setting	Default	Description
Auto-refresh	30s	How often the dashboard visitor list refreshes automatically
Card density	Comfortable	Compact or comfortable spacing on visitor cards
Show anonymous	On	Include visitors who have not yet been classified

Data retention

Plan	Retention
Free	30 days
Pro	90 days
Growth	365 days

Visitor data older than your plan's retention window is automatically purged at 02:00 UTC daily. You can set a shorter custom retention period in Settings if required for GDPR compliance.

⚠ Troubleshooting

No visitors appearing in the dashboard

Confirm the tracker script is present on the page — open DevTools → Sources and search for af-tracker.
Check the Network tab for POST requests to api.auraflow.ai/signals.
Verify the data-shop attribute matches your registered shop domain exactly.
Ad blockers and privacy extensions can intercept the tracker. Test in a clean browser profile.

HubSpot sync not working

In Settings, check the HubSpot status badge. If it shows Disconnected, click Reconnect and complete the OAuth flow again.
Syncing only creates HubSpot contacts for identified visitors (those with a known email). Anonymous visitors are tracked in Auraflow but not pushed to HubSpot until an email is associated.
Ensure your HubSpot portal has sufficient contact capacity on its current plan.

Klaviyo lists not updating

Confirm the Private API Key in Settings has not been rotated in Klaviyo — if it has, update it in Auraflow and save.
Check that Auto-sync is enabled on the segment and that the segment has matched profiles (run a preview first).

Meta events not showing in Events Manager

Meta can take up to 20 minutes to display new custom events for the first time.
Use the Test Events tool in Meta Events Manager to verify the pixel is receiving data. Look for events prefixed with Auraflow.
Confirm the Pixel ID in Auraflow Settings matches the pixel assigned to your ad account — not a page pixel.

✉ Support

If you run into anything not covered here, the team is available to help.

Email: support@kosmatic.com
FAQ: auraflow.ai/faq
Response time: within 24 hours on business days. Pro and Growth customers receive priority response.