/**
 * GEO Schema Markup Templates — Organization + FAQPage
 * ======================================================
 * Add each block inside a <script type="application/ld+json"> tag in your <head>.
 * Validate at: https://search.google.com/test/rich-results
 *
 * ORGANIZATION — add to homepage + every service/product page.
 * FAQPage      — add to blog posts, FAQ pages, and category explainers.
 *
 * Field notes are in // comments. Remove comments before deploying
 * (JSON does not support comments; these are here for guidance only).
 */

// ── ORGANIZATION SCHEMA ───────────────────────────────────────────────────────
// Tells AI engines who you are and what vocabulary classifies you.
// The "description" and "knowsAbout" fields are what engines read to place
// you in a category. Use exact phrasing your buyers type — not internal jargon.

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Your Company Name",
  "url": "https://yourcompany.com",
  "logo": {
    "@type": "ImageObject",
    "url": "https://yourcompany.com/logo.png",
    "width": 512,
    "height": 512
  },
  "description": "One sentence: what you do and who you serve. Keep it under 160 characters and match this text exactly across LinkedIn, Crunchbase, and G2.",
  "sameAs": [
    "https://www.linkedin.com/company/your-company",
    "https://twitter.com/yourcompany",
    "https://www.crunchbase.com/organization/your-company",
    "https://www.g2.com/products/your-product/reviews",
    "https://www.capterra.com/p/your-product"
  ],
  "foundingDate": "2023",
  "areaServed": "US",
  "knowsAbout": [
    "Replace with your primary category (e.g. 'AI marketing automation for B2B SaaS')",
    "Replace with a secondary category or adjacent topic",
    "Replace with a third topic you publish expert content on"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "sales",
    "url": "https://yourcompany.com/contact"
  }
}


// ── FAQPAGE SCHEMA ────────────────────────────────────────────────────────────
// Makes individual Q&A pairs directly extractable by AI engines.
// Each answer should make sense WITHOUT the surrounding page — it will often
// be read without it. Keep answers under 300 characters for cleaner extraction.
//
// Where to source your questions:
//  1. Your GEO tracking prompt log — queries where you are NOT cited are the
//     highest-priority targets for FAQPage schema.
//  2. Google Search Console "Queries" tab — filter by your key pages.
//  3. "People Also Ask" boxes that appear for your category queries.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is [your category]?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Complete one-to-two sentence definition. This is the passage an AI engine will quote verbatim — write it so it is self-contained."
      }
    },
    {
      "@type": "Question",
      "name": "How much does [your category] cost for a B2B SaaS company?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Include a specific price range and the two or three factors that most affect cost (team size, contract length, feature tier). Specific numbers outperform vague ranges in AI citations."
      }
    },
    {
      "@type": "Question",
      "name": "What should I look for when choosing a [your category] vendor?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Three to five specific criteria with brief rationale. A list-style answer (criterion: reason) extracts more cleanly than a prose paragraph."
      }
    },
    {
      "@type": "Question",
      "name": "How long does [your category] implementation take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Give a concrete range and what drives the variance. Buyers researching timelines are in active evaluation — specific answers earn citations more reliably than hedged ones."
      }
    },
    {
      "@type": "Question",
      "name": "What are alternatives to [your company or main competitor]?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Name two or three alternatives with a one-line differentiator for each. This positions you as the authoritative source in competitor comparison queries — one of the highest-intent query types in B2B."
      }
    }
  ]
}


// ── IMPLEMENTATION NOTES ──────────────────────────────────────────────────────
//
// Deployment: wrap each block in <script type="application/ld+json"> ... </script>
// in your page <head>. One <script> tag per schema type is cleaner than combining.
//
// Validation: https://search.google.com/test/rich-results
//             https://validator.schema.org
//
// Priority order:
//  1. Organization on homepage (one-time, high impact on entity clarity)
//  2. FAQPage on your top-traffic blog posts and category pages
//  3. FAQPage on service/product pages targeting buyer-intent queries
//
// Re-index signal: after adding schema, request re-indexing in Google Search
// Console (URL Inspection > Request Indexing). Perplexity and ChatGPT pick up
// schema changes when they next crawl; no manual trigger available.
//
// Update cadence: review FAQPage questions quarterly against your GEO tracking
// log. Queries where you are still not cited after 8 weeks with schema in place
// are candidates for answer rewrites — the question matches but the answer is
// not extractable enough.
