HTML/Static Sites Installation Guide

Step-by-step guide to install TwoBucks Analytics on HTML and static sites.

Quick Start

Add the TwoBucks script to your HTML <head> section:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Your Website</title>
  
  <!-- TwoBucks Analytics -->
  <script
    src="https://twobucks.ai/script.js"
    data-website-id="your-website-id"
    async
  ></script>
</head>
<body>
  <!-- Your content -->
</body>
</html>

Multiple Pages

Add the script to every page, or use a template/include system:

PHP Include

<!-- includes/analytics.php -->
<script
  src="https://twobucks.ai/script.js"
  data-website-id="your-website-id"
  async
></script>

<!-- index.php, about.php, etc. -->
<?php include 'includes/analytics.php'; ?>

Template System

If using a static site generator (Jekyll, Hugo, etc.), add to your base template:

Jekyll (_includes/analytics.html):

<script
  src="https://twobucks.ai/script.js"
  data-website-id="{{ site.twobucks_website_id }}"
  async
></script>

Hugo (layouts/partials/analytics.html):

<script
  src="https://twobucks.ai/script.js"
  data-website-id="{{ .Site.Params.twobucksWebsiteId }}"
  async
></script>

Track Events

Button Clicks

<button onclick="trackClick('signup_button')">Sign Up</button>

<script>
function trackClick(buttonName) {
  if (window.twobucks) {
    window.twobucks('button_click', {
      button_name: buttonName,
      page: window.location.pathname
    });
  }
}
</script>

Form Submissions

<form onsubmit="trackFormSubmit('contact_form')">
  <!-- Form fields -->
  <button type="submit">Submit</button>
</form>

<script>
function trackFormSubmit(formName) {
  if (window.twobucks) {
    window.twobucks('form_submit', {
      form_name: formName,
      page: window.location.pathname
    });
  }
}
</script>

Data Attributes

Use HTML data attributes for automatic tracking:

<!-- Goal tracking -->
<button two-bucks-goal="signup" two-bucks-goal-source="homepage">
  Sign Up
</button>

<!-- Scroll tracking -->
<div two-bucks-scroll="content_viewed" two-bucks-scroll-threshold="0.5">
  Important content
</div>

Common Issues

Script Not Loading

Ensure script is in <head> or before </body>
Check browser console for errors
Verify data-website-id is correct
Check for Content Security Policy (CSP) restrictions
Ensure your site uses HTTPS (or localhost for development)

CORS Errors

If you see CORS errors:

Verify script URL is correct: https://twobucks.ai/script.js
Check that your site is using HTTPS (or localhost for development)
Ensure domain is registered in TwoBucks settings