---
title: amp zoning
description: "Reference for amp zoning zone-metrics, which ranks the zones on a page URL by one metric."
product: general
lang: en
last_updated: 2026-11-18
token_estimate: 817
---
# amp zoning

`amp zoning` returns zone metrics for one page URL. It requires the `analytics:read` scope.

## `amp zoning zone-metrics`

Returns one metric for every zone on a page URL, ranked by value. A zone is identified by the CSS selector of its element. Results reflect the authenticated caller's project access and data access controls.

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

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 zoning zone-metrics --project <project_id> --page-url https://example.com/pricing --metric rage_click_rate_session
```

| Flag | Type | Required | Description |
| --- | --- | --- | --- |
| `--project` | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: `--project-id`. |
| `--page-url` | string | Yes | Page URL to analyze. Accepts `http` and `https` URLs; a URL without a scheme is treated as `https`. The query string and fragment are removed before matching, so `https://example.com/pricing?utm=x` and `https://example.com/pricing` are the same page. Alias: `--url`. |
| `--url-match` | string: `is`, `contains` | No | How `page_url` is matched against the page URL recorded on each event. `is` matches the exact URL; `contains` matches any URL containing it. Alias: `--match`. |
| `--time-range` | object | No |  |
| `--metric` | string: `click_rate_pageview`, `click_rate_session`, `rage_click_rate_pageview`, `rage_click_rate_session`, `click_distribution`, `click_recurrence`, `rage_click_recurrence`, `exposure_rate`, `attractiveness_rate`, `revenue_per_click` | No | Metric computed per zone. Rates are fractions (`0.18` is 18%). - `click_rate_pageview`: page views with a click in the zone, divided by page views. - `click_rate_session`: sessions with a click in the zone, divided by sessions. - `rage_click_rate_pageview`: page views with a rage click in the zone, divided by page views. - `rage_click_rate_session`: sessions with a rage click in the zone, divided by sessions. - `click_distribution`: clicks in the zone, divided by all clicks on the page. - `click_recurrence`: clicks in the zone, divided by page views. Can exceed 1. - `rage_click_recurrence`: rage clicks in the zone, divided by page views. Can exceed 1. - `exposure_rate`: page views where the zone was visible, divided by page views. - `attractiveness_rate`: page views where the zone was visible and clicked, divided by page views where it was visible. Can exceed 1. - `revenue_per_click`: revenue attributed to the zone, divided by sessions that clicked it, in the project's revenue unit. |
| `--zone-ids` | array | No | Restrict the result to these zones. A zone id is the CSS selector of the element, as returned in `zones[].zone_id`. Omit to rank every zone on the page. JSON array, or a comma-separated list for strings. Alias: `--zones`. |
| `--limit` | integer | No | Maximum number of zones returned after ranking by `value`. |

Requires the `analytics:read` scope.

