Page Metadata

Configure page metadata for enhanced analytics and reporting in Big Crunch. If page metadata is enabled for your website, Big Crunch will automatically detect and log the page metadata based on either the JSON-LD data object or standard meta tags.

Any automatic page meta detection can be overwritten in the Big Crunch dashboard.

Automatic Detection Methods

Big Crunch uses two methods to automatically detect page metadata, checking in order of priority:

1. JSON-LD Data (Preferred)

The Big Crunch script scans for a <script type="application/ld+json"> block that defines at least an author. From that block, the following metadata is derived:

URL
Author name
Title / headline
Article section
Tags / keywords
Date published
Date updated

JSON-LD Example

<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "NewsArticle",
    "headline": "How to Optimize Ad Revenue in 2024",
    "url": "https://example.com/articles/optimize-ad-revenue",
    "author": {
      "@type": "Person",
      "name": "Jane Smith"
    },
    "articleSection": "Monetization",
    "keywords": ["ad revenue", "optimization", "monetization"],
    "datePublished": "2024-01-15T08:00:00Z",
    "dateModified": "2024-01-16T10:30:00Z"
  }
</script>

2. Standard Meta Tags & Canonical Link (Fallback)

If there is no JSON-LD (or it doesn't include an author), we fall back to reading standard meta tags:

<!-- URL -->
<meta property="og:url" content="https://example.com/article" />
<link rel="canonical" href="https://example.com/article" />

<!-- Title -->
<meta property="og:title" content="Article Title" />
<title>Article Title</title>

<!-- Author -->
<meta property="article:author" content="Jane Smith" />

<!-- Section/Category -->
<meta property="article:section" content="Technology" />

<!-- Dates -->
<meta property="article:published_time" content="2024-01-15T08:00:00Z" />
<meta property="article:modified_time" content="2024-01-16T10:30:00Z" />

<!-- Tags -->
<meta property="article:tag" content="javascript" />
<meta property="article:tag" content="web development" />
<meta property="article:tag" content="performance" />

Metadata Fields Reference

Field	JSON-LD Property	Meta Tag Fallback	Fallback Value
Title	`headline`	`og:title`	`document.title`
Author	`author.name`	`article:author`	Required
Section	`articleSection`	`article:section`	None
Tags/Keywords	`keywords`	`article:tag` (multiple)	None
Published Date	`datePublished`	`article:published_time`	None
Modified Date	`dateModified`	`article:modified_time`	None

Implementation Best Practices

For JSON-LD (Recommended)

Include Author - This is required for detection to work
Use Schema.org Types - NewsArticle, Article, or BlogPosting
Provide Complete Data - Include all relevant fields
Validate Structure - Use Google's Structured Data Testing Tool
Place in <head> - Position before Big Crunch script

For Meta Tags

Use Open Graph - Standard og: properties for better compatibility
Include Canonical - Always provide a canonical URL
Multiple Tags - Use multiple article:tag for all tags
Date Formats - Use ISO 8601 format for dates
Author Attribution - Provide clear author names

Custom Overrides

If automatic detection doesn't work for your use case:

Navigate to your website settings in Big Crunch
Go to the Page paths tab
Add specific path patterns with custom metadata
Override any automatically detected fields
Save and test your configuration

Example

<!DOCTYPE html>
<html>
  <head>
    <!-- JSON-LD Structured Data (Preferred) -->
    <script type="application/ld+json">
      {
        "@context": "https://schema.org",
        "@type": "NewsArticle",
        "headline": "How to Optimize Ad Revenue in 2024",
        "url": "https://example.com/articles/optimize-ad-revenue",
        "author": {
          "@type": "Person",
          "name": "Jane Smith"
        },
        "image": "https://example.com/images/article-thumbnail.jpg",
        "articleSection": "Monetization",
        "keywords": ["ad revenue", "optimization", "monetization"],
        "datePublished": "2024-01-15T08:00:00Z",
        "dateModified": "2024-01-16T10:30:00Z"
      }
    </script>

    <!-- Fallback Meta Tags -->
    <meta property="og:url" content="https://example.com/article" />
    <link rel="canonical" href="https://example.com/article" />
    <meta property="og:title" content="How to Optimize Ad Revenue in 2024" />
    <meta property="article:author" content="Jane Smith" />
    <meta property="og:image" content="https://example.com/images/article-thumbnail.jpg" />
    <meta property="article:section" content="Monetization" />
    <meta property="article:published_time" content="2024-01-15T08:00:00Z" />
    <meta property="article:modified_time" content="2024-01-16T10:30:00Z" />
    <meta property="article:tag" content="ad revenue" />
    <meta property="article:tag" content="optimization" />
    <meta property="article:tag" content="monetization" />

    <!-- Big Crunch Script -->
    <script
      src="https://1h.bigcrunch.com/main.js"
      data-property-id="PROPERTY_ID"
      id="bigcrunchtag"
      crossorigin="anonymous"
      async=""
    ></script>
  </head>
  <body>
    <!-- Your content -->
  </body>
</html>

Search Documentation