amp heatmaps

amp heatmaps returns click map and scroll map data for one page URL. This read-only command family requires the analytics:read scope.

amp heatmaps click-map

Returns click counts for one page URL, grouped by the CSS selector of the clicked element or by page coordinate, ranked by count. Filter by device viewport band and date range. Results reflect the authenticated caller's project access and data access controls.

This POST computes a result and does not mutate state. It is therefore a read operation and does not require an Idempotency-Key.

Omitting time_range uses the last 30 days in the project timezone. The span of time_range cannot exceed 90 days.

bash
amp heatmaps click-map --project <project_id> --page-url https://example.com/pricing --limit 25

Requires the analytics:read scope.

amp heatmaps scroll-map

Returns the scroll-depth distribution for one page URL as a cumulative histogram from the top of the page, plus the average fold and the deepest scroll observed. Filter by device viewport band and date range. Results reflect the authenticated caller's project access and data access controls.

This POST computes a result and does not mutate state. It is therefore a read operation and does not require an Idempotency-Key.

Omitting time_range uses the last 30 days in the project timezone. The span of time_range cannot exceed 90 days.

bash
amp heatmaps scroll-map --project <project_id> --page-url https://example.com/pricing --device mobile

Requires the analytics:read scope.

Was this helpful?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

On this page