# Structured Data Implementation Guide
# Example Analytics | exampleanalytics.com
# Last updated: 2026-06-16

## Overview

This guide covers how to implement Schema.org JSON-LD structured data across the Example Analytics website. Structured data helps search engines, AI assistants, and knowledge graph systems understand the site's entities and content.

All JSON-LD blocks should be placed in the `<head>` section of each page, inside a `<script type="application/ld+json">` tag. The complete graph is also available as a standalone file at:
`https://exampleanalytics.com/ai-schema.json`

---

## Schema Types Used

### 1. Organization + SoftwareApplication (Homepage & Global)

Use on: All pages (sitewide `@graph` block)

```json
{
  "@context": "https://schema.org",
  "@type": ["SoftwareApplication", "Organization"],
  "@id": "https://exampleanalytics.com/#organization",
  "name": "Example Analytics",
  "legalName": "Example Analytics, Inc.",
  "url": "https://exampleanalytics.com/",
  "logo": "https://exampleanalytics.com/images/logo.png",
  "foundingDate": "2018",
  "description": "B2B SaaS analytics platform with real-time dashboards, 200+ data connectors, and AI-powered insights.",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "500 W 2nd St",
    "addressLocality": "Austin",
    "addressRegion": "TX",
    "postalCode": "78701",
    "addressCountry": "US"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+1-512-800-4200",
    "contactType": "sales",
    "email": "hello@exampleanalytics.com"
  },
  "sameAs": [
    "https://twitter.com/exampleHQ",
    "https://linkedin.com/company/example-analytics",
    "https://github.com/example-analytics"
  ]
}
```

### 2. WebSite + SearchAction (Homepage)

Use on: Homepage only

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "url": "https://exampleanalytics.com/",
  "name": "Example Analytics",
  "potentialAction": {
    "@type": "SearchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://exampleanalytics.com/search?q={search_term_string}"
    },
    "query-input": "required name=search_term_string"
  }
}
```

### 3. SoftwareApplication + Offers (Product & Pricing Pages)

Use on: `/product/` and `/pricing/`

```json
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "Example Analytics Platform",
  "applicationCategory": "BusinessApplication",
  "operatingSystem": "Web",
  "offers": [
    {
      "@type": "Offer",
      "name": "Starter Plan",
      "price": "49",
      "priceCurrency": "USD",
      "description": "Up to 5 users, 10 connectors, dashboards, reports, and alerts."
    },
    {
      "@type": "Offer",
      "name": "Growth Plan",
      "price": "149",
      "priceCurrency": "USD",
      "description": "Up to 25 users, 50 connectors, AI Insights, and workspaces."
    },
    {
      "@type": "Offer",
      "name": "Business Plan",
      "price": "399",
      "priceCurrency": "USD",
      "description": "Unlimited users, all connectors, embedded analytics, and SSO."
    }
  ],
  "featureList": [
    "Real-time dashboards",
    "200+ data connectors",
    "AI-powered analytics",
    "Automated reports",
    "Embedded analytics",
    "SOC 2 Type II certified"
  ]
}
```

### 4. BlogPosting (Blog Articles)

Use on: Every individual blog post

```json
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Article Title Here",
  "description": "Article meta description here.",
  "datePublished": "2026-01-15",
  "dateModified": "2026-01-20",
  "author": {
    "@type": "Person",
    "name": "Author Name",
    "url": "https://exampleanalytics.com/blog/author/author-slug/"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Example Analytics",
    "logo": {
      "@type": "ImageObject",
      "url": "https://exampleanalytics.com/images/logo.png"
    }
  },
  "url": "https://exampleanalytics.com/blog/article-slug/",
  "image": "https://exampleanalytics.com/images/blog/article-image.jpg",
  "mainEntityOfPage": "https://exampleanalytics.com/blog/article-slug/"
}
```

### 5. HowTo (Tutorial & Guide Pages)

Use on: Resource guides like "How to Build a Marketing Dashboard"

```json
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "How to Build a Marketing Analytics Dashboard",
  "description": "Step-by-step guide to setting up a marketing dashboard in Example Analytics.",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Connect your data sources",
      "text": "Navigate to Integrations and connect Google Analytics, Facebook Ads, and your CRM."
    },
    {
      "@type": "HowToStep",
      "name": "Select a template",
      "text": "From the Template Gallery, choose the Marketing Attribution Dashboard template."
    },
    {
      "@type": "HowToStep",
      "name": "Customize your KPIs",
      "text": "Add or remove metric cards to match your team's reporting needs."
    }
  ]
}
```

### 6. FAQPage (Product & Feature Pages)

Use on: Pricing, Security, and key product feature pages

```json
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Does Example Analytics offer a free trial?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes. Example Analytics offers a 14-day free trial on the Growth plan with no credit card required."
      }
    },
    {
      "@type": "Question",
      "name": "Is Example Analytics SOC 2 certified?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes. Example Analytics is SOC 2 Type II certified, audited annually by Prescient Assurance."
      }
    }
  ]
}
```

### 7. BreadcrumbList (All Interior Pages)

Use on: All pages except the homepage

```json
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://exampleanalytics.com/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Product",
      "item": "https://exampleanalytics.com/product/"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "AI Insights",
      "item": "https://exampleanalytics.com/product/ai-insights/"
    }
  ]
}
```

---

## Implementation in HTML

Place each JSON-LD block in the `<head>`:

```html
<head>
  <title>AI Insights — Example Analytics</title>
  <!-- Standard meta tags -->

  <!-- Schema.org JSON-LD -->
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "SoftwareApplication",
    ...
  }
  </script>

  <!-- BreadcrumbList -->
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    ...
  }
  </script>
</head>
```

Multiple `<script type="application/ld+json">` blocks on the same page are valid and supported by all major search engines.

---

## Validation Tools

Test structured data before deploying:

- **Google Rich Results Test:** https://search.google.com/test/rich-results
- **Schema.org Validator:** https://validator.schema.org/
- **Google Search Console:** Rich Results report in the Enhancements section

---

## Priority Rollout Order

| Priority | Page | Schema Types |
|----------|------|-------------|
| 1 | Homepage | Organization, WebSite+SearchAction |
| 2 | Pricing | SoftwareApplication+Offers, FAQPage |
| 3 | Product feature pages | SoftwareApplication, FAQPage, BreadcrumbList |
| 4 | Integration pages | SoftwareApplication, BreadcrumbList |
| 5 | Blog posts | BlogPosting, BreadcrumbList |
| 6 | Resource guides | HowTo or Article, BreadcrumbList |
| 7 | Solution pages | SoftwareApplication, FAQPage, BreadcrumbList |

---

## AI Authority Stack Reference Link

Add this `<link>` tag to the `<head>` of all pages to help AI systems discover the AI readiness files:

```html
<link rel="ai-content-declaration" href="https://exampleanalytics.com/ai.txt" />
<link rel="llms-txt" href="https://exampleanalytics.com/llms.txt" />
```

---

## Questions

Developer contact: engineering@exampleanalytics.com
Structured data issues: seo@exampleanalytics.com
