Ads and Analytics - Hanut.io

The ads and analytics configuration lets you connect third-party tracking and advertising platforms to your store. Enable the services you use to measure traffic, understand customer behaviour, and optimise your advertising campaigns.

Accessing ads and analytics settings

From your admin, go to Settings > Ads & Analytics
Enable the integrations you want to use
Enter the required IDs or credentials for each enabled integration
Click Save

Tip

You only need to configure the services you actively use. Leave others disabled to keep your store lightweight.

Google Analytics

Track website traffic, user behaviour, and conversion data with Google Analytics.

Setting up Google Analytics

Toggle Google Analytics Enabled to on
Enter your Google Analytics Measurement ID (e.g., G-XXXXXXXXXX)
Click Save

Finding your Measurement ID

Go to Google Analytics
Navigate to Admin > Data Streams
Select your web stream
Copy the Measurement ID starting with G-

Google Analytics scripts load automatically on your store once enabled and the customer has given analytics consent.

Google Tag Manager

Manage multiple tracking tags from a single interface with Google Tag Manager (GTM). GTM is always loaded when enabled and relies on its own built-in consent management to control which tags fire.

Setting up Google Tag Manager

Toggle Google Tag Manager Enabled to on
Enter your GTM Container ID (e.g., GTM-XXXXXXX)
Click Save

Finding your Container ID

Go to Google Tag Manager
Select your container
Copy the Container ID from the top of the page (starts with GTM-)

Tip

Configure consent mode within your GTM container to control which tags fire before and after consent is granted. GTM handles consent management independently from the store's cookie consent banner.

Facebook Pixel

Track conversions and build audiences for Facebook and Instagram advertising campaigns.

Setting up Facebook Pixel

Toggle Facebook Pixel Enabled to on
Enter your Facebook Pixel ID (a numeric ID)
Click Save

Finding your Pixel ID

Go to Meta Events Manager
Select your Pixel
Copy the numeric Pixel ID

Facebook Pixel scripts load on your store when enabled and the customer has given marketing consent.

Facebook Conversions API

Send conversion events directly from your server to Facebook for more reliable tracking that is not affected by browser ad blockers.

Setting up Facebook Conversions API

Toggle Facebook Conversions API Enabled to on
Enter your Facebook Conversions API Access Token
Click Save

Important

Your access token is stored securely and is never displayed after saving. If you need to update it, enter a new token. Leaving the field blank keeps the existing token.

Generating an access token

Go to Meta Events Manager
Select your Pixel
Navigate to Settings > Conversions API
Generate a new access token

Facebook Catalogue Export

Allow Facebook to import your product catalogue for use in dynamic ads, shops, and product tagging.

Setting up catalogue export

Toggle Facebook Catalogue Export Enabled to on
Set an Export Password to protect the export endpoint
Click Save

Once enabled, your product catalogue is available at a password-protected URL that you provide to Facebook as a data feed source.

Adding the feed to Facebook

Go to Meta Commerce Manager
Select your catalogue
Add a new Data Feed source
Enter the export URL provided in your admin settings
Include the password as a query parameter

Tip

Choose a strong password for your catalogue export. Anyone with the URL and password can access your product data.

Microsoft Clarity

Understand how customers interact with your store using session recordings and heatmaps.

Setting up Microsoft Clarity

Toggle Microsoft Clarity Enabled to on
Enter your Clarity Project ID
Click Save

Finding your Project ID

Go to Microsoft Clarity
Select your project
Copy the Project ID from the project settings

Microsoft Clarity loads automatically on your store once enabled. It operates independently of cookie consent preferences for basic functionality.

Ad attribution windows

Hanut.io automatically tracks which advertising campaigns led to purchases. When a visitor arrives via an ad click (Google Ads, Facebook, or a UTM-tagged link), a record is created that links the click to their session. When they place an order, the system looks back through their history to attribute the order to the relevant campaigns.

Two configurable windows control how far back the system looks:

Window	Default	Description
Direct attribution window	7 days	Clicks made by the customer in the current session
Indirect attribution window	7 days	Clicks made by the same customer in earlier sessions

Configuring attribution windows

From your admin, go to Settings > Ads & Analytics
Scroll to the Attribution Windows section
Enter the number of days for each window (1–90)
Click Save

Tip

Direct attribution captures the campaign a customer was browsing with when they checked out. Indirect attribution captures earlier campaigns that may have introduced the customer to your store. Shorter windows give a more conservative attribution; longer windows give broader credit to campaigns.

How attribution appears on orders

Attributed campaigns are shown on the Order Details page in your admin under the Ad Attribution section. Each entry shows the advertising source, medium, campaign name, and when the customer first clicked through.

Supported ad parameters

Parameter	Source	Medium
`gclid`, `gbraid`, `wbraid`	Google Ads	cpc
`fbclid`	Facebook	paid_social
`utm_source`	Value of `utm_source`	Value of `utm_medium`
`hioatt`	—	— (campaign label only)

The hioatt parameter is a Hanut.io-specific campaign label you can append to any ad URL. When combined with a click ID parameter (e.g. gclid), hioatt sets the campaign name while the source and medium are inferred from the click ID. This lets you distinguish between multiple campaigns running through the same ad platform.

Your store's cookie consent system works with these integrations:

Analytics consent - Required for Google Analytics
Marketing consent - Required for Facebook Pixel
Always loaded - Google Tag Manager and Microsoft Clarity

Google Analytics and Facebook Pixel scripts are only loaded after the customer grants the appropriate consent. Google Tag Manager is always loaded and manages consent internally through its own consent mode. Microsoft Clarity operates in a no-consent mode by default.

Privacy and data collection

When a visitor arrives via an ad click, Hanut.io stores an attribution record containing:

Session ID — the anonymous shopping session identifier
Source, medium, and campaign — inferred from the ad parameters (e.g. "Google Ads", "cpc", "Summer Sale")
Landing time — when the customer first clicked through

Attribution records are stored for 90 days and are then automatically deleted. When an order is placed, the relevant attribution data is copied into the order record, where it is retained as part of the order history.

Privacy policy guidance: If you collect and process ad attribution data, your store's Privacy Policy should disclose this. We recommend including a statement such as:

When you visit our store via an advertising link, we record which advertising channel referred you (for example, Google Ads or Facebook). This information is stored for up to 90 days and may be associated with your order if you make a purchase. We use this data solely to measure the effectiveness of our advertising campaigns.

GDPR and privacy regulations

Ad attribution involves processing personal data. Ensure your Privacy Policy covers this processing, identifies the lawful basis (typically legitimate interest for B2C attribution), and is accessible to customers. If you are subject to GDPR or similar regulations, consult a legal professional to ensure compliance.

Permissions

Ads and analytics configuration requires the Store Configuration permission. Users without this permission will not see the settings menu item or be able to access the configuration page.

Next steps

Configure your store identity with store configuration
Set up Facebook review sync for social proof
Export customer data for Meta advertising