Heatmap and personalization tools

Updated 2026-11-18

In short

Read heatmaps, set dynamic text, and show different content to different visitors.

7 tools. Each one is something you can ask an AI assistant to do in plain English.

get_page_heatmap

Read a page's real click, scroll-depth and attention data by device: the most-clicked elements, how far visitors scrolled and the busiest attention areas. Follows your plan's data retention. Needs a plan with heatmaps.

ParameterTypeRequiredDescription
pageIdstringYesThe page's ID (from list_pages)
range'24h' | '7d' | '14d' | '30d' | '60d' | '90d' | 'all'NoPeriod (default 7d)
device'desktop' | 'mobile' | 'tablet' | 'all'NoDevice (default all)
topnumberNoHow many elements and areas to return (1-50, default 10)

Try itWhere do mobile visitors stop scrolling on my pricing page?

list_page_text_replacements

List a page's dynamic text replacements: which URL parameter replaces which text. Built-in headline, subheadline and cta parameters also work without setup.

ParameterTypeRequiredDescription
pageIdstringYesThe page's ID (from list_pages)

Try itWhat dynamic text is set up on my ads landing page?

set_page_text_replacement

Add, change or remove a dynamic text replacement on one text element: the value of a URL parameter replaces that element's text. Saved to the page's private draft; publish the draft to go live. Needs a plan with dynamic text replacement.

ParameterTypeRequiredDescription
pageIdstringYesThe page's ID (from list_pages)
selectorstringYesCSS selector of the text element
paramNamestring | nullYesURL parameter to read, or null to remove

Try itMake my headline show the keyword from the utm_term parameter

get_page_personalization

Read a page's personalization settings, its content variants, each variant's impressions and conversions, and automatic-personalization results. Separate from A/B tests.

ParameterTypeRequiredDescription
pageIdstringYesThe page's ID (from list_pages)

Try itHow are the personalized headlines on my homepage doing?

create_personalized_variant

Create a draft variant of one part of a page, with its replacement content and optional audience rules (UTM values, device, country, referrer, time of day, visitor type, company details). Does not make it live.

ParameterTypeRequiredDescription
pageIdstringYesThe page's ID (from list_pages)
namestringYesVariant name
slotstringYesName of the part of the page, e.g. headline
selectorstringYesCSS selector of that part
variantContentstringYesReplacement HTML
targetingRulesobjectNoAudience: AND/OR conditions on visitor fields
trafficPercentnumberNoShare of matching visitors who see it (default 50)

Try itShow visitors from my Facebook ads a headline about the spring sale

update_personalized_variant

Change a variant's audience, traffic share, content, name or status (draft, active, paused, archived). Changes to an active variant reach live visitors, so the assistant asks you to confirm.

ParameterTypeRequiredDescription
pageIdstringYesThe page's ID (from list_pages)
variantIdstringYesThe variant (from get_page_personalization)
status'DRAFT' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED'NoNew status
targetingRulesobject | nullNoNew audience, or null for everyone
trafficPercentnumberNoNew traffic share
variantContentstringNoNew replacement HTML
namestringNoNew name

Try itMake the spring sale headline live

configure_page_personalization

Turn personalization on or off for a page, or configure automatic personalization, which writes and tests variants itself and spends AI credits. Can change what live visitors see, so the assistant asks you to confirm.

ParameterTypeRequiredDescription
pageIdstringYesThe page's ID (from list_pages)
enabledbooleanNoPersonalization on or off
autoModebooleanNoAutomatic personalization (needs a plan that includes it)
autoSlotsstring[]NoParts of the page automatic mode may change
autoSlotSelectorsobjectNoCSS selector for each of those parts
explorationRatenumberNoShare of traffic used to try new variants (0-1)
holdoutRatenumberNoShare of traffic kept on the original (0-0.5)

Try itTurn on automatic personalization for my homepage headline

Related