Punt Apple API schema; save Insights KPI source URL

Later proof/retention layer noted; no invented metrics or API names.
2026-09-15 18:58:24 +00:00
parent 01892a7f28
commit f4f8783c16
3 changed files with 11 additions and 2 deletions
@@ -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.

 ---
@@ -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.
@@ -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 |

 ---