Count page views once per load and skip known bots.

Stop auto-counting list APIs and homepage sliders, track static pages via pageKey, and add store-specials AI list matching.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/website-api/AI_PROMPT.md

@@ -198,13 +198,22 @@ Use product categories from `GET /tenants/{domain}/categories?entityType=product
 **Wrong:** expecting `fieldName` / `fieldNameFa` on each `technicalValues` item in the product detail response.
 
 ### Analytics (dashboard charts)
-Page views are recorded **automatically** when the website calls the normal public list/detail APIs (blogs, products, user-products, portfolios, videos, store-items, and homepage sliders). No extra website code is required for those.
+Page views are recorded **automatically** for roughly one count per page load:
 
-Optional explicit record (e.g. custom home without sliders):
-- `POST /tenants/{domain}/analytics/views` body `{ "kind": "home"|"blog_detail"|"product_detail"|..., "entityId"?: "...", "path"?: "/blog/my-post" }`
-- `kind` values: `home`, `portfolio_list`, `portfolio_detail`, `product_list`, `product_detail`, `store_item_list`, `store_item_detail`, `blog_list`, `blog_detail`, `video_list`, `video_detail`, `user_product_list`, `user_product_detail` (legacy aliases `website`/`product`/`portfolio`/`blog` still accepted)
+- **Home** — `GET /tenants/{domain}/website/static-images?pageKey=home`
+- **About / Contact / other static pages** — `GET .../static-images?pageKey=about` (or `contact`, etc.) → counted as `static_page` with `path=/about`
+- **Content detail** — product, user-product, blog, portfolio, video, and store-item **detail** GETs
+
+List APIs (`products`, `blogs`, …) and homepage sliders **do not** count (avoids multi-API inflation). Known bots (and empty User-Agent) are skipped. A browser refresh counts again.
+
+Call `static-images?pageKey=…` on About/Contact (and similar) so those pages appear in dashboard statistics.
+
+Optional explicit record (custom pages without static-images):
+- `POST /tenants/{domain}/analytics/views` body `{ "kind": "home"|"static_page"|"blog_detail"|"product_detail"|..., "entityId"?: "...", "path"?: "/blog/my-post" }`
+- `kind` values: `home`, `static_page`, `portfolio_list`, `portfolio_detail`, `product_list`, `product_detail`, `store_item_list`, `store_item_detail`, `blog_list`, `blog_detail`, `video_list`, `video_detail`, `user_product_list`, `user_product_detail` (legacy aliases `website`/`product`/`portfolio`/`blog` still accepted). Prefer detail / `home` / `static_page` for real page visits.
 - Events kept ~6 months for charts; lifetime totals kept forever in counters.
 - The business dashboard **Product views** chart counts both `product_detail` and `user_product_detail`.
+- The **Pages** statistics row counts `static_page` (about, contact, …).
 
 ### Static images
 Named slots the business dashboard can replace. Fetch once per page:

docs/website-api/openapi.json

@@ -631,7 +631,7 @@
       "post": {
         "tags": ["Analytics"],
         "summary": "Record a storefront page view",
-        "description": "Optional explicit view counter. Most page views are recorded automatically when public list/detail APIs are called (blogs, products, portfolios, videos, store-items, homepage sliders). Use this for custom pages. No auth required. Events retained ~6 months; lifetime counters kept forever.",
+        "description": "Optional explicit view counter. Most page views are recorded automatically on: (1) GET website/static-images?pageKey=home → home, (2) GET static-images?pageKey=about|contact|… → static_page, (3) public detail GETs for products, user-products, blogs, portfolios, videos, store-items. List APIs and homepage sliders do not count. Known bots / empty User-Agent are skipped. Refresh counts again. Use this POST for custom pages that do not hit those endpoints. No auth required. Events retained ~6 months; lifetime counters kept forever.",
         "parameters": [
           {
             "$ref": "#/components/parameters/domain"
@@ -649,6 +649,7 @@
                     "type": "string",
                     "enum": [
                       "home",
+                      "static_page",
                       "portfolio_list",
                       "portfolio_detail",
                       "product_list",
@@ -666,7 +667,7 @@
                       "portfolio",
                       "blog"
                     ],
-                    "description": "Canonical kinds preferred. Legacy aliases: website→home, product→product_detail, portfolio→portfolio_detail, blog→blog_detail."
+                    "description": "Canonical kinds preferred. Prefer home, static_page, and *_detail for page visits. Legacy aliases: website→home, product→product_detail, portfolio→portfolio_detail, blog→blog_detail."
                   },
                   "entityId": {
                     "type": "string",
@@ -674,7 +675,7 @@
                   },
                   "path": {
                     "type": "string",
-                    "description": "Optional page path (e.g. `/`, `/blog/my-post`)."
+                    "description": "Optional page path (e.g. `/`, `/about`, `/blog/my-post`). Recommended for static_page."
                   }
                 }
               }
@@ -683,13 +684,14 @@
         },
         "responses": {
           "200": {
-            "description": "View recorded",
+            "description": "View recorded (or skipped for bots)",
             "content": {
               "application/json": {
                 "schema": {
                   "type": "object",
                   "properties": {
-                    "ok": { "type": "boolean", "enum": [true] }
+                    "ok": { "type": "boolean", "enum": [true] },
+                    "skipped": { "type": "string", "enum": ["bot"] }
                   }
                 }
               }