From f4f8783c16526eb15c86a416840a62c2f18d57ee Mon Sep 17 00:00:00 2001 From: porbot Date: Tue, 15 Sep 2026 18:58:24 +0000 Subject: [PATCH] Punt Apple API schema; save Insights KPI source URL Later proof/retention layer noted; no invented metrics or API names. --- docs/product/genre-packs/SOURCES.md | 5 +++++ docs/product/genre-packs/core3-field-map.md | 4 ++-- docs/strategy/BUSINESS_PLAN.md | 4 ++++ 3 files changed, 11 insertions(+), 2 deletions(-) diff --git a/docs/product/genre-packs/SOURCES.md b/docs/product/genre-packs/SOURCES.md index 453b5b7..0e2fc1b 100644 --- a/docs/product/genre-packs/SOURCES.md +++ b/docs/product/genre-packs/SOURCES.md @@ -28,6 +28,11 @@ Last updated: 2026-09-15 (porbot) | Configure location attributes (owner-facing field labels) | https://support.apple.com/guide/business/configure-location-attributes-abcbdc543423/web | | Brand identity attributes (brand-level — not Location schema) | https://support.apple.com/guide/business/brand-identity-attributes-abcbb1973199/web | + +| Insights for a single location (KPI telemetry — searches, place card views, Actions, etc.) | https://support.apple.com/guide/business/use-insights-for-a-single-location-abcbb749656b/web | + +**Punted (2026-09-15):** Apple partner API schema (`https://business.apple.com/docs/api/v1/introduction` and data-spec camelCase Location fields) — rabbit hole at this altitude; revisit when we have signed-in/partner access. Do not invent API names meanwhile. + **BLOCKED:** Apple Business Connect Location API data specification (camelCase resource fields), e.g. `https://businessconnect.apple.com/docs/data-specification/v1.3/…` — often partner-gated; do not invent names. Unlock: accessible dump or paste of Location resource. --- diff --git a/docs/product/genre-packs/core3-field-map.md b/docs/product/genre-packs/core3-field-map.md index 0b36947..dff0ee7 100644 --- a/docs/product/genre-packs/core3-field-map.md +++ b/docs/product/genre-packs/core3-field-map.md @@ -9,7 +9,7 @@ - Apple: [Welcome](https://support.apple.com/guide/business/welcome/web) → [Configure location attributes](https://support.apple.com/guide/business/configure-location-attributes-abcbdc543423/web) - Bing: [Places API PDF (Latest)](https://cdn.bingplaces.com/tpshared/BingPlaces_API_Latest.pdf) -**Apple naming:** owner-facing **UI labels** from Configure location attributes (below). Still **BLOCKED** on separate camelCase Location API resource names from `businessconnect.apple.com` data-spec v1.3 until that dump is available — we do not invent them. +**Apple naming:** owner-facing **UI labels** from Configure location attributes (below). **Punted** at this altitude: separate camelCase Location/partner API resource names — we do not invent them. UI labels from Configure location attributes remain the Apple column SoT. Example values in genre packs are **illustrative only** — they are not schema claims. @@ -32,5 +32,5 @@ Example values in genre packs are **illustrative only** — they are not schema | Status | Open / closed / etc. | *(platform status / openInfo as applicable)* | Status | *(platform-specific)* | Suppress wrong “open now” | | Showcase | Merchandising | *(GBP posts / products — separate surfaces)* | Showcase | *(n/a or limited)* | Optional merchandising — not Layer A P1 | -**Still BLOCKED:** Apple Location API v1.3 camelCase field list (partner/data-spec dump). Unlock: paste or accessible fetch of that resource. +**Punted (altitude):** Apple Location / partner API camelCase field list (`business.apple.com` / data-spec). Revisit with signed-in access — do not invent names. Owner-facing UI labels above remain SoT for Apple column. **Still BLOCKED for genre attribute rows:** GBP `attributes.list` per salon/bakery `gcid` (US) + Apple Good to Know enum values. diff --git a/docs/strategy/BUSINESS_PLAN.md b/docs/strategy/BUSINESS_PLAN.md index 166b488..9ccce98 100644 --- a/docs/strategy/BUSINESS_PLAN.md +++ b/docs/strategy/BUSINESS_PLAN.md @@ -117,6 +117,9 @@ Checked *on* the Core 3 (and the site). Prerequisite for 2027 work **when flaws ### Surfacing work to owners (working direction — essence) +**Later proof layer (working idea, not free first-hour):** platform KPI telemetry (e.g. Apple Insights — searches, place card views, Actions). Owner language: found you → tapped directions/call. Pair with GBP performance later. Show only what platforms return — never invent numbers. Fit = ongoing AI readiness / retention, not the initial free scorecard. + + Three layers (not one giant schema): **A** universal Discovery foundation → **B** thin genre pack → **C** known-for overlay. Scorecard first, then 3–7 actions max by impact. Deep example packs: [`docs/product/genre-packs/salon.md`](../product/genre-packs/salon.md), [`docs/product/genre-packs/bakery.md`](../product/genre-packs/bakery.md). Index: [`docs/product/genre-packs.md`](../product/genre-packs.md). @@ -186,6 +189,7 @@ If something here conflicts with `CANONICAL_STRATEGY.md`, resolve on purpose in | 2026-09-15 | Replaced guessed genre matrices with sourced Core 3 field map (core3-field-map.md); salon/bakery = application notes only | | 2026-09-15 | Apple Core 3 column = UI labels until Business Connect Location API v1.3 field list dumped; no invented Apple schema names | | 2026-09-15 | Apple column filled from Configure location attributes guide; still BLOCKED on API camelCase names + per-genre attribute enums | +| 2026-09-15 | Punted Apple partner API schema rabbit hole; noted Insights-style KPIs as later proof/retention (SOURCES.md); still BLOCKED on per-genre attribute enums | ---