GeoKnows Generative Engine Optimization

Kim jesteśmy i co obiecujemy

Pozycjonowanie (one-liner):
GeoKnows pomaga markom stać się źródłem, które silniki cytują i dostawcą akcji, które agenci uruchamiają. Od treści „cite-ready”, przez encje i schema, po ofertę „invokable” i mierzalne wyniki.

Hero (EN): GeoKnows — Be the source engines cite.
Subhead: From content to citation to action. GEO + AEO for Google AI Overviews & LLM search.
CTA: Get a GEO Audit

Architektura oferty (stack GeoKnows)

  1. GeoKnows Insights — audyty i mapa encji (Brand SERP, Overview Readiness, Entity/Schema/Tech).
  2. GeoKnows Studio — produkcja i redakcja treści cite-ready + wdrożenie schema.org.
  3. GeoKnows Monitor — Overviews Watch + dashboard KPI (Answer→Action).
  4. GeoKnows Academy — szkolenia PL/EN, governance, SOP, RODO.

Nowe moduły (AEO i dalej):
5) AEO Kit (Answer/Action Engine Optimization) — OfferGraph + Action Endpoints + Interface Hints.
6) Provenance Studio — podpisy, Content Credentials (C2PA), wersjonowanie, źródła.
7) Policy Graph — polityki zgodności jako dane (jurysdykcje, wyjątki, limity).
8) A2S Attribution — pomiar Answer→Action→Settlement, revenue & disputes.
9) AgentOps — integracje z asystentami/agentami (voice/gaze/zero-UI), testy akceptacyjne akcji.
(opcjonalnie) 10) Smart Payments — smart-wallet (ERC-4337), paymaster, limity, escrow.

Co dostaje klient (klarowne deliverables)

  • Mapa encji i luk + plan priorytetów.
  • 3–5 stron pilotażowych PL/EN (definicje, Q&A, porównania, źródła) + JSON-LD.
  • OfferGraph (maszynowa reprezentacja oferty) i Action Endpoints (np. getQuote(), bookDemo()) z walidacjami i limitami ryzyka.
  • Interface Hints (mikrowidoki/zero-UI) + consents & kill-switch.
  • Dashboard KPI + alerty + raport Overviews Watch.
  • SOP i playbook (publikacja, aktualizacja, governance, RODO).
  • Mini-case „przed/po” z metrykami.

ICP i rynek polski (GTM)

  • E-commerce / marketplace’y, B2B SaaS, software houses (PL→EN), MŚP-eksporterzy, regulowani (finanse/med/edu).
  • Kanały: ABM na LinkedIn, partnerstwa white-label z agencjami SEO/PR, webinary „30 dni do AI Overviews”, gościnne artykuły i konferencje (dane > hype).
  • Oferta wejściowa: GEO Readiness Sprint w stałej cenie + opcjonalny AEO Kit.

Program 30 dni (skrót operacyjny)

Tydz. 1 — Audyt i mapa encji
Brand SERP, crawlability, schema gap, koszyki zapytań, wybór 3–5 stron pilotażowych.
Tydz. 2 — Treść „cite-ready”
Definicje, Q&A, porównania, źródła, autorzy, daty; wersje PL/EN + hreflang.
Tydz. 3 — Schema & AEO Kit
JSON-LD (Organization/WebPage/Article/FAQPage/Service…), OfferGraph + Action Endpoints, Interface Hints, Sitelinks Search Box; CWV i linkowanie wewnętrzne.
Tydz. 4 — Monitoring i iteracje
Overviews Watch, instrumentacja KPI, poprawki merytoryczne, publikacja mini-case, szkolenie zespołu, roadmapa 90 dni.

Roadmapa 90/180/365 dni

0–90 dni

  • Rozszerzenie pilotażu na 10–20 stron; konsolidacja sameAs, grafu encji; baseline KPI.
  • Wdrożenie Provenance Studio (C2PA, wersjonowanie, ścieżka audytu).
  • Wystawienie 2–3 Action Endpoints z testami akceptacyjnymi i limitami.

90–180 dni

  • Skalowanie OfferGraph na pełną ofertę; Policy Graph z automatycznymi testami zgodności.
  • Integracje z agentami (voice/gaze/zero-UI); A/B testy micro-copy potwierdzeń.
  • Pierwsze use-case’y A2S Attribution (Answer→Action→Revenue/Refund/Dispute).

180–365 dni

  • „Plural Agent Readiness” (wiele silników/agentów), opcjonalny smart-wallet (4337) i escrow.
  • Przygotowanie wariantów edge/on-device (prywatność i szybkość).
  • Wejście w „aukcje zadań” (ABO) tam, gdzie dostępne; ujednolicone settlementy.

Technika i bezpieczeństwo (assume-abuse)

Guardrails „by design”:

  • Dual-control: automatycznie odwracalne vs. nieodwracalne po akcepcie.
  • Kill-switch + tamper-evident logs (append-only).
  • Rate-limits / circuit breakers (kwoty, liczba akcji, kanały).
  • Consents ladder (sugeruj → wykonuj z limitem → wykonuj wszystko).
  • Portowalność profilu/zgód/ofert (eksport on-demand, standardy).
  • Pluralizm agentów (łatwa zmiana dostawcy).
  • Privacy-by-default: lokalne przetwarzanie gdzie to możliwe, minimalizacja danych.

KPI (dashboard GeoKnows)

  • Answer Inclusion Rate (udział w AI Overviews / LLM answers).
  • Action Inclusion / Share (jak często agent wybiera naszą akcję).
  • Microview Completion Rate i No-UI Latency.
  • Provenance Coverage i Verifiable Source Rate.
  • Consent Match Rate, Undo/Abort Rate, Dispute Resolution Time.
  • Entity Coverage Score, Citation Velocity, Share of Answers.
  • A2S Revenue / Time-to-Settlement.

Cennik (ramowy)

  • Starter (MŚP): GEO Readiness Sprint + 1 filar + FAQ + schema core + Overviews Watch (baseline).
  • Growth: 3–5 filarów + pełny schema stack + AEO Kit (2 akcje) + dashboard KPI + kwartalne retro.
  • Enterprise: pełny OfferGraph, Policy Graph, A2S Attribution, AgentOps, RODO & legal review, integracje płatności (opcjonalnie 4337).

Brand & treści

  • Nazwa: GeoKnows (parasol). Linie: Insights, Studio, Monitor, Academy, AEO Kit, Provenance Studio, Policy Graph, A2S, AgentOps.
  • Stały descriptor: Generative Engine Optimization.
  • Copy: „GEO, not just SEO”, „From content to citation to action”, „Evidence over promises”.
  • Formaty treści: filary + Q&A + definicje + porównania + dane (tabele), mikro-widoki do cytowania.

Zespół i role

  • Lead/Owner — cel, priorytety, SLA.
  • Entity/Content Lead — definicje, Q&A, porównania, źródła, PL/EN.
  • Tech SEO/Schema — JSON-LD, CWV, hreflang, linkowanie.
  • AEO Engineer — OfferGraph, Action Endpoints, Interface Hints, testy akceptacyjne.
  • Data/Analytics — dashboardy, alerty, A2S.
  • Legal/Compliance — RODO, polityki, C2PA, Policy Graph.
  • Domain Expert — merytoryczny sign-off.

Ryzyka i jak je gasimy

  • Mylenie „Geo” z geolokalizacją → zawsze z deskryptorem „Generative Engine Optimization”.
  • Zmiany algorytmów → kwartalne retro + iteracje; testy definicji/Q&A; „proof over promises”.
  • Nadużycia/lock-in → guardrails, portowalność, pluralizm agentów, audyty.
  • Brak cytowalności → wzmocnić definicje, źródła, atrybuty encji, tabelaryzację danych.

Co robimy jutro (pierwsze 2 tygodnie)

Overviews Watch + dashboard KPI (D14).

Kickoff + dostęp do GSC/logów (D1), wybór 3–5 stron pilotażowych (D3).

Mapa encji + schema gap (D5), briefy contentowe (D6).

Definicje/Q&A/porównania + JSON-LD (D10).

OfferGraph (MVP) + 1–2 Action Endpoints (D12).

Kim jesteśmy i co obiecujemy

Pozycjonowanie (one-liner)

PL: GeoKnows pomaga markom stać się źródłem, które silniki cytują i dostawcą akcji, które agenci uruchamiają — od treści cite-ready, przez encje i schema, po ofertę invokable i mierzalne wyniki.
EN: GeoKnows helps brands become the source engines cite and the provider of actions agents invoke — from cite-ready content and entity/schema design to invokable offers and measurable outcomes.

Hero (sekcja nad foldem)

Wariant podstawowy (proponowany)

Headline (EN): GeoKnows — Be the source engines cite
Subhead (EN): From content to citation to action. GEO + AEO for Google AI Overviews & LLM search.
Primary CTA: Get a GEO Audit
Secondary CTA: See the Playbook

Wersja PL (skrót do decka/LP):
Nagłówek: GeoKnows — zostań źródłem, które cytują wyszukiwarki
Podtytuł: Od treści do cytatu i akcji. GEO + AEO pod Google AI Overviews i wyszukiwarki LLM.
CTA główny: Zamów audyt GEO
CTA pomocniczy: Zobacz playbook

Dwa dodatkowe warianty do A/B testów

Variant B — „answers → clicks”

  • Headline: Win the answer, then win the click
  • Subhead: Entity-first content, schema and actions designed for AI Overviews. Evidence over promises.
  • CTAs: Book a Strategy Call • See Case Studies

Variant C — „stack & trust”

  • Headline: Make your entity undeniable
  • Subhead: One stack — entities, schema, cite-ready content, monitoring — so engines recognize you and users trust you.
  • CTAs: Start an Overview Check • Download One-Pager

Mikro-elementy hero (UX)

  • Trust strip: „PL/EN • RODO-ready • Evidence-based • No ranking guarantees”
  • Micro-proof: „Avg. +X% Overview Inclusion in 90 days*” (*metodyka w case study)
  • Micro-disclaimer: „We optimize for citations and actions, not promises of positions.”

Filary wartości (Value Pillars)

  1. Cytowalność (GEO): treści, które modele chętnie przywołują (definicje, Q&A, dane, źródła).
  2. Wywoływalność (AEO): OfferGraph + Action Endpoints — Twoja oferta gotowa do porównania i uruchomienia przez agentów.
  3. Zaufanie (Proof & Provenance): podpisy/autorzy, źródła, daty, wersjonowanie, (opcjonalnie) Content Credentials/C2PA.
  4. Zgodność (Policy-by-Design): RODO, jurysdykcje, limity ryzyka i „kill-switch” w procesach.
  5. Pomiar (A2S): dashboard Answer → Action → Settlement (wynik zamiast obietnic).

Co konkretnie obiecujemy (bez hype’u)

  • Outcome 1: „Overview Inclusion Rate” rośnie w zdefiniowanych koszykach zapytań.
  • Outcome 2: Większy Share of Answers vs. konkurencja (monitoring).
  • Outcome 3: Akcje są invokable (wyszukiwarki LLM/asyści) z kontrolą ryzyka i „undo”.
  • Outcome 4: Kompletna mapa encji i spójny schema stack.
  • Outcome 5: Provenance Coverage ≥ X% treści krytycznych (dowód pochodzenia).
    (Nie składamy gwarancji pozycji — dostarczamy dowody i metryki wpływu.)

Dla kogo (ICP)

  • E-commerce / marketplace z treściami porównawczymi.
  • B2B SaaS / software houses (PL→EN).
  • Producenci/eksporterzy (MŚP) z katalogami usług/produktów.
  • Sektory regulowane (finanse/med/edu) — gdzie provenance i policy są kluczowe.

Nasze różnice vs klasyczne SEO

  • Od keywordów do encji: model pojęć, about/mentions, sameAs.
  • Od artykułu do cytatu: definicje, Q&A, porównania, dane z jawnych źródeł.
  • Od kliknięć do akcji: OfferGraph i Action Endpoints (np. getQuote()).
  • Od obietnic do dowodów: case’y, metryki i provenance.

Elevator pitch (3 długości)

  • 20 s: We turn your expertise into generative presence — content engines cite and actions agents invoke.
  • 60 s: GeoKnows designs entity-first content, schema and invokable offers so you show up in AI Overviews and agent answers. We measure the lift in citations and actions — not just rankings.
  • 120 s: (rozszerzenie o AEO, provenance, policy i A2S — do decka sprzedażowego)

Ton i styl (Voice & Tone)

  • Evidence over promises — liczby, daty, źródła, bez „gwarancji #1”.
  • Clarity over cleverness — krótkie zdania, definicje 2–4 zdania, Q&A 50–120 słów.
  • Transparent by default — ujawniaj metodologię, ograniczenia i aktualizacje.

CTA-drabinka (Top/Mid/Bottom funnel)

  • Top: Get a GEO Audit • Start an Overview Check • See the Playbook
  • Mid: Book a Strategy Call • See Case Studies • Download One-Pager
  • Bottom: Start AEO Kit • Request Quote • Run Pilot (30-day)

Micro-copy przy CTA: „No hard sell — we start with a readiness check.”

Sekcja dowodów (Proof)

  • Metryki: Overview Inclusion Rate, Share of Answers, Entity Coverage, AI Reference Rate, Action Inclusion, No-UI Latency, A2S Revenue.
  • Case tiles: (logo/branża) → „+X p.p. Overview Inclusion w 60 dni” → „metodyka i wnioski”.
  • Provenance badge: „Content signed • Sources listed • Last updated: YYYY-MM-DD”.

FAQ snippet (pod hero – pomaga GEO/Overviews)

Q: What’s GEO vs. SEO?
A: GEO (Generative Engine Optimization) prepares your content to be cited by AI systems (e.g., Google AI Overviews) using entity-first structure, schema and evidence. We still care about SEO, but GEO focuses on being recognized and referenced in answers.

Q: Do you guarantee rankings?
A: No. We don’t guarantee positions. We optimize for measurable inclusion in AI Overviews and agent answers — and for safe, invokable actions.

Mini-wytyczne projektowe hero (UX)

  • Układ: H1 → Subhead → CTA (primary/secondary) → trust strip → micro-proof → hero-grafika (np. schemat „content → citation → action”).
  • Zero-UI hint: mały przycisk „Try an Overview Check” otwierający mikrowidok (1 pole + potwierdzenie).
  • Dostępność: kontrast AA, czcionka ≥ 18px, jasne etykiety CTA, aria-labels.

Copy do meta (SEO/GEO)

  • Meta title: GeoKnows — Generative Engine Optimization (GEO) for AI Overviews & LLM Search
  • Meta description: From content to citation to action. Entity-first content, schema and invokable offers that engines cite and agents execute. Book a GEO Audit.

Krótkie bloki do decka (PL)

  • Nagłówek slajdu: GEO + AEO: od treści do cytatu i akcji
  • Punktacja:
    • Treści cite-ready (definicje, Q&A, dane, źródła)
    • Encje i schema (spójność, sameAs, about/mentions)
    • OfferGraph + Action Endpoints (invokable)
    • Monitoring: Answer → Action → Settlement
    • Dowód pochodzenia (provenance), RODO i limity ryzyka

Krótka „polityka obietnic”

  • Tak: mówimy o metrykach, case’ach, zmianach w czasie i ograniczeniach.
  • Nie: nie obiecujemy rankingów, nie ukrywamy metodologii, nie upiększamy wyników.

Podsumowanie (co wkleić na LP teraz)

  • Hero: proponowany wariant podstawowy (EN/PL) + CTAs + trust strip.
  • Poniżej: 4 filary wartości, sekcja dowodów (metryka + case tile), krótki FAQ, micro-CTA do Playbooka, „Start an Overview Check”.

GeoKnows Insights

Cel: szybki, mierzalny obraz stanu wyjściowego i priorytetów pod AI Overviews/LLM answers.
Dla kogo: zarząd/marketing/SEO/produkt.

Zakres (audyt + mapa encji):

  • Brand SERP & Entity Audit: panel wiedzy, sameAs, spójność nazwy/typu/atrybutów, autorzy, produkty/usługi.
  • Overview Readiness: koszyki zapytań, obecność w AI Overviews (baseline), cytowane źródła, luki treści.
  • Schema/Tech: JSON-LD (Organization/WebSite/WebPage/Article/FAQPage/Service/Product…), CWV, crawlability, hreflang, linkowanie, sitemap/robots, kanoniki.
  • Konkurencja: porównanie Share of Answers i przykładów cytowań.

Proces (7–10 dni): kickoff → zbiory danych (GSC, logi, CMS) → crawle/ekstrakcja → scoring → warsztat priorytetów.

Deliverables:

  • Mapa encji (Organizacja/Produkty/Autorzy/Słownik) + relacje about/mentions i sameAs.
  • Raport Insights z priorytetami (treść/schema/tech) i backlogiem 30/60/90 dni.
  • Baseline KPI: Overview Inclusion Rate, Share of Answers, Entity Coverage, AI Reference Rate.

KPI po zakończeniu: kompletność mapy encji (≥90%), lista 3–5 stron pilotażowych, zaakceptowany backlog.

Ryzyka: brak dostępu do danych, niespójne brand assets; mitigacja: lista minimalnych dostępów i eksportów.

GeoKnows Studio

Cel: tworzenie/edytowanie treści cite-ready oraz wdrożenie schema.org.

Zakres:

  • Treść: definicje (2–4 zdania), Q&A (50–120 słów), porównania, tabele danych, źródła z datami, podpisani autorzy i „last updated”.
  • Dwujęzyczność: pełny parytet PL/EN + hreflang.
  • Komponenty reużywalne: boksy „Key Takeaway”, „Sources”, „Methodology”.
  • Schema (JSON-LD): Organization, WebSite(+SearchAction), WebPage/Article, FAQPage/HowTo, Service/Product, BreadcrumbList; about/mentions, author/publisher, daty, sameAs.

Proces: briefy → redakcja → fact-check → schema → QA (walidatory, CWV) → publikacja.

Deliverables:

  • 3–5 stron filarowych + 1 FAQPage (PL/EN) z kompletnym JSON-LD.
  • Style guide (ton, długości, źródła, podpisy).
  • Checklisty publikacji (treść/schema/UX).

KPI: AI Reference Rate, Entity Coverage, CWV pass rate, Schema Validity (100% bez błędów).

Ryzyka: „ściana tekstu”, brak źródeł; mitigacja: definicje/Q&A w standardzie, obowiązkowe źródła.

GeoKnows Monitor

Cel: stały Overviews Watch + dashboard KPI (Answer → Action).

Zakres:

  • Koszyki zapytań: tematy, intencje, kraje/języki.
  • Monitoring: pojawienia w AI Overviews/LLM answers, cytowane źródła, konkurenci; archiwum screenshotów/próbek.
  • Alerty: pojawienie/utrata, błędy schema, regres CWV.
  • Dashboard: Overview Inclusion Rate, Share of Answers, AI Reference Rate, Entity Coverage, Citation Velocity, Action Inclusion.

Proces: definicja koszyków → automatyzacja pobrań → archiwizacja → tygodniowe/msc raporty.

Deliverables: dashboard (Looker/Metabase/GA4 + BigQuery), raport bazowy i rytm raportowania.

KPI: kompletność monitoringu (≥95% koszyków), czas reakcji na regresy (<7 dni).

Ryzyka: niestabilność wyników; mitigacja: próbkowanie w czasie, wersjonowanie koszyków.

GeoKnows Academy

Cel: standaryzacja procesu i odporność organizacji (PL/EN).

Zakres:

  • Szkolenia: GEO/AEO fundamentals, entity-first writing, schema, governance, RODO/źródła.
  • SOP/Playbook: publikacja, aktualizacje, QA, „proof over promises”.
  • Governance: role, przeglądy kwartalne, sign-off eksperta.

Deliverables: Materiały szkoleniowe (deck + nagranie), Playbook GEO/AEO, SOP z checklistami.

KPI: adopcja SOP (≥80% publikacji zgodnie z checklistą), błędy merytoryczne → 0 krytycznych.

5) AEO Kit (Answer/Action Engine Optimization)

Cel: uczynić ofertę porównywalną i wywoływalną przez agentów.

Skład:

  • OfferGraph: maszynowa reprezentacja oferty (atrybuty, warianty, warunki, SLA, ceny, wyjątki).
  • Action Endpoints: bezpieczne akcje (getQuote(), bookDemo(), comparePlans()) z walidacją, limitami ryzyka, idempotencją i undo.
  • Interface Hints: wskazówki do mikrowidoków (pola, walidacje, domyślne zakresy, micro-copy).

Proces: inwentaryzacja oferty → model danych → projekt endpointów → testy akceptacyjne → rollout.

Przykład — OfferGraph (JSON):

jsonKopiujEdytuj{
  "offerId": "svc-geo-audit",
  "name": "GEO Readiness Sprint",
  "attributes": {
    "durationDays": 21,
    "languages": ["PL", "EN"],
    "deliverables": ["EntityMap", "SchemaPlan", "PilotPages"],
    "sla": {"reportDeliveryDays": 3}
  },
  "pricing": {"currency": "PLN", "base": 24000, "options": [{"addon":"AEO Kit","price":12000}]},
  "constraints": {"jurisdictions": ["EU"], "data": {"requiresGSC": true}},
  "policies": {"cancelWindowHours": 48, "refundPercent": 80}
}

Przykład — Action Endpoint (OpenAPI sketch):

yamlKopiujEdytujPOST /actions/getQuote
request:
  customerId: string
  offerId: string
  params: { pages: int, languages: [string] }
response:
  quoteId: string
  amount: number
  currency: string
  undoToken: string
limits:
  rate: 30/min
  maxAmount: 100000
safety:
  consentScope: "pricing"
  undoWindowMinutes: 30

Przykład — Interface Hints (JSON):

jsonKopiujEdytuj{
  "microview": "quote",
  "fields": [
    {"name":"pages","type":"number","min":1,"max":100},
    {"name":"languages","type":"multiselect","options":["PL","EN","DE"]}
  ],
  "confirmCopy": "Confirm quote request?",
  "errorHints": {"pages":"Enter 1–100"}
}

Deliverables: offergraph.json, actions.openapi.yaml, interface-hints.json, testy akceptacyjne (E2E).

KPI: Action Inclusion/Share, No-UI Latency, Undo Rate, Error Rate.

Ryzyka: niejednoznaczne warunki; mitigacja: jasno opisane polityki/wyjątki, testy i „dry runs”.

6) Provenance Studio

Cel: zaufanie i audytowalność: podpisy, pochodzenie, wersjonowanie, źródła.

Zakres:

  • Content Credentials (C2PA) dla grafik/plików; podpisy autora/organizacji, daty, hash.
  • Wersjonowanie treści (git/CMS), changelog publiczny dla stron krytycznych.
  • Źródła i metodologia: sekcje „Sources/Methodology”, daty aktualizacji, zakres odpowiedzialności.
  • Logi działań (append-only) dla akcji wywoływanych przez agentów.

Deliverables: pipelines C2PA, stopki „Evidence”, polityka wersjonowania + narzędzia do podpisów.

KPI: Provenance Coverage (≥X% krytycznych stron), Verifiable Source Rate.

Ryzyka: brak wsparcia niektórych platform; mitigacja: równoległe logi i archiwum hashy.

7) Policy Graph

Cel: polityki zgodności jako dane — jurysdykcje, licencje, limity ryzyka, wyjątki.

Zakres: reprezentacja zasad, które agent może maszynowo sprawdzić przed akcją.

Przykład (YAML):

yamlKopiujEdytujpolicyId: eu-rodo-quote
appliesTo: ["getQuote","bookDemo"]
jurisdictions: ["EU"]
rules:
  - name: consent_required
    if: user.consent.pricing != true
    then: "require_micro_confirm"
  - name: pii_export
    if: data.containsPII == true
    then: "process_on_device"
limits:
  amountMax: 100000
  retryMax: 2
exceptions:
  - condition: customer.tier == "enterprise"
    override: { amountMax: 250000 }

Deliverables: policy-graph.yaml, walidator polityk, testy regresyjne.

KPI: Policy Compliance Pass Rate, Exception Handling Time.

Ryzyka: dryf reguł; mitigacja: wersjonowanie i przeglądy kwartalne.

8) A2S Attribution (Answer → Action → Settlement)

Cel: pełna atrybucja od odpowiedzi po rozliczenie (i spór).

Zakres:

  • Event model: answer_seen, answer_cited, action_invoked, action_confirmed, settlement_posted, dispute_opened/resolved.
  • Mapowanie bez-UI: identyfikacja strumieni agentowych, parametry i konteksty.
  • Revenue/Refund/Dispute: przypisanie wyniku do koszyka zapytań/answer chain.

Przykład (Event JSON):

jsonKopiujEdytuj{
  "event": "action_confirmed",
  "ts": "2025-08-10T12:34:56Z",
  "session": "anon-xyz",
  "answerId": "ovw-123",
  "action": "getQuote",
  "offerId": "svc-geo-audit",
  "amount": 24000,
  "currency": "PLN",
  "provenanceRef": "hash:abc...",
  "policyRef": "eu-rodo-quote@v1"
}

Deliverables: specyfikacja zdarzeń, pipeline (np. GA4/BigQuery/Segment), dashboard A2S.

KPI: Answer Inclusion → Action Inclusion → Revenue, Time-to-Settlement, Dispute Rate.

Ryzyka: pomylenie „współwystąpienia” z kauzalnością; mitigacja: eksperymenty/kohorty.

9) AgentOps

Cel: praktyczne integracje z asystentami/agentami (voice/gaze/zero-UI) + jakość i bezpieczeństwo.

Zakres:

  • Connectors: spec do OfferGraph, Action Endpoints, Interface Hints, Policy Graph.
  • Acceptance tests: scenariusze E2E (happy path, błędy, rate-limits, undo).
  • Eval & Red-team: halucynacje, manipulacje, nadużycia (assume-abuse).
  • Fallback: eskalacja do człowieka dla ryzykownych akcji.

Deliverables: zestaw testów, wyniki eval, lista kompatybilności (silniki/agent-platformy), „playbook nadużyć”.

KPI: Interaction Success Rate, No-UI Latency, Abort/Undo Rate (spada z czasem), Security Incidents (=0).

Ryzyka: szybko zmieniające się API; mitigacja: warstwa abstrakcji, testy ciągłe.

(opcjonalnie) 10) Smart Payments

Cel: bezpieczne płatności agentów (limity, escrow, refundy), np. ERC-4337.

Zakres:

  • Smart-wallet: polityki (limity/merchant whitelist/undo window), paymaster (gasless).
  • Escrow/Settlement: rezerwacja środków, wydanie po potwierdzeniu wyniku; ścieżka sporów.
  • Compliance: KYC/AML (jeśli dotyczy), audyt transakcji.

Przykład — Policy (JSON):

jsonKopiujEdytuj{
  "wallet": "geo-wallet",
  "limits": {"perAction": 5000, "perDay": 20000},
  "whitelist": ["merchantA","merchantB"],
  "undoWindowMin": 30,
  "escrow": true
}

Deliverables: spec płatności, integracja z checkoutem, raport settlementów.

KPI: Payment Success Rate, Refund/Dispute Resolution Time.

Ryzyka: UX/fee/latencja; mitigacja: paymaster, batchowanie, fallback do tradycyjnych płatności.

Pakiety i zależności (skrót)

  • Starter: Insights + Studio (1 filar + FAQ + schema core) + Monitor (baseline).
  • Growth: + AEO Kit (2 akcje) + Provenance Studio + Monitor (raporty msc).
  • Enterprise: + Policy Graph + A2S Attribution + AgentOps (+ opcjonalnie Smart Payments).

Zależności: AEO wymaga Insights/Studio (encje/treść/schema) → Provenance/Policy włączają trust/compliance → A2S/AgentOps domyka pomiar i integracje.

Wspólne standardy (dla całego stacku)

  • Evidence over promises: każdy artefakt z datą, źródłem, zakresem odpowiedzialności.
  • Privacy-by-design: minimalizacja danych, lokalne przetwarzanie gdzie możliwe.
  • Assume-abuse: limity, logi, kill-switch, testy nadużyć.
  • Interoperacyjność: otwarte formaty (offergraph.json, policy-graph.yaml, OpenAPI dla akcji).
  • SLA: czasy reakcji na regres Overviews, błędy schema, incydenty bezpieczeństwa.

Co dostaje klient (klarowne deliverables)

1) Mapa encji i luk + plan priorytetów

Po co: spójna baza wiedzy maszynowej o marce i ofercie (rdzeń GEO), plus lista działań.

Co dostajesz:

  • Entity Catalog (Organizacja, Produkty/Usługi, Autorzy, Klienci, Branże, Słownik pojęć) z atrybutami i sameAs.
  • Entity Graph (relacje about/mentions, hierarchie, aliasy).
  • Gap Analysis (braki treści/schema/tech).
  • Plan priorytetów 30/60/90 dni (tagi: content/schema/tech; wpływ × łatwość).

Formaty:

  • entity_map.json (dane), entity_graph.png/svg (wizual), backlog.csv (priorytety), krótki raport PDF.

Definition of done:

  • ≥90% kluczowych encji opisane (nazwa, typ, opis, sameAs).
  • Zatwierdzony backlog z właścicielami i terminami.

Mini-przykład (entity_map.json):

jsonKopiujEdytuj{
  "Organization": {
    "name": "GeoKnows",
    "url": "https://geoknows.com",
    "sameAs": ["https://linkedin.com/company/geoknows"],
    "founder": "Your Name"
  },
  "Service": [
    {"@id":"svc-geo-audit","name":"GEO Readiness Sprint","about":["Generative Engine Optimization","AI Overviews"]}
  ],
  "Person": [{"name":"Jane Kowalska","jobTitle":"Head of GEO"}]
}

2) 3–5 stron pilotażowych PL/EN (+ JSON-LD)

Po co: szybkie „proof” — strony gotowe do cytowania i monitoringu.

Co dostajesz:

  • 3–5 stron filarowych (PL i EN) z sekcjami: definicja (2–4 zdania), How it works, porównania (tabela), Q&A (50–120 słów), źródła (z datą), autor, „last updated”, nota metodologii.
  • FAQPage (dedykowana strona Q&A).
  • Hreflang + pełny parytet PL/EN.
  • JSON-LD: Organization, WebSite(+SearchAction), WebPage/Article, FAQPage, Service/Product, BreadcrumbList.

Definition of done:

  • Brak błędów w testach schema, CWV LCP <2.5 s, CLS <0.1 (mobil/desktop).
  • Każda strona ma ≥3 wiarygodne źródła, podpisanego autora i datę aktualizacji.
  • Linkowanie wewnętrzne do słownika/porównań/FAQ.

Mini-przykład (fragment Article JSON-LD):

jsonKopiujEdytuj{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "AI Overviews — what it is",
  "author": {"@type":"Person","name":"Jane Kowalska"},
  "dateModified": "2025-08-10",
  "about": ["Generative Engine Optimization","AI Overviews"],
  "mentions": [{"@type":"Thing","name":"Entity-first content"}]
}

3) OfferGraph + Action Endpoints (z walidacjami i limitami)

Po co: aby agenci mogli porównać i wywołać Twoją ofertę (AEO).

Co dostajesz:

  • OfferGraph — maszyny-czytelny opis oferty (atrybuty, warianty, ceny, SLA, wyjątki, ograniczenia).
  • Action Endpoints — minimum 2: np. getQuote(), bookDemo(); z walidacją parametrów, limitami ryzyka, idempotencją, „undo window”.
  • Testy akceptacyjne (happy path, błędy, odwołanie).

Formaty:

  • offergraph.json, actions.openapi.yaml, testy (Postman/pytest), krótkie README.

Mini-przykład (offergraph.json):

jsonKopiujEdytuj{
  "offerId":"svc-geo-audit",
  "name":"GEO Readiness Sprint",
  "attributes":{"durationDays":21,"languages":["PL","EN"],"deliverables":["EntityMap","PilotPages"]},
  "pricing":{"currency":"PLN","base":24000},
  "constraints":{"requiresGSC":true},
  "policies":{"cancelWindowHours":48,"refundPercent":80}
}

Mini-przykład (OpenAPI szkic):

yamlKopiujEdytujpost: /actions/getQuote
requestBody:
  pages: integer  # 1-100
  languages: array # ["PL","EN"]
responses:
  200: { quoteId: string, amount: number, currency: "PLN", undoToken: string }
x-safety:
  rateLimit: 30/min
  undoWindowMinutes: 30
  maxAmount: 100000

KPI: Action Inclusion/Share, No-UI Latency, Undo Rate, Error Rate.

4) Interface Hints (mikrowidoki/zero-UI) + consents & kill-switch

Po co: żeby agent mógł wyrenderować czytelny mini-formularz i poprosić o zgodę jednym gestem/głosem.

Co dostajesz:

  • Interface Hints (pola, walidacje, domyślne zakresy, mikro-copy błędów/akceptu).
  • Drabinka zgód (scope: suggest → execute with limit → execute all) + kill-switch i undo window.
  • Instrukcja integracyjna (dla agentów/asystentów).

Formaty: interface-hints.json, consents.yaml, ops-runbook.md.

Mini-przykład (interface-hints.json):

jsonKopiujEdytuj{
  "microview":"quote",
  "fields":[
    {"name":"pages","type":"number","min":1,"max":100,"label":"Pages to audit"},
    {"name":"languages","type":"multiselect","options":["PL","EN"]}
  ],
  "confirmCopy":"Confirm quote request?",
  "errorHints":{"pages":"Enter 1–100"}
}

Mini-przykład (consents.yaml):

yamlKopiujEdytujscopes:
  - name: suggest
  - name: execute_limited
    limits: { amountMax: 20000 }
  - name: execute_all
undoWindowMinutes: 30
killSwitch: "mailto:soc@geoknows.com"

KPI: Microview Completion Rate, Consent Match Rate, Abort/Undo Rate.

5) Dashboard KPI + alerty + raport Overviews Watch

Po co: widzieć wpływ: od odpowiedzi do akcji.

Co dostajesz:

  • Dashboard (Looker/Metabase/GA4+BigQuery) z metrykami:
    • Overview Inclusion Rate, Share of Answers, AI Reference Rate,
    • Entity Coverage Score, Citation Velocity,
    • Action Inclusion/Share, No-UI Latency, Undo/Abort Rate,
    • (opcjonalnie) A2S Revenue, Dispute Rate.
  • Alerty (mail/Slack): spadek Overviews, błąd schema, regres CWV, skoki Undo.
  • Raport Overviews Watch (mies.): nowe pojawienia/utrata, przykłady podsumowań, cytowane źródła, konkurenci, rekomendacje.

Definition of done:

  • Dashboard zasilany codziennie/tygodniowo (wg metryki), min. 3 alerty skonfigurowane.
  • Raport bazowy + harmonogram (tyg./msc).

6) SOP i playbook (publikacja, aktualizacja, governance, RODO)

Po co: żeby jakość nie zależała od „dobrych chęci”, tylko od procesu.

Co dostajesz:

  • Playbook GEO/AEO (PDF + repo): role, KRs, rytm przeglądów.
  • SOP z checklistami:
    • Treść: definicje/Q&A/porównania, źródła, autor, aktualizacja.
    • Schema: typy, about/mentions, daty, sameAs, walidacja.
    • Dwujęzyczność: parytet PL/EN, hreflang, kanoniki.
    • Provenance: podpisy/C2PA (jeśli dotyczy), changelog.
    • AEO: OfferGraph, Endpoints, Interface Hints, testy.
    • RODO/Compliance: zgody, retencja, prawo do sprzeciwu, kill-switch.
  • Szablony: brief treści, matryca źródeł, wzór offergraph.json, policy-graph.yaml, actions.openapi.yaml.

Definition of done: min. 80% nowych publikacji przechodzi checklisty bez błędów krytycznych przez 2 cykle.

7) Mini-case „przed/po” (z metrykami)

Po co: szybki dowód dla zarządu i sprzedaży.

Co dostajesz:

  • 2–3-stronicowy case PDF/HTML + źródłowy markdown.
  • Struktura:
    1. Kontekst i hipoteza (koszyki zapytań, baseline).
    2. Interwencje (treść/schema/AEO — daty).
    3. Wyniki (min. 2 metryki, np. Overview Inclusion +X p.p., Action Share +Y%, No-UI Latency −Z%).
    4. Zrzuty ekranów/ekrany Overviews (z datami) + metodologia.
    5. Ograniczenia i następne kroki.

Definition of done: metryki z datami, screen-proofy, podpis odpowiedzialnego, bez „gwarancji” w języku.

Struktura paczki przekazywanej klientowi (proponowana)

swiftKopiujEdytuj/deliverables/
  /insights/ entity_map.json, entity_graph.svg, backlog.csv, report.pdf
  /content/  pl-en-pages/..., faq/, sources.md, style-guide.md
  /schema/   jsonld-samples/, validation-report.md
  /aeo/      offergraph.json, actions.openapi.yaml, interface-hints.json, tests/
  /consent/  consents.yaml, ops-runbook.md
  /monitor/  dashboard-link.txt, alerts-config.md, overviews-watch-baseline.pdf
  /sop/      playbook.pdf, checklists/, templates/
  /cases/    case-01-before-after.pdf

Role i odpowiedzialności (skrót)

  • Client Owner: priorytety, dostęp do danych, decyzje.
  • Entity/Content Lead (GeoKnows): briefy, redakcja, źródła, PL/EN.
  • Tech/Schema Lead (GeoKnows): JSON-LD, CWV, hreflang, QA.
  • AEO Engineer (GeoKnows): OfferGraph, Endpoints, Hints, testy.
  • Analytics (GeoKnows): dashboard, alerty, raporty.
  • Legal/Compliance (po stronie klienta/GeoKnows): RODO, polityki.

SLA (rekomendowane)

  • Błędy schema/CWV krytyczne: <5 dni roboczych do poprawy.
  • Alert o utracie Overviews w koszyku krytycznym: <7 dni analiza i poprawki.
  • Aktualizacja SOP/playbook po zmianie algorytmów: ≤1 kwartał.

Efekt końcowy: po dostarczeniu powyższych elementów masz cytowalną treść, spójny graf encji, ofertę wywoływalną przez agentów, zgody i bezpieczeństwo by-design, oraz monitoring od odpowiedzi do akcji — wszystko w formatach, które łatwo utrzymać i skalować.