Scripts

Ahrefs Web Analytics

Ahrefs Web Analytics tracks page views and custom events without cookies or persistent identifiers. It discards the raw IP address after deriving coarse location data.

View source

Nuxt Config Setup

Add this to your nuxt.config.ts to load Ahrefs Web Analytics globally. Alternatively you can use the useScriptAhrefsAnalytics composable for more control.

export default defineNuxtConfig({
  scripts: {
    registry: {
      ahrefsAnalytics: {
        trigger: 'onNuxtReady',
      }
    }
  }
})

This config automatically enables first-party mode (bundle + proxy). See below to customise.

useScriptAhrefsAnalytics()

The useScriptAhrefsAnalytics composable lets you have fine-grain control over when and how Ahrefs Web Analytics is loaded on your site.

const { proxy } = useScriptAhrefsAnalytics()

Please follow the Registry Scripts guide to learn more about advanced usage.

First-Party Mode: Privacy Focused Proxy

No extra config needed. The script is bundled from your domain (faster loads, no extra DNS lookup) and runtime requests are reverse-proxied through your server with automatic anonymisation (user IPs stay hidden from Ahrefs Web Analytics, works with ad blockers). Learn more.

Mode

Bundle Proxy

Privacy

User IP addresses are anonymised. Other request data passes through.

export default defineNuxtConfig({
  scripts: {
    // ✅ First-party mode: bundled + proxied
    registry: {
      ahrefsAnalytics: {
        trigger: 'onNuxtReady',
      },
    },
  },
})

Example

Using Ahrefs Web Analytics in a component with the proxy to send events .

<script setup lang="ts">
const { proxy } = useScriptAhrefsAnalytics()

// noop in development, ssr
// just works in production, client
function handleAction() {
  // use proxy methods here
}
</script>

<template>
  <div>
    <button @click="handleAction">
      Send Event
    </button>
  </div>
</template>

Default:

Trigger: onNuxtReady The script loads when the Nuxt app is ready.

Use the proxy for void calls. Await $script when you need the loaded AhrefsAnalytics object. The Ahrefs tracked events guide documents the JavaScript API and event-property shape.

const { proxy } = useScriptAhrefsAnalytics({
  key: 'your-project-key',
})
function trackSignup() {
  proxy.AhrefsAnalytics.sendEvent('signup', {
    props: { plan: 'pro' },
  })
}

SPA navigation

Ahrefs Analytics tracks single-page app navigations natively: the loaded analytics.js patches history.pushState and listens for popstate, firing a fresh page view whenever the URL changes. Nuxt route changes need no extra configuration.

keystring required

Your Ahrefs Web Analytics project key. Set as the `data-key` attribute on the loaded `analytics.js` script tag.

Edit this page

Markdown For LLMs

Bing UET

Load Microsoft Advertising UET, send conversion events, and update its ad-storage consent signal.